# 用户访问令牌

使用 Zenlayer API 或命令行时，可使用用户访问令牌 替代密码向 Zenlayer Cloud 进行身份验证。

在发出请求时，您需要使用访问令牌对请求进行身份验证。与密码类似，用户访问令牌（也称为“API密钥”或“访问令牌”）标识向API发出请求的实体，以及实体可以通过其作用域和权限执行的操作。

{% hint style="info" %}
**请记住，您的用户访问令牌是秘密！**请勿与他人共享或在任何客户端代码（浏览器、应用程序）中公开它。生产请求必须通过您自己的后端服务器进行路由，在该服务器中，您的 API 密钥可以从环境变量或密钥管理服务安全地加载。
{% endhint %}

### 创建一个用户访问令牌 <a href="#creating-a-site-token" id="creating-a-site-token"></a>

1. 通过访问**密钥 > 令牌**进入\\

   <div align="center"><figure><img src="https://2493229348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3TWGrywFMs2mAYa92qcz%2Fuploads%2Fgit-blob-bbd692fca35086a86154d39442c7b00ae418d721%2Fimage%20(7).png?alt=media" alt="" width="375"><figcaption></figcaption></figure></div>
2. 点击生成令牌

   <figure><img src="https://2493229348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3TWGrywFMs2mAYa92qcz%2Fuploads%2Fgit-blob-9a694f29094cee4a743d1a6c1432fe2a4c2b247a%2Fimage%20(2).png?alt=media" alt="" width="375"><figcaption></figcaption></figure>
3. 为你的令牌选择一个用户并设置一个名称\\

   <figure><img src="https://2493229348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3TWGrywFMs2mAYa92qcz%2Fuploads%2Fgit-blob-0e4d3cb67b1d7f8565cb4487ed029a9eccd0ba0a%2Fimage%20(8).png?alt=media" alt="" width="375"><figcaption></figcaption></figure>
4. 点击生成并复制出令牌\\

   <figure><img src="https://2493229348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3TWGrywFMs2mAYa92qcz%2Fuploads%2Fgit-blob-7a4d2d0d9e2bf387be301a9484d471c6b2ed5a70%2Fimage%20(9).png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

### 使用令牌访问API

创建令牌后，可以通过在请求的 `Authorization` 标头中发送令牌来对请求进行身份验证。 下面通过cURL来访问BMC的`DescribeInstances`接口作为示例：

<pre class="language-sh" data-line-numbers><code class="lang-sh">export ACCESS_TOKEN="your_user_access_token"

curl https://console.zenlayer.com/api/v2/bmc \
 -H "Content-Type: application/json" \
 -H "X-ZC-Action: DescribeInstances" \
<strong> -H "Authorization: Bearer $ACCESS_TOKEN" \
</strong> -d '{
       "pageNum": 1,
       "pageSize": 2
    }'
</code></pre>