RAM authorization - CloudSSO - Alibaba Cloud Documentation Center

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.

Actions	API operation	Access level	Resource type	Condition key	Associated operation
cloudsso:GetUserProvisioningStatistics	GetUserProvisioningStatistics	get	UserProvisioning acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user-provisioning/{#UserProvisioningId}	None	None
cloudsso:GetMFAAuthenticationSettingInfo	GetMFAAuthenticationSettingInfo	get	Directory acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}	None	None
cloudsso:GetAccessConfiguration	GetAccessConfiguration	get	AccessConfiguration acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/access-configuration/{#AccessConfigurationId}	None	None
cloudsso:ProvisionAccessConfiguration	ProvisionAccessConfiguration	update	AccessConfiguration acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/access-configuration/{#AccessConfigurationId}	None	None
cloudsso:SetExternalSAMLIdentityProvider	SetExternalSAMLIdentityProvider	update	Directory acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}	None	None
cloudsso:RemoveUserFromGroup	RemoveUserFromGroup	Write	Group acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/group/{#GroupId} User acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user/{#UserId}	None	None
cloudsso:ListGroupMembers	ListGroupMembers	get	Group acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/group/{#GroupId}	None	None
cloudsso:CreateAccessAssignment	CreateAccessAssignment	create	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}	None	None
cloudsso:GetUserProvisioningEvent	GetUserProvisioningEvent	get	UserProvisioning acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user-provisioning/{#UserProvisioningId} UserProvisioning acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user-provisioning/*	None	None
cloudsso:ListUsers	ListUsers	get	User acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user/*	None	None
cloudsso:ListExternalSAMLIdPCertificates	ListExternalSAMLIdPCertificates	get	Directory acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}	None	None
cloudsso:ListAccessAssignments	ListAccessAssignments	get	All Resources *	None	None
cloudsso:CreateUserProvisioning	CreateUserProvisioning	Write	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}	None	None
cloudsso:GetLoginPreference	GetLoginPreference	get	Directory acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}	None	None
cloudsso:GetTask	GetTask	get	Directory acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}	None	None
cloudsso:RemoveExternalSAMLIdPCertificate	RemoveExternalSAMLIdPCertificate	update	Directory acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}	None	None
cloudsso:DeleteUser	DeleteUser	delete	User acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user/{#UserId}	None	None
cloudsso:UpdateDirectory	UpdateDirectory	update	Directory acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}	None	None
cloudsso:UpdateUserProvisioning	UpdateUserProvisioning	Write	UserProvisioning acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user-provisioning/{#UserProvisioningId}	None	None
cloudsso:RetryUserProvisioningEvent	RetryUserProvisioningEvent	Write	UserProvisioning acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user-provisioning/{#UserProvisioningId} UserProvisioning acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user-provisioning/*	None	None
cloudsso:EnableService	EnableService	update	All Resources *	None	None
cloudsso:GetDirectorySAMLServiceProviderInfo	GetDirectorySAMLServiceProviderInfo	get	Directory acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}	None	None
cloudsso:UpdateInlinePolicyForAccessConfiguration	UpdateInlinePolicyForAccessConfiguration	update	AccessConfiguration acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/access-configuration/{#AccessConfigurationId}	None	None
cloudsso:GetDirectoryStatistics	GetDirectoryStatistics	get	Directory acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}	None	None
cloudsso:GetUserMFAAuthenticationSettings	GetUserMFAAuthenticationSettings	get	User acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user/{#UserId}	None	None
cloudsso:RemovePermissionPolicyFromAccessConfiguration	RemovePermissionPolicyFromAccessConfiguration	update	AccessConfiguration acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/access-configuration/{#AccessConfigurationId}	None	None
cloudsso:AddUserToGroup	AddUserToGroup	create	User acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user/{#UserId} Group acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/group/{#GroupId}	None	None
cloudsso:GetServiceStatus	GetServiceStatus	get	All Resources *	None	None
cloudsso:SetPasswordPolicy	SetPasswordPolicy	update	Directory acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}	None	None
cloudsso:ListSCIMServerCredentials	ListSCIMServerCredentials	get	SCIMServerCredential acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/scim-credential/*	None	None
cloudsso:SetMFAAuthenticationStatus	SetMFAAuthenticationStatus	update	Directory acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}	None	None
cloudsso:CreateSCIMServerCredential	CreateSCIMServerCredential	create	SCIMServerCredential acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/scim-credential/*	None	None
cloudsso:ListJoinedGroupsForUser	ListJoinedGroupsForUser	get	User acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user/{#UserId}	None	None
cloudsso:CreateUser	CreateUser	create	User acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user/*	None	None
cloudsso:SetLoginPreference	SetLoginPreference	update	Directory acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}	None	None
cloudsso:ListAccessConfigurationProvisionings	ListAccessConfigurationProvisionings	get	AccessConfiguration acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/access-configuration/{#AccessConfigurationId} AccessConfiguration acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/access-configuration/*	None	None
cloudsso:SetSCIMSynchronizationStatus	SetSCIMSynchronizationStatus	update	Directory acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}	None	None
cloudsso:GetUserProvisioningConfiguration	GetUserProvisioningConfiguration	get	Directory acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}	None	None
cloudsso:GetUserProvisioningRdAccountStatistics	GetUserProvisioningRdAccountStatistics	get	Account acs:resourcemanager::{#accountId}:account/{#AccountId}	None	None
cloudsso:GetSCIMSynchronizationStatus	GetSCIMSynchronizationStatus	get	Directory acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}	None	None
cloudsso:DeleteAccessAssignment	DeleteAccessAssignment	delete	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}	None	None
cloudsso:UpdateMFAAuthenticationSettings	UpdateMFAAuthenticationSettings	update	Directory acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}	None	None
cloudsso:ResetUserPassword	ResetUserPassword	update	User acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user/{#UserId}	None	None
cloudsso:DeleteSCIMServerCredential	DeleteSCIMServerCredential	delete	SCIMServerCredential acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/scim-credential/{#CredentialId}	None	None
cloudsso:ListUserProvisioningEvents	ListUserProvisioningEvents	get	UserProvisioning acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user-provisioning/{#UserProvisioningId} UserProvisioning acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user-provisioning/*	None	None
cloudsso:GetPasswordPolicy	GetPasswordPolicy	get	Directory acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}	None	None
cloudsso:DeleteGroup	DeleteGroup	delete	Group acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/group/{#GroupId}	None	None
cloudsso:CreateDirectory	CreateDirectory	create	Directory acs:cloudsso:{#regionId}:{#accountId}:directory/*	None	None
cloudsso:GetDirectory	GetDirectory	get	Directory acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}	None	None
cloudsso:UpdateUserStatus	UpdateUserStatus	update	User acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user/{#UserId}	None	None
cloudsso:ListGroups	ListGroups	get	Group acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/group/*	None	None
cloudsso:AddPermissionPolicyToAccessConfiguration	AddPermissionPolicyToAccessConfiguration	create	AccessConfiguration acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/access-configuration/{#AccessConfigurationId}	None	None
cloudsso:UpdateSCIMServerCredentialStatus	UpdateSCIMServerCredentialStatus	update	SCIMServerCredential acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/scim-credential/{#CredentialId}	None	None
cloudsso:GetUserProvisioning	GetUserProvisioning	get	UserProvisioning acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user-provisioning/{#UserProvisioningId}	None	None
cloudsso:CreateGroup	CreateGroup	create	Group acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/group/*	None	None
cloudsso:ClearExternalSAMLIdentityProvider	ClearExternalSAMLIdentityProvider	update	Directory acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}	None	None
cloudsso:ListPermissionPoliciesInAccessConfiguration	ListPermissionPoliciesInAccessConfiguration	get	AccessConfiguration acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/access-configuration/{#AccessConfigurationId}	None	None
cloudsso:GetGroup	GetGroup	get	Group acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/group/{#GroupId}	None	None
cloudsso:UpdateGroup	UpdateGroup	update	Group acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/group/{#GroupId}	None	None
cloudsso:GetMFAAuthenticationStatus	GetMFAAuthenticationStatus	get	Directory acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}	None	None
cloudsso:GetExternalSAMLIdentityProvider	GetExternalSAMLIdentityProvider	get	Directory acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}	None	None
cloudsso:DeleteDirectory	DeleteDirectory	delete	Directory acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}	None	None
cloudsso:ListMFADevicesForUser	ListMFADevicesForUser	get	User acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user/{#UserId}	None	None
cloudsso:GetUser	GetUser	get	User acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user/{#UserId}	None	None
cloudsso:AddExternalSAMLIdPCertificate	AddExternalSAMLIdPCertificate	create	Directory acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}	None	None
cloudsso:UpdateUserMFAAuthenticationSettings	UpdateUserMFAAuthenticationSettings	update	User acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user/{#UserId}	None	None
cloudsso:UpdateUser	UpdateUser	update	User acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user/{#UserId}	None	None
cloudsso:DeleteMFADeviceForUser	DeleteMFADeviceForUser	delete	User acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user/{#UserId}	None	None
cloudsso:ListTasks	ListTasks	get	Directory acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}	None	None
cloudsso:UpdateAccessConfiguration	UpdateAccessConfiguration	update	AccessConfiguration acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/access-configuration/{#AccessConfigurationId}	None	None
cloudsso:UpdateUserProvisioningConfiguration	UpdateUserProvisioningConfiguration	Write	Directory acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}	None	None
cloudsso:DisableService	DisableService	update	All Resources *	None	None
cloudsso:DeleteUserProvisioning	DeleteUserProvisioning	Write	UserProvisioning acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user-provisioning/{#UserProvisioningId}	None	None
cloudsso:ListUserProvisionings	ListUserProvisionings	list	All Resources *	None	None
cloudsso:GetUserId	GetUserId	get	User acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user/*	None	None
cloudsso:GetTaskStatus	GetTaskStatus	get	Directory acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}	None	None
cloudsso:ListDirectories	ListDirectories	get	Directory acs:cloudsso:{#regionId}:{#accountId}:directory/*	None	None
cloudsso:DeleteAccessConfiguration	DeleteAccessConfiguration	delete	AccessConfiguration acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/access-configuration/{#AccessConfigurationId}	None	None
cloudsso:GetMFAAuthenticationSettings	GetMFAAuthenticationSettings	get	Directory acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}	None	None
cloudsso:DeleteUserProvisioningEvent	DeleteUserProvisioningEvent	Write	UserProvisioning acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user-provisioning/{#UserProvisioningId} UserProvisioning acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user-provisioning/*	None	None
cloudsso:CreateAccessConfiguration	CreateAccessConfiguration	create	AccessConfiguration acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/access-configuration/*	None	None
cloudsso:DeprovisionAccessConfiguration	DeprovisionAccessConfiguration	update	AccessConfiguration acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/access-configuration/{#AccessConfigurationId}	None	None
cloudsso:ListAccessConfigurations	ListAccessConfigurations	get	AccessConfiguration acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/access-configuration/*	None	None

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 type	ARN
UserProvisioning	acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user-provisioning/{#UserProvisioningId}
Directory	acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}
AccessConfiguration	acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/access-configuration/{#AccessConfigurationId}
Group	acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/group/{#GroupId}
User	acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user/{#UserId}
Account	acs:resourcemanager::{#accountId}:account/{#AccountId}
UserProvisioning	acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user-provisioning/*
User	acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/user/*
AccessConfiguration	acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/access-configuration/*
Account	acs:resourcemanager::{#accountId}:account/*
Group	acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/group/*
SCIMServerCredential	acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/scim-credential/*
SCIMServerCredential	acs:cloudsso:{#regionId}:{#accountId}:directory/{#DirectoryId}/scim-credential/{#CredentialId}
Directory	acs: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: