更新时间: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认证:。

相关文档

网站地图