访问令牌

文章内容

功能介绍
创建访问令牌
编辑/重新生成访问令牌
删除访问令牌
访问令牌权限说明
使用访问令牌
利用令牌访问代码仓库

功能介绍

个人访问令牌类似某些系统中的应用专用密码。生成后可根据设置的权限访问特定的 API，可以用于创建自己的程序或者脚本。

创建访问令牌

点击页面右上角个人头像，选择「个人账户设置」。

在左侧导航栏中选择「访问令牌」进入令牌列表，点击页面右上角「新建令牌」。

在表单中填写令牌描述，并选择此令牌的访问权限（参考访问令牌权限说明）。你还可以设置 IP 白名单。

令牌创建完成之后将会显示在令牌列表，并将新建的令牌的内容显示出来。

注意：令牌的内容只在刚创建完成时显示在令牌列表，刷新之后即显示为令牌描述。为了安全，请将其复制粘贴至您需要使用的地方，并不要保存副本。如果您需要调试，请在调试后，点击「编辑」重新生成令牌。

编辑/重新生成访问令牌

在访问令牌列表，点击「编辑」即可进入任一令牌的编辑页面。

修改令牌：

在编辑页面，你可以修改令牌描述、权限或白名单。

重新生成令牌：

如果遗失了令牌，可以选择重新生成。

注意：重新生成令牌后，令牌内容也仅在创建成功时显示在列表。刷新页面即会显示为令牌描述。

删除访问令牌

如果令牌不再继续使用，为了避免信息泄露，建议将其删除。

删除单个令牌：

选择要删除的访问令牌，点击更多选项按钮，选择「删除」即可删除该令牌。

批量删除所有令牌：

如需批量删除所有令牌，点击令牌列表右上角的更多选项按钮，选择「删除全部」即可。

访问令牌权限说明

访问令牌目前与 OAuth 的 Access Token 共用一个 Scope 权限范围。

Scope 名称	说明	授权
project:depot	获取 commit 信息，分支操作，MR/PR, LineNotes, fork, webhook 等操作	读写
user	授权获取用户信息（用户名称，头像，tag，email，动态）	读
user:email	授权获取用户的 email	读
notification	授权读取通知信息，包含 email 通知	读写
social:message	授权读取、发送私信、私信语音	读写
project	授权项目信息、项目列表，仓库信息，公钥列表、成员，任务列表	读
project:members	授权项目管理者增、删、改项目成员，退出项目	读写
project:task	授权任务操作，包含增、删、改	读写
project:file	授权文件，包含增、删、改	读写
project:key	授权操作部署公钥、个人公钥	读写

使用访问令牌

访问令牌可以用于在 HTTP 请求中代替用户名密码，访问 CODING API。

可以在 HTTP 请求中使用 -u 参数，加入用户：

curl -X POST -u "djjdXXXXX:5ffe9a43c6425bc0a4c95bc22b1aXXXXX" https://e.coding.net/open-api -d "{\"Action\":\"DescribeCodingCurrentUser\"}"
{
  "Response": {
    "RequestId": "1c20991d-03a3-47d3-8c52-XXXXX",
    "User": {
      "Id": 123456,
      "Status": 1,
      "Email": "coding@tencent.com",
      "GlobalKey": "djjdXXXXX",
      "Avatar": "https://coding-net-production-static-ci.codehub.cn/test.jpg",
      "Name": "tester",
      "NamePinYin": "cxzh|ce",
      "Phone": "13500000000",
      "PhoneValidation": 1,
      "EmailValidation": 1,
      "PhoneRegionCode": "+86",
      "TeamId": 7654321
    }
  }
}

你还可以设置至 HTTP 请求的 Header 中：

curl -X POST -H "Authorization: Bearer 5ffe9a43c6425bc0a4c95bc22b1aXXXXX" https://e.coding.net/open-api -d "{\"Action\":\"DescribeCodingCurrentUser\"}"
{
  "Response": {
    "RequestId": "1c20991d-03a3-47d3-8c52-XXXXX",
    "User": {
      "Id": 123456,
      "Status": 1,
      "Email": "coding@tencent.com",
      "GlobalKey": "djjdXXXXX",
      "Avatar": "https://coding-net-production-static-ci.codehub.cn/test.jpg",
      "Name": "tester",
      "NamePinYin": "cxzh|ce",
      "Phone": "13500000000",
      "PhoneValidation": 1,
      "EmailValidation": 1,
      "PhoneRegionCode": "+86",
      "TeamId": 7654321
    }
  }
}

利用令牌访问代码仓库

在设置 Scope 权限选项中勾选 project:depot 后，可以用于访问代码仓库。

git clone https://tester:90ed7a169febb12d17e14aa5531827476f6b3a4e@test.coding.net/test/testRepo.git
Cloning into 'testRepo'...
remote: Counting objects: 11, done.
remote: Compressing objects: 100% (7/7), done.
remote: Total 11 (delta 2), reused 0 (delta 0)
Unpacking objects: 100% (11/11), done.

问题反馈 >

2023-07-04最近更新

感谢反馈有用

感谢反馈没用