نظرة عامة
بالنسبة إلى عضويات مؤسسة API التي تُدار يدويًا، يمكنك إضافة الأشخاص وإزالتهم في منصّة الـ API. وإذا كانت مؤسستك تستخدم مجموعات متزامنة، فأدر الوصول من خلال Admin Console.
اختيار مكان إدارة الأعضاء
لإجراء تغييرات يدوية على عضوية المؤسسة في منصّة الـ API، تحتاج إلى إذن لإدارة الأعضاء. ويملك مالكو المؤسسة هذه الصلاحية افتراضيًا. بينما لا يملك القرّاء صلاحية إدارة الأعضاء افتراضيًا.
إذا أشارت صفحة الأشخاص إلى أن مؤسستك تُدار من خلال Cloud Console، وكانت عناصر التحكم الخاصة بالأعضاء للقراءة فقط، فحدّد فتح Cloud Console لفتح وحدة تحكّم المسؤول. وبالنسبة إلى المؤسسات التي تستخدم SCIM على مستوى وحدة Tenant، اتبع خطوات الوصول عبر المجموعات أدناه. وإذا كنت بحاجة إلى الوصول ولم تكن مؤسستك تستخدم تعيينًا لمجموعة SCIM، فتواصل مع المسؤول العام.
تختلف عضوية المؤسسة عن الوصول إلى المشروعات. راجع المشروعات التي يحتاج إليها الشخص عند إضافته. وللاطلاع على أدوار المشروعات وأذوناتها، راجع: إدارة المشروعات في منصّة الـ API.
تختلف أدوار العضوية في مؤسسة API وعضوية المؤسسة عن أدوار وعضوية مساحة عمل ChatGPT.
إضافة عضو في منصّة الـ API
افتح إعدادات منصّة الـ API ثم حدّد المؤسسة التي تريد إدارتها.
انتقل إلى الأشخاص > الأعضاء.
اختر إضافة عضو.
أدخل عنوان البريد الإلكتروني للشخص في عناوين البريد الإلكتروني. وإذا كان خيار تحديد مستخدم متاحًا، فيمكنك بدلًا من ذلك تحديد مستخدم حالي في وحدة Tenant، أو استخدام إدخال البريد الإلكتروني للمستخدم.
ضمن الدور، اختر المالك أو القارئ.
ضمن دعوة إلى المشروعات، اختر مشروعًا واحدًا على الأقل. وراجع أي مشروع محدد بالفعل.
حدّد دعوة. وإذا ظهرت رسالة تفيد بإضافة مستخدمي وحدة Tenant الحاليين مباشرةً، فراجعها، ثم حدّد إضافة أو إضافة ودعوة.
اطلب من المدعوين فتح رسالة الدعوة في بريدهم الإلكتروني واتباع الرابط للانضمام. أما مستخدمو وحدة Tenant الحاليون الذين تتم إضافتهم مباشرةً، فلا يحتاجون إلى قبول دعوة.
اختر المالك لشخص يحتاج إلى إدارة المؤسسة. واختر القارئ لشخص يحتاج إلى الوصول إلى واجهة API دون أذونات مالك المؤسسة الافتراضية. وتمنح المشروعات المحددة دور العضو على مستوى المشروع.
إدارة الدعوات المعلّقة
في إعدادات منصة API، انتقل إلى الأشخاص > الدعوات الخاصة بالمؤسسة.
ابحث عن دعوة الشخص.
لإعادة إرسال الدعوة، اختر إعادة الإرسال. ولإلغائها، اختر إزالة، ثم اختر إزالة في تأكيد الإزالة.
لا يتوفر خيار إعادة الإرسال بعد انتهاء صلاحية الدعوة. بالنسبة إلى الدعوة اليدوية منتهية الصلاحية، أزلها ثم أرسل دعوة جديدة. ولا يمكن إزالة دعوات SCIM من منصّة الـ API. أما الدعوات المُدارة من خلال وحدة Tenant، فلا تتوفر لها عناصر تحكم لتنفيذ إجراءات هنا.
تغيير أدوار العضو
في إعدادات منصّة الـ API الخاصة بالمؤسسة، انتقل إلى الأشخاص > الأعضاء.
حدّد الأدوار بجانب المستخدم.
حدّد مربعات الاختيار الخاصة بالأدوار المطلوبة أو ألغِ تحديدها، ثم اختر حفظ.
راجع أي تحذير قبل إزالة دور المالك. فقد يؤدي خفض رتبة المالك إلى إبطال مفاتيح API الخاصة بالمسؤول لديه. ولتغيير المشروعات التي يمكن لشخص ما استخدامها، أدر عضويته في المشروعات بشكل منفصل.
إزالة عضو
قبل إزالة عضو، راجع ما إذا كانت مفاتيح API النشطة الخاصة به قيد الاستخدام. قد تؤدي إزالة العضو إلى تعطيل الوصول إلى واجهة API الذي يعتمد على هذه المفاتيح.
في إعدادات منصّة الـ API الخاصة بالمؤسسة، انتقل إلى الأشخاص > الأعضاء.
ابحث عن الشخص، ثم حدّد إزالة.
راجع تأكيد الإزالة، ثم حدّد إزالة.
عندما يكون بإمكانك إزالة عضويتك بنفسك، سيظهر في صفك خيار مغادرة. وإذا كنت المالك الوحيد للمؤسسة، فانقل الملكية قبل مغادرتها أو إزالة عضويتك.
لا يمكنك إزالة عضو تتم إدارته عبر SCIM باستخدام هذا الخيار. غيّر عضويته في المجموعة أو تعيين الوصول الخاص به من خلال النظام الذي يدير هذه الإعدادات.
إدارة الوصول من خلال مجموعات SCIM
إذا كانت وحدة Tenant لديك تستخدم SCIM على مستوى وحدة Tenant (إدارة هوية المستخدمين عبر النطاقات المشتركة)، فيمكن للمسؤولين العامّين تعيين المجموعات المتزامنة إلى مؤسسات API من خلال وحدة تحكم المسؤول. ولإضافة شخص إلى مجموعة حالية، حدّث عضويته في المجموعة لدى موفّر الهوية.
لمنح مجموعة متزامنة صلاحية الوصول إلى مؤسسة API:
في وحدة تحكم المسؤول، انتقل إلى المستخدمون والمجموعات > مجموعات SCIM.
افتح المجموعة، ثم افتح الوصول إلى المنتج.
اختر إضافة وصول إلى المنتج.
ضمن المنتج، حدّد منصّة الـ API.
ضمن الوصول إلى المؤسسة، حدد المؤسسة في Org.
ضمن الوصول إلى المشروع، اختر مشروعًا. واختر إضافة مشروع لإضافة المزيد من المشروعات.
اختر حفظ.
تتم إضافة أعضاء المجموعة مباشرةً من دون الحاجة إلى قبول دعوة إلى مؤسسة API. ولتغيير تعيينات المشروعات الخاصة بالمجموعة، استخدم تعديل في تعيين الوصول إلى المنتج. ويؤدي إزالة إلى إزالة تعيين الوصول الخاص بالمجموعة، لذا استخدم موفّر الهوية لإزالة شخص واحد فقط من المجموعة.
يتولى SCIM إدارة عضويات المؤسسات التي ينشئها أو يتولى إدارتها، بما في ذلك العضويات التي أُضيفت يدويًا في الأصل. ويمكن أن تؤدي إزالة آخر تعيين مؤهل لشخص ما إلى إزالة عضويته في المؤسسة وعضوياته المرتبطة بالمشروعات. أما العضويات اليدوية التي لم يتولَّ SCIM إدارتها، فتظل مُدارة بشكل منفصل.
للاطلاع على متطلبات الإعداد وعمليات التحقق عند إيقاف وصول المستخدمين، راجع: توفير الحسابات وإدارتها باستخدام SCIM.
استكشاف مشكلات وصول الأعضاء وإصلاحها
## عناصر التحكم في الأعضاء غير متاحة
تأكد من تحديد المؤسسة الصحيحة ومن امتلاكك إذن إدارة الأعضاء. إذا وجّهتك الصفحة إلى وحدة تحكم المسؤول، فاستخدم آلية الوصول المستندة إلى المجموعات المعتمدة في مؤسستك، أو تواصل مع المسؤول العام.
تعذّر إضافة شخص
تأكد من صحة عنوان البريد الإلكتروني ومن تحديد مشروع واحد على الأقل. وإذا كان الشخص عضوًا بالفعل في المؤسسة، فابحث عنه ضمن الأعضاء. وإذا كانت لديه دعوة معلّقة، فاستخدم الدعوات لإدارتها.
تعذّر على عضو الوصول إلى مشروع
تحقق من عضوية الشخص في المشروع والدور المعيّن له. وبالنسبة إلى الوصول عبر مجموعات SCIM، تحقق من عضوية الشخص في مجموعة موفّر الهوية، وكذلك من تعيين المجموعة للمشروع في وحدة تحكم المسؤول.