# مجموعات البوابات

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

تتيح مجموعات البوابات (Gating Group Collections) للمنظمات منح (أو رفض) الوصول إلى جميع النماذج ومجموعات البيانات في مجموعة واحدة دفعة واحدة، بدلاً من التعامل مع كل مستودع على حدة. لن يضطر المستخدمون إلى المرور سوى بـ**طلب وصول واحد**.

لتفعيل مجموعة البوابة (Gating Group) في مجموعة:

- يجب أن يكون مالك المجموعة منظمة
- يجب أن تكون المنظمة مشتركة في خطة فريق أو مؤسسة
- يجب أن تكون جميع النماذج ومجموعات البيانات في المجموعة مملوكة لنفس المنظمة المالكة للمجموعة
- قد ينتمي كل نموذج أو مجموعة بيانات في المجموعة إلى مجموعة واحدة فقط من مجموعات البوابات (Gating Group Collection) (لكن يمكنها أن تكون مدرجة في مجموعات غير بوابات، أي _عادية_).

> [!TIP]
> لا ينطبق البوابة (Gating) إلا على النماذج ومجموعات البيانات؛ أما أي مورد آخر ضمن المجموعة (مثل مساحة (Space) أو ورقة بحثية (Paper)) فلن يتأثر.

## إدارة مجموعة البوابة كمسؤول منظمة

لتفعيل طلبات الوصول، انتقل إلى صفحة المجموعة وانقر على **Gating group** في الزاوية اليمنى السفلية.

    <img
        class="block dark:hidden m-0!"
        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/gating-group-collection-disabled.webp"
        alt="Hugging Face collection page with gating group collection feature disabled"
    />
    <img
        class="hidden dark:block m-0!"
        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/dark-gating-group-collection-disabled.webp"
        alt="Hugging Face collection page with gating group collection feature disabled"
    />

بشكل افتراضي، تكون مجموعة التحكم معطّلة: انقر على **إعداد طلبات الوصول** لفتح الإعدادات

    <img
        class="block dark:hidden m-0!"
        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/gating-group-modal-disabled.webp"
        alt="Hugging Face gating group collection settings with gating disabled"
    />
    <img
        class="hidden dark:block m-0!"
        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/dark-gating-group-modal-disabled.webp"
        alt="Hugging Face gating group collection settings with gating disabled"
    />

بشكل افتراضي، يُمنح الوصول إلى المستودعات في المجموعة تلقائيًا للمستخدمين عند طلبهم ذلك. يُشار إلى ذلك باسم **الموافقة التلقائية**. في هذا الوضع، يمكن لأي مستخدم الوصول إلى مستودعاتك بمجرد موافقته على مشاركة معلومات جهات الاتصال الخاصة به معك.

    <img
        class="block dark:hidden m-0!"
        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/gating-group-modal-enabling.webp"
        alt="Hugging Face gating group collection settings with automatic mode selected"
    />
    <img
        class="hidden dark:block m-0!"
        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/dark-gating-group-modal-enabling.webp"
        alt="Hugging Face gating group collection settings with automatic mode selected"  
    />

إذا كنت ترغب في الموافقة يدويًا على المستخدمين الذين يمكنهم الوصول إلى المستودعات في مجموعتك، فيجب عليك ضبطه على **Manual Review**. في هذه الحالة، ستلاحظ خيارًا جديدًا:

**تكرار الإشعارات**، والذي يتيح لك تحديد متى تصلك إشعارات حول المستخدمين الجدد الذين يطلبون الوصول. يمكن ضبطه ليتم مرة واحدة يوميًا أو في الوقت الفعلي. افتراضيًا، تُرسل رسائل البريد الإلكتروني إلى أول 5 مسؤولين في المنظمة. يمكنك أيضًا تعيين عنوان بريد إلكتروني مختلف في حقل **بريد الإلكتروني للإشعارات**.

    <img
        class="block dark:hidden m-0!"
        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/gating-group-modal-manual.webp"
        alt="Hugging Face gating group collection settings with manual review mode selected"
    />
    <img
        class="hidden dark:block m-0!"
        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/dark-gating-group-modal-manual.webp"
        alt="Hugging Face gating group collection settings with manual review mode selected"
    />

### مراجعة طلبات الوصول

بمجرد تمكين طلبات الوصول، تملك تحكماً كاملاً في من يمكنه الوصول إلى المستودعات في مجموعة مجموعاتك المُتحكَّم بها، سواء كان وضع الاعتماد يدوياً أو تلقائياً. يمكنك مراجعة الطلبات وإدارتها إما من خلال واجهة المستخدم أو عبر واجهة برمجة التطبيقات.

**سيؤدي اعتماد طلب مستودع ضمن مجموعة مجموعات البوابة إلى اعتماد الوصول تلقائيًا إلى جميع المستودعات (النماذج ومجموعات البيانات) في تلك المجموعة.**

#### من واجهة المستخدم

يمكنك مراجعة من لديه وصول إلى جميع المستودعات في مجموعة مجموعات البوابة الخاصة بك من صفحة الإعدادات لأي من المستودعات في المجموعة، بالنقر على زر **مراجعة طلبات الوصول**:

    <img
        class="block dark:hidden m-0!"
        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/gating-group-repo-settings.webp"
        alt="Hugging Face repo access settings when repo is in a gating group collection"
    />
    <img
        class="hidden dark:block m-0!"
        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/dark-gating-group-repo-settings.webp"
        alt="Hugging Face repo access settings when repo is in a gating group collection"
    />

سيؤدي هذا إلى فتح نافذة منبثقة تحتوي على ثلاث قوائم للمستخدمين:

- **قيد الانتظار**: قائمة المستخدمين الذين ينتظرون الموافقة على الوصول إلى مستودعك. تكون هذه القائمة فارغة ما لم تكن قد اخترت **المراجعة اليدوية**. يمكنك إما **قبول** أو **رفض** كل طلب. إذا رُفض الطلب، فلن يتمكن المستخدم من الوصول إلى مستودعك ولن يتمكن من طلب الوصول مرة أخرى.
- **accepted**: القائمة الكاملة بالمستخدمين الذين لديهم وصول إلى مستودعك. يمكنك اختيار **Reject** الوصول في أي وقت لأي مستخدم، سواء كان وضع الموافقة يدويًا أو تلقائيًا. كما يمكنك **Cancel** الموافقة، مما سينقل المستخدم إلى قائمة **pending**.
- **مرفوض**: قائمة المستخدمين الذين رفضتهم يدويًا. لا يمكن لهؤلاء المستخدمين الوصول إلى مستودعاتك. إذا انتقلوا إلى مستودعك، فسيرون رسالة _تم رفض طلبك للوصول إلى هذا المستودع من قبل مؤلفي المستودع_.

    <img 
        class="block dark:hidden"
        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/hub/models-gated-enabled-pending-users.png"
        alt="Manage access requests modal for a repo in a gating group collection"
    />
    <img
        class="hidden dark:block"
        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/hub/models-gated-enabled-pending-users-dark.png"
        alt="Manage access requests modal for a repo in a gating group collection"
    />

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

يمكنك إدارة طلبات الوصول برمجياً في مجموعة مجموعات مقيّدة (Gated Group Collection) من خلال واجهة برمجة التطبيقات (API) لأي من نماذجها أو مجموعات بياناتها.

قم بزيارة توثيق [النماذج المُقيَّدة](https://huggingface.co/docs/hub/models-gated#via-the-api) أو [مجموعات البيانات المُقيَّدة](https://huggingface.co/docs/hub/datasets-gated#via-the-api) لمعرفة المزيد حول ذلك.

#### تنزيل تقرير الوصول

يمكنك تنزيل تقارير الوصول لمجموعة Gated Group من خلال صفحة الإعدادات لأي من نماذجها أو مجموعات بياناتها.

قم بزيارة توثيق [النماذج المُقيَّدة](https://huggingface.co/docs/hub/models-gated#download-access-report) أو [مجموعات البيانات المُقيَّدة](https://huggingface.co/docs/hub/datasets-gated#download-access-report) لمعرفة المزيد حول ذلك.

#### اختر بيانات الملف الشخصي التي سيتم جمعها

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

قم بزيارة توثيق [النماذج المُقيَّدة](https://huggingface.co/docs/hub/models-gated#choose-which-profile-data-hugging-face-shares-with-you) أو [مجموعات البيانات المُقيَّدة](https://huggingface.co/docs/hub/datasets-gated#choose-which-profile-data-hugging-face-shares-with-you) لمعرفة المزيد حول ذلك.

#### تخصيص المعلومات المطلوبة

يمكن للمنظمات تخصيص معاملات البوابة (gating) وكذلك معلومات المستخدم التي يتم جمعها لكل مستودع محكوم. يرجى زيارة توثيق [النماذج المحكومة](https://huggingface.co/docs/hub/models-gated#customize-requested-information) أو [مجموعات البيانات المحكومة](https://huggingface.co/docs/hub/datasets-gated#customize-requested-information) لمزيد من التفاصيل.

> [!WARNING]
> باستثناء إعدادات بيانات الملف الشخصي المذكورة أعلاه، لا توجد حاليًا طريقة لتخصيص معاملات البوابة والمعلومات المطلوبة بطريقة مركزية. إذا كنت ترغب في جمع البيانات نفسها بغض النظر عن مستودع المجموعة التي يطلب المستخدم الوصول إليها، فستحتاج إلى إضافة معاملات البوابة نفسها في البيانات الوصفية لجميع النماذج ومجموعات البيانات في المجموعة، والاحتفاظ بها متزامنة.

## إعدادات متقدمة

يمكن لمنظمات Enterprise Plus رفض الزوار تلقائيًا أو حظرهم من مواقع محددة عبر جميع نماذجها ومجموعات بياناتها. توجد هذه الإعدادات في إعدادات **Publisher Analytics**، تحت تبويب **Advanced Gating**.

### الإنفاذ

يتحكم إعداد **Enforcement** في ما يُمنع الزوار المحظورون من الوصول إليه:

- **المستودعات المُقيَّدة**: تُرفض طلبات الوصول إلى المستودعات المُقيَّدة التابعة للمنظمة تلقائيًا.
- **جميع المستودعات**: بالإضافة إلى رفض طلبات الوصول تلقائيًا، يتم رفض التنزيلات في كل مستودع تابع للمنظمة، بما في ذلك المستودعات العامة. يرى الزوار المحظورون إشعارًا على صفحة المستودع ينص على «غير متاح في منطقتك»، ويُعطَّل عارض البيانات بالنسبة لهم.

تُطبَّق سياسة التنفيذ على الزوار من البلدان والمناطق المحظورة، سواء كانوا مسجلين أم لا. ولا يُستثنى أعضاء المنظمة من ذلك.

### المواقع المحظورة

تعرف قائمتان الموقعين المحظورين:

- **الدول المحظورة**: الدول، المحددة برمز [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) الخاص بها.
- **المناطق المحظورة**: أراضٍ محددة لحظرها بالإضافة إلى البلدان المذكورة أعلاه، وذلك للأراضي التي لا تُعدّ دولاً مستقلة وبالتالي لا يمكن اختيارها من القائمة أعلاه.

## الوصول إلى المستودعات المقيدة ضمن مجموعة مجموعات التقييد بصفتك مستخدماً

تعرض مجموعة المجموعة البوابة أيقونة محددة بجانب اسمها:

    <img
        class="block dark:hidden m-0!"
        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/gating-group-collection-enabled.webp"
        alt="Hugging Face collection page with gating group collection feature enabled"
    />
    <img
        class="hidden dark:block m-0!"
        src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/collections/dark-gating-group-collection-enabled.webp"
        alt="Hugging Face collection page with gating group collection feature enabled"
    />

للحصول على الوصول إلى النماذج ومجموعات البيانات في مجموعة مجموعات مقيدة (Gated Group Collection)، يكفي تقديم طلب وصول واحد على صفحة أيٍّ من تلك المستودعات. بمجرد موافقتك على طلبك، ستتمكن من الوصول إلى جميع المستودعات الأخرى في المجموعة، بما في ذلك المستودعات المستقبلية.

قم بزيارة وثائق [النماذج المقيدة](https://huggingface.co/docs/hub/models-gated#access-gated-models-as-a-user) أو [مجموعات البيانات المقيدة](https://huggingface.co/docs/hub/datasets-gated#access-gated-datasets-as-a-user) لمعرفة المزيد حول طلب الوصول إلى مستودع.