# Denetim Kayıtları

> [!WARNING]
> 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.

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

## 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

  > [!TIP]
  > 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.

- **Çekirdek organizasyon değişiklikleri** — Oluşturma, silme, geri yükleme ve yeniden adlandırma.
  - **Olaylar:** `org.create`, `org.delete`, `org.restore`, `org.rename`
- **Ayar değişiklikleri** — Organizasyon ayarlarındaki güncellemeler, hangi ayarın değiştiğini tam olarak belirleyebilmeniz için ince 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`

  
- **Güvenlik yönetimi**
  - 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`
- **Birleşme ayarları** — Alan adı tabanlı erişim ve otomatik birleşme yapılandırması.
  - **Olay:** `org.update_join_settings`

### Üyelik ve Erişim Kontrolü

- **Üye yaşam döngüsü** — Üyelerin eklenmesi ve kaldırılması, rol değişiklikleri ve üyelerin organizasyondan ayrılması.
  - **Olaylar:** `org.add_user`, `org.remove_user`, `org.change_role`, `org.leave`
- **Hesap türü** — Bir üyeyi [dış işbirlikçisi](./security-sso-user-management#external-collaborators) olarak dönüştürme veya tekrar üyeye çevirme.
  - **Olay:** `org.change_account_type`
- **Davetler** — Davet gönderme, e-posta ile davet bağlantıları ve kullanıcıların davetleri kabul etmesi.
  - **Olaylar:** `org.invite_user`, `org.invite.accept`, `org.invite.email`
- **Otomatik birleşmeler** — Doğrulanmış e-posta alanı veya “erişim iste” yoluyla birleşmeler.
  - **Olaylar:** `org.join.from_domain`, `org.join.automatic`

### Hizmet Hesapları

- **Hizmet hesabı yaşam döngüsü**: Hizmet hesaplarının oluşturulması ve silinmesi.
  - **Olaylar:** `org.service_account.create`, `org.service_account.delete`
- **Hizmet hesabı belirteçleri**: Belirteç oluşturma, silme, döndürme ve güncelleme (ad, izinler, ağ güvenliği muafiyeti) ile bir belirteçle eşleştirilen S3 kimlik bilgileri için üretim ve iptal.
  - **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 uygulama yönetimi** — Organizasyona ait [OAuth uygulamalarının](./oauth#organization-owned-oauth-apps) (arasında [Token Exchange uygulaması](./oauth#token-exchange-for-organizations-rfc-8693) da dahil) oluşturulması, güncellenmesi (ad, URL'ler, kapsamlar veya token süresi) ve silinmesi, ayrıca bir üyenin kişisel uygulamasının organizasyona aktarılması. Logo değişiklikleri kaydedilmez.
  - **Olaylar:** `oauth.app.create`, `oauth.app.update`, `oauth.app.delete`, `oauth.app.move`
- **İstemci gizli anahtarı** — İ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 yayını** — Organizasyonun [Token Exchange](./oauth#token-exchange-for-organizations-rfc-8693) uygulaması üzerinden üyelere verilen tokenlar.
  - **Olay:** `oauth.token`

### İçerik ve Kaynak Yönetimi

- **Depo yönetimi** — Oluşturma, silme, taşıma, devre dışı bırakma/yeniden etkinleştirme, kopyalama 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`
- **Koleksiyonlar** — Koleksiyonların oluşturulması ve silinmesi.
  - **Olaylar:** `collection.create`, `collection.delete`
- **Depo güvenliği** — 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 yapılandırması** — Depolama katmanı değişiklikleri, donanım (flavor) güncellemeleri ve uyku süresi ayarlamaları.
  - **Olaylar:** `spaces.add_storage`, `spaces.remove_storage`, `spaces.update_hardware`, `spaces.update_sleep_time`

### Kaynak Grupları

- **Kaynak grubu yönetimi** — Oluşturma, silme ve ayar değişiklikleri.
  - **Olaylar:** `resource_group.create`, `resource_group.delete`, `resource_group.settings`
- **Kaynak grubu üyeleri** — Kullanıcıların eklenmesi ve çıkarılması, rol değişiklikleri.
  - **Olaylar:** `resource_group.add_users`, `resource_group.remove_users`, `resource_group.change_role`
- **Kaynak grubu davetleri** — Organizasyon dışındaki kullanıcıları bir kaynak grubuna davet etme ve bu davetleri iptal etme.
  - **Olaylar:** `resource_group.invite_user`, `resource_group.invite.revoke`

### İşler ve Zamanlanmış İşler

- **Görevler** — Görev oluşturma (ör. bir Space üzerinde) ve iptal etme.
  - **Olaylar:** `jobs.create`, `jobs.cancel`
- **Zamanlanmış işler** — Ç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

- **Ödeme ve müşteriler** — Ö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`
- **Bulut pazar yerleri** — AWS ve GCP pazar yeri bağlantısı/koparılması ve pazar yeri onayı.
  - **Olaylar:** `billing.aws_add`, `billing.aws_remove`, `billing.gcp_add`, `billing.gcp_remove`, `billing.marketplace_approve`
- **Abonelikler** — Aboneliklerin başlatılması, yenilenmesi, iptal edilmesi, yeniden etkinleştirilmesi ve güncellenmesi (plan ve sözleşme detayları 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.

