Agent ID Roles and Scopes
Roles and scopes controls access to applications, tools, and actions by assigning permissions to a role and mapping that role to identity-provider groups. An identity-provider group maps to a role, and each role maps to one or more backend scopes; at call time, the gateway filters which tools an agent can see and invoke based on the backend scope assigned to the tool and the caller's identity-provider group membership.
When creating a role, you pick an app, then grant access at whichever level makes sense:
| Level | What It Grants |
|---|---|
| Scope | A group of related access controls, such as Read, Write, or Admin. |
| Individual tool | One specific action, for when a whole scope would grant too much. |
Two things are worth knowing about how this works:
- Access controls that are not granted are invisible: Users see and can use only the access controls granted to the groups they belong to. Anything else does not appear at all.
- Agents have no access of their own: An agent acting for a user gets exactly that user's access, nothing more.
Note: A role can grant scopes across more than one linked resource (MCP server) at once — for example, read-only access to one resource and read/write access to another.
The Roles and scopes page lists the existing roles and the associated details.
Use the Actions menu at the end of a role's row to Edit role, Duplicate role, or Delete role.
Procedure
- On the Roles and scopes page, click New role.
- Type a Name.
- Under Gateway, select a gateway this role applies to.
- Under IdP groups, search for and select the identity-provider groups that should get access.
- On the Configure tab, select the resource, then select the access controls for the role.
- Click Create role.
Results
Members of the mapped IdP group can now call only the access controls assigned to this role, once the change is published from Gateways > View publishing > Publish all pending (For more information, see Publishing Configuration Changes).
Related Articles
RSA Agent ID Release Notes 2Number of Views RSA Agent ID Installation, Deployment, and Administration Guide 5Number of Views RSA Agent ID November 2026 Release Announcement 1Number of Views Agent ID Administration 1Number of Views Agent ID Components 1Number of Views