# 审计日志

> [!WARNING]
> 此功能包含在 Team & Enterprise 套餐中。

Audit Logs 允许组织管理员轻松查看成员执行的操作，包括组织成员资格、仓库设置和计费变更。

  <img
    class="block dark:hidden m-0!"
    src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/enterprise/audit-logs.png"
    alt="screenshot of Hugging Face Audit Logs feature"
  />
  <img
    class="hidden dark:block m-0!"
    src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/enterprise/dark-audit-logs.png"
    alt="screenshot of Hugging Face Audit Logs feature"
  />

## 访问审计日志

审计日志可通过您的组织设置访问。每条日志条目包含：

- 执行该操作的人
- 采取了何种类型的操作
- 更改的描述
- 位置和匿名化 IP 地址
- 操作日期和时间

您还可以将完整的审计日志下载为 JSON 文件，以便进一步分析。

### 通过 API 导出

编程式导出功能可在以下位置获取：

```
GET https://huggingface.co/api/organizations/{org}/audit-log/export
```

请使用具有 **导出审计日志** 权限（`org.auditLog.write`）的用户访问令牌或服务账号令牌进行身份验证。响应为日志条目的 JSON 数组，与从设置页面下载的文件完全相同。与手动导出一样，该 API 调用会被记录为 `org.audit_log.export`。

该端点也在 OpenAPI 参考文档中有说明。

## 会跟踪哪些事件？

每个操作都有一个 **事件名称**，格式为 `scope.action`（例如 `repo.create`、`collection.delete`）。这是每条日志条目以及导出的 JSON 中的 `type` 字段——在搜索或筛选日志时请使用该字段。

### 组织管理与安全

  > [!TIP]
  > 以下 **Settings changes** 事件仅适用于 2026 年 6 月 16 日之后执行的操作。该日期之前的事件使用唯一的 `org.update_settings` 事件类型。任何针对 2026 年 6 月 16 日之前创建的组织过滤或解析事件 `type` 字段的集成，都应同时处理这两种类型。

- **核心组织变更** — 创建、删除、恢复和重命名。
  - **事件：** `org.create`、`org.delete`、`org.restore`、`org.rename`
- **设置更改** — 对组织设置的更新会记录为细粒度的 `org.settings.*` 事件，因此您可以准确定位具体更改了哪项设置。
  - 通用设置 — 个人资料、存储区域、资源组和发布者门控。
  - **事件：** `org.settings.profile`、`org.settings.regions`、`org.settings.resource_groups`、`org.settings.publisher_gating`
  - 推理提供商 — 提供商配置、API 密钥的添加/移除以及使用设置。
  - **事件：** `org.settings.inference_providers`、`org.settings.inference_providers.keys.add`、`org.settings.inference_providers.keys.remove`、`org.settings.inference_providers.usage`
  - SSO — SSO 配置更新，以及启用或禁用 SSO。
  - **事件：** `org.settings.sso`、`org.settings.sso.enable`、`org.settings.sso.disable`
  - 安全 — 默认仓库可见性，以及启用或禁用 2FA 强制验证、自动加入和成员隐私设置。
  - **事件：** `org.settings.security.repo_visibility`、`org.settings.security.2fa.enable`、`org.settings.security.2fa.disable`、`org.settings.security.auto_join.enable`、`org.settings.security.auto_join.disable`、`org.settings.security.members_privacy.enable`、`org.settings.security.members_privacy.disable`
  - Network — 网络配置更新，以及启用或禁用 IP 访问限制和身份验证强制。
  - **事件：** `org.settings.network`、`org.settings.network.ip_restriction.enable`、`org.settings.network.ip_restriction.disable`、`org.settings.network.auth_enforcement.enable`、`org.settings.network.auth_enforcement.disable`

  
- **安全管理**
  - 组织 API 令牌轮换。
  - **事件：** `org.rotate_token`
  - Token 审批系统 — 启用或禁用策略、授权请求、批准、拒绝以及撤销。
  - **事件：** `org.token_approval.enabled`、`org.token_approval.disabled`、`org.token_approval.authorization_request`、`org.token_approval.authorization_request.authorized`、`org.token_approval.authorization_request.revoked`、`org.token_approval.authorization_request.denied`
  - SSO — 通过 SSO 进行登录和加入，以及成员授权或取消授权其访问令牌和 SSH 密钥。
  - **事件：** `org.sso_login`、`org.sso_join`、`org.sso_credential.authorize`、`org.sso_credential.deauthorize`
- **加入设置** — 基于域名的访问和自动加入配置。
  - **事件：** `org.update_join_settings`

### 成员资格与访问控制

- **成员生命周期** — 添加和移除成员、角色变更以及成员离开组织。
  - **事件：** `org.add_user`、`org.remove_user`、`org.change_role`、`org.leave`
- **账户类型** — 将成员转换为 [外部协作者](./security-sso-user-management#external-collaborators)，或将其转换回成员。
  - **事件：** `org.change_account_type`
- **邀请** — 发送邀请、通过电子邮件发送邀请链接，以及用户接受邀请。
  - **事件：** `org.invite_user`、`org.invite.accept`、`org.invite.email`
- **自动加入** — 通过已验证的邮箱域名或“申请访问”加入。
  - **事件：** `org.join.from_domain`、`org.join.automatic`

### 服务账号

- **服务账号生命周期**：服务账号的创建和删除。
  - **事件：** `org.service_account.create`、`org.service_account.delete`
- **服务账号令牌**：令牌的创建、删除、轮换和更新（名称、权限、网络安全豁免），以及与令牌配对的 S3 凭证的生成和撤销。
  - **事件：** `org.service_account.token.create`、`org.service_account.token.delete`、`org.service_account.token.rotate`、`org.service_account.token.update`、`org.service_account.token.s3_credential.create`、`org.service_account.token.s3_credential.delete`

### OAuth 应用

- **OAuth 应用管理** — 创建、更新（名称、URL、权限范围或令牌过期时间）以及删除组织拥有的 [OAuth 应用](./oauth#organization-owned-oauth-apps)，包括其 [Token Exchange 应用](./oauth#token-exchange-for-organizations-rfc-8693)，以及将成员的个人应用转移至组织。Logo 的更改不会被记录。
  - **事件：** `oauth.app.create`、`oauth.app.update`、`oauth.app.delete`、`oauth.app.move`
- **客户端密钥** — 轮换客户端密钥（或为公开应用添加密钥）、删除密钥，以及 Hugging Face 使密钥过期。
  - **事件：** `oauth.app.secret.rotate`、`oauth.app.secret.delete`、`oauth.app.secret.expire`
- **令牌颁发** — 通过组织的 [Token Exchange](./oauth#token-exchange-for-organizations-rfc-8693) 应用颁发给成员的令牌。
  - **事件：** `oauth.token`

### 内容和资源管理

- **仓库管理** — 创建、删除、移动、禁用/重新启用、复制设置、DOI 移除、资源组分配以及通用仓库设置（可见性、门控、讨论等）。还包括 LFS 文件删除。
  - **事件：** `repo.create`、`repo.delete`、`repo.move`、`repo.disable`、`repo.removeDisable`、`repo.duplication`、`repo.delete_doi`、`repo.update_resource_group`、`repo.update_settings`、`repo.delete_lfs_file`
- **集合** — 集合的创建和删除。
  - **事件：** `collection.create`、`collection.delete`
- **仓库安全** — 密钥和变量（单个及批量添加/更新/删除）。
  - **事件（密钥）：** `repo.add_secret`、`repo.update_secret`、`repo.remove_secret`、`repo.add_secrets`、`repo.remove_secrets`
  - **事件（变量）：** `repo.add_variable`、`repo.update_variable`、`repo.remove_variable`、`repo.add_variables`、`repo.remove_variables`
- **Spaces 配置** — 存储层级变更、硬件（flavor）更新以及休眠时间调整。
  - **事件：** `spaces.add_storage`、`spaces.remove_storage`、`spaces.update_hardware`、`spaces.update_sleep_time`

### 资源组

- **资源组管理** — 创建、删除和设置更改。
  - **事件：** `resource_group.create`、`resource_group.delete`、`resource_group.settings`
- **资源组成员** — 添加和移除用户，以及角色变更。
  - **事件：** `resource_group.add_users`、`resource_group.remove_users`、`resource_group.change_role`
- **资源组邀请** — 将组织外部的用户邀请到资源组中，以及撤销这些邀请。
  - **事件：** `resource_group.invite_user`、`resource_group.invite.revoke`

### 作业和计划作业

- **任务** — 任务创建（例如在 Space 上）和取消。
  - **事件：** `jobs.create`、`jobs.cancel`
- **计划任务** — 创建、删除、恢复、暂停和触发运行。
  - **事件：** `scheduled_job.create`、`scheduled_job.delete`、`scheduled_job.resume`、`scheduled_job.suspend`、`scheduled_job.run`

### 账单与云集成

- **付款与客户** — 更新、添加和移除付款方式；创建客户账户。
  - **事件：** `billing.update_payment_method`、`billing.create_customer`、`billing.remove_payment_method`
- **云市场** — AWS 和 GCP 市场的关联/取消关联以及市场审批。
  - **事件：** `billing.aws_add`、`billing.aws_remove`、`billing.gcp_add`、`billing.gcp_remove`、`billing.marketplace_approve`
- **订阅** — 开始、续订、取消、重新激活和更新订阅（包括套餐和合同详情）。
  - **事件：** `billing.start_subscription`、`billing.renew_subscription`、`billing.cancel_subscription`、`billing.un_cancel_subscription`、`billing.update_subscription`、`billing.update_subscription_plan`、`billing.update_subscription_contract_details`

## 事件参考

上述列表涵盖了审计日志 UI 和导出中显示的所有事件类型。事件名称遵循 `scope.action` 模式；作用域包括 `org`、`repo`、`collection`、`spaces`、`resource_group`、`jobs`、`scheduled_job`、`oauth` 和 `billing`。导出操作本身被记录为 `org.audit_log.export`，但该事件不包含在默认审计日志视图中。

