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

تُعد هذه الميزة جزءًا من خطط الفريق والمؤسسات.

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

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

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

• من قام بالإجراء
• ما نوع الإجراء المتخذ
• وصف التغيير
• الموقع وعنوان 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 المُصدَّر—استخدمه عند البحث في السجلات أو تصفيتها.

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

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

• Core organization changes — إنشاء، حذف، استعادة، وإعادة تسمية.
  • الأحداث: org.create، org.delete، org.restore، org.rename
• Settings changes — تُسجَّل تحديثات إعدادات المنظمة كأحداث مفصّلة 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
• Security management
  • تدوير رمز 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.
  • الأحداث: org.sso_login، org.sso_join
• Join settings — الوصول القائم على النطاق وإعداد الانضمام التلقائي.
  • الحدث: org.update_join_settings

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

• Member lifecycle — إضافة وإزالة الأعضاء، وتغيير الأدوار، ومغادرة الأعضاء للمنظمة.
  • الأحداث: org.add_user، org.remove_user، org.change_role، org.leave
• Account type — تحويل عضو إلى مشارك خارجي, أو إعادته إلى عضو.
  • الحدث: org.change_account_type
• Invitations — إرسال الدعوات، وروابط الدعوة عبر البريد الإلكتروني، وقبول المستخدمين للدعوات.
  • الأحداث: org.invite_user، org.invite.accept، org.invite.email
• Automatic joins — الانضمام عبر نطاق البريد الإلكتروني الموثّق أو "طلب الوصول".
  • الأحداث: org.join.from_domain، org.join.automatic

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

• Service account lifecycle: إنشاء حسابات الخدمة وحذفها.
  • الأحداث: org.service_account.create، org.service_account.delete
• Service account tokens: إنشاء الرموز، وحذفها، وتدويرها، وتحديثها (الاسم، والصلاحيات، واستثناء الأمان الشبكي)، بالإضافة إلى توليد وإبطال بيانات اعتماد 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 app management — إنشاء، وتحديث (الاسم، والعناوين، والصلاحيات، أو انتهاء صلاحية الرمز)، وحذف تطبيقات OAuth الخاصة بالمنظمة، بما في ذلك تطبيق Token Exchange, وعمليات نقل تطبيق عضو شخصي إلى المنظمة. لا يتم تسجيل تغييرات الشعار.
  • الأحداث: oauth.app.create، oauth.app.update، oauth.app.delete، oauth.app.move
• Client secret — تدوير سر العميل (أو إضافته إلى تطبيق عام)، وإزالته، وانتهاء صلاحية السر من قِبل Hugging Face.
  • الأحداث: oauth.app.secret.rotate، oauth.app.secret.delete، oauth.app.secret.expire
• Token issuance — الرموز الصادرة للأعضاء عبر Token Exchange التطبيق.
  • الحدث: oauth.token

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

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

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

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

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

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

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

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