OAuth 2.0-Based Permissions for the Cloud Administration APIs
5 months ago

OAuth 2.0-Based Permissions for the Cloud Administration APIs

The Cloud Access Service (CAS) APIs now support OAuth 2.0, providing secure, token-based access to the Cloud Administration and Authentication APIs. OAuth 2.0 is an authorization framework that enables third-party applications to securely obtain limited access to services. OAuth helps protect these APIs, with each one requiring specific permissions for access. For information about OAuth clients and how to add an API client for Cloud Administration and Authentication APIs, see Manage OAuth API Clients.

Note:  Your license may limit which permissions you can access. All ID Plus licenses include access to the APIs and permissions listed under the " Audit" group. To access the full set of permissions, you need to have the "Allow Admin API Key" license and any required add-ons, such as RSA Risk AI. For more information, please contact RSA Customer Support.

The following tables outline the OAuth2-based RSA API permissions for the Cloud Administration and Authentication APIs, respectively.

 

Cloud Administration API Permissions

GroupAPI NamePermissionPermission Description
AgentMFA Agent Lookup REST APIrsa.agent.read Retrieve Agent details
rsa.agent.certAgent Certificate Provisioning
AuditCloud Administration Event Log API rsa.audit.admin Retrieve admin event logs from the Cloud Access Service (CAS) (audit microservice)
Cloud Administration Retrieve Authentication Audit Logs API rsa.audit.user Retrieve RSA authentication audit logs
Cloud Administration User Event Log APIrsa.audit.user Retrieve RSA authentication audit and user event logs
AuthenticatorCloud Administration Delete User Device API rsa.authenticator.mobile.delete Delete a device for individual users
Cloud Administration Authenticator Details API Version 1rsa.authenticator.mobile.read Retrieve device details for individual users
Cloud Administration Authenticator Details API Version 2rsa.authenticator.mobile.read Retrieve RSA user event logs
Cloud Administration Retrieve Device Registration Code API rsa.authenticator.mobile.manage Generate a code for users to register their iOS, Android, and Windows devices
Cloud Administration Delete User Device API rsa.authenticator.device.delete Delete devices for individual users
Cloud Administration Enable Emergency Tokencode API Version 1rsa.authenticator.emergency.manage Enable/disable Emergency Token code for a user
Cloud Administration Disable Emergency Tokencode APIrsa.authenticator.emergency.manage Enable/disable Emergency Token code for a user
Cloud Administration FIDO Authenticator APIrsa.authenticator.fido.read Retrieve FIDO authenticator(s) assigned to a user
 rsa.authenticator.fido.delete Delete FIDO authenticator assigned to a user
Cloud Administration Enable FIDO Authenticator APIrsa.authenticator.fido.manage Update, enroll, enable, and disable FIDO authenticators
Cloud Administration Disable FIDO Authenticator APIrsa.authenticator.fido.manage Update, enroll, enable, and disable FIDO authenticators
Cloud Administration Retrieve Hardware Token Details APIrsa.authenticator.sidtoken.read Retrieve a hardware token's details
Cloud Administration Assign Hardware Token APIrsa.authenticator.sidtoken.manage Update, enable, disable, assign, unassign, and clear pin for a hardware token
Cloud Administration Unassign Hardware Token APIrsa.authenticator.sidtoken.manage Update, enable, disable, assign, unassign, and clear pin for a hardware token
Cloud Administration Enable Hardware Token APIrsa.authenticator.sidtoken.manage Update, enable, disable, assign, unassign, and clear pin for a hardware token
Cloud Administration Disable Hardware Token APIrsa.authenticator.sidtoken.manage Update, enable, disable, assign, unassign, and clear pin for a hardware token
Cloud Administration Delete Hardware Token APIrsa.authenticator.sidtoken.delete Delete a hardware token from CAS
Cloud Administration Clear PIN for Hardware Token APIrsa.authenticator.sidtoken.manage Update, enable, disable, assign, unassign, and clear pin for a hardware token
Cloud Administration Update Hardware Token Name APIrsa.authenticator.sidtoken.manage Update, enable, disable, assign, unassign, and clear pin for a hardware token
Cloud Administration Enable SecurID DS100 OTP Credential APIrsa.authenticator.ds100.manage Enable, disable, and clear pin for a SecurID DS100 OTP
Cloud Administration Disable SecurID DS100 OTP Credential APIrsa.authenticator.ds100.manage Enable, disable, and clear pin for a SecurID DS100 OTP
Cloud Administration Delete SecurID DS100 OTP Credential APIrsa.authenticator.ds100.delete Delete user's SecurID DS100 OTP credential
Cloud Administration Clear PIN RSA DS100 OTP Credential APIrsa.authenticator.ds100.manage Enable, disable, and clear pin for an RSA DS100 OTP
Cloud Administration Retrieve RSA DS100 OTP Credential APIrsa.authenticator.ds100.read Retrieve user's RSA DS100 OTP credential
Local GroupCloud Administration Local Groups Public APIrsa.group.manageLocal group management actions (create, update, delete)
 Managing Local Group Users with the Cloud Administration Local Groups Public APIrsa.group.read

Retrieve local group(s) details
rsa.group.users.manage
Local group membership actions (add/remove users)
rsa.group.users.readRetrieve local group user details
Report Cloud Administration Health Check API   rsa.report.health Retrieve report on CAS availability
Cloud Administration Retrieve License Usage API Version 1rsa.report.license.usage Retrieve MFA license usage to monitor license compliance
Cloud Administration Retrieve License Usage API Version 2rsa.report.license.usage Retrieve MFA license usage to monitor license compliance
Cloud Administration Generate and Download Report APIsrsa.report.read Generate and download users, hardware tokens, and MFA clients report
Cloud Administration Anomalous Users APIrsa.report.user.risky Retrieve a list of users who exhibit anomalous behavior
UserCloud Administration User Search API Version 1rsa.user.read Retrieve user information from the identity source
Cloud Administration Synchronize User APIrsa.user.syncUser synchronization to user identity
Cloud Administration User Details API rsa.user.read Retrieve user information from the identity source
Cloud Administration Mark User Deleted API rsa.user.delete.soft Mark a disabled user as pending deletion
Cloud Administration Delete User Now API rsa.user.delete Delete a single disabled user and immediately remove all devices associated with that user
Cloud Administration User Status APIrsa.user.manage Update, sync, enable, and disable users
Cloud Administration Unlock User Tokencodes APIrsa.user.factor.manage Unlock, update, reset, and generate codes for users' authentication factors
Cloud Administration Update SMS and Voice Phone APIrsa.user.factor.manage Unlock, update, reset, and generate codes for users' authentication factors
Cloud Administration Add/Remove High-Risk User APIrsa.user.risky.manage Add or remove one or more users from the high-risk user lis
Cloud Administration Retrieve High-Risk User List API Version 1rsa.user.risky.read Retrieve a list of users who are identified as high risk
Cloud Administration Retrieve High-Risk User List API Version 2rsa.user.risky.read Retrieve a list of users who are identified as high risk
Cloud Administration Generate Enrollment Code APIrsa.user.factor.manage Unlock, update, reset, and generate codes for users' authentication factors
Cloud Administration Void Enrollment Code APIrsa.user.factor.manage Unlock, update, reset, and generate codes for users' authentication factors
Cloud Administration Password Reset Code APIrsa.user.factor.manage Unlock, update, reset, and generate codes for users' authentication factors
Cloud Administration Void Password Reset Code APIrsa.user.factor.manage Unlock, update, reset, and generate codes for users' authentication factors

 

Cloud Authentication API Permissions

GroupPermissionPermission Description

MFA

rsa.mfa.authnFor multi-factor, multi-step authentications with CAS
rsa.mfa.identityconfidenceView and update the identity confidence score of a user