Nhật ký kiểm toán

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.

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

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.

• Core organization changes — Tạo, xóa, khôi phục và đổi tên.
  • Sự kiện: org.create, org.delete, org.restore, org.rename
• Settings changes — Các cập nhật đối với cài đặt tổ chức được ghi lại dưới dạng các sự kiện chi tiết org.settings.* để bạn có thể 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
• Security management
  • 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
• Join settings — 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

• Member lifecycle — 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
• Account type — Chuyển đổi một thành viên thành người cộng tác bên ngoài, hoặc chuyển lại thành thành viên.
  • Sự kiện: org.change_account_type
• Invitations — Gửi lời mời, liên kết lời 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
• Automatic joins — Tham gia thông qua tên miền email đã xác minh hoặc “yêu cầu truy cập”.
  • Sự kiện: org.join.from_domain, org.join.automatic

Tài khoản dịch vụ

• Service account lifecycle: Tạo và xóa tài khoản dịch vụ.
  • Sự kiện: org.service_account.create, org.service_account.delete
• Service account tokens: 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

• OAuth app management — Tạo, cập nhật (tên, URL, phạm vi hoặc thời hạn token) và xóa ứng dụng OAuth do tổ chức sở hữu, bao gồm cả ứng dụng Token Exchange, và việc chuyển ứng dụng cá nhân của thành viên sang tổ chức. Thay đổi logo không được ghi lại.
  • 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 cho ứ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
• Token issuance — Token được phát hành cho các thành viên thông qua Token Exchange của tổ chức.
  • Sự kiện: oauth.token

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

• Repository administration — Tạo, xóa, di chuyển, vô hiệu hóa/kích hoạt lại, cài đặt sao chép, 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
• Collections — Tạo và xóa các bộ sưu tập.
  • Các sự kiện: collection.create, collection.delete
• Repository security — Mật khẩu và biến (thêm/cập nhật/xóa từng cái hoặc 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
• Spaces configuration — 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

• Resource group administration — Tạo, xóa và thay đổi cài đặt.
  • Sự kiện: resource_group.create, resource_group.delete, resource_group.settings
• Resource group members — Thêm và xóa người dùng, cũng như thay đổi vai trò.
  • Sự kiện: resource_group.add_users, resource_group.remove_users, resource_group.change_role
• Resource group invitations — 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

• Jobs — Tạo (ví dụ trên một Space) và hủy Job.
  • Các sự kiện: jobs.create, jobs.cancel
• Scheduled jobs — 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

• Payment and customers — 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
• Cloud marketplaces — liên kết/gỡ liên kết và phê duyệt marketplace trên AWS và GCP.
  • Sự kiện: billing.aws_add, billing.aws_remove, billing.gcp_add, billing.gcp_remove, billing.marketplace_approve
• Subscriptions — 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.