是否可以通过 API 检索 github.com 中的审计日志？

Question

我在 API 文档中没有发现任何内容，只有企业版提到您可以使用人员工具检索审计日志。

任何的想法？ 我想定期检查审核日志并将新条目发送到我们的 IM 频道 (ChatOps)。

提前致谢，

Answer 1

正如VonC指出的那样，没有 API（截至 2017 年 10 月）。

不幸的是，GitHub 审核日志中的“导出”功能会生成审核事件的 JSON 或 CSV，但数据缺少包含详细信息的有效负载。

例如，导出将显示已进行issue_comment.update ，但 Web UI 会提供指向评论本身的链接。 导出将显示一个用户对另一个用户执行了org.update_member ，但 Web UI 将显示为该用户所做的角色更改。

要获取每个事件的详细信息，目前（2017 年 10 月），唯一的方法是通过 Web UI。

这是一个 ruby​​ 工具，它可以抓取 Web UI，获取带有详细信息的审核日志条目。

Answer 2

2020 年 12 月更新，5 年后：

审计日志 Git 事件和 REST API 现已可用

^{（在有限的公开测试版中）}

在 GitHub Enterprise Cloud 中，审计日志现在包含 Git 事件并具有新的 REST API。
两者都作为有限的公开测试版提供。

新的 Git 事件将允许您作为管理员查看与您的 Git 存储库交互的用户的活动。
您可以查看git.clone 、 git.fetch和git.push 。

此外，新的 REST API 为您提供了另一种与审核日志事件交互的选项。 在有限公测期间，Git 事件只能通过 REST API 查看并可以导出。

你如何获得这个有限的公开测试版？ 要添加到有限公开测试版，请联系销售或支持。

---

2021 年 2 月，仍然适用于 GHE（企业版 GitHub）：

GitHub 操作：工作流运行事件现在包含在审核日志中

审计日志现在包括与 GitHub 操作工作流运行相关的事件。
这些数据为企业客户提供了一个大大扩展的数据集，用于安全和合规审计。

在以下情况下，新事件将合并到审核日志中：

• 创建、完成、删除或重新运行工作流运行
• 准备工作流作业。 重要的是，这项工作将包括提供给跑步者的秘密列表
• 自托管运行器的版本已更新

这些新活动仅适用于企业计划的客户。 所有事件都在 REST API 中可用，并且除工作流运行已创建、工作流运行已完成和工作流作业已准备之外的所有事件都可在 UI 和导出中使用。

了解有关审核日志事件的更多信息

---

2015 年：尚无法通过 GitHub API 实现。

但至少，可以以 JSON 或 CSV 格式导出它（ 自 2015 年 5 月 5 日起）。

请参阅“ 导出审核日志”。