更新时间:2023-06-20 GMT+08:00

认证鉴权

CSS服务支持通过Token认证进行认证鉴权。

Token认证

Token的有效期为24小时,需要使用同一个Token鉴权时,可以缓存起来,避免频繁调用。

Token在计算机系统中代表令牌(临时)的意思,拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头,从而通过身份认证,获得操作API的权限。

获取Token的接口为“POST https://{IAM的Endpoint}/v3/auth/tokens”,IAM的终端节点可以参考终端节点获取。

{
	"auth": {
		"identity": {
			"methods": [
				"password"
			],
			"password": {
				"user": {
					"name": "username",    //用户名
					"password": "********",    //登录密码
					"domain": {
						"name": "domainname"    //用户所属的帐号名称
					}
				}
			}
		},
		"scope": {
			"project": {
				"name": "xxxxxxxx"    //项目名称
			}
		}
	}
}

获取Token后,再调用其他接口时,您需要在请求消息头中添加“X-Auth-Token”,其值即为Token。例如Token值为“ABCDEFJ....”,则调用接口时将“X-Auth-Token: ABCDEFJ....”加到请求消息头即可,如下所示。

POST https://{endpoint}/v3/auth/projects
Content-Type: application/json
X-Auth-Token: ABCDEFJ....