Microsoft app registration

This is where Connect gets its credentials for Dynamics. By the end you'll have noted down three of the five details you need:

  • Your Microsoft app registration tenant ID.
  • Your Microsoft app registration client ID.
  • Your Microsoft app registration client secret.

The client secret is only shown once, when you create it, so copy it somewhere safe before you leave that screen.

1. Go to the Azure portal.

2. Click App registrations.

App registrations in the Azure portal

3. Click New registration.

The New registration button

4. Give it a name. Anything recognisable will do, for example "Dynamics365 App".

Entering a name for the app registration

5. Click Register.

The Register button

6. Note down the client ID and tenant ID from the overview page.

The client ID and tenant ID on the app registration overview page

7. Click Certificates & secrets.

Certificates and secrets in the app registration menu

8. Click New client secret.

The New client secret button

9. Add a description and save, then copy the secret value straight away. Azure hides it as soon as you navigate away, and you can't get it back.

The generated client secret value

10. Click API permissions.

API permissions in the app registration menu

11. Click Add a permission.

The Add a permission button

12. Choose Dynamics CRM.

Dynamics CRM in the list of APIs

13. Tick user_impersonation, described as "Access Common Data Service as organization users".

Ticking the user_impersonation permission

14. Click Add permissions.

The Add permissions button

Next: linking your app registration to Dynamics.