Microsoft Entra ID
Configure Microsoft Entra ID (Azure AD) integration with Risotto
Connect your Microsoft Entra ID (formerly Azure Active Directory) to Risotto to enable automated access management and group-based application provisioning.
Prerequisites
Before setting up the Microsoft Entra ID integration, ensure you have:
- Global Administrator Access - Administrative privileges in your Microsoft Entra ID tenant
- Application Registration Rights - Ability to register applications in your tenant
- Microsoft Graph API Permissions - Access to configure application permissions
Setup Process
Step 1: Register Application in Microsoft Entra ID
Access Azure Portal
- Sign in to the Azure Portal
- Navigate to Microsoft Entra ID
- Select App registrations from the left menu
Create New Registration
- Click New registration
- Enter application details:
- Name:
Risotto Integration - Supported account types: Accounts in this organizational directory only
- Redirect URI: Leave blank for now
- Name:
- Click Register
Note Application Details
After registration, copy and securely store:
- Application (client) ID
- Directory (tenant) ID
Step 2: Configure API Permissions
Add Microsoft Graph Permissions
- In your app registration, select API permissions
- Click Add a permission > Microsoft Graph > Application permissions. Do not use delegated permissions.
- Add the following permissions:
User.Read.All- Read all user profilesGroup.ReadWrite.All- Read and write all groupsGroupMember.ReadWrite.All- Read and write all group membershipsApplication.Read.All- Read all applications
Grant Admin Consent
- Click Grant admin consent for [Your Organization]
- Confirm by clicking Yes
- Verify all permissions show Granted for [Your Organization]
Step 3: Create Client Secret
Generate Secret
- Navigate to Certificates & secrets
- Click New client secret
- Add description:
Risotto Integration - Set expiration (recommended: 24 months)
- Click Add
Secure the Secret
Immediately copy the client secret value - it won't be shown again. Store it securely.
Step 4: Configure Integration in Risotto
Open the Microsoft Entra ID page
In your Risotto dashboard, go to Settings > Integrations and click the Microsoft Entra ID card. On the App registration card, click Connect.
Enter the app registration details
The Microsoft Entra ID dialog opens, with the Entra steps in its Instructions pane. Enter:
- Tenant ID: your Directory (tenant) ID from Step 1
- Client ID: your Application (client) ID from Step 1
- Client Secret: the secret value from Step 3
The Tenant ID and Client ID must be GUIDs, like
a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d. Click Save.Check the connection
When you click Save, Risotto asks Microsoft for an access token with these credentials. If the Tenant ID, Client ID, or Client Secret is wrong, or the secret has expired, the dialog shows the error and nothing is saved. When the save succeeds, the App registration card shows the Tenant ID, the Client ID, and Client Secret: Set.
Sign-in Verification
See Sign-in Verification.
Configuration Details
Required Information
| Field | Description | Example |
|---|---|---|
| Tenant ID | Your Microsoft Entra ID tenant identifier | 12345678-1234-1234-1234-123456789012 |
| Client ID | Application (client) ID from app registration | 87654321-4321-4321-4321-210987654321 |
| Client Secret | Secret value generated in app registration | abc123...xyz789 |
API Permissions
The integration requires these Microsoft Graph API permissions:
- User.Read.All: Read user profiles and the groups a user belongs to
- Group.ReadWrite.All: Read groups and their properties
- GroupMember.ReadWrite.All: Add users to groups and remove them for access control
- Application.Read.All: Read the applications in your tenant
The Reset User Password and Reset User MFA Factors runbook tools need more permissions and a directory role. Their pages list them.
Best Practices
Troubleshooting
Common Issues
Authentication Failed
- Verify the Tenant ID, Client ID, and Client Secret are correct
- Check that the client secret hasn't expired
- Ensure the application registration is in the correct tenant
Permission Denied
- Verify admin consent has been granted for all required permissions
- Check that the Global Administrator has approved the permissions
- Ensure the application has the correct Microsoft Graph permissions
Groups Not Syncing
- Confirm
Group.ReadWrite.AllandGroupMember.ReadWrite.Allpermissions are granted - Verify group membership in Microsoft Entra ID
- Check that groups are security groups (not distribution groups)
Permission Reference
If you encounter permission errors, verify these Microsoft Graph permissions are configured:
Application Permissions:
- User.Read.All
- Group.ReadWrite.All
- GroupMember.ReadWrite.All
- Application.Read.All
Security Considerations
- Secret rotation: Risotto connects with the client secret. Before it expires, create a new secret in Certificates & secrets, then open the App registration card's Connected menu, choose Configure..., and save the new value
- Conditional Access: Configure conditional access policies to restrict when and how the application can access your tenant
- Monitoring: Enable audit logging and monitor application activity in Microsoft Entra ID logs
Support
For additional help with Microsoft Entra ID integration:
- Review Microsoft Graph permissions documentation
- Check the Applications documentation for access rule configuration
- Consult Microsoft Entra ID app registration guide
- Contact your Risotto administrator for organization-specific questions
Something wrong or missing? Report an issue · View as Markdown