更新时间:2025-11-20 gmt 08:00
认证鉴权-j9九游会登录
调用接口有如下两种认证方式,您可以选择其中一种进行认证鉴权。
- ak/sk认证:通过ak(access key id)/sk(secret access key)加密调用请求。推荐使用ak/sk认证,其安全性比token认证要高。
- token认证:通过token认证调用请求。
ak/sk认证
- ak/sk签名认证方式仅支持消息体大小在12mb以内,12mb以上的请求请使用token认证。
- ak/sk既可以使用永久访问密钥中的ak/sk,也可以使用临时访问密钥中的ak/sk,但使用临时访问密钥的ak/sk时需要额外携带“x-security-token”字段,字段值为临时访问密钥的security_token。
- api网关除了校验时间格式外,还会校验该时间值与网关收到请求的时间差,如果时间差大于15分钟,api网关将拒绝请求。因此客户端必须注意本地时间与时钟服务器的同步,避免请求消息头x-sdk-date的值出现较大误差。
ak/sk认证就是使用ak/sk对请求进行签名,在请求时将签名信息添加到消息头,从而通过身份认证。
- ak(access key id):访问密钥id。与私有访问密钥关联的唯一标识符;访问密钥id和私有访问密钥一起使用,对请求进行加密签名。
- sk(secret access key):私有访问密钥。与访问密钥id结合使用,对请求进行加密签名,可标识发送方,并防止请求被修改。
使用ak/sk认证时,您可以基于签名算法使用ak/sk对请求进行签名,也可以使用专门的签名sdk对请求进行签名。详细的签名方法和sdk使用方法请参见api签名指南。
签名sdk只提供签名功能,与服务提供的sdk不同,使用时请注意。
您也可以通过这个视频教程了解ak/sk认证的使用:。
token认证
- token的有效期为24小时,需要使用一个token鉴权时,可以先缓存起来,避免频繁调用。
- 使用token前请确保token离过期有足够的时间,防止调用api的过程中token过期导致调用api失败。
token在计算机系统中代表令牌(临时)的意思,拥有token就代表拥有某种权限。token认证就是在调用api的时候将token加到请求消息头中,从而通过身份认证,获得操作api的权限。token可通过调用获取用户token接口获取。
调用本服务api需要项目级别的token,即调用获取用户token接口时,请求body中auth.scope的取值需要选择project,如下所示。
{
"auth": {
"identity": {
"methods": [
"password"
],
"password": {
"user": {
"name": "username", //iam用户名
"password": $admin_pass, //iam用户密码,建议在配置文件或者环境变量中密文存放,使用时解密,确保安全
"domain": {
"name": "domainname" //iam用户所属账号名
}
}
}
},
"scope": {
"project": {
"name": "xxxxxxxx" //项目名称
}
}
}
}
获取token后,再调用其他接口时,您需要在请求消息头中添加“x-auth-token”,其值即为token。例如token值为“abcdefg....”,则调用接口时将“x-auth-token: abcdefg....”加到请求消息头即可,如下所示。
1 2 3 |
posthttps://iam.cn-north-4.myhuaweicloud.com/v3.0/os-user/users content-type:application/json x-auth-token:abcdefg.... |
您还可以通过这个视频教程了解如何使用token认证:。
父主题: 如何调用api
相关文档
意见反馈
文档内容是否对您有帮助?
提交成功!非常感谢您的反馈,我们会继续努力做到更好!
您可在查看反馈及问题处理状态。
系统繁忙,请稍后重试
如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨