评估来自机密扫描的警报

关于评估警报

有一些其他功能可以帮助你评估警报，以便更好地排列警报优先级和管理警报。 您可以：

• 检查机密的有效性，了解机密是否仍处于活动状态。 仅适用于 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 令牌元数据

在活动的 GitHub 令牌警报视图中，可以查看有关令牌的某些元数据。 此元数据可以帮助你识别令牌，并确定要采取的修正步骤。

令牌（如personal access token和其他凭据）被视为个人信息。 有关使用 GitHub令牌的详细信息，请参阅 GitHub 的隐私声明和可接受的使用政策。

GitHub 令牌的元数据可用于任何启用了机密扫描的存储库的活动令牌。 如果令牌已被撤销或无法验证其状态，则元数据将不可用。 GitHub 会自动撤销公共存储库中的 GitHub 令牌，因此公共存储库中 GitHub 令牌的元数据极有可能不可用。 以下元数据可用于活动的 GitHub 令牌：

元数据	描述
机密名称	GitHub 令牌的创建者为该令牌提供的名称
机密所有者	令牌所有者的 GitHub 句柄
创建时间	令牌的创建日期
过期日期	令牌的过期日期
上次使用时间	上次使用令牌的日期
访问	令牌是否具有组织访问权限

只有对包含已泄露机密的存储库具有管理员权限的人员才能查看安全警报详细信息和警报的令牌元数据。 企业所有者可以出于此目的请求对存储库的临时访问权限。如果授予访问权限，GitHub 将通知包含已泄露机密的存储库的所有者，在存储库所有者和企业审核日志中报告该操作，并将访问权限启用 2 小时。

后续步骤

• “解决来自机密扫描的警报”