All Products
Search
Document Center

CloudSSO:RAM authorization

Last Updated:Aug 01, 2024
Resource Access Management (RAM) is a service provided by Alibaba Cloud to manage user identities and resource access permissions. You can use RAM to prevent RAM users from sharing the AccessKey pairs of your Alibaba Cloud account. You can also use RAM to grant minimum permissions to RAM users. RAM uses policies to define permissions.
This topic describes the elements, such as Action, Resource, and Condition, which are defined by CloudSSO. You can use the elements to create policies in RAM. The code (RamCode) in RAM that is used to indicate CloudSSO is cloudsso. You can grant permissions on CloudSSO at the RESOURCE.

General structure of a policy

Policies can be stored as JSON files. The following code provides an example on the general structure of a policy:
{
  "Version": "1",
  "Statement": [
    {
      "Effect": "<Effect>",
      "Action": "<Action>",
      "Resource": "<Resource>",
      "Condition": {
        "<Condition_operator>": {
          "<Condition_key>": [
            "<Condition_value>"
          ]
        }
      }
    }
  ]
}
The following list describes the fields in the policy:
  • Effect: specifies the authorization effect. Valid values: Allow, Deny.
  • Action: specifies one or more API operations that are allowed or denied. For more information, see the Action section of this topic.
  • Resource: specifies one or more resources to which the policy applies. You can use an Alibaba Cloud Resource Name (ARN) to specify a resource. For more information, see the Resource section of this topic.
  • Condition: specifies one or more conditions that are required for the policy to take effect. This is an optional field. For more information, see the Condition section of this topic.
    • Condition_operator: specifies the conditional operators. Different types of conditions support different conditional operators. For more information, see Policy elements.
    • Condition_key: specifies the condition keys.
    • Condition_value: specifies the condition values.

Action

CloudSSO defines the values that you can use in the Action element of a policy statement. The following table describes the values.
  • Operation: the value that you can use in the Action element to specify the operation on a resource.
  • API operation: the API operation that you can call to perform the operation.
  • Access level: the access level of each operation. The levels are read, write, and list.
  • Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
    • The required resource types are displayed in bold characters.
    • If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
  • Condition key: the condition keys that are defined by the Alibaba Cloud service. The Condition key column does not list the common condition keys that are defined by Alibaba Cloud. For more information about the common condition keys, see Generic Condition Keyword.
  • Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.
ActionsAPI operationAccess levelResource typeCondition keyAssociated operation
cloudsso:GetUserProvisioningStatisticsGetUserProvisioningStatisticsget
UserProvisioning
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user-provisioning/{#UserProvisioningId}
NoneNone
cloudsso:GetMFAAuthenticationSettingInfoGetMFAAuthenticationSettingInfoget
Directory
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}
NoneNone
cloudsso:GetAccessConfigurationGetAccessConfigurationget
AccessConfiguration
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/access-configuration/{#AccessConfigurationId}
NoneNone
cloudsso:ProvisionAccessConfigurationProvisionAccessConfigurationupdate
AccessConfiguration
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/access-configuration/{#AccessConfigurationId}
NoneNone
cloudsso:SetExternalSAMLIdentityProviderSetExternalSAMLIdentityProviderupdate
Directory
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}
NoneNone
cloudsso:RemoveUserFromGroupRemoveUserFromGroupWrite
Group
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/group/{#GroupId}
User
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user/{#UserId}
NoneNone
cloudsso:ListGroupMembersListGroupMembersget
Group
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/group/{#GroupId}
NoneNone
cloudsso:CreateAccessAssignmentCreateAccessAssignmentcreate
AccessConfiguration
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/access-configuration/{#AccessConfigurationId}
User
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user/{#UserId}
Group
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/group/{#GroupId}
Account
acs:resourcemanager::{#accountId}:account/{#AccountId}
NoneNone
cloudsso:GetUserProvisioningEventGetUserProvisioningEventget
UserProvisioning
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user-provisioning/{#UserProvisioningId}
UserProvisioning
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user-provisioning/*
NoneNone
cloudsso:ListUsersListUsersget
User
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user/*
NoneNone
cloudsso:ListExternalSAMLIdPCertificatesListExternalSAMLIdPCertificatesget
Directory
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}
NoneNone
cloudsso:ListAccessAssignmentsListAccessAssignmentsget
All Resources
*
NoneNone
cloudsso:CreateUserProvisioningCreateUserProvisioningWrite
UserProvisioning
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user-provisioning/*
Account
acs:resourcemanager::{#accountId}:account/{#AccountId}
Group
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/group/{#GroupId}
User
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user/{#UserId}
NoneNone
cloudsso:GetLoginPreferenceGetLoginPreferenceget
Directory
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}
NoneNone
cloudsso:GetTaskGetTaskget
Directory
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}
NoneNone
cloudsso:RemoveExternalSAMLIdPCertificateRemoveExternalSAMLIdPCertificateupdate
Directory
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}
NoneNone
cloudsso:DeleteUserDeleteUserdelete
User
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user/{#UserId}
NoneNone
cloudsso:UpdateDirectoryUpdateDirectoryupdate
Directory
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}
NoneNone
cloudsso:UpdateUserProvisioningUpdateUserProvisioningWrite
UserProvisioning
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user-provisioning/{#UserProvisioningId}
NoneNone
cloudsso:RetryUserProvisioningEventRetryUserProvisioningEventWrite
UserProvisioning
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user-provisioning/{#UserProvisioningId}
UserProvisioning
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user-provisioning/*
NoneNone
cloudsso:EnableServiceEnableServiceupdate
All Resources
*
NoneNone
cloudsso:GetDirectorySAMLServiceProviderInfoGetDirectorySAMLServiceProviderInfoget
Directory
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}
NoneNone
cloudsso:UpdateInlinePolicyForAccessConfigurationUpdateInlinePolicyForAccessConfigurationupdate
AccessConfiguration
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/access-configuration/{#AccessConfigurationId}
NoneNone
cloudsso:GetDirectoryStatisticsGetDirectoryStatisticsget
Directory
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}
NoneNone
cloudsso:GetUserMFAAuthenticationSettingsGetUserMFAAuthenticationSettingsget
User
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user/{#UserId}
NoneNone
cloudsso:RemovePermissionPolicyFromAccessConfigurationRemovePermissionPolicyFromAccessConfigurationupdate
AccessConfiguration
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/access-configuration/{#AccessConfigurationId}
NoneNone
cloudsso:AddUserToGroupAddUserToGroupcreate
User
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user/{#UserId}
Group
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/group/{#GroupId}
NoneNone
cloudsso:GetServiceStatusGetServiceStatusget
All Resources
*
NoneNone
cloudsso:SetPasswordPolicySetPasswordPolicyupdate
Directory
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}
NoneNone
cloudsso:ListSCIMServerCredentialsListSCIMServerCredentialsget
SCIMServerCredential
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/scim-credential/*
NoneNone
cloudsso:SetMFAAuthenticationStatusSetMFAAuthenticationStatusupdate
Directory
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}
NoneNone
cloudsso:CreateSCIMServerCredentialCreateSCIMServerCredentialcreate
SCIMServerCredential
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/scim-credential/*
NoneNone
cloudsso:ListJoinedGroupsForUserListJoinedGroupsForUserget
User
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user/{#UserId}
NoneNone
cloudsso:CreateUserCreateUsercreate
User
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user/*
NoneNone
cloudsso:SetLoginPreferenceSetLoginPreferenceupdate
Directory
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}
NoneNone
cloudsso:ListAccessConfigurationProvisioningsListAccessConfigurationProvisioningsget
AccessConfiguration
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/access-configuration/{#AccessConfigurationId}
AccessConfiguration
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/access-configuration/*
NoneNone
cloudsso:SetSCIMSynchronizationStatusSetSCIMSynchronizationStatusupdate
Directory
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}
NoneNone
cloudsso:GetUserProvisioningConfigurationGetUserProvisioningConfigurationget
Directory
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}
NoneNone
cloudsso:GetUserProvisioningRdAccountStatisticsGetUserProvisioningRdAccountStatisticsget
Account
acs:resourcemanager::{#accountId}:account/{#AccountId}
NoneNone
cloudsso:GetSCIMSynchronizationStatusGetSCIMSynchronizationStatusget
Directory
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}
NoneNone
cloudsso:DeleteAccessAssignmentDeleteAccessAssignmentdelete
AccessConfiguration
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/access-configuration/{#AccessConfigurationId}
User
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user/{#UserId}
Group
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/group/{#GroupId}
Account
acs:resourcemanager::{#accountId}:account/{#AccountId}
NoneNone
cloudsso:UpdateMFAAuthenticationSettingsUpdateMFAAuthenticationSettingsupdate
Directory
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}
NoneNone
cloudsso:ResetUserPasswordResetUserPasswordupdate
User
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user/{#UserId}
NoneNone
cloudsso:DeleteSCIMServerCredentialDeleteSCIMServerCredentialdelete
SCIMServerCredential
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/scim-credential/{#CredentialId}
NoneNone
cloudsso:ListUserProvisioningEventsListUserProvisioningEventsget
UserProvisioning
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user-provisioning/{#UserProvisioningId}
UserProvisioning
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user-provisioning/*
NoneNone
cloudsso:GetPasswordPolicyGetPasswordPolicyget
Directory
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}
NoneNone
cloudsso:DeleteGroupDeleteGroupdelete
Group
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/group/{#GroupId}
NoneNone
cloudsso:CreateDirectoryCreateDirectorycreate
Directory
acs:cloudsso:{#regionId}:{#accountId}:directory/*
NoneNone
cloudsso:GetDirectoryGetDirectoryget
Directory
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}
NoneNone
cloudsso:UpdateUserStatusUpdateUserStatusupdate
User
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user/{#UserId}
NoneNone
cloudsso:ListGroupsListGroupsget
Group
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/group/*
NoneNone
cloudsso:AddPermissionPolicyToAccessConfigurationAddPermissionPolicyToAccessConfigurationcreate
AccessConfiguration
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/access-configuration/{#AccessConfigurationId}
NoneNone
cloudsso:UpdateSCIMServerCredentialStatusUpdateSCIMServerCredentialStatusupdate
SCIMServerCredential
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/scim-credential/{#CredentialId}
NoneNone
cloudsso:GetUserProvisioningGetUserProvisioningget
UserProvisioning
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user-provisioning/{#UserProvisioningId}
NoneNone
cloudsso:CreateGroupCreateGroupcreate
Group
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/group/*
NoneNone
cloudsso:ClearExternalSAMLIdentityProviderClearExternalSAMLIdentityProviderupdate
Directory
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}
NoneNone
cloudsso:ListPermissionPoliciesInAccessConfigurationListPermissionPoliciesInAccessConfigurationget
AccessConfiguration
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/access-configuration/{#AccessConfigurationId}
NoneNone
cloudsso:GetGroupGetGroupget
Group
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/group/{#GroupId}
NoneNone
cloudsso:UpdateGroupUpdateGroupupdate
Group
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/group/{#GroupId}
NoneNone
cloudsso:GetMFAAuthenticationStatusGetMFAAuthenticationStatusget
Directory
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}
NoneNone
cloudsso:GetExternalSAMLIdentityProviderGetExternalSAMLIdentityProviderget
Directory
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}
NoneNone
cloudsso:DeleteDirectoryDeleteDirectorydelete
Directory
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}
NoneNone
cloudsso:ListMFADevicesForUserListMFADevicesForUserget
User
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user/{#UserId}
NoneNone
cloudsso:GetUserGetUserget
User
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user/{#UserId}
NoneNone
cloudsso:AddExternalSAMLIdPCertificateAddExternalSAMLIdPCertificatecreate
Directory
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}
NoneNone
cloudsso:UpdateUserMFAAuthenticationSettingsUpdateUserMFAAuthenticationSettingsupdate
User
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user/{#UserId}
NoneNone
cloudsso:UpdateUserUpdateUserupdate
User
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user/{#UserId}
NoneNone
cloudsso:DeleteMFADeviceForUserDeleteMFADeviceForUserdelete
User
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user/{#UserId}
NoneNone
cloudsso:ListTasksListTasksget
Directory
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}
NoneNone
cloudsso:UpdateAccessConfigurationUpdateAccessConfigurationupdate
AccessConfiguration
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/access-configuration/{#AccessConfigurationId}
NoneNone
cloudsso:UpdateUserProvisioningConfigurationUpdateUserProvisioningConfigurationWrite
Directory
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}
NoneNone
cloudsso:DisableServiceDisableServiceupdate
All Resources
*
NoneNone
cloudsso:DeleteUserProvisioningDeleteUserProvisioningWrite
UserProvisioning
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user-provisioning/{#UserProvisioningId}
NoneNone
cloudsso:ListUserProvisioningsListUserProvisioningslist
All Resources
*
NoneNone
cloudsso:GetUserIdGetUserIdget
User
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user/*
NoneNone
cloudsso:GetTaskStatusGetTaskStatusget
Directory
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}
NoneNone
cloudsso:ListDirectoriesListDirectoriesget
Directory
acs:cloudsso:{#regionId}:{#accountId}:directory/*
NoneNone
cloudsso:DeleteAccessConfigurationDeleteAccessConfigurationdelete
AccessConfiguration
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/access-configuration/{#AccessConfigurationId}
NoneNone
cloudsso:GetMFAAuthenticationSettingsGetMFAAuthenticationSettingsget
Directory
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}
NoneNone
cloudsso:DeleteUserProvisioningEventDeleteUserProvisioningEventWrite
UserProvisioning
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user-provisioning/{#UserProvisioningId}
UserProvisioning
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user-provisioning/*
NoneNone
cloudsso:CreateAccessConfigurationCreateAccessConfigurationcreate
AccessConfiguration
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/access-configuration/*
NoneNone
cloudsso:DeprovisionAccessConfigurationDeprovisionAccessConfigurationupdate
AccessConfiguration
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/access-configuration/{#AccessConfigurationId}
NoneNone
cloudsso:ListAccessConfigurationsListAccessConfigurationsget
AccessConfiguration
acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/access-configuration/*
NoneNone

Resource

CloudSSO defines the values that you can use in the Resource. You can attach the policy to a RAM user or a RAM role so that the RAM user or the RAM role can perform a specific operation on a specific resource. The ARN is the unique identifier of the resource on Alibaba Cloud. Take note of the following items:
  • {#}indicates a variable. {#} must be replaced with an actual value. For example, {#ramcode} must be replaced with the actual code of an Alibaba Cloud service in RAM.
  • An asterisk (*) is used as a wildcard. Examples:
    • {#resourceType} is set to *, all resources are specified.
    • {#regionId} is set to *, all regions are specified.
    • {#accountId} is set to *, all Alibaba Cloud accounts are specified.
Resource typeARN
UserProvisioningacs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user-provisioning/{#UserProvisioningId}
Directoryacs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}
AccessConfigurationacs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/access-configuration/{#AccessConfigurationId}
Groupacs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/group/{#GroupId}
Useracs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user/{#UserId}
Accountacs:resourcemanager::{#accountId}:account/{#AccountId}
UserProvisioningacs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user-provisioning/*
Useracs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user/*
AccessConfigurationacs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/access-configuration/*
Accountacs:resourcemanager::{#accountId}:account/*
Groupacs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/group/*
SCIMServerCredentialacs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/scim-credential/*
SCIMServerCredentialacs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/scim-credential/{#CredentialId}
Directoryacs:cloudsso:{#regionId}:{#accountId}:directory/*

Condition

CloudSSO does not define service-specific condition keys. For more information about common condition keys that are defined by Alibaba Cloud, see Generic Condition Keyword.

What to do next

You can create a custom policy and attach the policy to a RAM user, RAM user group, or RAM role. For more information, see the following topics: