التحكم في الوصول القائم على الأدوار (RBAC)

نظرة عامة

يتيح RBAC في CrewAI AMP إدارة وصول آمنة وقابلة للتوسع من خلال طبقتين:

1. صلاحيات الميزات — تتحكم في ما يمكن لكل دور القيام به عبر المنصة (إدارة، قراءة، أو بدون وصول)
2. صلاحيات على مستوى الكيان — وصول دقيق للأتمتات الفردية ومتغيرات البيئة واتصالات LLM ومستودعات Git

المستخدمون والأدوار

يُعيَّن لكل عضو في مساحة عمل CrewAI دور يحدد صلاحيات الوصول عبر الميزات المختلفة.

يمكنك:

• استخدام الأدوار المحددة مسبقاً (Owner، Member)
• إنشاء أدوار مخصصة مصممة لصلاحيات محددة
• تعيين الأدوار في أي وقت عبر لوحة الإعدادات

يمكنك تهيئة المستخدمين والأدوار في Settings → Roles.

1. فتح إعدادات الأدوار

   انتقل إلى Settings → Roles في CrewAI AMP.

2. اختيار نوع الدور

   استخدم دوراً محدداً مسبقاً (Owner، Member) أو انقر على Create role لتحديد دور مخصص.

3. التعيين للأعضاء

   اختر المستخدمين وعيّن لهم الدور. يمكنك تغيير ذلك في أي وقت.

الأدوار المحددة مسبقاً

الدور	الوصف
Owner	وصول كامل لجميع الميزات والإعدادات. لا يمكن تقييده.
Member	وصول للقراءة لمعظم الميزات، وصول إدارة لمتغيرات البيئة واتصالات LLM ومشاريع Studio. لا يمكنه تعديل إعدادات المؤسسة أو الإعدادات الافتراضية.

ملخص التهيئة

المجال	مكان التهيئة	الخيارات
المستخدمون والأدوار	Settings → Roles	محددة مسبقاً: Owner، Member؛ أدوار مخصصة
رؤية الأتمتة	Automation → Settings → Visibility	خاص؛ قائمة بيضاء للمستخدمين/الأدوار

---

مصفوفة صلاحيات الميزات

لكل دور مستوى صلاحية لكل منطقة ميزة. المستويات الثلاثة هي:

• إدارة (Manage) — وصول كامل للقراءة/الكتابة (إنشاء، تعديل، حذف)
• قراءة (Read) — وصول للعرض فقط
• بدون وصول (No access) — الميزة مخفية/غير قابلة للوصول

الميزة	Owner	Member (افتراضي)	المستويات المتاحة	الوصف
usage_dashboards	Manage	Read	Manage / Read / No access	عرض مقاييس وتحليلات الاستخدام
crews_dashboards	Manage	Read	Manage / Read / No access	عرض لوحات النشر والوصول إلى تفاصيل الأتمتة
invitations	Manage	Read	Manage / Read / No access	دعوة أعضاء جدد إلى المؤسسة
training_ui	Manage	Read	Manage / Read / No access	الوصول إلى واجهات التدريب/الضبط الدقيق
tools	Manage	Read	Manage / Read / No access	إنشاء وإدارة الأدوات
agents	Manage	Read	Manage / Read / No access	إنشاء وإدارة الوكلاء
environment_variables	Manage	Manage	Manage / No access	إنشاء وإدارة متغيرات البيئة
llm_connections	Manage	Manage	Manage / No access	تهيئة اتصالات مزودي LLM
default_settings	Manage	No access	Manage / No access	تعديل الإعدادات الافتراضية على مستوى المؤسسة
organization_settings	Manage	No access	Manage / No access	إدارة الفوترة والخطط وتهيئة المؤسسة
studio_projects	Manage	Manage	Manage / No access	إنشاء وتعديل المشاريع في Studio

Tip

عند إنشاء دور مخصص، يمكن ضبط معظم الميزات على Manage أو Read أو No access. ومع ذلك، فإن environment_variables وllm_connections وdefault_settings وorganization_settings وstudio_projects تدعم فقط Manage أو No access — لا يوجد خيار للقراءة فقط لهذه الميزات.

---

النشر من GitHub أو Zip

من أكثر أسئلة RBAC شيوعاً: “ما الصلاحيات التي يحتاجها عضو الفريق للنشر؟“

النشر من GitHub

لنشر أتمتة من مستودع GitHub، يحتاج المستخدم إلى:

1. crews_dashboards: على الأقل Read — مطلوب للوصول إلى لوحة الأتمتات حيث يتم إنشاء عمليات النشر
2. الوصول إلى مستودع Git (إذا كان RBAC على مستوى الكيان لمستودعات Git مفعلاً): يجب منح دور المستخدم الوصول إلى مستودع Git المحدد عبر صلاحيات مستوى الكيان
3. studio_projects: Manage — إذا كان يبني الطاقم في Studio قبل النشر

النشر من Zip

لنشر أتمتة من ملف Zip، يحتاج المستخدم إلى:

1. crews_dashboards: على الأقل Read — مطلوب للوصول إلى لوحة الأتمتات
2. تفعيل نشر Zip: يجب ألا تكون المؤسسة قد عطلت نشر Zip في إعدادات المؤسسة

مرجع سريع: الحد الأدنى من الصلاحيات للنشر

الإجراء	صلاحيات الميزات المطلوبة	متطلبات إضافية
النشر من GitHub	crews_dashboards: Read	وصول كيان مستودع Git (إذا كان Git RBAC مفعلاً)
النشر من Zip	crews_dashboards: Read	يجب تفعيل نشر Zip على مستوى المؤسسة
البناء في Studio	studio_projects: Manage	—
تهيئة مفاتيح LLM	llm_connections: Manage	—
ضبط متغيرات البيئة	environment_variables: Manage	وصول مستوى الكيان (إذا كان RBAC الكيان مفعلاً)

---

التحكم في الوصول على مستوى الأتمتة (صلاحيات الكيان)

بالإضافة إلى الأدوار على مستوى المؤسسة، يدعم CrewAI صلاحيات دقيقة على مستوى الكيان تقيد الوصول إلى موارد فردية.

رؤية الأتمتة

تدعم الأتمتات إعدادات رؤية تقيد الوصول حسب المستخدم أو الدور. هذا مفيد لـ:

• الحفاظ على خصوصية الأتمتات الحساسة أو التجريبية
• إدارة الرؤية عبر الفرق الكبيرة أو المتعاونين الخارجيين
• اختبار الأتمتات في سياقات معزولة

يمكن تهيئة عمليات النشر كخاصة، مما يعني أن المستخدمين والأدوار المدرجين في القائمة البيضاء فقط سيتمكنون من التفاعل معها.

يمكنك تهيئة التحكم في الوصول على مستوى الأتمتة في Automation → Settings → علامة تبويب Visibility.

1. فتح علامة تبويب الرؤية

   انتقل إلى Automation → Settings → Visibility.

2. ضبط الرؤية

   اختر Private لتقييد الوصول. يحتفظ مالك المؤسسة دائماً بالوصول.

3. القائمة البيضاء للوصول

   أضف مستخدمين وأدواراً محددة مسموح لهم بالعرض والتشغيل والوصول إلى السجلات/المقاييس/الإعدادات.

4. الحفظ والتحقق

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

الرؤية الخاصة: نتائج الوصول

الإجراء	المالك	مستخدم/دور في القائمة البيضاء	غير مدرج في القائمة البيضاء
عرض الأتمتة	✓	✓	✗
تشغيل الأتمتة/API	✓	✓	✗
الوصول إلى السجلات/المقاييس/الإعدادات	✓	✓	✗

Tip

يتمتع مالك المؤسسة دائماً بالوصول. في الوضع الخاص، يمكن فقط للمستخدمين والأدوار المدرجين في القائمة البيضاء العرض والتشغيل والوصول إلى السجلات/المقاييس/الإعدادات.

أنواع صلاحيات النشر

عند منح وصول على مستوى الكيان لأتمتة محددة، يمكنك تعيين أنواع الصلاحيات التالية:

الصلاحية	ما تسمح به
run	تنفيذ الأتمتة واستخدام API الخاص بها
traces	عرض تتبعات التنفيذ والسجلات
manage_settings	تعديل، إعادة نشر، استرجاع، أو حذف الأتمتة
human_in_the_loop	الرد على طلبات الإنسان في الحلقة (HITL)
full_access	جميع ما سبق

RBAC على مستوى الكيان لموارد أخرى

عند تفعيل RBAC على مستوى الكيان، يمكن أيضاً التحكم في الوصول لهذه الموارد حسب المستخدم أو الدور:

المورد	يتم التحكم فيه بواسطة	الوصف
متغيرات البيئة	علامة ميزة RBAC الكيان	تقييد أي الأدوار/المستخدمين يمكنهم عرض أو إدارة متغيرات بيئة محددة
اتصالات LLM	علامة ميزة RBAC الكيان	تقييد الوصول لتهيئات مزودي LLM محددة
مستودعات Git	إعداد RBAC لمستودعات Git بالمؤسسة	تقييد أي الأدوار/المستخدمين يمكنهم الوصول لمستودعات متصلة محددة

---

أنماط الأدوار الشائعة

بينما يأتي CrewAI بدوري Owner وMember، تستفيد معظم الفرق من إنشاء أدوار مخصصة. إليك الأنماط الشائعة:

دور المطور

دور لأعضاء الفريق الذين يبنون وينشرون الأتمتات لكن لا يديرون إعدادات المؤسسة.

الميزة	الصلاحية
usage_dashboards	Read
crews_dashboards	Manage
invitations	Read
training_ui	Read
tools	Manage
agents	Manage
environment_variables	Manage
llm_connections	Manage
default_settings	No access
organization_settings	No access
studio_projects	Manage

دور المشاهد / أصحاب المصلحة

دور للمعنيين غير التقنيين الذين يحتاجون لمراقبة الأتمتات وعرض النتائج.

الميزة	الصلاحية
usage_dashboards	Read
crews_dashboards	Read
invitations	No access
training_ui	Read
tools	Read
agents	Read
environment_variables	No access
llm_connections	No access
default_settings	No access
organization_settings	No access
studio_projects	No access

دور مسؤول العمليات / المنصة

دور لمشغلي المنصة الذين يديرون إعدادات البنية التحتية لكن قد لا يبنون الوكلاء.

الميزة	الصلاحية
usage_dashboards	Manage
crews_dashboards	Manage
invitations	Manage
training_ui	Read
tools	Read
agents	Read
environment_variables	Manage
llm_connections	Manage
default_settings	Manage
organization_settings	Read
studio_projects	No access

---

تحتاج مساعدة؟

تواصل مع فريق الدعم للمساعدة في أسئلة RBAC.