Denetim Kayıtları

Bu özellik, Team & Enterprise planlarının bir parçasıdır.

Audit Logs, organizasyon yöneticilerinin, organizasyon üyeliği, depo ayarları ve faturalama değişiklikleri dahil olmak üzere üyeler tarafından gerçekleştirilen eylemleri kolayca incelemesini sağlar.

Denetim Kayıtlarına Erişim

Denetim Kayıtlarına organizasyon ayarlarınız üzerinden erişebilirsiniz. Her kayıt girişi şunları içerir:

• Eylemi kim gerçekleştirdi
• Hangi tür işlem gerçekleştirildi
• Değişikliğin açıklaması
• Konum ve anonimleştirilmiş IP adresi
• Eylemin tarihi ve saati

Ayrıca, daha fazla analiz için tam denetim günlüğünü bir JSON dosyası olarak da indirebilirsiniz.

API ile dışa aktarma

Programatik dışa aktarma şu adreste kullanılabilir:

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

Organizasyon için org.auditLog.write (Denetim günlüğünü dışa aktar) iznine sahip bir kullanıcı erişim belirteci veya hizmet hesabı belirteciyle kimlik doğrulaması yapın. Yanıt, ayarlar sayfasından indirilen dosya ile aynı olan, günlük girdilerinden oluşan bir JSON dizisidir. Manuel dışa aktarma gibi, API çağrısı org.audit_log.export olarak kaydedilir.

Uç nokta ayrıca OpenAPI referansında da belgelenmiştir.

Hangi Olaylar İzlenir?

Her eylemin scope.action biçiminde bir olay adı vardır (ör. repo.create, collection.delete). Bu, her günlük kaydında ve dışa aktarılan JSON'daki type alanıdır—günlükleri ararken veya filtrelerken bunu kullanın.

Organizasyon Yönetimi & Güvenlik

Aşağıdaki Ayar değişiklikleri olayları yalnızca 16 Haziran 2026 tarihinden sonra gerçekleştirilen eylemler için kullanılabilir. Bu tarihten önceki olaylar benzersiz bir org.update_settings olay türü kullanır. 16 Haziran 2026'dan önce oluşturulan organizasyonlar için olay type alanını filtreleyen veya ayrıştıran tüm entegrasyonlar her iki türü de ele almalıdır.

• Core organization changes — Oluşturma, silme, geri yükleme ve yeniden adlandırma.
  • Olaylar: org.create, org.delete, org.restore, org.rename
• Settings changes — Organizasyon ayarlarındaki güncellemeler, hangi ayarın değiştiğini tam olarak belirleyebilmeniz için ayrıntılı org.settings.* olayları olarak kaydedilir.
  • Genel ayarlar — Profil, depolama bölgeleri, kaynak grupları ve yayıncı kısıtlamaları.
  • Olaylar: org.settings.profile, org.settings.regions, org.settings.resource_groups, org.settings.publisher_gating
  • Çıkarım sağlayıcıları — Sağlayıcı yapılandırması, API anahtarı ekleme/kaldırma ve kullanım ayarları.
  • Olaylar: org.settings.inference_providers, org.settings.inference_providers.keys.add, org.settings.inference_providers.keys.remove, org.settings.inference_providers.usage
  • SSO — SSO yapılandırma güncellemeleri ve SSO'nun etkinleştirilmesi veya devre dışı bırakılması.
  • Olaylar: org.settings.sso, org.settings.sso.enable, org.settings.sso.disable
  • Güvenlik — Varsayılan depo görünürlüğü ve 2FA zorunluluğunun, otomatik katılımın ve üye gizliliğinin etkinleştirilmesi veya devre dışı bırakılması.
  • Olaylar: 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 — Ağ yapılandırması güncellemeleri ve IP erişim kısıtlaması ile kimlik doğrulama uygulamasının etkinleştirilmesi veya devre dışı bırakılması.
  • Olaylar: 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
  • Organizasyon API anahtarı döndürme.
  • Olay: org.rotate_token
  • Token onay sistemi — Politikayı etkinleştirme veya devre dışı bırakma, yetkilendirme istekleri, onaylar, retler ve iptaller.
  • Olaylar: 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 üzerinden oturum açma ve katılım.
  • Olaylar: org.sso_login, org.sso_join
• Join settings — Alan adı tabanlı erişim ve otomatik katılım yapılandırması.
  • Olay: org.update_join_settings

Üyelik ve Erişim Kontrolü

• Member lifecycle — Üye ekleme ve çıkarma, rol değişiklikleri ve üyelerin organizasyondan ayrılması.
  • Olaylar: org.add_user, org.remove_user, org.change_role, org.leave
• Account type — bir üyeyi dış işbirlikçisine, veya tekrar üyeye dönüştürme.
  • Olay: org.change_account_type
• Invitations — Davet gönderme, e-posta ile davet bağlantısı gönderme ve kullanıcıların davetleri kabul etmesi.
  • Olaylar: org.invite_user, org.invite.accept, org.invite.email
• Automatic joins — Doğrulanmış e-posta alanı veya "erişim iste" yoluyla katılım.
  • Olaylar: org.join.from_domain, org.join.automatic

Hizmet Hesapları

• Service account lifecycle: Hizmet hesaplarının oluşturulması ve silinmesi.
  • Olaylar: org.service_account.create, org.service_account.delete
• Service account tokens: Token oluşturma, silme, döndürme ve güncelleme (ad, izinler, ağ güvenliği muafiyeti) ile bir token'a eşleştirilen S3 kimlik bilgileri için üretim ve iptal işlemleri.
  • Olaylar: 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 Uygulamaları

• OAuth app management — oluşturma, güncelleme (ad, URL'ler, kapsamlar veya token süresi dolma) ve silme işlemleri OAuth uygulamalarının organizasyona ait olan, bunların arasında Token Exchange uygulaması, ve bir üyenin kişisel uygulamasının organizasyona aktarımı. Logo değişiklikleri kaydedilmez.
  • Olaylar: oauth.app.create, oauth.app.update, oauth.app.delete, oauth.app.move
• Client secret — İstemci gizli anahtarının döndürülmesi (veya herkese açık bir uygulamaya eklenmesi), kaldırılması ve Hugging Face tarafından gizli anahtarın süresinin dolması.
  • Olaylar: oauth.app.secret.rotate, oauth.app.secret.delete, oauth.app.secret.expire
• Token issuance — Organizasyonun Token Exchange uygulaması üzerinden üyelere dağıtılan tokenlar.
  • Olay: oauth.token

İçerik ve Kaynak Yönetimi

• Repository administration — Oluşturma, silme, taşıma, devre dışı bırakma/yeniden etkinleştirme, çoğaltma ayarları, DOI kaldırma, kaynak grubu atama ve genel depo ayarları (görünürlük, kapı, tartışmalar vb.). Ayrıca LFS dosyası silme.
  • Olaylar: 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 — Koleksiyonların oluşturulması ve silinmesi.
  • Olaylar: collection.create, collection.delete
• Repository security — Gizli anahtarlar ve değişkenler (bireysel ve toplu ekleme/güncelleme/silme).
  • Olaylar (gizli bilgiler): repo.add_secret, repo.update_secret, repo.remove_secret, repo.add_secrets, repo.remove_secrets
  • Olaylar (değişkenler): repo.add_variable, repo.update_variable, repo.remove_variable, repo.add_variables, repo.remove_variables
• Spaces configuration — Depolama katmanı değişiklikleri, donanım (flavor) güncellemeleri ve uyku süresi ayarları.
  • Olaylar: spaces.add_storage, spaces.remove_storage, spaces.update_hardware, spaces.update_sleep_time

Kaynak Grupları

• Resource group administration — Oluşturma, silme ve ayar değişiklikleri.
  • Olaylar: resource_group.create, resource_group.delete, resource_group.settings
• Resource group members — Kullanıcıların eklenip çıkarılması ve rol değişiklikleri.
  • Olaylar: resource_group.add_users, resource_group.remove_users, resource_group.change_role
• Resource group invitations — Kullanıcıları organizasyon dışından bir kaynak grubuna davet etme ve bu davetleri iptal etme.
  • Olaylar: resource_group.invite_user, resource_group.invite.revoke

İşler ve Zamanlanmış İşler

• Jobs — İş oluşturma (ör. bir Space üzerinde) ve iptal etme.
  • Olaylar: jobs.create, jobs.cancel
• Scheduled jobs — Çalıştırmaların oluşturulması, silinmesi, yeniden başlatılması, askıya alınması ve tetiklenmesi.
  • Olaylar: scheduled_job.create, scheduled_job.delete, scheduled_job.resume, scheduled_job.suspend, scheduled_job.run

Faturalama ve Bulut Entegrasyonu

• Payment and customers — Ödeme yöntemi güncellemeleri, eklenmesi ve kaldırılması; müşteri hesabı oluşturma.
  • Olaylar: billing.update_payment_method, billing.create_customer, billing.remove_payment_method
• Cloud marketplaces — AWS ve GCP marketplace bağlantısı/kurulumu ve marketplace onayı.
  • Olaylar: billing.aws_add, billing.aws_remove, billing.gcp_add, billing.gcp_remove, billing.marketplace_approve
• Subscriptions — Aboneliklerin başlatılması, yenilenmesi, iptal edilmesi, yeniden etkinleştirilmesi ve güncellenmesi (plan ve sözleşme ayrıntıları dahil).
  • Olaylar: 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

Olay referansı

Yukarıdaki liste, denetim günlüğü arayüzünde ve dışa aktarmada gösterilen tüm olay türlerini kapsar. Olay adları scope.action kalıbını izler; kapsamlar arasında org, repo, collection, spaces, resource_group, jobs, scheduled_job, oauth ve billing bulunur. Dışa aktarma işlemi kendisi org.audit_log.export olarak kaydedilir ancak bu olay varsayılan denetim günlüğü görünümünde yer almaz.