# 作用域令牌：最佳实践

impact.com 允许您创建 *范围限定令牌*：具有细粒度权限的 API 凭证，可授予对特定 API 端点的访问权限。了解更多关于 [确保您的令牌安全](https://help.impact.com/other/zh/readme/api-access-tokens-and-changelog/keep-your-access-tokens-secure).

<div data-with-frame="true"><figure><img src="https://2499487857-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhRN1rcrim887TwHLBjac%2Fuploads%2Fgit-blob-fe3efc74bca33b0b652161e5998440268b8aa50d%2F5b0a9e9151e8fbc234e52fbb902b41b711de77f2760d139f813dfbfff1584b99.png?alt=media" alt=""><figcaption></figcaption></figure></div>

#### 范围限定令牌的优势

<details>

<summary>更强的安全性</summary>

范围限定令牌只允许访问所需内容，从而在凭证泄露时降低风险。

</details>

<details>

<summary>更好的访问控制</summary>

为每个令牌可通过特定 API 执行的操作设置具体权限。

</details>

<details>

<summary>简化管理</summary>

简化令牌管理，尤其是在与多个团队或外部合作伙伴协作时。

</details>

<details>

<summary>洞察性监控</summary>

深入了解令牌使用情况，更好地理解 API 流量并有效管理速率限制。

</details>

<details>

<summary>改进的令牌管理</summary>

轻松创建、管理和撤销令牌，而不会影响其他集成。

</details>

#### 创建范围限定令牌的最佳实践

在创建范围限定令牌时，请遵循以下最佳实践，以确保安全性、清晰度和有效管理：

<details>

<summary>只选择您需要的 API 和方法</summary>

通过仅选择您的集成实际需要的特定 API 和 HTTP 方法（如 GET、POST、PUT、DELETE）来定义作用域。如果您的集成只需要检索数据，则仅使用 GET 方法授予对该 API 的访问权限。

</details>

<details>

<summary>应用最小权限原则</summary>

始终从所需的最低访问级别开始，仅在绝对必要时再添加更多权限。除非您的集成明确需要，否则避免启用 POST、PUT 或 DELETE 方法。

</details>

<details>

<summary>使用描述性名称和说明</summary>

为每个令牌提供清晰、有意义的名称，并包含详细说明。这有助于您的团队更有效地管理、理解和审计令牌使用情况。

</details>

<details>

<summary>指定负责的技术联系人</summary>

确保每个令牌都有指定的技术联系人。此人将负责接收与 API 访问和集成性能相关的重要更新、提醒或通知。

</details>

<details>

<summary>选择正确的 API 版本</summary>

确保令牌与您的集成所使用的 API 版本保持一致。这有助于保持兼容性并防止意外错误。

</details>

#### 监控和管理范围限定令牌

<details>

<summary>定期检查令牌使用情况</summary>

养成定期检查令牌使用方式的习惯。您可以通过设置仪表板来跟踪令牌活动，或向 impact.com 索取使用详情。同时，注意集成中的频繁错误。

</details>

<details>

<summary>避免授予过多访问权限</summary>

如果令牌拥有超出所需的权限，一旦泄露就会很危险。为防止这种情况，请比较令牌被允许执行的操作与其实际执行的操作。如果它拥有不需要的访问权限，请将其移除。

</details>

<details>

<summary>经常轮换令牌</summary>

定期更改令牌凭证，以帮助保障系统安全。尽量每隔几个月更新一次令牌——每季度一次是个不错的做法。创建新令牌后，请确保更新您的集成以使用新的令牌。

</details>

<details>

<summary>使用清晰的名称和描述</summary>

为每个令牌提供一个名称和描述，说明该令牌的用途及其所有者。包含使用该令牌的应用或系统、用途，以及它是用于测试还是线上环境等信息。此外，为团队中每个令牌指定一名主要联系人，以便在出现问题时联系。

</details>

<details>

<summary>移除未使用的令牌</summary>

旧令牌或未使用的令牌可能带来安全风险。安排定期清理——每月或每季度一次——检查所有令牌。删除或停用任何不再需要的令牌。

</details>

#### 常见问题

<details>

<summary>现有集成会受到影响吗？</summary>

不会。使用旧版令牌的现有集成将继续运行。不过，我们建议迁移到范围限定的 API 访问令牌，以获得更好的安全性和管理能力。

</details>

<details>

<summary>什么是旧版令牌？</summary>

*旧版令牌* 是一种较早的访问令牌类型，早于 *范围限定令牌*。范围限定令牌在 2025 年 5 月之后可在 impact.com 上使用。

</details>

<details>

<summary>保持令牌安全的最佳实践是什么？</summary>

了解更多关于 [确保您的访问令牌安全](https://help.impact.com/other/zh/readme/api-access-tokens-and-changelog/keep-your-access-tokens-secure).

</details>

<details>

<summary>我可以创建多少个范围限定令牌？</summary>

每个账户最多可拥有 20 个处于激活状态的范围限定令牌。可根据需要停用或删除令牌。

</details>

<details>

<summary>令牌被停用时会发生什么？</summary>

被停用的令牌将被拒绝访问，并返回 403“访问被拒绝”响应。这样可以在不删除令牌的情况下进行临时停用。

</details>

<details>

<summary>可以恢复已删除的令牌吗？</summary>

不可以，删除功能会永久删除访问令牌及其分配的任何权限。如果您误删了令牌，您可以创建一个新令牌并选择作用域。现有集成需要更新为使用新的访问令牌凭证。

</details>

<details>

<summary>范围限定令牌可以进行速率限制吗？</summary>

可以，范围限定访问令牌属于已实施的账户级速率限制的一部分。

</details>

<details>

<summary>范围限定令牌支持哪种身份验证方式？</summary>

我们的范围限定访问令牌仅支持基本身份验证。

</details>

<details>

<summary>如果使用无效令牌访问 API 会怎样？</summary>

如果您在没有有效范围限定访问令牌的情况下向 API 发出请求，您将看到 403“访问被拒绝”响应。

</details>