访问控制(RAM)是阿里云提供的管理用户身份与资源访问权限的服务。使用RAM可以让您避免与其他用户共享阿里云账号密钥,并可按需为用户授予最小权限。RAM中使用权限策略描述授权的具体内容。
本文为您介绍IMS为RAM权限策略定义的操作(Action)、资源(Resource)和条件(Condition)。IMS的RAM代码(RamCode)为ram,ims,支持的授权粒度为IMS RESOURCE。
权限策略通用结构
权限策略支持JSON格式,其通用结构如下:
{
"Version": "1",
"Statement": [
{
"Effect": "<Effect>",
"Action": "<Action>",
"Resource": "<Resource>",
"Condition": {
"<Condition_operator>": {
"<Condition_key>": [
"<Condition_value>"
]
}
}
}
]
}
- Effect:权限策略效果。取值:Allow(允许)、Deny(拒绝)。
- Action:授予允许或拒绝权限的具体操作。具体信息,请参见操作(Action)。
- Resource:受操作影响的具体对象,您可以使用资源ARN来描述指定资源。具体信息,请参见资源(Resource)。
- Condition:指授权生效的条件。可选字段。具体信息,请参见条件(Condition)。
- Condition_operator:条件运算符,不同类型的条件对应不同的条件运算符。具体信息,请参见权限策略基本元素。
- Condition_key:条件关键字。
- Condition_value:条件关键字对应的值。
操作(Action)
下表是IMS定义的操作,这些操作可以在RAM权限策略语句的Action
元素中使用,用来授予执行该操作的权限。下面对表中的具体项提供说明:- 操作:是指具体的权限点。
- API:是指操作对应的API接口。
- 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
- 资源类型:是指操作中支持授权的资源类型。具体说明如下:
- 对于必选的资源类型,用背景高亮的方式表示。
- 对于不支持资源级授权的操作,用
全部资源
表示。
- 条件关键字:是指云产品自身定义的条件关键字。该列不体现适用于任何操作的通用条件关键字。
- 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作 | API | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
---|---|---|---|---|---|
ram:CreateSAMLProvider | CreateSAMLProvider | create | 全部资源 * | 无 | 无 |
ram:GetLoginProfile | GetLoginProfile | get | User acs:ram::{#accountId}:user/{#UserName} | 无 | 无 |
ram:DeleteApplication | DeleteApplication | delete | Application acs:ram::{#accountId}:application/{#AppName} | 无 | 无 |
ram:CreateApplication | CreateApplication | create | 全部资源 * | 无 | 无 |
ram:DeleteLoginProfile | DeleteLoginProfile | Write | User acs:ram::{#accountId}:user/{#UserName} | 无 | 无 |
ram:GetUserMFAInfo | GetUserMFAInfo | get | User acs:ram::{#accountId}:user/{#UserName} | 无 | 无 |
ram:DeleteUser | DeleteUser | delete | User acs:ram::{#accountId}:user/{#UserName} | 无 | 无 |
ram:GetGroup | GetGroup | get | Group acs:ram::{#accountId}:group/{#GroupName} | 无 | 无 |
ram:DeleteAccessKey | DeleteAccessKey | Write | User acs:ram::{#accountId}:user/{#UserName} | 无 | 无 |
ram:ChangePassword | ChangePassword | update | 全部资源 * | 无 | 无 |
ram:GetSecurityPreference | GetSecurityPreference | get | 全部资源 * | 无 | 无 |
ram:UpdateOIDCProvider | UpdateOIDCProvider | update | OIDCProvider acs:ram::{#accountId}:oidc-provider/{#OIDCProviderName} | ram:OidcIssuerUrl | 无 |
ram:GetAccountSecurityPracticeReport | GetAccountSecurityPracticeReport | get | 全部资源 * | 无 | 无 |
ram:AddClientIdToOIDCProvider | AddClientIdToOIDCProvider | create | OIDCProvider acs:ram::{#accountId}:oidc-provider/{#OIDCProviderName} | ram:OidcIssuerUrl | 无 |
ram:UpdateApplication | UpdateApplication | update | Application acs:ram::{#accountId}:application/{#AppName} | 无 | 无 |
ram:RemoveFingerprintFromOIDCProvider | RemoveFingerprintFromOIDCProvider | delete | OIDCProvider acs:ram::{#accountId}:oidc-provider/{#OIDCProviderName} | ram:OidcIssuerUrl | 无 |
ram:SetDefaultDomain | SetDefaultDomain | update | 全部资源 * | 无 | 无 |
ram:AddUserToGroup | AddUserToGroup | create | Group acs:ram::{#accountId}:group/{#GroupName}User acs:ram::{#accountId}:user/{#UserName} | 无 | 无 |
ram:GetApplication | GetApplication | get | Application acs:ram::{#accountId}:application/{#AppName} | 无 | 无 |
ram:UpdateSAMLProvider | UpdateSAMLProvider | update | SAMLProvider acs:ram::{#accountId}:saml-provider/{#SAMLProviderName} | 无 | 无 |
ram:SetPasswordPolicy | SetPasswordPolicy | update | 全部资源 * | 无 | 无 |
ram:DeleteAppSecret | DeleteAppSecret | delete | Application acs:ram::{#accountId}:application/{#AppName} | 无 | 无 |
ram:GenerateCredentialReport | GenerateCredentialReport | get | 全部资源 * | 无 | 无 |
ram:GetPasswordPolicy | GetPasswordPolicy | get | 全部资源 * | 无 | 无 |
ram:GetDefaultDomain | GetDefaultDomain | get | 全部资源 * | 无 | 无 |
ram:DisableVirtualMFA | DisableVirtualMFA | delete | User acs:ram::{#accountId}:user/{#UserName} | 无 | 无 |
ram:UnbindMFADevice | UnbindMFADevice | update | User acs:ram::{#accountId}:user/{#UserName} | 无 | 无 |
ram:GetVerificationInfo | GetVerificationInfo | 全部资源 * | 无 | 无 | |
ram:GetCredentialReport | GetCredentialReport | get | 全部资源 * | 无 | 无 |
ram:CreateLoginProfile | CreateLoginProfile | Write | User acs:ram::{#accountId}:user/{#UserName} | 无 | 无 |
ram:ListApplications | ListApplications | get | 全部资源 * | 无 | 无 |
ram:CreateAccessKey | CreateAccessKey | Write | User acs:ram::{#accountId}:user/{#UserName} | 无 | 无 |
ram:GetAccessKeyLastUsed | GetAccessKeyLastUsed | get | User acs:ram::{#accountId}:user/{#UserName} | 无 | 无 |
ram:RemoveClientIdFromOIDCProvider | RemoveClientIdFromOIDCProvider | delete | OIDCProvider acs:ram::{#accountId}:oidc-provider/{#OIDCProviderName} | ram:OidcIssuerUrl | 无 |
ram:DeleteSAMLProvider | DeleteSAMLProvider | delete | SAMLProvider acs:ram::{#accountId}:saml-provider/{#SAMLProviderName} | 无 | 无 |
ram:ListSAMLProviders | ListSAMLProviders | get | 全部资源 * | 无 | 无 |
ram:SetUserSsoSettings | SetUserSsoSettings | update | 全部资源 * | 无 | 无 |
ram:ListGroups | ListGroups | get | Group acs:ram::{#accountId}:group/* | 无 | 无 |
ram:UpdateGroup | UpdateGroup | update | Group acs:ram::{#accountId}:group/{#GroupName} | 无 | 无 |
ram:UpdateUser | UpdateUser | update | User acs:ram::{#accountId}:user/{#UserName} | 无 | 无 |
ram:ListUsersForGroup | ListUsersForGroup | get | Group acs:ram::{#accountId}:group/{#GroupName} | 无 | 无 |
ram:CreateAppSecret | CreateAppSecret | create | Application acs:ram::{#accountId}:application/{#AppName} | 无 | 无 |
ram:TagResources | TagResources | 全部资源 * | 无 | 无 | |
ram:UpdateLoginProfile | UpdateLoginProfile | Write | User acs:ram::{#accountId}:user/{#UserName} | 无 | 无 |
ram:GetAccountSummary | GetAccountSummary | get | 全部资源 * | 无 | 无 |
ram:BindMFADevice | BindMFADevice | update | User acs:ram::{#accountId}:user/{#UserName} | 无 | 无 |
ram:RemoveUserFromGroup | RemoveUserFromGroup | delete | Group acs:ram::{#accountId}:group/{#GroupName}User acs:ram::{#accountId}:user/{#UserName} | 无 | 无 |
ram:CreateUser | CreateUser | create | User acs:ram::{#accountId}:user/* | 无 | 无 |
ram:ListTagResources | ListTagResources | 全部资源 * | 无 | 无 | |
ram:AddFingerprintToOIDCProvider | AddFingerprintToOIDCProvider | create | OIDCProvider acs:ram::{#accountId}:oidc-provider/{#OIDCProviderName} | ram:OidcIssuerUrl | 无 |
ram:UntagResources | UntagResources | 全部资源 * | 无 | 无 | |
ram:CreateVirtualMFADevice | CreateVirtualMFADevice | create | 全部资源 * | 无 | 无 |
ram:GetSAMLProvider | GetSAMLProvider | get | SAMLProvider acs:ram::{#accountId}:saml-provider/{#SAMLProviderName} | 无 | 无 |
ram:ListAccessKeys | ListAccessKeys | list | User acs:ram::{#accountId}:user/{#UserName} | 无 | 无 |
ram:ListGroupsForUser | ListGroupsForUser | get | User acs:ram::{#accountId}:user/{#UserName} | 无 | 无 |
ram:SetSecurityPreference | SetSecurityPreference | update | 全部资源 * | ram:MFAOperationForLogin | 无 |
ram:ListOIDCProviders | ListOIDCProviders | get | 全部资源 * | 无 | 无 |
ram:ListAppSecretIds | ListAppSecretIds | get | Application acs:ram::{#accountId}:application/{#AppName} | 无 | 无 |
ram:CreateOIDCProvider | CreateOIDCProvider | create | 全部资源 * | ram:OidcIssuerUrl | 无 |
ram:DeleteVirtualMFADevice | DeleteVirtualMFADevice | delete | MFADevice acs:ram::{#accountId}:mfa/{#SerialNumber} | 无 | 无 |
ram:ListVirtualMFADevices | ListVirtualMFADevices | list | 全部资源 * | 无 | 无 |
ram:GetAppSecret | GetAppSecret | get | Application acs:ram::{#accountId}:application/{#AppName} | 无 | 无 |
ram:UpdateAccessKey | UpdateAccessKey | Write | User acs:ram::{#accountId}:user/{#UserName} | 无 | 无 |
ram:CreateGroup | CreateGroup | create | Group acs:ram::{#accountId}:group/* | 无 | 无 |
ram:DeleteOIDCProvider | DeleteOIDCProvider | delete | OIDCProvider acs:ram::{#accountId}:oidc-provider/{#OIDCProviderName} | ram:OidcIssuerUrl | 无 |
ram:ListUsers | ListUsers | list | User acs:ram::{#accountId}:user/* | 无 | 无 |
ram:GetUser | GetUser | get | User acs:ram::{#accountId}:user/{#UserName} | 无 | 无 |
ram:GetAccountMFAInfo | GetAccountMFAInfo | get | 全部资源 * | 无 | 无 |
ram:GetOIDCProvider | GetOIDCProvider | get | OIDCProvider acs:ram::{#accountId}:oidc-provider/{#OIDCProviderName} | ram:OidcIssuerUrl | 无 |
ram:GetUserSsoSettings | GetUserSsoSettings | get | 全部资源 * | 无 | 无 |
ram:DeleteGroup | DeleteGroup | delete | Group acs:ram::{#accountId}:group/{#GroupName} | 无 | 无 |
ram:ListUserBasicInfos | ListUserBasicInfos | list | User acs:ram::{#accountId}:user/* | 无 | 无 |
资源(Resource)
下表是IMS定义的资源,这些资源可以在RAM权限策略语句的Resource
元素中使用,用来授予对该资源执行具体操作的权限。 其中,资源ARN是资源在阿里云上的唯一标识。具体说明如下:{#}
为变量标识,需要您替换为实际值。例如:{#ramcode}
需要您替换为实际的云服务RAM代码。-
*
表示全部。例如:{#resourceType}
为*
时:表示全部资源。{#regionId}
为*
时:表示全部地域。{#accountId}
为*
时:表示全部阿里云账号。
资源类型 | 资源ARN |
---|---|
SAMLProvider | acs:ram::{#accountId}:saml-provider/* |
User | acs:ram::{#accountId}:user/{#UserName} |
Application | acs:ram::{#accountId}:application/{#AppName} |
Application | acs:ram::{#accountId}:application/* |
User | acs:ram::{#AccountId}:user/* |
User | acs:ram::{#AccountId}:user/{#UserName} |
Group | acs:ram::{#accountId}:group/{#GroupName} |
OIDCProvider | acs:ram::{#accountId}:oidc-provider/{#OIDCProviderName} |
SAMLProvider | acs:ram::{#accountId}:saml-provider/{#SAMLProviderName} |
Group | acs:ram::{#accountId}:group/* |
User | acs:ram::{#accountId}:user/* |
MFADevice | acs:ram::{#accountId}:mfa/* |
OIDCProvider | acs:ram::{#accountId}:oidc-provider/* |
MFADevice | acs:ram::{#accountId}:mfa/{#SerialNumber} |
条件(Condition)
下表是IMS定义的产品级条件关键字,这些条件关键字可以在RAM权限策略语句的
Condition
元素中使用,用来描述授予权限的条件。以下仅列举产品级的条件关键字,阿里云定义的IMS也同样适用通用条件关键字。其中,数据类型决定了您可以使用哪些条件运算符将请求中的值与权限策略语句中的值进行比较。您必须使用与数据类型匹配的条件运算符,否则无法匹配策略语句,授权行为无效。数据类型与条件运算符的对应关系,请参见条件操作类型。
条件关键字 | 描述 | 类型 |
---|---|---|
ram:OidcIssuerUrl | The URL of the issuer, which is provided by the external IdP. | String |
ram:MFAOperationForLogin | Whether MFA authentication is required for login. | String |