管理受信任的配置文件
通过随时更新权限或重新定义信任关系来管理受信任的配置文件。 您还可以删除受信任的配置文件,这样计算资源和联合用户就与配置文件解除了链接,不能再应用受信任的配置文件身份。
删除受信任的配置文件时,会撤销所有活动会话。 用户会立即注销,被删除的配置文件也无法再连接到目标账户。 使用访问令牌的 API 调用可能会成功,直到访问令牌过期。
您可以使用 Activity Tracker 监控哪些联合用户和计算资源应用了可信配置文件。 有关详细信息,请参阅 监控受信任配置文件的登录会话。
准备工作
- 您必须在账户内或 IAM Identity Service 上分配管理员、操作员或编辑器角色,才能管理受信任的配置文件。
使用控制台更新受信任配置文件
要更新受信任的配置文件,请进入 IBM Cloud 控制台的“管理”>“访问 (IAM)”,然后选择“受信任的配置文件”。 然后,选择要更新的受信任配置文件的名称。
更新个人简介说明
单击要更新的受信任配置文件的名称,然后选择操作 > 编辑。 输入新名称和描述,然后单击“应用”。
重新定义信任关系
创建受信任配置文件后,就可以在同一受信任配置文件中与联合用户和计算资源建立信任关系。
- 单击要更新的受信任配置文件的名称。
- 单击添加,为现有信任关系添加条件。 要编辑现有条件,请单击要更新的信任关系旁边的操作图标
> 编辑。
- 单击添加条件,然后根据需要重复添加更多条件。
- 要删除条件,请单击现有条件旁边的 移除 图标
。
- 单击保存,将所有添加或删除的条件应用到受信任的配置文件。
分配访问权
您可以通过分配单独的访问策略或将受信任的配置文件添加到现有的访问组来为受信任的配置文件分配访问权限。
分配访问策略
- 单击要更新的受信任配置文件的名称。
- 点击访问。
- 要编辑现有访问策略,请单击要更新的访问策略旁边的操作图标
> 编辑。
- 要分配新的访问策略,请单击“分配”。
您可以根据资源属性选择资源,并分配任意角色组合。
分配访问组
- 单击要更新的受信任配置文件的名称。
- 点击访问
- 要编辑现有访问组的成员资格,请单击要更新的访问组旁边的操作图标
> 编辑。
- 要将受信任的配置文件添加到新的访问组,请单击“指定组”。
- 选择要添加受信任配置文件的访问组,然后单击添加。 您只能将用户分配到您有权管理的访问组。
- 单击分配。
更新会话持续时间
- 单击要更新的受信任配置文件的名称。
- 在联合用户部分,点击要更新的身份提供者 (IdP) 的 行动 图标
。
- 选择编辑
- 以小时为单位,输入联合用户在会话过期前可以使用此配置文件的时间。
- 单击保存。
使用 CLI 更新受信任配置文件
您可以使用 CLI 从账户更新受信任配置文件。 更多信息,请参阅 IBM Cloud CLI。
-
登录并选择帐户。
ibmcloud login -
检查当前账户的受信任配置文件列表,选择要更新的配置文件。 以下命令显示 IBM Cloud 账户的受信任配置文件列表:
ibmcloud iam trusted-profiles -
如果要检查受信任配置文件的详细信息,请使用
ibmcloud iam trusted-profile命令。 指定要检查的受信任配置文件的 ID 或名称。ibmcloud iam trusted-profile <IDorName> -
运行以下命令,了解不同选项的概况。
ibmcloud iam trusted-profile-update -
运行以下命令更新受信任配置文件。 指定要更新和重命名的受信任配置文件的 ID 或名称。
ibmcloud iam trusted-profile-update <IDorName> -n <NewName> ...
例如,以下命令将 Test trusted profile 更新为 New test trusted profile。
ibmcloud iam trusted-profile-update <Test trusted profile> -n <New test trusted profile> ...
分配访问策略
您可以使用 CLI 为受信任配置文件分配新的访问策略。
-
登录并选择帐户。
ibmcloud login -
检查当前账户的受信任配置文件列表,选择要为其分配新访问策略的配置文件。 以下命令显示 IBM Cloud 账户的受信任配置文件列表:
ibmcloud iam trusted-profiles -
运行以下命令分配新的访问策略:
ibmcloud iam trusted-profile-policy-create
要检查受信任配置文件访问策略的详细信息,请运行以下命令:
ibmcloud iam trusted-profile-policy
要检查受信任配置文件的访问策略列表,可以使用 ibmcloud iam trusted-profile-policies 命令:
ibmcloud iam trusted-profile-policies
运行 ibmcloud iam trusted-profile-policy-update 命令即可轻松更新现有的访问策略:
ibmcloud iam trusted-profile-policy-update
如果要删除受信任配置文件的访问策略,可以使用 ibmcloud iam trusted-profile-policy-delete 命令:
ibmcloud iam trusted-profile-policy-delete
使用应用程序接口更新受信任的配置文件
更多信息,请参阅 IAM 身份服务 API。
更新名称或说明
要更新现有受信任配置文件的名称或描述,请执行以下操作。 输入更新后的 name 和 description 属性。
curl -X PUT 'https://iam.cloud.ibm.com/v1/profiles/PROFILE_ID' -H 'Authorization: Bearer TOKEN' -H 'If-Match: <value of etag header from GET request>' -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{
"name": "My Profile updated",
"description": "My updated desc"
}'
更新信任关系的条件
创建受信任配置文件后,就可以在同一受信任配置文件中与联合用户和计算资源建立信任关系。
curl -X PUT 'https://iam.cloud.ibm.com/v1/profiles/PROFILE_ID/rules/CLAIM_RULE_ID'
-H 'Authorization: Bearer TOKEN'
-H 'If-Match: <value of etag header from GET request>'
-H 'Content-Type: application/json'
-H 'Accept: application/json'
-d '{
"type": "Profile-SAML",
"realm_name": "https://w3id.sso.ibm.com/auth/sps/samlidp2/saml20",
"expiration": 10000,
"conditions": [
{
"claim": "groups",
"operator": "CONTAINS",
"value": "\"cloud-docs-ops\""
}
]
}'
分配访问策略
要分配新的访问策略,请拨打以下电话:
curl -X PUT 'https://iam.cloud.ibm.com/v1/policies'
-H 'Authorization: Bearer $TOKEN'
-H 'Content-Type: application/json'
-H 'If-Match: $ETAG'
-d '{
"type": "access",
"description": "Viewer role for for all instances of SERVICE_NAME in the account.",
"subjects": [
{
"attributes": [
{
"name": "iam_id",
"value": "IBMid-123453user"
}
]
}'
],
"roles":[
{
"role_id": "crn:v1:bluemix:public:iam::::role:Viewer"
}
],
"resources":[
{
"attributes": [
{
"name": "accountId",
"value": "$ACCOUNT_ID"
},
{
"name": "serviceName",
"value": "$SERVICE_NAME"
}
]
}
]
}'
更多信息,请参阅 IAM 策略管理 API。
更新会话持续时间
要更新联合用户的会话持续时间,请执行以下操作:
curl -X PUT 'https://iam.cloud.ibm.com/v1/profiles/PROFILE_ID/rules/CLAIM_RULE_ID'
-H 'Authorization: Bearer TOKEN'
-H 'If-Match: <value of etag header from GET request>'
-H 'Content-Type: application/json'
-H 'Accept: application/json'
-d '{
"type": "Profile-SAML",
"realm_name": "https://w3id.sso.ibm.com/auth/sps/samlidp2/saml20",
"expiration": 10000,
"conditions": [
{
"claim": "groups",
"operator": "CONTAINS",
"value": "\"cloud-docs-ops\""
}
]
}'
使用控制台删除受信任的配置文件
移除受信任的配置文件后,计算资源和联合用户将与配置文件解除链接,不能再应用受信任的配置文件身份。 要删除受信任的配置文件,请完成以下步骤:
- 要查看账户中受信任配置文件的完整列表,请转到 IBM Cloud 控制台中的管理 > 访问 (IAM),然后选择受信任配置文件。
- 单击要删除的受信任配置文件旁边的操作图标
,然后选择删除。
使用 CLI 删除受信任配置文件
您可以使用 CLI 从账户中删除受信任的配置文件。 更多信息,请参阅 IBM Cloud CLI。
-
登录并选择帐户。
ibmcloud login -
检查当前账户的受信任配置文件列表,选择要删除的配置文件。 以下命令显示 IBM Cloud 账户的受信任配置文件列表:
ibmcloud iam trusted-profiles -
运行以下命令,从账户中删除受信任配置文件。 指定要删除的受信任配置文件的 ID 或名称。
ibmcloud iam trusted-profile-delete <IDorName>
例如,以下命令删除名为 Test trusted profile 的受信任配置文件。
ibmcloud iam trusted-profile-delete <Test trusted profile>
使用应用程序接口删除受信任的配置文件
要从账户中删除受信任的个人资料,请拨打以下电话:
curl -X DELETE 'https://iam.cloud.ibm.com/v1/profiles/PROFILE_ID' -H 'Authorization: Bearer TOKEN'
更多信息,请参阅 IAM 身份服务 API。