The CloudRadial AutomationAI Microsoft Entra ID extension lets a workflow or agent investigate and secure identities through Microsoft Graph: look up users, review group memberships, directory roles, and sign-in activity, inventory devices, and lock down a compromised account. This article covers what the extension can do, the app registration and secrets it needs, which tools require approval, and the skills that ship with it. It is for workspace users who build automations (Admin or Owner Role).
- What the Extension Covers
- Creating the App Registration
- Providing the Credentials to Your Runner
- Reads and Approval-Gated Changes
- Skills
- Tips for Working With Entra ID Data
What the Extension Covers
The extension calls Microsoft Graph and provides 16 tools across these areas:
| Area | What you can automate |
| Users | List and search users, look up one user by object id or user principal name (UPN), and list the groups and directory roles a user directly belongs to |
| Account lock-down | Revoke all of a user's sign-in sessions and refresh tokens, force a password reset, and disable or re-enable an account |
| Groups | List, search, and read groups, list a group's members, and add or remove a user |
| Directory roles | List the directory roles activated in your tenant, to review which privileged roles exist |
| Sign-in and audit logs | List interactive sign-in events and directory change events, such as password resets, role assignments, and group changes |
| Devices | List devices registered or joined to the directory, filtered by name or operating system |
To create users, manage licenses, or set automatic replies, use the Microsoft 365 extension instead; this extension does not do those.
Install it from Extensions like any other catalog extension. See Browsing and installing extensions for the general install flow.
Creating the App Registration
The extension signs in with an app-only (client-credentials) token for a Microsoft Entra ID app registration, so it runs unattended with no signed-in user. For the general steps of creating an app registration and a client secret, see Creating a Microsoft 365 app registration for the Microsoft 365 extension, but grant this app the Microsoft Graph application permissions below, with admin consent:
| Permission | Used for |
User.Read.All |
Reading users, their memberships, and devices |
Group.Read.All |
Reading groups |
Directory.Read.All |
Reading directory roles |
AuditLog.Read.All |
Reading sign-in and directory audit logs |
User.ReadWrite.All, or the least-privileged User-PasswordProfile.ReadWrite.All |
Resetting a password |
User.EnableDisableAccount.All |
Disabling and re-enabling an account |
User.RevokeSessions.All |
Revoking sign-in sessions |
GroupMember.ReadWrite.All |
Adding and removing group members |
Sign-in logs also require a Microsoft Entra ID P1 or P2 license on the tenant.
Providing the Credentials to Your Runner
Store four secrets in your runner's Key Vault with these exact names. They are separate from the Microsoft 365 extension's secrets, so add them under these names even if you have already set that extension up.
| Secret | Value |
Entra-ApiUrl |
The Microsoft Graph base URL, normally https://graph.microsoft.com/v1.0, with no trailing slash. It is the same for every tenant, but the extension still reads it from this secret. |
Entra-TenantID |
Your Entra tenant (directory) ID GUID |
Entra-ClientID |
The application (client) ID GUID from the app registration's Overview page |
Entra-ClientSecret |
The client secret value created under the app registration's Certificates & secrets |
The runner reads these secrets itself, so never paste them into a prompt or a tool input. For how to add secrets, see Accessing and updating your runner's Key Vault. If you manage a separate Entra tenant for each client, see Managing companies and per-company credentials.
Reads and Approval-Gated Changes
Of the 16 tools, 10 are read-only and run without interruption. The other 6 change an account or a group, and every one of them is approval-gated: the run pauses and the request appears as an Action Required item in the Inbox until someone approves it. See Handling Action Required items in the Inbox.
| Tool behavior | Tools |
| Approval-gated | Revoke sign-in sessions; reset a password; disable an account; re-enable an account; add a group member; remove a group member |
| Read-only | List users; look up a user; list a user's groups and roles; list groups; read a group; list group members; list directory roles; list sign-ins; list directory audit events; list devices |
The extension does not delete users or groups.
Skills
The extension ships five skills that guide an agent through common Entra ID tasks:
| Skill | Use it to |
| Investigate & Lock Down a Compromised Account | Review a suspect account's groups and sign-ins, then revoke its sessions, reset its password, disable it, and remove it from privileged groups. The remediation steps are approval-gated. |
| Manage Users | Find a user and read their details, reset a password, or disable or re-enable an account. Changes are approval-gated. |
| Manage Group Membership | Review a group's members or a user's groups, and add or remove a user. Adding and removing are approval-gated. |
| Review Sign-In Activity | Investigate a user's recent or failed sign-ins and the directory change history. Read-only. |
| Inventory Devices | List the devices registered or joined to the directory, filtered by name or operating system, and the directory roles in use. Read-only. |
To give an agent these skills, see Creating custom agents and using them in workflows.
Tips for Working With Entra ID Data
- You can refer to a user by UPN, for example
jane@contoso.com. The agent resolves the user's id before any change and never acts on an id it has not looked up. - List tools return the complete result in one call, so you do not page through results. Ask for a filter, such as accounts that are disabled or names that start with a given value, to keep large directories focused.
- A password reset sets a temporary password and forces the user to change it at next sign-in
- The group-membership list shows only groups and roles the user belongs to directly
- If listing sign-ins fails while other reads work, check that the app has
AuditLog.Read.Alland that the tenant has an Entra ID P1 or P2 license - Once the secrets are in place, ask the AI Playground to look up a user to confirm the connection works
If you are still having trouble, we’re here to help! Submit a ticket here for assistance, and don’t forget to check our status page to ensure there are no outages in your area.
Comments
0 comments
Please sign in to leave a comment.