If you are using CRM or are thinking of acquiring it soon and happen to be doing development outside of the .NET world, then this is something you’ll want to pay attention to right away. Trying to connect to CRM outside of .NET up until this point has been a fairly unpleasant experience. Everyone has undoubtedly seen at this point that Microsoft is doing it’s best to make sure its products and services can work on the broadest range of platforms that it can. This extends to being able to consume those services (like CRM) from as many different languages as it can. Building on top of RESTful web services goes along way in accomplishing that goal. To show how easy it can be I’ll be posting the same examples in a variety of different languages and scenarios.
- C# (Console)
- C# (Universal Windows Platform)
- Java (Console)
- Python (Console)
- Python (Django) – Coming Soon
To get started you’ll need to pre-register an application with Azure / On Premise Active Directory in order to get the Client Id the application needs. The steps can be found here:
This C# example really isn’t doing much different from the samples Microsoft provides. Both use ADAL (Active Directory Authentication Library) (get it from NuGet) to handle authentication and both do similar operations (Create, Read, Update, Delete & WhoAmI) but the one thing my sample shows is using one of the overloads for the AcquireToken method to actually get authenticated. The Microsoft sample shows how an interactive authentication would work by popping open the A/AD login page. I’ve also included a sample of how this can look when using a hardcoded username and password combination for an integration type scenario where user interaction wouldn’t make sense.
//Azure Application Client ID private const string _clientId = "00000000-0000-0000-0000-000000000000"; // Azure Application REPLY URL - can be anything here but it must be registered ahead of time private const string _redirectUrl = "http://localhost/CrmWebApi"; //CRM URL private const string _serviceUrl = "https://org.crm.dynamics.com"; //O365 credentials for authentication w/o login prompt private const string _username = "firstname.lastname@example.org"; private const string _password = "password"; //Azure Directory OAUTH 2.0 AUTHORIZATION ENDPOINT private const string _authority = "https://login.microsoftonline.com/00000000-0000-0000-0000-000000000000";
private static AuthenticationResult _authResult;
AuthenticationContext authContext = new AuthenticationContext(_authority, false);
//Prompt for credentials //_authResult = authContext.AcquireToken( // _serviceUrl, _clientId, new Uri(_redirectUrl)); //No prompt for credentials UserCredential credentials = new UserCredential(_username, _password); _authResult = authContext.AcquireToken( _serviceUrl, _clientId, credentials); var token = _authResult.AccessToken;
Of course the other cool feature to consider is that there is no longer any dependency on the CRM SDK assemblies. Hopefully 2016 SDK will not ship with ADAL in the set of binaries, hopefully forcing everyone to get it from NuGet and preventing a some of those dreaded missing assembly reference errors when you get someone else’s code from source control that didn’t use NuGet.
You can check out the code on GitHub: