认证鉴权
调用接口采用Token认证鉴权。
前提条件
- 必须注册成为华为乾坤租户,用租户帐号登录华为乾坤控制台。
- 必须购买华为乾坤云管理网络服务或者通过联系华为乾坤运营人员开通试用权限。
创建三方系统接入用户
获取试用权限,当前仅限于华为内部测试用,可联系网络环境监控和用户体验保障服务研发团队进行支持,协助进行开通;外部帐号只能通过购买云管理网络服务获得试用权限。
- 登录华为乾坤控制台。
- 鼠标移动至登录用户名,在下拉菜单中单击“权限管理”,选择“用户管理”页签。
- 单击“创建”,创建用户。
- 在“基本信息”界面,“类型”选择“三方系统接入用户”,并依次设置访问API接口的用户名和密码,单击“下一步”。
- 在“选择角色”界面,勾选“云管理网络开放接口操作员”。
- 创建完成后,通过用户名和密码,调用IAM接口获取到Token。
Token认证
Token的有效期为30分钟,需要使用一个Token鉴权时,可以先缓存起来,避免频繁调用。
使用Token前请确保Token离过期有足够的时间,防止调用API的过程中Token过期导致调用API失败。
Token在计算机系统中代表令牌(临时)的意思,拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头,从而通过身份认证,获得操作API的权限。
Token可通过调用获取用户Token接口获取,请求body填写数据,参考如下所示。
POST https://openapi.qiankun-saas.huawei.com/v1/iam/tokens Content-Type: application/json { "user_name": "***", "password": "***" }
获取Token后,再调用其他接口时,您需要在请求消息头中添加“x-auth-token”,其值即为Token。例如Token值为“ABCDEFJ....”,则调用接口时将“x-auth-token: ABCDEFJ....”加到请求消息头即可,如下所示。
GET https://openapi.qiankun-saas.huawei.com/v1/ci/expmonitor/common/basic?param={"id":"/","regionType":"site","level":0,"tenantId":"default-organization-id","startTime":1597766400000,"endTime":1597820400000,"settingRefresh":false,"metricType":"accessSuccessRate"} Content-Type: application/json x-auth-token: ABCDEFJ....