Log Audit

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.

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

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.

• Core organization changes — Pembuatan, penghapusan, pemulihan, dan penggantian nama.
  • Peristiwa: org.create, org.delete, org.restore, org.rename
• Settings changes — Pembaruan pada pengaturan organisasi dicatat sebagai org.settings.* event 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
• Security management
  • 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 — Masuk dan bergabung melalui SSO.
  • Peristiwa: org.sso_login, org.sso_join
• Join settings — Akses berbasis domain dan konfigurasi join otomatis.
  • Peristiwa: org.update_join_settings

Keanggotaan dan Kontrol Akses

• Member lifecycle — Menambahkan dan menghapus anggota, perubahan peran, dan anggota yang keluar dari organisasi.
  • Peristiwa: org.add_user, org.remove_user, org.change_role, org.leave
• Account type — Mengubah anggota menjadi kolaborator eksternal, atau kembali menjadi anggota.
  • Peristiwa: org.change_account_type
• Invitations — Mengirim undangan, tautan undangan melalui email, dan pengguna yang menerima undangan.
  • Peristiwa: org.invite_user, org.invite.accept, org.invite.email
• Automatic joins — Gabungan melalui domain email terverifikasi atau “minta akses”.
  • Peristiwa: org.join.from_domain, org.join.automatic

Akun Layanan

• Service account lifecycle: Pembuatan dan penghapusan service account.
  • Peristiwa: org.service_account.create, org.service_account.delete
• Service account tokens: 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

• OAuth app management — Pembuatan, pembaruan (nama, URL, scope, atau kedaluwarsa token), dan penghapusan aplikasi OAuth yang dimiliki oleh organisasi, termasuk aplikasi Token Exchange, dan transfer aplikasi pribadi anggota ke organisasi. Perubahan logo tidak dicatat.
  • Peristiwa: oauth.app.create, oauth.app.update, oauth.app.delete, oauth.app.move
• Client secret — Rotasi client secret (atau penambahan client secret ke aplikasi publik), penghapusannya, dan kedaluwarsa secret oleh Hugging Face.
  • Peristiwa: oauth.app.secret.rotate, oauth.app.secret.delete, oauth.app.secret.expire
• Token issuance — Token yang diterbitkan kepada anggota melalui Token Exchange aplikasi organisasi.
  • Peristiwa: oauth.token

Manajemen Konten dan Sumber Daya

• Repository administration — Pembuatan, penghapusan, pemindahan, penonaktifan/pengaktifan kembali, pengaturan duplikasi, penghapusan DOI, penugasan grup sumber daya, dan pengaturan umum repo (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
• Collections — Pembuatan dan penghapusan koleksi.
  • Peristiwa: collection.create, collection.delete
• Repository security — Secrets dan variabel (tambah/perbarui/hapus secara individual maupun 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
• Spaces configuration — 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

• Resource group administration — Pembuatan, penghapusan, dan perubahan pengaturan.
  • Peristiwa: resource_group.create, resource_group.delete, resource_group.settings
• Resource group members — Menambahkan dan menghapus pengguna, serta perubahan peran.
  • Peristiwa: resource_group.add_users, resource_group.remove_users, resource_group.change_role
• Resource group invitations — Mengundang pengguna dari luar organisasi ke dalam resource group, serta 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
• Scheduled jobs — 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

• Payment and customers — Pembaruan, penempelan, dan penghapusan metode pembayaran; pembuatan akun pelanggan.
  • Peristiwa: billing.update_payment_method, billing.create_customer, billing.remove_payment_method
• Cloud marketplaces — Tautan/pelepasan tautan dan persetujuan marketplace untuk AWS dan GCP.
  • Peristiwa: billing.aws_add, billing.aws_remove, billing.gcp_add, billing.gcp_remove, billing.marketplace_approve
• Subscriptions — 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.