# Nhật ký kiểm toán

> [!WARNING]
> Tính năng này là một phần của các gói Team & Enterprise.

Audit Logs cho phép quản trị viên tổ chức dễ dàng xem xét các hành động được thực hiện bởi các thành viên, bao gồm việc quản lý thành viên tổ chức, cài đặt kho lưu trữ và các thay đổi về thanh toán.

  <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"
  />

## Truy cập Nhật ký Kiểm toán

Audit Logs có thể truy cập thông qua cài đặt tổ chức của bạn. Mỗi mục nhật ký bao gồm:

- Ai đã thực hiện hành động
- Loại hành động đã được thực hiện
- Mô tả về thay đổi
- Vị trí và địa chỉ IP đã ẩn danh
- Thời gian và ngày của hành động

Bạn cũng có thể tải xuống nhật ký kiểm toán hoàn chỉnh dưới dạng tệp JSON để phân tích thêm.

### Xuất qua API

Xuất theo chương trình có sẵn tại:

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

Xác thực bằng token truy cập của người dùng hoặc token tài khoản dịch vụ có quyền **Xuất nhật ký kiểm toán** (`org.auditLog.write`) cho tổ chức. Phản hồi là một mảng JSON chứa các mục nhật ký, giống hệt với tệp được tải xuống từ trang cài đặt. Giống như việc xuất thủ công, cuộc gọi API được ghi nhận là `org.audit_log.export`.

Endpoint này cũng được tài liệu hóa trong tham chiếu OpenAPI.

## Những Sự Kiện Nào Được Theo Dõi?

Mỗi hành động có một **tên sự kiện** ở định dạng `scope.action` (ví dụ: `repo.create`, `collection.delete`). Đây là trường `type` trong mỗi mục nhật ký và trong JSON đã xuất—sử dụng trường này khi tìm kiếm hoặc lọc nhật ký.

### Quản lý tổ chức & Bảo mật

  > [!TIP]
  > Các sự kiện **Thay đổi cài đặt** bên dưới chỉ khả dụng cho các hành động được thực hiện sau ngày 16 tháng 6 năm 2026. Các sự kiện trước ngày đó sử dụng loại sự kiện `org.update_settings` riêng biệt. Bất kỳ tích hợp nào lọc hoặc phân tích trường `type` của sự kiện cho các tổ chức được tạo trước ngày 16 tháng 6 năm 2026 đều phải xử lý cả hai.

- **Thay đổi tổ chức cốt lõi** — Tạo, xóa, khôi phục và đổi tên.
  - **Sự kiện:** `org.create`, `org.delete`, `org.restore`, `org.rename`
- **Thay đổi cài đặt** — Các cập nhật đối với cài đặt của tổ chức được ghi lại dưới dạng các sự kiện `org.settings.*` chi tiết, giúp bạn xác định chính xác cài đặt nào đã bị thay đổi.
  - Cài đặt chung — Hồ sơ, khu vực lưu trữ, nhóm tài nguyên và kiểm soát nhà phát hành.
  - **Sự kiện:** `org.settings.profile`, `org.settings.regions`, `org.settings.resource_groups`, `org.settings.publisher_gating`
  - Nhà cung cấp suy luận — Cấu hình nhà cung cấp, thêm/xóa khóa API và cài đặt sử dụng.
  - **Sự kiện:** `org.settings.inference_providers`, `org.settings.inference_providers.keys.add`, `org.settings.inference_providers.keys.remove`, `org.settings.inference_providers.usage`
  - SSO — cập nhật cấu hình SSO, và bật hoặc tắt SSO.
  - **Sự kiện:** `org.settings.sso`, `org.settings.sso.enable`, `org.settings.sso.disable`
  - Bảo mật — Hiển thị mặc định của kho lưu trữ, và việc bật hoặc tắt việc thực thi 2FA, tham gia tự động và quyền riêng tư của thành viên.
  - **Sự kiện:** `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 — Cập nhật cấu hình mạng, và bật hoặc tắt hạn chế truy cập IP và thực thi xác thực.
  - **Sự kiện:** `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`

  
- **Quản lý bảo mật**
  - Xoay vòng token API của tổ chức.
  - **Sự kiện:** `org.rotate_token`
  - Hệ thống phê duyệt token — Bật hoặc tắt chính sách, các yêu cầu ủy quyền, phê duyệt, từ chối và thu hồi.
  - **Sự kiện:** `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 — Đăng nhập và tham gia thông qua SSO.
  - **Các sự kiện:** `org.sso_login`, `org.sso_join`
- **Cài đặt tham gia** — Truy cập dựa trên tên miền và cấu hình tham gia tự động.
  - **Sự kiện:** `org.update_join_settings`

### Thành viên và Kiểm soát truy cập

- **Chu kỳ vòng đời thành viên** — Thêm và xóa thành viên, thay đổi vai trò, và thành viên rời khỏi tổ chức.
  - **Sự kiện:** `org.add_user`, `org.remove_user`, `org.change_role`, `org.leave`
- **Loại tài khoản** — Chuyển đổi một thành viên thành [người cộng tác bên ngoài](./security-sso-user-management#external-collaborators), hoặc chuyển ngược lại thành thành viên.
  - **Sự kiện:** `org.change_account_type`
- **Mời** — Gửi lời mời, liên kết mời qua email, và người dùng chấp nhận lời mời.
  - **Sự kiện:** `org.invite_user`, `org.invite.accept`, `org.invite.email`
- **Kết nối tự động** — Kết nối qua tên miền email đã xác minh hoặc “yêu cầu quyền truy cập”.
  - **Sự kiện:** `org.join.from_domain`, `org.join.automatic`

### Tài khoản dịch vụ

- **Chu kỳ sống của tài khoản dịch vụ**: Việc tạo và xóa tài khoản dịch vụ.
  - **Sự kiện:** `org.service_account.create`, `org.service_account.delete`
- **Token tài khoản dịch vụ**: Tạo, xóa, xoay vòng và cập nhật token (tên, quyền, ngoại lệ bảo mật mạng), cùng với việc tạo và thu hồi thông tin xác thực S3 được ghép cặp với token.
  - **Sự kiện:** `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`

### Ứng dụng OAuth

- **Quản lý ứng dụng OAuth** — Tạo, cập nhật (tên, URL, phạm vi hoặc thời hạn token) và xóa các [ứng dụng OAuth](./oauth#organization-owned-oauth-apps) thuộc sở hữu của tổ chức, bao gồm cả [ứng dụng Token Exchange](./oauth#token-exchange-for-organizations-rfc-8693) của tổ chức, và việc chuyển ứng dụng cá nhân của thành viên sang tổ chức. Các thay đổi logo không được ghi nhận.
  - **Sự kiện:** `oauth.app.create`, `oauth.app.update`, `oauth.app.delete`, `oauth.app.move`
- **Client secret** — Việc xoay vòng client secret (hoặc thêm một client secret vào ứng dụng công khai), việc xóa nó, và sự hết hạn của secret do Hugging Face thực hiện.
  - **Sự kiện:** `oauth.app.secret.rotate`, `oauth.app.secret.delete`, `oauth.app.secret.expire`
- **Phát hành token** — Các token được phát hành cho thành viên thông qua ứng dụng [Token Exchange](./oauth#token-exchange-for-organizations-rfc-8693) của tổ chức.
  - **Sự kiện:** `oauth.token`

### Quản lý nội dung và tài nguyên

- **Quản trị kho** — Tạo, xóa, di chuyển, vô hiệu hóa/khôi phục, sao chép cài đặt, xóa DOI, gán nhóm tài nguyên và các cài đặt chung của kho (tầm nhìn, kiểm soát truy cập, thảo luận, v.v.). Bao gồm cả việc xóa tệp LFS.
  - **Sự kiện:** `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`
- **Bộ sưu tập** — Tạo và xóa bộ sưu tập.
  - **Các sự kiện:** `collection.create`, `collection.delete`
- **Bảo mật kho** — Bí mật và biến (thêm/cập nhật/xóa từng cái và hàng loạt).
  - **Sự kiện (bí mật):** `repo.add_secret`, `repo.update_secret`, `repo.remove_secret`, `repo.add_secrets`, `repo.remove_secrets`
  - **Sự kiện (biến):** `repo.add_variable`, `repo.update_variable`, `repo.remove_variable`, `repo.add_variables`, `repo.remove_variables`
- **Cấu hình Spaces** — Thay đổi tầng lưu trữ, cập nhật phần cứng (flavor) và điều chỉnh thời gian ngủ.
  - **Sự kiện:** `spaces.add_storage`, `spaces.remove_storage`, `spaces.update_hardware`, `spaces.update_sleep_time`

### Nhóm tài nguyên

- **Quản trị nhóm tài nguyên** — Tạo, xóa và thay đổi cài đặt.
  - **Sự kiện:** `resource_group.create`, `resource_group.delete`, `resource_group.settings`
- **Thành viên nhóm tài nguyên** — Thêm và xóa người dùng, và thay đổi vai trò.
  - **Sự kiện:** `resource_group.add_users`, `resource_group.remove_users`, `resource_group.change_role`
- **Lời mời nhóm tài nguyên** — Mời người dùng từ bên ngoài tổ chức vào nhóm tài nguyên và thu hồi các lời mời đó.
  - **Sự kiện:** `resource_group.invite_user`, `resource_group.invite.revoke`

### Jobs và Scheduled Jobs

- **Các tác vụ** — Tạo (ví dụ trên một Space) và hủy tác vụ.
  - **Các sự kiện:** `jobs.create`, `jobs.cancel`
- **Công việc được lên lịch** — Tạo, xóa, tiếp tục, tạm dừng và kích hoạt các lần chạy.
  - **Sự kiện:** `scheduled_job.create`, `scheduled_job.delete`, `scheduled_job.resume`, `scheduled_job.suspend`, `scheduled_job.run`

### Hóa đơn và Tích hợp Cloud

- **Thanh toán và khách hàng** — Cập nhật, gắn và gỡ phương thức thanh toán; tạo tài khoản khách hàng.
  - **Sự kiện:** `billing.update_payment_method`, `billing.create_customer`, `billing.remove_payment_method`
- **Chợ ứng dụng đám mây** — liên kết/hủy liên kết và phê duyệt chợ ứng dụng trên AWS và GCP.
  - **Sự kiện:** `billing.aws_add`, `billing.aws_remove`, `billing.gcp_add`, `billing.gcp_remove`, `billing.marketplace_approve`
- **Gói đăng ký** — Bắt đầu, gia hạn, hủy, kích hoạt lại và cập nhật các gói đăng ký (bao gồm chi tiết gói và hợp đồng).
  - **Sự kiện:** `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`

## Tham chiếu sự kiện

Danh sách ở trên bao gồm mọi loại sự kiện được hiển thị trong giao diện nhật ký kiểm toán và tệp xuất. Tên sự kiện tuân theo mẫu `scope.action`; các phạm vi bao gồm `org`, `repo`, `collection`, `spaces`, `resource_group`, `jobs`, `scheduled_job`, `oauth` và `billing`. Bản thân hành động xuất được ghi nhận là `org.audit_log.export` nhưng sự kiện đó không được bao gồm trong chế độ xem nhật ký kiểm toán mặc định.