DevelKit.Crm.Sdk.Lite
11.0.0
dotnet add package DevelKit.Crm.Sdk.Lite --version 11.0.0
NuGet\Install-Package DevelKit.Crm.Sdk.Lite -Version 11.0.0
<PackageReference Include="DevelKit.Crm.Sdk.Lite" Version="11.0.0" />
<PackageVersion Include="DevelKit.Crm.Sdk.Lite" Version="11.0.0" />
<PackageReference Include="DevelKit.Crm.Sdk.Lite" />
paket add DevelKit.Crm.Sdk.Lite --version 11.0.0
#r "nuget: DevelKit.Crm.Sdk.Lite, 11.0.0"
#:package DevelKit.Crm.Sdk.Lite@11.0.0
#addin nuget:?package=DevelKit.Crm.Sdk.Lite&version=11.0.0
#tool nuget:?package=DevelKit.Crm.Sdk.Lite&version=11.0.0
Crm.Sdk.Core.Async.Lite
Async SDK for Microsoft Dynamics CRM on-premises, including CRM 2015.
Install
dotnet add package DevelKit.Crm.Sdk.Lite --version 11.0.0
The 11.0.0 release is prepared in this repository; the package owner publishes it to NuGet separately. Until then, use the generated nupkg from a local feed. ADFS, Live ID and Dynamics 365 Online authentication are not implemented.
Framework compatibility
| Consumer | Selected package assets |
|---|---|
| .NET Core 2.1, 2.2, 3.0, 3.1 and .NET 5 | netstandard2.0 |
| .NET 6, 7, 8, 9, 10 | matching net6.0 through net10.0 |
Build with the .NET 10 SDK. Older target compatibility does not imply that those runtimes still receive security updates from Microsoft. Regression suites target .NET 6, 8, 9 and 10. Package smoke tests (serialization, two pooled SOAP calls, and cancellation isolation) also passed on Windows with runtimes 2.1.30, 2.2.8, 3.0.3, 3.1.32, 5.0.17 and 7.0.20. This is local protocol validation, not a live CRM compatibility certification.
NTLM and connection lifetime
NTLM/Negotiate authentication is performed by HttpClientHandler so the transport keeps the handshake on one connection and reuses authenticated sockets. The old manual handshake and its hidden HttpClient timeout have been removed. Credentials are restricted to NTLM/Negotiate on the first CRM authority; redirects are not followed. Configure credentials and proxy settings before the first call.
Windows uses SSPI. Linux needs a working GSSAPI NTLM provider (for example the OS package gss-ntlmssp); validate the target container with your domain. A managed NTLM fallback is no longer provided. Never disable TLS validation to make a connection work; install the organization's trusted CA certificates instead.
Keep each proxy alive for its owner's lifetime and dispose it when that owner stops. Lite/OData keep a handler per proxy; per-call HttpClient wrappers do not destroy its connection pool. Do not use a WCF proxy concurrently: lease it to one operation at a time. Do not mutate a NetworkCredential while it is in use.
Cancellation, timeouts and writes
Cancellation is local. CRM 2015 does not accept a .NET CancellationToken as part of its SOAP contract. Canceling or timing out a client does not confirm that CRM rolled back a write. After dispatch, a lost response means the outcome can be unknown; reconcile the result before repeating a create.
The Full proxy Timeout maps to WCF binding timeouts and channel OperationTimeout. Lite/OData use the per-call HttpClient timeout. Registration of local cancellation is scoped to one call and cannot abort a later pooled call. Write operations and generic Execute are not automatically replayed by the Full proxy after errors.
CRM's standard duplicate detection can be requested with CreateRequest and SuppressDuplicateDetection=false. It requires enabled, published server rules and is not an atomic uniqueness guarantee for concurrent creates.
Version 11 migration
The Lite package is prepared as DevelKit.Crm.Sdk.Lite. Previous repository
packaging incorrectly used the Full package ID. Lite uses direct SOAP/HTTP and
includes Microsoft.Xrm.Sdk and Microsoft.Crm.Sdk. Do not install both variants
in one application: their assembly names overlap.
Build and verify
./build.ps1
Install .NET runtimes 6, 8, 9 and 10 to execute the test matrix. The script builds
all target assets, runs the isolated loopback tests, compiles package consumers
for .NET Core 2.1, 2.2, 3.0, 3.1 and .NET 5-10, and puts the nupkg in
artifacts/. Use -SkipTests only if test execution is handled separately.
To repeat runtime smoke tests with isolated Windows runtimes, run
./verify-runtimes.ps1 -RuntimeRoot <directory>; the directory contains
2.1/, 2.2/, 3.0/, 3.1/, 5.0/ and 7.0/ dotnet installations.
Tests never connect to a live CRM. The NTLM handshake test uses a native server challenge on .NET 8+ and checks connection affinity and request count; it is not a domain-credential validation test.
License
MIT. See LICENSE.md.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net5.0 was computed. net5.0-windows was computed. net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 is compatible. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
| .NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
| .NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
| .NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
| MonoAndroid | monoandroid was computed. |
| MonoMac | monomac was computed. |
| MonoTouch | monotouch was computed. |
| Tizen | tizen40 was computed. tizen60 was computed. |
| Xamarin.iOS | xamarinios was computed. |
| Xamarin.Mac | xamarinmac was computed. |
| Xamarin.TVOS | xamarintvos was computed. |
| Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- Newtonsoft.Json (>= 13.0.3)
- System.Memory (>= 4.5.5)
-
net10.0
- Newtonsoft.Json (>= 13.0.3)
- System.Memory (>= 4.5.5)
-
net6.0
- Newtonsoft.Json (>= 13.0.3)
- System.Memory (>= 4.5.5)
-
net7.0
- Newtonsoft.Json (>= 13.0.3)
- System.Memory (>= 4.5.5)
-
net8.0
- Newtonsoft.Json (>= 13.0.3)
- System.Memory (>= 4.5.5)
-
net9.0
- Newtonsoft.Json (>= 13.0.3)
- System.Memory (>= 4.5.5)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|
Reuse authenticated transport pools; local cancellation and timeout safety; .NET Standard 2.0 and .NET 6-10 assets. See README for migration and runtime requirements.