# Log Audit

> [!WARNING]
> Fitur ini merupakan bagian dari paket Team & Enterprise.

Audit Logs memungkinkan admin organisasi untuk dengan mudah meninjau tindakan yang dilakukan oleh anggota, termasuk keanggotaan organisasi, pengaturan repositori, dan perubahan penagihan.

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

## Mengakses Log Audit

Audit Logs dapat diakses melalui pengaturan organisasi Anda. Setiap entri log mencakup:

- Siapa yang melakukan tindakan
- Jenis tindakan yang diambil
- Deskripsi perubahan
- Lokasi dan alamat IP yang dianonimkan
- Tanggal dan waktu tindakan

Anda juga dapat mengunduh log audit lengkap sebagai file JSON untuk analisis lebih lanjut.

### Ekspor melalui API

Ekspor programatik tersedia di:

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

Autentikasi dengan token akses pengguna atau token akun layanan yang memiliki izin **Export the audit log** (`org.auditLog.write`) untuk organisasi. Responsnya adalah array JSON berisi entri log, identik dengan file yang diunduh dari halaman pengaturan. Seperti ekspor manual, panggilan API dicatat sebagai `org.audit_log.export`.

Endpoint ini juga didokumentasikan dalam referensi OpenAPI.

## Event Apa yang Dilacak?

Setiap aksi memiliki **nama event** dalam format `scope.action` (misalnya `repo.create`, `collection.delete`). Ini adalah field `type` di setiap entri log dan dalam JSON yang diekspor—gunakan ini saat mencari atau memfilter log.

### Manajemen Organisasi & Keamanan

  > [!TIP]
  > Peristiwa **Perubahan Pengaturan** di bawah ini hanya tersedia untuk tindakan yang dilakukan setelah 16 Juni 2026. Peristiwa sebelum tanggal tersebut menggunakan tipe peristiwa `org.update_settings` yang unik. Integrasi mana pun yang memfilter atau mengurai bidang `type` peristiwa untuk organisasi yang dibuat sebelum 16 Juni 2026, harus menangani keduanya.

- **Perubahan organisasi inti** — Pembuatan, penghapusan, pemulihan, dan penggantian nama.
  - **Peristiwa:** `org.create`, `org.delete`, `org.restore`, `org.rename`
- **Perubahan pengaturan** — Pembaruan pada pengaturan organisasi dicatat sebagai peristiwa `org.settings.*` yang terperinci, sehingga Anda dapat mengidentifikasi secara tepat pengaturan mana yang berubah.
  - Pengaturan umum — Profil, wilayah penyimpanan, grup sumber daya, dan pembatasan penerbit.
  - **Peristiwa:** `org.settings.profile`, `org.settings.regions`, `org.settings.resource_groups`, `org.settings.publisher_gating`
  - Penyedia inferensi — Konfigurasi penyedia, penambahan/penghapusan kunci API, dan pengaturan penggunaan.
  - **Peristiwa:** `org.settings.inference_providers`, `org.settings.inference_providers.keys.add`, `org.settings.inference_providers.keys.remove`, `org.settings.inference_providers.usage`
  - SSO — pembaruan konfigurasi SSO, serta mengaktifkan atau menonaktifkan SSO.
  - **Peristiwa:** `org.settings.sso`, `org.settings.sso.enable`, `org.settings.sso.disable`
  - Keamanan — Visibilitas repositori default, serta mengaktifkan atau menonaktifkan penegakan 2FA, bergabung otomatis, dan privasi anggota.
  - **Peristiwa:** `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 — Pembaruan konfigurasi jaringan, serta mengaktifkan atau menonaktifkan pembatasan akses IP dan penegakan autentikasi.
  - **Peristiwa:** `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`

  
- **Manajemen keamanan**
  - Rotasi token API Organisasi.
  - **Peristiwa:** `org.rotate_token`
  - Sistem persetujuan token — Mengaktifkan atau menonaktifkan kebijakan, permintaan otorisasi, persetujuan, penolakan, dan pencabutan.
  - **Peristiwa:** `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 — Login dan bergabung melalui SSO, serta anggota yang mengotorisasi atau mencabut otorisasi token akses dan kunci SSH mereka.
  - **Peristiwa:** `org.sso_login`, `org.sso_join`, `org.sso_credential.authorize`, `org.sso_credential.deauthorize`
- **Pengaturan bergabung** — Akses berbasis domain dan konfigurasi bergabung otomatis.
  - **Peristiwa:** `org.update_join_settings`

### Keanggotaan dan Kontrol Akses

- **Siklus hidup anggota** — Menambahkan dan menghapus anggota, perubahan peran, dan anggota yang keluar dari organisasi.
  - **Peristiwa:** `org.add_user`, `org.remove_user`, `org.change_role`, `org.leave`
- **Jenis akun** — Mengubah anggota menjadi [kolaborator eksternal](./security-sso-user-management#external-collaborators), atau kembali menjadi anggota.
  - **Peristiwa:** `org.change_account_type`
- **Undangan** — Mengirim undangan, tautan undangan melalui email, dan pengguna menerima undangan.
  - **Peristiwa:** `org.invite_user`, `org.invite.accept`, `org.invite.email`
- **Penggabungan otomatis** — Penggabungan melalui domain email terverifikasi atau “minta akses”.
  - **Peristiwa:** `org.join.from_domain`, `org.join.automatic`

### Akun Layanan

- **Siklus hidup akun layanan**: Pembuatan dan penghapusan akun layanan.
  - **Peristiwa:** `org.service_account.create`, `org.service_account.delete`
- **Token akun layanan**: Pembuatan, penghapusan, rotasi, dan pembaruan token (nama, izin, pengecualian keamanan jaringan), serta pembuatan dan pencabutan kredensial S3 yang berpasangan dengan token.
  - **Peristiwa:** `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`

### Aplikasi OAuth

- **Manajemen aplikasi OAuth** — Pembuatan, pembaruan (nama, URL, cakupan, atau kedaluwarsa token), dan penghapusan [aplikasi OAuth](./oauth#organization-owned-oauth-apps) yang dimiliki organisasi, termasuk [aplikasi Token Exchange](./oauth#token-exchange-for-organizations-rfc-8693) miliknya, serta transfer aplikasi pribadi anggota ke organisasi. Perubahan logo tidak dicatat.
  - **Peristiwa:** `oauth.app.create`, `oauth.app.update`, `oauth.app.delete`, `oauth.app.move`
- **Rahasia klien** — Rotasi rahasia klien (atau penambahan satu pada aplikasi publik), penghapusannya, dan kedaluwarsa rahasia oleh Hugging Face.
  - **Peristiwa:** `oauth.app.secret.rotate`, `oauth.app.secret.delete`, `oauth.app.secret.expire`
- **Penerbitan token** — Token yang diterbitkan kepada anggota melalui aplikasi [Token Exchange](./oauth#token-exchange-for-organizations-rfc-8693) organisasi.
  - **Peristiwa:** `oauth.token`

### Manajemen Konten dan Sumber Daya

- **Administrasi repositori** — Pembuatan, penghapusan, pemindahan, penonaktifan/pengaktifan kembali, pengaturan duplikasi, penghapusan DOI, penugasan grup sumber daya, dan pengaturan repositori secara umum (visibilitas, gating, diskusi, dll.). Juga penghapusan file LFS.
  - **Peristiwa:** `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`
- **Koleksi** — Pembuatan dan penghapusan koleksi.
  - **Peristiwa:** `collection.create`, `collection.delete`
- **Keamanan repositori** — Secrets dan variabel (tambah/perbarui/hapus secara individual dan massal).
  - **Peristiwa (rahasia):** `repo.add_secret`, `repo.update_secret`, `repo.remove_secret`, `repo.add_secrets`, `repo.remove_secrets`
  - **Peristiwa (variabel):** `repo.add_variable`, `repo.update_variable`, `repo.remove_variable`, `repo.add_variables`, `repo.remove_variables`
- **Konfigurasi Spaces** — Perubahan tier penyimpanan, pembaruan perangkat keras (flavor), dan penyesuaian waktu tidur.
  - **Peristiwa:** `spaces.add_storage`, `spaces.remove_storage`, `spaces.update_hardware`, `spaces.update_sleep_time`

### Grup Sumber Daya

- **Administrasi grup sumber daya** — Pembuatan, penghapusan, dan perubahan pengaturan.
  - **Peristiwa:** `resource_group.create`, `resource_group.delete`, `resource_group.settings`
- **Anggota grup sumber daya** — Menambahkan dan menghapus pengguna, serta perubahan peran.
  - **Peristiwa:** `resource_group.add_users`, `resource_group.remove_users`, `resource_group.change_role`
- **Undangan grup sumber daya** — Mengundang pengguna dari luar organisasi ke grup sumber daya, dan mencabut undangan tersebut.
  - **Peristiwa:** `resource_group.invite_user`, `resource_group.invite.revoke`

### Jobs dan Jobs Terjadwal

- **Jobs** — Pembuatan (misalnya di Space) dan pembatalan job.
  - **Peristiwa:** `jobs.create`, `jobs.cancel`
- **Job terjadwal** — Membuat, menghapus, melanjutkan, menangguhkan, dan memicu eksekusi.
  - **Peristiwa:** `scheduled_job.create`, `scheduled_job.delete`, `scheduled_job.resume`, `scheduled_job.suspend`, `scheduled_job.run`

### Penagihan dan Integrasi Cloud

- **Pembayaran dan pelanggan** — Pembaruan, penempelan, dan penghapusan metode pembayaran; pembuatan akun pelanggan.
  - **Peristiwa:** `billing.update_payment_method`, `billing.create_customer`, `billing.remove_payment_method`
- **Marketplace cloud** — tautan/pelepasan tautan marketplace AWS dan GCP serta persetujuan marketplace.
  - **Peristiwa:** `billing.aws_add`, `billing.aws_remove`, `billing.gcp_add`, `billing.gcp_remove`, `billing.marketplace_approve`
- **Langganan** — Memulai, memperbarui, membatalkan, mengaktifkan kembali, dan memperbarui langganan (termasuk detail paket dan kontrak).
  - **Peristiwa:** `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`

## Referensi event

Daftar di atas mencakup setiap jenis event yang ditampilkan di UI dan ekspor log audit. Nama event mengikuti pola `scope.action`; scope mencakup `org`, `repo`, `collection`, `spaces`, `resource_group`, `jobs`, `scheduled_job`, `oauth`, dan `billing`. Aksi ekspor itu sendiri dicatat sebagai `org.audit_log.export` tetapi event tersebut tidak disertakan dalam tampilan log audit default.