文档首页 > > API签名指南> AK/SK签名认证准备

AK/SK签名认证准备

分享
更新时间: 2019/10/28 GMT+08:00

写在前面

本手册意在指导用户使用AK/SK签名认证方式调用云服务API,提供签名流程与实现逻辑,以及Java、Go、Python、C等多种不同语言的签名SDK和调用示例。

  1. SDK打包在示例中,可单独获取SDK,然后参考示例与各语言的API调用说明部分,将SDK集成到您的应用中。
  2. 如果本手册的多语言签名示例没有涵盖您使用的编程语言,请根据签名流程与算法,自主实现请求的签名。
  3. API调用的另一种认证方式为携带Token,Token方式的说明与示例包含在各服务的API参考手册
  4. AK/SK签名认证方式,仅支持Body体12M以内,12M以上的请求,需使用Token认证。
  5. 云服务具体的API在各云服务的API参考手册中列明。

API调用信息收集

在构造API请求前,我们需要获取以下信息,包括组成请求URL的Endpoint和URI,用于签名和认证的AK/SK,用于区分租户的项目ID。

表1 信息收集项

信息项

说明

Endpoint

地区与终端节点,即云服务在不同Region有不同的访问域名。

获取方式请参考地区和终端节点

说明:

本手册所有关于请求URL的举例,其中Endpoint假设为service.region.example.com。

Project_Id

项目ID,在大多数API接口调用时需要配置在uri中,用以识别不同的项目。

获取方式请参考获取项目ID

AK/SK

访问密钥对,包含密钥ID与密钥。AK/SK用于对请求内容进行签名。

获取方式请参考获取AK/SK

URI

API接口的调用路径及参数。

请参考各云服务的详细接口章节获取。

X-Domain-Id

账号ID,用途:

  • Token认证方式下获取Token。
  • AK/SK认证方式下,全局服务的接口调用,需在请求消息头中配置X-Domain-Id,如CDN服务。

获取方式请参考获取账号名和账号名ID

X-Project-Id

子项目ID,在多项目场景中使用。如果云服务资源创建在子项目中,AK/SK认证方式下,操作该资源的接口调用需要在请求消息头中携带X-Project-Id。

获取方式请参考获取项目ID

获取项目ID

在调用接口的时候,部分URL中需要填入项目编号,获取token时,同样需要获取项目编号,所以需要先在管理控制台上获取到项目编号。项目编号获取步骤如下:

  1. 注册并登录管理控制台。
  2. 单击用户名,在下拉列表中单击“我的凭证”,查看“项目ID”。
    项目用于对云服务器资源进行物理隔离,默认有region级别的隔离,也可在Region下建立多项目,做更细级别的隔离。因此,请参考下图,在左侧列表中找到您的服务器资源对应的Region(所属区域),在其右侧列表中获取项目ID。
    图1 查看项目ID

    如果要查看子项目ID,请单击该项目,展开子项目列表后获取。

获取AK/SK

如果已生成过AK/SK,则可跳过此步骤,找到原来已下载的AK/SK文件,文件名一般为:credentials.csv。

如下图所示,文件包含了租户名(User Name),AK(Access Key Id),SK(Secret Access Key)。

图2 credential.csv文件内容
AK/SK生成步骤:
  1. 注册并登录管理控制台。
  2. 单击右上角的用户名,在下拉列表中单击“我的凭证”。
  1. 单击“管理访问密钥”。
  2. 单击“新增访问密钥”,进入“新增访问密钥”页面。
  3. 输入登录密码和短信验证码,单击“确定”,下载密钥,请妥善保管。
图3 访问密钥获取页面示意

获取账号名和账号名ID

在调用接口的时候,部分URL中需要填入账号名和账号ID,所以需要先在管理控制台上获取到账号名和账号ID。账号名和账号ID获取步骤如下:

  1. 注册并登录管理控制台。
  2. 单击用户名,在下拉列表中单击“我的凭证”。

    查看账号名和账号ID。

    图4 查看账号名和账号ID
分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区