Azure AD (Microsoft Entra ID) Integration Guide
Connecting Azure AD to Raptoriods ID enables fully automated, cloud-based identity lifecycle management including account creation, attribute modification, and termination workflows.
Prerequisites
Administrator Access
You must have **Global Administrator** or **Application Administrator** privileges within your Microsoft Entra ID (Azure AD) tenant.
Create the App Registration in Azure
First, you need to create a dedicated application identity for Raptoriods ID to use.
- 1Log in to the **Azure Portal**.
- 2Navigate to **Microsoft Entra ID** (formerly Azure Active Directory).
- 3In the left-hand menu, select **App registrations**, then click **+ New registration**.
- 4Configure the following:NameRaptoriods ID IAM ProvisioningAccount TypesSingle tenant
Save your IDs
On the Overview page of your new app, copy the **Application (client) ID** and the **Directory (tenant) ID**. You will need these later.
Grant Graph API Permissions
Next, you must give the application the specific permissions it needs to manage your users and groups.
- Click on **API permissions** > **+ Add a permission** > **Microsoft Graph**.
Required Application Permissions:
User.ReadWrite.AllRequired to create, update, and disable users.
Group.ReadWrite.AllRequired to add/remove users from security groups.
Directory.ReadWrite.AllRequired for directory-level reads.
CRITICAL STEP: Admin Consent
Click the button that says **Grant admin consent for [Your Organization]** and confirm. The status column for all permissions must show a green checkmark.
Generate a Client Secret
Create the secure password (secret) that Raptoriods will use to authenticate.
Add a description (e.g., `Raptoriods API Key`) and select an expiration timeframe (e.g., **24 months**).
Copy the Secret Value
Immediately copy the text in the **Value** column. Note: Azure will only show this value to you once. If you lose it, you will need to generate a new secret.
Connect Raptoriods ID
Finally, bring the credentials you gathered back to your Raptoriods dashboard.
Enter your **Tenant ID**, **Client ID**, and **Client Secret**, then click **Connect & Verify**. Raptoriods ID will immediately test the connection using the Microsoft Graph API.