关于评估警报
有一些其他功能可以帮助你评估警报,以便更好地排列警报优先级和管理警报。 您可以:
- 检查机密的有效性,了解机密是否仍处于活动状态。 仅适用于 GitHub 令牌。有关详细信息,请参阅检查机密的有效性。
- 查看令牌的元数据。 仅适用于 GitHub 令牌。 例如查看上次使用令牌的时间。 有关详细信息,请参阅查看 GitHub 令牌元数据。
检查机密的有效性
验证检查让您知道哪些机密属于 active
或 inactive
机密,帮助你排列 警报优先级。 active
机密是仍可能被利用的机密,因此应该优先审查和修正它们的警报。
默认情况下,GitHub 检查 GitHub 令牌的有效性,并在警报视图中显示令牌的验证状态。
有效期 | Status | 结果 |
---|---|---|
活动机密 | active | GitHub 向此机密的提供者进行了核实,发现此机密处于活动状态 |
可能处于活动状态的机密 | unknown | GitHub 尚不支持对此令牌类型进行验证检查 |
可能处于活动状态的机密 | unknown | GitHub 无法验证此机密 |
机密处于非活动状态 | inactive | 应确保未发生未经授权的访问 |
可以使用 REST API 检索每个令牌的最新验证状态的列表。 有关详细信息,请参阅 REST API 文档中的 适用于机密扫描的 REST API 终结点。 还可以使用 Webhook 来通知与 secret scanning 警报相关的活动。 有关详细信息,请参阅 Webhook 事件和有效负载 中的 secret_scanning_alert
事件。
查看 GitHub 令牌元数据
Note
GitHub 令牌的元数据目前为 beta 版本,可能会更改。
在活动的 GitHub 令牌警报视图中,可以查看有关令牌的某些元数据。 此元数据可以帮助你识别令牌,并确定要采取的修正步骤。
令牌(如personal access token和其他凭据)被视为个人信息。 有关使用 GitHub令牌的详细信息,请参阅 GitHub 的隐私声明和可接受的使用政策。
GitHub 令牌的元数据可用于任何启用了机密扫描的存储库的活动令牌。 如果令牌已被撤销或无法验证其状态,则元数据将不可用。 GitHub 会自动撤销公共存储库中的 GitHub 令牌,因此公共存储库中 GitHub 令牌的元数据极有可能不可用。 以下元数据可用于活动的 GitHub 令牌:
元数据 | 描述 |
---|---|
机密名称 | GitHub 令牌的创建者为该令牌提供的名称 |
机密所有者 | 令牌所有者的 GitHub 句柄 |
创建时间 | 令牌的创建日期 |
过期日期 | 令牌的过期日期 |
上次使用时间 | 上次使用令牌的日期 |
访问 | 令牌是否具有组织访问权限 |
只有对包含已泄露机密的存储库具有管理员权限的人员才能查看安全警报详细信息和警报的令牌元数据。 企业所有者可以出于此目的请求对存储库的临时访问权限。如果授予访问权限,GitHub 将通知包含已泄露机密的仓库的所有者,在仓库所有者和企业审核日志中报告该操作,并将访问权限启用 2 小时。