更新时间:2026-02-05 gmt 08:00

传递会话标签-j9九游会登录

会话标签(session tags)是您在通过华为云安全令牌服务(sts)调用assumeagency api切换iam信任委托时传递的tags参数。当调用sts服务的assumeagency api时,您会生成一个临时安全凭证(包括临时ak/sk和会话令牌security_token),该临时安全凭证对应本次委托会话(assumed-agency),具有过期时间。当您使用该临时安全凭证发起后续请求时,请求上下文中会包含g:principaltag条件键。您可以在策略的condition元素中使用g:principaltag条件键,来基于这些标签允许或拒绝访问。

会话标记

目前您只能在sts的assumeagency api中通过tags参数传递会话标签,在iam控制台切换信任委托时不支持传递会话标签。您还可以在assumeagency api中通过transitive_tag_keys参数将会话标签设置为可传递(transitive),这样在委托链中,这些会话标签将持续存在。详细信息可以参考获取临时安全凭证,如果满足以下条件,则传递会话标签的assumeagency api调用会失败:
  • 您传递的会话标签tags数量超过20个。
  • 会话标签tags中键的纯文本超过128个字符。
  • 会话标签tags中值的纯文本超过255个字符。
  • 传递会话标签transitive_tag_keys数量超过20个。

会话标签注意事项

在使用会话标签前,请了解以下关于会话标签的细节:
  • 当使用会话标签时,准备切换信任委托的主体(iam用户或信任委托)附加的身份策略和目标信任委托的信任策略必须都包含sts::tagsession授权项,否则assumeagency操作将失败。
  • 会话标签采用键值对形式。例如,若要在会话中添加联系信息,可以设置标签键为email,标签值为xxxxxx@example.com。
  • 在使用委托链时(一个信任委托切换到另外一个信任委托)无法使用相同的会话标签键覆盖原有的会话标签的值。
  • 您无法在iam控制台切换信任委托时传递会话标签。
  • 会话标签仅对当前会话有效。
  • 会话标签支持委托链。默认情况下,sts不会将标签传递至后续信任委托会话,但您可以将会话标签设置为可传递,使标签在委托链中持续存在。
  • 您可以使用g:principaltag条件键来控制委托会话对华为云资源的访问。

使用会话标签所需要的权限

要想设置会话标签,除了需要与assumeagency api相匹配的sts:agencies:assume授权项外,您的策略中还必须具有以下授权项:
sts::tagsession
  • 在iam用户切换信任委托的场景中,要指定会话标签,iam用户的身份策略和信任委托的信任策略都必须包含sts::tagsession权限。
  • 在信任委托切换信任委托的场景中,要指定会话标签,发起切换的信任委托的身份策略和目标信任委托的信任策略都必须包含sts::tagsession权限。
作为账号管理员,假设您希望允许账号内的iam用户a切换到同一账号中的trustagencya信任委托,且在切换时允许传递会话标签。您可以将以下身份策略附加到该iam用户:
{
	"version": "5.0",
	"statement": [{
		"effect": "allow",
		"action": [
			"sts:agencies:assume",
			"sts::tagsession"
		]
	}]
}
要想主体切换信任委托时可以传递会话标签,您可以在创建信任委托a时配置如下的信任策略:
{
	"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这两个标签。

将会话标签用于访问控制

可以在信任委托身上附加身份策略要求满足g:principaltag/team=1时才拥有iam访问权限,策略示例如下:
{
	"version": "5.0",
	"statement": [{
		"effect": "allow",
		"action": [
			"iam:*:*"
		],
		"condition": {
			"stringequals": {
				"g:principaltag/team": [
					"1"
				]
			}
		}
	}]
}
如果信任委托本身没有team=1的委托标签,那么在调用assumeagency api切换信任委托时,只有在tags参数中填写key=team,value=1时获取的临时安全凭证会话才拥有访问iam的权限,assumeagency api请求体示例如下:
{
	"agency_urn": "iam::account_id:agency:agency_name",
	"agency_session_name": "session_name",
	"tags": [{
		"key": "team",
		"value": "1"
	}]
}

相关文档

网站地图