认证鉴权
平台支持使用令牌(Token)对访问平台的用户进行身份认证。
系统颁发给用户的令牌,承载用户的身份、权限等信息。当用户调用平台提供的 API 时,将令牌加到请求消息头中,可通过身份认证,获得调用 API 操作平台资源的权限。
令牌在请求头(Headers)中的具体格式如下:
| KEY | Value | 
|---|---|
| Authorization | Bearer {您的令牌} | 
说明:{您的令牌} 为您通过平台获取的令牌,令牌在请求头中的输入格式如:Bearer eyJhxxxxxxxxxxxxxxxUiOiJhZG1pbiIsImV4dQ。
以下示例为通过命令行调用接口时令牌的使用方法。
## List services
curl -X "GET" "https://{IP 地址或域名}/auth/v1/users?limit=20" \
     -H "Authorization: Bearer <your token>"获取令牌
我们所提供的对外的 API 都需要使用令牌进行认证与鉴权,因此在使用我们的 API 之前您首先需要获取一个有效的令牌。
在平台的个人中心,您可根据需要自行添加、管理您的令牌。每个令牌都承载了您在平台上的身份、权限信息。
- 
您可根据不同的使用场景添加多个令牌,并可设置令牌的有效期(永久、自定义),多个令牌在有效期内均可正常使用。 
- 
您可通过平台删除未过期的令牌,使令牌即时失效。 
注意:为避免他人使用您的令牌对平台执行未经许可的操作,请不要随意分享您的令牌。
前提条件
您在获取令牌之前,需要先拥有一个可正常登录平台的账号,如果您还没有平台的账号,可联系平台管理员申请开通账号。
操作步骤
- 
成功并登录平台后,单击界面右上角的 账号名称 > 个人信息。 
- 
在 API 令牌 页签下,单击 添加令牌。 
- 
输入令牌的描述,并设置令牌的有效期。 
- 
单击 添加。 
- 
单击 复制,并另存您的令牌。 注意:请务必确保您已复制令牌后再关闭 API 令牌已创建 对话框。 
 令牌添加成功后,需要您自己保存令牌的信息。令牌信息仅可在 API 令牌已创建 对话框中查看,且该对话框关闭后将无法再打开。