If you’re like me you’ll have been excited recently with all the improvements coming in .NET, first with .NET Core and now with .NET 5 and 6. But as Dynamics developers we’ve been locked into using .NET Framework by the Dynamics SDK.
Thankfully that’s changing with the preview Dataverse ServiceClient, which provides a familiar SDK for .NET Core too.
However this library requires the use of OAuth to authenticate to Dynamics. This is great security-wise, but can lead to problems connecting to older on-prem systems where OAuth might not be available.
By default, on-prem Dynamics CRM & Dynamics 365 use WS-Trust. This older security protocol:
- has already been deprecated for online instances
- is not available in new environments and
- will be removed from existing environments in April 2022
You can enable OAuth for on-prem instances by following some additional steps.
OAuth is definitely what you should be using if at all possible, but what if you’re not in control of the on-prem server and need to connect using WS-Trust from .NET Core?
Enter my new NuGet package Data8.PowerPlatform.Dataverse.Client!
This builds on top of the preview SDK and provides a new
OnPremiseClient class. Simply create an instance of this class with the URL of the organization service, username and password. It implements the standard
IOrganizationService interface so you can use it as a drop-in replacement wherever you are using the regular SDK.
var svc = new OnPremiseClient("https://org.crm.contoso.com/XRMServices/2011/OrganizationService.svc", "AD\\username", "password"); var qry = new QueryExpression("contact"); qry.Criteria.AddCondition("firstname", ConditionOperator.Equal, "Mark"); qry.Criteria.AddCondition("lastname", ConditionOperator.Equal, "Carrington"); var results = svc.RetrieveMultiple(qry);
Other than switching
OnPremiseClient you shouldn’t need to make any other changes to your code to use this package – all the query, entity etc. types are reused from the Microsoft SDK.
This library does require claims-based authentication to be enabled on the server – it doesn’t work with Windows authentication. The library is open source however if you want to have a go at adding this in!
Many thanks to Data8 for agreeing to open up this library to the community!