1. Automated Integrations

How do I connect the Adoptech Portal to Microsoft Azure?

Connect Adoptech Portal to Azure to synchronise your list of users on the Adoptech Portal with those in Microsoft Entra ID (formerly known as Active Directory).

Go to https://portal.azure.com/ in your browser, log in as an administrator and then click the icon for Microsoft Entra ID.

From the left-hand side menu, choose App Registrations.

From the top menu, select New registration.

Enter a name for the application. You can choose any name, but we recommend that you call it Adoptech. The supported account type should be set to Single tenant. Then click Register.

Now take a copy of the Application (client) ID and the Directory (tenant) ID. If you hover your pointer over the string, you'll get a Copy to clipboard icon. You will need these strings later to connect the Adoptech Portal to Azure. You should store these in a secure place, such as in your password manager. Then click Certificates and secrets.

Click New client secret. Enter Adoptech in the Description field and choose 730 days (24 months) in the Expires dropdown. Then click Add.

Make a note of the string in the Value field. This is your client secret, and it should be stored in a secure place, such as your password manager.

From the left-hand side menu, choose API permissions. Then click Add a permission. Now click on Microsoft Graph in the right-hand pop-up window.

Then choose Application permissions. In the Select permissions box, enter Directory. Flip down the Directory dropdown and enable the checkbox labelled Directory.Read.All. This gives the Adoptech Portal permission to read your directory, but not to modify it. Finally, click Add permissions.

Now click Grant admin consent and confirm in the following pop-up box by selecting Yes.

Go back to the main Azure Portal page and navigate to Subscriptions. Click on your subscription.

Click on Access control (IAM), and on the right-hand side, choose Add role assignment from the Add menu.

Enter reader in the search box, and then highlight the Reader row in the search results.

Select the Members tab, ensure Assign access to is set to User, group or service principal, and then click Select members. In the pop-up, search for the Adoptech app and select it. then press the Select button and finally the Review + assign button.

Now open the Adoptech Portal (https://portal.adoptech.co.uk/) in your browser, click Apps & Integrations on the left-hand side menu and find the Azure card in the list of integrations. Press the Connect button on the card.

Now paste in the three strings that you saved from your earlier steps on Azure, and click Connect.