传递会话标签-j9九游会登录
会话标签(session tags)是您在通过华为云安全令牌服务(sts)调用assumeagency api切换iam信任委托时传递的tags参数。当调用sts服务的assumeagency api时,您会生成一个临时安全凭证(包括临时ak/sk和会话令牌security_token),该临时安全凭证对应本次委托会话(assumed-agency),具有过期时间。当您使用该临时安全凭证发起后续请求时,请求上下文中会包含g:principaltag条件键。您可以在策略的condition元素中使用g:principaltag条件键,来基于这些标签允许或拒绝访问。
会话标记
- 您传递的会话标签tags数量超过20个。
- 会话标签tags中键的纯文本超过128个字符。
- 会话标签tags中值的纯文本超过255个字符。
- 传递会话标签transitive_tag_keys数量超过20个。
会话标签注意事项
- 当使用会话标签时,准备切换信任委托的主体(iam用户或信任委托)附加的身份策略和目标信任委托的信任策略必须都包含sts::tagsession授权项,否则assumeagency操作将失败。
- 会话标签采用键值对形式。例如,若要在会话中添加联系信息,可以设置标签键为email,标签值为xxxxxx@example.com。
- 在使用委托链时(一个信任委托切换到另外一个信任委托)无法使用相同的会话标签键覆盖原有的会话标签的值。
- 您无法在iam控制台切换信任委托时传递会话标签。
- 会话标签仅对当前会话有效。
- 会话标签支持委托链。默认情况下,sts不会将标签传递至后续信任委托会话,但您可以将会话标签设置为可传递,使标签在委托链中持续存在。
- 您可以使用g:principaltag条件键来控制委托会话对华为云资源的访问。
使用会话标签所需要的权限
sts::tagsession
- 在iam用户切换信任委托的场景中,要指定会话标签,iam用户的身份策略和信任委托的信任策略都必须包含sts::tagsession权限。
- 在信任委托切换信任委托的场景中,要指定会话标签,发起切换的信任委托的身份策略和目标信任委托的信任策略都必须包含sts::tagsession权限。
{
"version": "5.0",
"statement": [{
"effect": "allow",
"action": [
"sts:agencies:assume",
"sts::tagsession"
]
}]
}
{
"version": "5.0",
"statement": [{
"action": [
"sts:agencies:assume",
"sts::tagsession"
],
"effect": "allow",
"principal": {
"iam": [
"account a id"
]
}
}]
}
接下来iam用户a便可以在调用assumeagency api时传递会话标签,调用详情见通过委托或者信任委托获取临时安全凭证中的tags参数。
委托链中的会话标签
您可以先切换到一个信任委托,然后使用获取的临时凭证切换到另外一个信任委托,这一过程称为委托链(agency chaining)。在您设置会话标签时,您可以将标签键设置为可传递,以确保这些会话标签能传递至委托链中的后续会话。请注意:信任委托身上的标签无法设为可传递,若要将这些标签传递至后续会话,必须将其明确指定为会话标签。
以下示例演示了sts如何在委托链中将会话标签、委托标签传递至后续会话。在此委托链场景中,您通过assumeagency api使用iam用户访问密钥切换到trustagency1的信任委托,随后利用生成的会话临时安全凭证切换到第二个信任委托trustagency2,最后使用第二次会话的临时安全凭证切换到第三个信任委托trustagency3。这些请求作为三个独立操作执行,且每个信任委托已预先在iam中打上了标签,每次请求时您可以使用assumeagency api中的tags和transitive_tag_keys参数确保会话标签从早期会话传递到后续会话。

假设切换trustagency1时在assumeagency api中设置了会话标签team=1,且将team设置为了可传递。此时,在trustagency1身上打了标签employeeid=1,如果您想要将委托标签employeeid=1也传递至后续会话,那么您必须手动在assumeagency api中也将其作为会话标签并设置为可传递。最后,生成的会话主体(session principal)中将同时包含team=1和employeeid=1这两个标签,这样您便可以使用g:principaltag/team、g:principaltag/employeeid条件键进行访问控制。

现在您使用会话1的临时安全凭证去切换trustagency2,team=1和employeeid=1将从会话1继承到会话2。此时,在trustagency2身上打了标签jobrole=2,但是您没有将其作为会话标签并设置为可传递。最后,虽然生成的会话主体中将同时包含team=1、employeeid=1和jobrole=2这三个标签,但是jobrole=2将不会往后续的会话中进行传递,只在本次会话2中有效。

最后您使用会话2的临时安全凭证去切换trustagency3,team=1和employeeid=1将从会话2继续继承到会话3。实际上,会话3的主体标签(principal tag)将由新增的会话标签、新增的可传递标签、信任委托本身的委托标签构成。此时,在trustagency3身上打了标签team=3,继承的标签team=1和信任委托本身的标签team=3在标签键上是相同的,由于继承的标签优先级要高于信任委托本身的标签,因此team=1将覆盖team=3。最后,生成的会话主体中将同时包含team=1、employeeid=1这两个标签。

将会话标签用于访问控制
{
"version": "5.0",
"statement": [{
"effect": "allow",
"action": [
"iam:*:*"
],
"condition": {
"stringequals": {
"g:principaltag/team": [
"1"
]
}
}
}]
}
{
"agency_urn": "iam::account_id:agency:agency_name",
"agency_session_name": "session_name",
"tags": [{
"key": "team",
"value": "1"
}]
}
相关文档
意见反馈
文档内容是否对您有帮助?
如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨