# Azure Integration

This document describes how to integrate the Rezonate product with the Azure Active Directory and Azure Subscriptions. The integration also covers M365 and Intune.



### Step 1 - Creating an Application

&#x20;

1. Browse to the Azure Active Directory [user portal](https://portal.azure.com/#view/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/~/Overview).
2. Select “Enterprise Applications” in the side menu\
   ![](https://2355086414-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIkSba0W4HlnmPJ93gVOS%2Fuploads%2FglhiZr3uQbSGVI2e9pEj%2Fimage.png?alt=media\&token=a32929f8-75a3-4e67-9c4f-dc790ba438ed)\

3. Click “New Application”.\
   ![](https://2355086414-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIkSba0W4HlnmPJ93gVOS%2Fuploads%2FqR9u50NpawuTtF6npHMW%2Fimage.png?alt=media\&token=d0f02061-4743-4348-851c-a654ec90ce17)\

4. Select “Create your own”.\
   ![](https://2355086414-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIkSba0W4HlnmPJ93gVOS%2Fuploads%2Fb43GaPqW1iloTJ0ED2ZJ%2Fimage.png?alt=media\&token=5962a9dd-aa3b-4288-94c3-aaeb001ab055)\

5. In the new Application name, write “**Rezonate**” and then click Create.
6. After the creation process is complete, you will be redirected to the application page.
7. Click the Permissions tab on the side menu.\

8. Select “Application registration”.&#x20;

### Step 2 - Granting Access to Azure AD + M365

1.  Select “Add Permissions” and select Microsoft Graph, and then **Application permissions.**\


    <figure><img src="https://rezonate.zendesk.com/hc/article_attachments/11076742147229" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://2355086414-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIkSba0W4HlnmPJ93gVOS%2Fuploads%2FlhE0obp1OO5I64hKcxGD%2Fimage.png?alt=media&#x26;token=f14dfc4d-174b-4419-8efd-a28cfb6ef242" alt="" width="563"><figcaption></figcaption></figure>

1. Add the following read-only permissions for the application to acquire all relevant data:

TeamMember.Read.All\
UserAuthenticationMethod.Read.All\
Policy.Read.PermissionGrant\
IdentityRiskyServicePrincipal.Read.All\
Channel.ReadBasic.All\
SecurityAlert.Read.All\
MailboxSettings.Read\
Directory.Read.All\
ReportSettings.Read.All\
RoleManagement.Read.All\
IdentityProvider.Read.All\
IdentityRiskyUser.Read.All\
IdentityRiskEvent.Read.All\
AuditLog.Read.All\
Policy.Read.All\
Member.Read.Hidden\
Reports.Read.All\
DirectoryRecommendations.Read.All\


After selecting the permissions, Click **Add Permissions**.

6. Click “Grant Admin Consent for Rezonate” and then “Yes”.
7. Select “Certificates & secrets” in the side menu.\

8. Select “Upload certificate”.\

9. Add the rezonate\_aad\_azure.crt file from Rezonate. (Attached in this article)&#x20;
10. Click the Overview button.\
    &#x20;
11. **Please copy and bring back the following items:**
    1. Application (client) ID
    2. Directory (tenant) ID

### Step 3 (for Azure Integration) - Granting Access to Azure Management Group

1. Head over to the Management Groups screen, and choose the Tenant Root Group.
2. Select Access Control (IAM) from the left-side bar.\
   \

3. Select “Role Assignments”, then “Add”, and then “Add role assignment”.
4. Select “Job Function Roles”, and head over to the Role tab.&#x20;
5. In this tab, select “**Reader**” and then “Next”.
6. You will be moved to the “Members” page, to add members to the assignment.
7. Click “+ Select Members” and enter the application name created in step 1 - “Rezonate”. You will see the application in the right-side menu, click it and then click “Select”.
8. You should now see the application in the Members box. Click “Review + Assign” to finish the process.
9. You should now see the application is assigned the “Reader” role, listed in the “Role assignments” screen.
10. Head over to the overview screen of the subscription to find the ID.\

11. **Please copy and bring back the following items:**
    1. Subscription ID numbers to cover.
    2. Tenant ID.



{% file src="https://2355086414-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIkSba0W4HlnmPJ93gVOS%2Fuploads%2FkDkbNe9FAilRDBdj0QI9%2Frez-2025.crt?alt=media&token=fd8020ea-f0de-4d5c-8fde-2c12e286dfcf" %}
