# سجلات التدقيق

> [!WARNING]
> تُعد هذه الميزة جزءًا من باقات الفريق والمؤسسات.

تتيح سجلات التدقيق لمسؤولي المنظمة مراجعة الإجراءات التي اتخذها الأعضاء بسهولة، بما في ذلك عضوية المنظمة وإعدادات المستودعات وتغييرات الفوترة.

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

## الوصول إلى سجلات التدقيق

يمكن الوصول إلى سجلات التدقيق من خلال إعدادات مؤسستك. يتضمن كل إدخال في السجل:

- من قام بالإجراء
- ما نوع الإجراء المتخذ
- وصف التغيير
- الموقع وعنوان IP المجهول
- تاريخ ووقت الإجراء

يمكنك أيضًا تنزيل سجل التدقيق الكامل كملف JSON للتحليل الإضافي.

### التصدير عبر واجهة برمجة التطبيقات

يتوفر التصدير البرمجي في:

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

قم بالمصادقة باستخدام رمز وصول مستخدم أو رمز حساب خدمة يتمتع بإذن **تصدير سجل التدقيق** (`org.auditLog.write`) للمنظمة. تكون الاستجابة مصفوفة JSON من إدخالات السجل، مطابقة للملف الذي يتم تنزيله من صفحة الإعدادات. وكما هو الحال مع التصدير اليدوي، يتم تسجيل استدعاء واجهة برمجة التطبيقات على أنه `org.audit_log.export`.

يُوثَّق هذا المنفذ أيضًا في مرجع OpenAPI.

## ما الأحداث التي يتم تتبعها؟

لكل إجراء **اسم حدث** بصيغة `scope.action` (مثل `repo.create`، `collection.delete`). وهذا هو حقل `type` في كل سجل وفي ملف JSON المُصدَّر—استخدمه عند البحث في السجلات أو تصفيتها.

### إدارة المنظمات والأمان

  > [!TIP]
  > أحداث **تغييرات الإعدادات** أدناه متاحة فقط للإجراءات المتخذة بعد 16 يونيو 2026. تستخدم الأحداث السابقة لتاريخ ذلك نوع حدث فريد هو `org.update_settings`. يجب على أي تكامل يقوم بتصفية أو تحليل حقل `type` للحدث للمنظمات المنشأة قبل 16 يونيو 2026، التعامل مع النوعين معاً.

- **التغييرات الأساسية في التنظيم** — الإنشاء، والحذف، والاستعادة، وإعادة التسمية.
  - **الأحداث:** `org.create`، `org.delete`، `org.restore`، `org.rename`
- **تغييرات الإعدادات** — تُسجَّل تحديثات إعدادات المنظمة كأحداث مفصّلة `org.settings.*`، مما يتيح لك تحديد الإعداد الذي تغيّر بدقة.
  - الإعدادات العامة — الملف الشخصي، مناطق التخزين، مجموعات الموارد، وتقييد الناشرين.
  - **الأحداث:** `org.settings.profile`، `org.settings.regions`، `org.settings.resource_groups`، `org.settings.publisher_gating`
  - مزودو الاستدلال — تكوين المزود، إضافة/إزالة مفتاح 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`
  - الأمان — تحديد مستوى الظهور الافتراضي للمستودع، وتفعيل أو تعطيل فرض المصادقة الثنائية، والانضمام التلقائي، وخصوصية الأعضاء.
  - **الأحداث:** `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`
  - الشبكة — تحديثات تكوين الشبكة، وتمكين أو تعطيل تقييد الوصول عبر بروتوكول الإنترنت وإنفاذ المصادقة.
  - **الأحداث:** `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`

  
- **إدارة الأمان**
  - تدوير رمز API للمنظمة.
  - **الحدث:** `org.rotate_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، وتصرير الأعضاء أو إلغاء تصرير رموز الوصول ومفاتيح SSH الخاصة بهم.
  - **الأحداث:** `org.sso_login`، `org.sso_join`، `org.sso_credential.authorize`، `org.sso_credential.deauthorize`
- **إعدادات الانضمام** — الوصول المبني على النطاقات وإعداد الانضمام التلقائي.
  - **الحدث:** `org.update_join_settings`

### عضوية وتحكم الوصول

- **دورة حياة الأعضاء** — إضافة الأعضاء وإزالتهم، وتغيير الأدوار، ومغادرة الأعضاء للمنظمة.
  - **الأحداث:** `org.add_user`، `org.remove_user`، `org.change_role`، `org.leave`
- **نوع الحساب** — تحويل عضو إلى [متعاون خارجي](./security-sso-user-management#external-collaborators)، أو إعادته إلى عضو.
  - **الحدث:** `org.change_account_type`
- **الدعوات** — إرسال الدعوات، وروابط الدعوة عبر البريد الإلكتروني، وقبول المستخدمين للدعوات.
  - **الأحداث:** `org.invite_user`، `org.invite.accept`، `org.invite.email`
- **الانضمام التلقائي** — الانضمام عبر نطاق البريد الإلكتروني الموثّق أو “طلب الوصول”.
  - **الأحداث:** `org.join.from_domain`، `org.join.automatic`

### حسابات الخدمة

- **دورة حياة حساب الخدمة**: إنشاء حسابات الخدمة وحذفها.
  - **الأحداث:** `org.service_account.create`، `org.service_account.delete`
- **رموز حساب الخدمة**: إنشاء الرموز وحذفها وتدويرها وتحديثها (الاسم، الصلاحيات، الإعفاء من أمان الشبكة)، بالإضافة إلى توليد وإبطال بيانات اعتماد 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** — إنشاء التطبيقات وتحديثها (الاسم، الروابط، النطاقات، أو انتهاء صلاحية الرمز) وحذف [تطبيقات OAuth](./oauth#organization-owned-oauth-apps) التي تملكها المنظمة، بما في ذلك [تطبيق تبادل الرموز](./oauth#token-exchange-for-organizations-rfc-8693) الخاص بها، بالإضافة إلى نقل التطبيق الشخصي لعضو إلى المنظمة. لا يتم تسجيل تغييرات الشعار.
  - **الأحداث:** `oauth.app.create`، `oauth.app.update`، `oauth.app.delete`، `oauth.app.move`
- **سر العميل** — تدوير سر العميل (أو إضافته إلى تطبيق عام)، وإزالته، وانتهاء صلاحية السر من قِبل Hugging Face.
  - **الأحداث:** `oauth.app.secret.rotate`، `oauth.app.secret.delete`، `oauth.app.secret.expire`
- **إصدار الرموز** — الرموز المُصدَّرة للأعضاء عبر تطبيق [Token Exchange](./oauth#token-exchange-for-organizations-rfc-8693) التابع للمنظمة.
  - **الحدث:** `oauth.token`

### إدارة المحتوى والموارد

- **إدارة المستودع** — الإنشاء، والحذف، والنقل، وتعطيل/إعادة تفعيل الإعدادات، والتكرار، وإزالة المعرف الرقمي (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`
- **المجموعات** — إنشاء المجموعات وحذفها.
  - **الأحداث:** `collection.create`، `collection.delete`
- **أمان المستودع** — الأسرار والمتغيرات (إضافة/تحديث/حذف فردي وجماعي).
  - **الأحداث (الأسرار):** `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** — تغييرات طبقة التخزين، وتحديثات العتاد (النوع)، وضبط وقت السكون.
  - **الأحداث:** `spaces.add_storage`، `spaces.remove_storage`، `spaces.update_hardware`، `spaces.update_sleep_time`

### مجموعات الموارد

- **إدارة مجموعة الموارد** — الإنشاء والحذف وتغيير الإعدادات.
  - **الأحداث:** `resource_group.create`، `resource_group.delete`، `resource_group.settings`
- **أعضاء مجموعة الموارد** — إضافة المستخدمين وإزالتهم، وتغيير الأدوار.
  - **الأحداث:** `resource_group.add_users`، `resource_group.remove_users`، `resource_group.change_role`
- **دعوات مجموعات الموارد** — دعوة مستخدمين من خارج المنظمة إلى مجموعة موارد، وسحب تلك الدعوات.
  - **الأحداث:** `resource_group.invite_user`، `resource_group.invite.revoke`

### المهام والمهام المجدولة

- **المهام** — إنشاء المهام (مثلًا على مساحة) وإلغاؤها.
  - **الأحداث:** `jobs.create`، `jobs.cancel`
- **المهام المجدولة** — إنشاء المهام وحذفها واستئنافها وإيقافها مؤقتًا وتشغيلها.
  - **الأحداث:** `scheduled_job.create`، `scheduled_job.delete`، `scheduled_job.resume`، `scheduled_job.suspend`، `scheduled_job.run`

### الفوترة والتكامل مع السحابة

- **الدفع والعملاء** — تحديث طرق الدفع وإرفاقها وإزالتها؛ إنشاء حسابات العملاء.
  - **الأحداث:** `billing.update_payment_method`، `billing.create_customer`، `billing.remove_payment_method`
- **سوق السحابة** — ربط وفصل سوق AWS وGCP والموافقة على السوق.
  - **الأحداث:** `billing.aws_add`، `billing.aws_remove`، `billing.gcp_add`، `billing.gcp_remove`، `billing.marketplace_approve`
- **الاشتراكات** — بدء الاشتراكات وتجديدها وإلغاؤها وإعادة تفعيلها وتحديثها (بما في ذلك تفاصيل الخطة والعقد).
  - **الأحداث:** `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`

## مرجع الأحداث

تغطي القائمة أعلاه جميع أنواع الأحداث المعروضة في واجهة سجل التدقيق والتصدير. تتبع أسماء الأحداث نمط `scope.action`؛ وتشمل النطاقات `org`، `repo`، `collection`، `spaces`، `resource_group`، `jobs`، `scheduled_job`، `oauth`، و`billing`. يُسجَّل إجراء التصدير نفسه على أنه `org.audit_log.export` لكن هذا الحدث غير مدرج في عرض سجل التدقيق الافتراضي.