감사 로그

이 기능은 Team & Enterprise 플랜의 일부입니다.

Audit Logs는 조직 관리자가 조직 멤버십, 저장소 설정 및 청구 변경을 포함하여 멤버가 수행한 작업을 쉽게 검토할 수 있도록 합니다.

감사 로그에 액세스

Audit Logs는 조직 설정을 통해 액세스할 수 있습니다. 각 로그 항목에는 다음이 포함됩니다:

• 행위를 수행한 주체
• 조치된 조치 유형
• 변경 사항에 대한 설명
• 위치 및 익명화된 IP 주소
• 작업의 날짜 및 시간

추가 분석을 위해 전체 감사 로그를 JSON 파일로 다운로드할 수도 있습니다.

API를 통한 내보내기

프로그램 기반 내보내기는 다음에서 사용할 수 있습니다:

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

조직에 대해 감사 로그 내보내기 권한(org.auditLog.write)이 있는 사용자 액세스 토큰 또는 서비스 계정 토큰으로 인증합니다. 응답은 설정 페이지에서 다운로드한 파일과 동일한 로그 항목의 JSON 배열입니다. 수동 내보내기와 마찬가지로, API 호출은 org.audit_log.export로 기록됩니다.

이 엔드포인트는 OpenAPI reference에도 문서화되어 있습니다.

어떤 이벤트가 추적됩니까?

각 작업에는 scope.action 형식의 이벤트 이름이 있습니다(예: repo.create, collection.delete). 이는 각 로그 항목 및 내보낸 JSON의 type 필드입니다. 로그를 검색하거나 필터링할 때 이 값을 사용하세요.

조직 관리 및 보안

아래의 Settings changes 이벤트는 2026년 6월 16일 이후에 수행된 작업에 대해서만 사용할 수 있습니다. 해당 날짜 이전의 이벤트는 고유한 org.update_settings 이벤트 유형을 사용합니다. 2026년 6월 16일 이전에 생성된 조직의 이벤트 type 필드를 필터링하거나 파싱하는 모든 통합은 두 가지 유형을 모두 처리해야 합니다.

• Core organization changes — 생성, 삭제, 복원 및 이름 변경.
  • 이벤트: org.create, org.delete, org.restore, org.rename
• Settings changes — 조직 설정 업데이트는 세분화된 org.settings.* 이벤트로 기록되므로, 정확히 어떤 설정이 변경되었는지 파악할 수 있습니다.
  • 일반 설정 — 프로필, 저장 영역, 리소스 그룹, 게시자 게이팅.
  • 이벤트: org.settings.profile, org.settings.regions, org.settings.resource_groups, org.settings.publisher_gating
  • Inference providers — Provider 설정, 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
  • Security — 기본 저장소 가시성, 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
• Security management
  • Organization 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를 통한 로그인 및 가입.
  • 이벤트: org.sso_login, org.sso_join
• Join settings — 도메인 기반 액세스 및 자동 가입 구성.
  • 이벤트: org.update_join_settings

멤버십 및 액세스 제어

• Member lifecycle — 멤버 추가 및 제거, 역할 변경, 조직 탈퇴.
  • 이벤트: org.add_user, org.remove_user, org.change_role, org.leave
• Account type — 멤버를 외부 협업자, 로 전환하거나 다시 멤버로 전환합니다.
  • 이벤트: org.change_account_type
• Invitations — 초대 보내기, 이메일로 초대 링크 전송, 사용자가 초대 수락하기.
  • 이벤트: org.invite_user, org.invite.accept, org.invite.email
• Automatic joins — 검증된 이메일 도메인 또는 "접근 요청"을 통한 가입.
  • 이벤트: org.join.from_domain, org.join.automatic

서비스 계정

• Service account lifecycle: 서비스 계정의 생성 및 삭제.
  • 이벤트: org.service_account.create, org.service_account.delete
• Service account tokens: 토큰 생성, 삭제, 로테이션 및 업데이트(이름, 권한, 네트워크 보안 예외)와 토큰에 연결된 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 app management — 조직이 소유한 OAuth 앱 의 생성, 업데이트(이름, URL, 스코프 또는 토큰 만료), 삭제, 그리고 Token Exchange 앱, 을 포함하며, 멤버의 개인 앱을 조직으로 이전하는 작업도 대상입니다. 로고 변경 사항은 기록되지 않습니다.
  • 이벤트: oauth.app.create, oauth.app.update, oauth.app.delete, oauth.app.move
• Client secret — 클라이언트 시크릿을 회전하거나(또는 공개 앱에 추가하거나), 삭제하거나, Hugging Face에 의해 시크릿이 만료되는 경우.
  • 이벤트: oauth.app.secret.rotate, oauth.app.secret.delete, oauth.app.secret.expire
• Token issuance — 조직의 Token Exchange 앱을 통해 멤버에게 발급된 토큰
  • 이벤트: oauth.token

콘텐츠 및 리소스 관리

• Repository administration — 생성, 삭제, 이동, 비활성화/재활성화, 복제 설정, 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
• Collections — 컬렉션 생성 및 삭제.
  • 이벤트: collection.create, collection.delete
• Repository security — Secrets 및 변수(개별 및 일괄 추가/업데이트/삭제).
  • 이벤트(시크릿): 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 configuration — 스토리지 티어 변경, 하드웨어(flavor) 업데이트, 수면 시간 조정.
  • 이벤트: spaces.add_storage, spaces.remove_storage, spaces.update_hardware, spaces.update_sleep_time

리소스 그룹

• Resource group administration — 생성, 삭제 및 설정 변경.
  • 이벤트: resource_group.create, resource_group.delete, resource_group.settings
• Resource group members — 사용자 추가 및 제거, 역할 변경.
  • 이벤트: resource_group.add_users, resource_group.remove_users, resource_group.change_role
• Resource group invitations — 조직 외부의 사용자를 리소스 그룹에 초대하고 해당 초대를 취소하는 방법입니다.
  • 이벤트: resource_group.invite_user, resource_group.invite.revoke

Jobs and Scheduled Jobs

• Jobs — Job 생성(예: Space에서) 및 취소.
  • 이벤트: jobs.create, jobs.cancel
• Scheduled jobs — 실행 생성, 삭제, 재개, 일시 정지 및 트리거.
  • 이벤트: scheduled_job.create, scheduled_job.delete, scheduled_job.resume, scheduled_job.suspend, scheduled_job.run

빌링 및 클라우드 통합

• Payment and customers — 결제 방법 업데이트, 연결 및 제거; 고객 계정 생성.
  • 이벤트: billing.update_payment_method, billing.create_customer, billing.remove_payment_method
• Cloud marketplaces — AWS 및 GCP 마켓플레이스 연결/연결 해제 및 마켓플레이스 승인.
  • 이벤트: billing.aws_add, billing.aws_remove, billing.gcp_add, billing.gcp_remove, billing.marketplace_approve
• Subscriptions — 구독 시작, 갱신, 취소, 재개 및 업데이트(플랜 및 계약 세부 정보 포함).
  • 이벤트: 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로 기록되지만, 해당 이벤트는 기본 감사 로그 뷰에 포함되지 않습니다.