简介
要使 Kody 能够对 Bitbucket Cloud 执行自动代码审查,您需要生成一个 API 令牌。此令牌允许 Kody 访问您的代码库、拉取请求、webhooks、工单、管道等,并具有下面列出的特定权限。在 Bitbucket 中生成 API 令牌
- 直接打开 Atlassian API 令牌页面(或从您的 Atlassian 个人资料导航到 Security → API tokens)。
- 点击 Create API token with scopes。
- 为令牌命名(例如
kody_code_review)并设置到期日期。 - 如果出现提示,选择 Bitbucket 作为应用程序。
- 选择所有必需的范围(见下文)。
- 查看您的选择,然后点击 Create token。
- 立即复制令牌并安全存储——创建后您将无法再次查看它。
Kody 所需的范围
令牌必须包含 Kody 完整功能的所有以下范围:⚠️ 确保您仅授予这些必要的权限;避免授予超过所需的权限以降低安全风险。
将令牌添加到 Kody
- 一旦使用所有必需的范围生成令牌,在启用 Bitbucket 集成时将其粘贴到 Kody 集成/自动化设置屏幕中。
- 如果 Kody 需要配置 webhooks 或监听拉取请求事件,请确保令牌具有
admin:repository:bitbucket(或等效权限)。
重要说明
- 令牌将在创建时仅显示一次。请安全保存,因为您将无法再次查看它。
- 如果可能,设置到期日期以限制令牌的生命周期。
- 如果令牌被泄露,请立即撤销它并创建一个新的。
- 定期审核令牌及其范围,以确认它们仍然必要和有效。
- 检查您的 Bitbucket 计划/账户是否允许上述所有范围;某些范围(项目、工作区、管理员)可能取决于订阅/权限。