توفير الأعضاء عبر SCIM

مع SCIM، يُبقي مزوّد الهوية أعضاء Polzy متطابقين مع دليلكم. عندما ينضمّ شخص أو يتغيّر أو يغادر لديكم، يُبلغ الدليل Polzy فورًا، ولا يحتاج أحد إلى دعوة الأشخاص أو إزالتهم يدويًا. يغطي هذا الدليل الرمز، والإعداد في كل دليل، وما يفعله Polzy مع كل تغيير.

كيف يعمل

• الإضافة. يصبح الشخص الجديد في دليلكم عضوًا، في مساحة العمل وبالدور اللذين اخترتهما لتسجيل الدخول الموحّد، دون رسالة دعوة. ويسجّل الدخول عبر مزوّد الهوية.
• التحديث. يصل تغيير الاسم إلى كل مساحة عمل هو عضو فيها.
• التعطيل. تعطيل شخص في دليلكم يعطّله فورًا في Polzy ويُنهي جلساته. ويصبح مقعده شاغرًا.
• الإزالة. حذف شخص من دليلكم يزيل عضوياته في مؤسستكم. وتبقى إجاباته وما أنشأه.
• المجموعات. يرسل دليلك مجموعاته إلى جانب أشخاصه. وتمنح قواعد المجموعات في خطوة الأشخاص من تسجيل الدخول الموحّد الأشخاصَ في كل مجموعة مساحة عمل ودورًا: مجموعة قواعد واحدة لتسجيل الدخول الموحّد وSCIM.

في إعدادات المؤسسة ← الأعضاء يحمل الأشخاص الذين أنشأهم الدليل أو يديرهم وسم يُدار من دليلك.

قبل أن تبدأ

• تسجيل الدخول الموحّد حتى خطوة الأشخاص. يوزّع SCIM الأشخاص بمساحة العمل والدور وقواعد المجموعات التي تختارها هناك. اختر مساحة العمل تحت إنشاء عضو تلقائيًا؛ وإن انتقلت بعدها إلى فقط الأشخاص المدعوون أو المُزامَنون مسبقًا، تبقى مساحة العمل المختارة محفوظة لـ SCIM. راجع اختيار من يدخل.
• كل النطاقات مُتحقَّق منها. يُرفض الشخص الذي عنوانه في نطاق آخر. راجع التحقق من نطاقك.
• بلا مزامنة أشخاص. لا يمكن لـ SCIM ولمزامنة من BambooHR أو Workday أو Personio أو Microsoft Entra ID إدارة المؤسسة نفسها معًا. افصل المزامنة في جهات الاتصال ← المزامنة والحقول قبل إنشاء الرمز؛ وما دام رمز موجودًا لا يمكن ربط أي مزامنة.
• مقاعد شاغرة. تشغل كل عضوية ينشئها الدليل مقعدًا في خطتك.

إنشاء الرمز

1. افتح إعدادات المؤسسة ← الأمان. في قسم تسجيل الدخول الموحّد ابحث عن التزويد عبر SCIM واختر إعداد.
2. تحت اربط دليلك انسخ رابط SCIM الأساسي: https://api.polzy.ai/api/scim/v2.
3. تحت الرمز اختر إنشاء رمز. انسخه من النافذة التي تفتح: لا يُعرض إلا هذه المرة. لا يحتفظ Polzy إلا ببصمة له وبأحرفه الأولى للتعرّف عليه.
4. الصق الاثنين في الدليل كما تشرح الأقسام التالية.

• استبدال الرمز يمنحك رمزًا جديدًا ويُبقي الحالي يعمل 24 ساعة ريثما تلصق الجديد في الدليل.
• إلغاء يوقف كل الرموز دفعة واحدة، ومعها التزويد. ويبقى الأعضاء الذين أضافهم الدليل كما هم.
• النشاط الأخير يعرض عدد التغييرات التي أجراها الدليل خلال آخر 30 يومًا.
• مساحات العمل والأدوار يبيّن أين ينتهي الأشخاص الذين يرسلهم الدليل. ويفتح تعديل قواعد المجموعات خطوة الأشخاص من تسجيل الدخول الموحّد، حيث مساحة العمل الافتراضية والدور الافتراضي وقواعد المجموعات.

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

Okta

يعمل SCIM في Okta داخل التطبيق نفسه الذي أنشأته لتسجيل الدخول الموحّد. تُذكر قوائم المزوّدين بالإنجليزية كما تظهر.

1. في تبويب General للتطبيق اختر Edit تحت App Settings، واضبط Provisioning على SCIM واحفظ. يظهر تبويب Provisioning.
2. في تبويب Provisioning افتح Integration واختر Edit. الصق الرابط الأساسي في SCIM connector base URL وأدخل userName في Unique identifier field for users.
3. تحت Supported provisioning actions حدّد Push New Users وPush Profile Updates وPush Groups.
4. اضبط Authentication Mode على HTTP Header والصق الرمز بوصفه bearer token في Authorization. اختر Test Connector Configuration ثم Save.
5. تحت To App اختر Edit، وفعّل Create Users وUpdate User Attributes وDeactivate Users، ثم احفظ.
6. في تبويب Push Groups اختر Push Groups وادفع المجموعات التي تذكرها قواعد مجموعاتك. إسناد مجموعة في تبويب Assignments يرسل أشخاصها لا المجموعة نفسها: وحدها المجموعة المدفوعة تصل إلى قواعد مجموعاتك.

ترسل Okta اسم المستخدم في Okta بوصفه userName، لذا يجب أن يكون عنوان بريد الشخص في أحد نطاقاتكم المُتحقَّق منها.

أدلة Okta: Add SCIM provisioning to app integrations وEnable Group Push.

Microsoft Entra ID

1. في مركز إدارة Microsoft Entra افتح تطبيق المؤسسة Polzy الذي أنشأته لتسجيل الدخول الموحّد وانتقل إلى Provisioning.
2. اضبط Provisioning Mode على Automatic (في المستأجرين الأحدث اختر New configuration).
3. تحت Admin Credentials الصق الرابط الأساسي بوصفه Tenant URL والرمز بوصفه Secret Token. اختر Test Connection ثم احفظ.
4. تحت Mappings افتح ربط المستخدمين وتحقّق من مصدر userName: userPrincipalName افتراضيًا، أو mail إن لم تكن أسماء تسجيل الدخول لدى فريقك هي عناوين بريدهم.
5. تحت Settings اضبط النطاق على Sync only assigned users and groups، وعيّن الأشخاص والمجموعات تحت Users and groups.
6. اضبط Provisioning Status على On واحفظ.

يُجري Entra التزويد في دورات مدّتها نحو 40 دقيقة. ويرسل Provision on demand شخصًا واحدًا، أو مجموعة حتى خمسة أشخاص، فورًا: أسرع طريقة للتجربة.

يرسل Entra المجموعات المُسندة إلى التطبيق مع معرّف الكائن الخاص بها بوصفه externalId، فيمكن لقاعدة المجموعة أن تسمّي المجموعة باسمها أو بمعرّف الكائن هذا، وهو ما ترسله مطالبة المجموعات في Entra عند تسجيل الدخول.

أدلة Microsoft: Develop and plan provisioning for a SCIM endpoint وConfigure automatic user provisioning وProvision a user or group on demand.

OneLogin

يُجري OneLogin التزويد عبر موصّله SCIM Provisioner with SAML، الذي يسجّل دخول الأشخاص بـ SAML أيضًا: يمكنك إعداد تسجيل الدخول الموحّد في التطبيق نفسه بالقيم الواردة في قسم OneLogin من دليل تسجيل الدخول الموحّد.

1. انتقل إلى Applications ← Add App وأضف SCIM Provisioner with SAML (المخطط الأساسي core). سمِّه Polzy.
2. في تبويب Configuration الصق الرابط الأساسي في SCIM Base URL والرمز في SCIM Bearer Token. أبقِ SCIM JSON Template الافتراضي الذي يرسل عنوان البريد بوصفه userName. احفظ، ثم اختر Enable تحت API Connection.
3. في تبويب Provisioning حدّد Enable provisioning.
4. في تبويب Parameters افتح Groups وحدّد Include in User Provisioning.
5. امنح من يستخدمون Polzy الوصول إلى التطبيق.

دليل OneLogin: Create a SCIM app.

JumpCloud

1. في JumpCloud Admin Portal افتح تطبيق Polzy تحت Access ← SSO Applications وانتقل إلى تبويب Provisioning.
2. الصق الرابط الأساسي في Base URL والرمز في Token. تحت Test User Email أدخل عنوان شخص موجود أصلًا في Polzy، واختر Test Connection.
3. فعّل Enable management of User Groups and Group Membership in this application ثم اختر Activate. أما اختيار Save بدلًا منه فيُبقي التزويد متوقفًا.
4. في تبويب User Groups أضف المجموعات التي تستخدم Polzy.

دليل JumpCloud: Integrate with custom SCIM.

Ping Identity

1. في PingOne انتقل إلى Integrations ← Provisioning وأضف New Connection من نوع Identity Store ← SCIM Outbound.
2. أدخل الرابط الأساسي في SCIM Base URL، و/Users في Users Resource، و/Groups في Groups Resource، واختر SCIM 2.0.
3. اضبط Authentication Method على OAuth 2 Bearer Token، والصق الرمز في OAuth Access Token، واختر Test connection.
4. اضبط User Identifier على عنوان البريد، واسمح بإنشاء المستخدمين وتحديثهم وتعطيلهم وإلغاء تزويدهم.
5. أضف قاعدة صادرة تذكر الأشخاص والمجموعات المطلوب تزويدهم: الاتصال وحده لا يزوّد أحدًا.

أدلة Ping Identity: Creating a SCIM connection وCreating an outbound rule.

Google Workspace

يُجري Google Workspace التزويد للتطبيقات خارج كتالوجه عبر ملفات SCIM مخصّصة، وهي ميزة تجريبية متاحة لعدد محدود من المشاركين. إن كانت متاحة في Google Workspace لديكم، فاضبط التزويد التلقائي على تطبيق SAML باسم Polzy مع الرابط الأساسي بوصفه Endpoint URL والرمز بوصفه Access token.

دليل Google: Set up automated user provisioning with custom SCIM profiles.

دليل SCIM 2.0 آخر

يعمل أي عميل SCIM 2.0 يستطيع إرسال bearer token. وجّهه إلى الرابط الأساسي وأرسل Authorization: Bearer متبوعًا بالرمز.

• المستخدمون والمجموعات. /Users و/Groups، مع التصفية حسب userName وemails.value وexternalId (المعامل eq مع الربط بـ and؛ ويُطابَق userName وemails.value دون اعتبار لحالة الأحرف). وتصل عضوية المجموعات عبر /Groups، بـ POST أو PUT أو PATCH؛ أما السمة groups المرسلة مع المستخدم فهي للقراءة فقط في SCIM وتُتجاهل.
• ما يحمله المستخدم. userName (عنوان البريد) وname.givenName وname.familyName وexternalId وactive. ومن امتداد المؤسسات يملأ department وemployeeNumber حقول مساحة العمل التي تحمل الاسم نفسه، ويحدّد manager مدير الشخص حيث تكون خطوط التبعية مفعّلة.
• غير مدعوم. الطلبات المجمّعة (bulk) والفرز وETags وتغيير كلمات المرور.
• حدّ المعدّل. 600 طلب في الدقيقة لكل رمز.

ما يفعله Polzy

• الأعضاء الحاليون. يُتعرّف على من هو موجود في مؤسستكم من عنوان بريده. وإن كان قد انضم بتسجيل الدخول عبر مزوّد الهوية، يتولّى الدليل عضويته حالما يرسل مجموعة ينتمي إليها، ومن ثمّ تحدّد قواعد المجموعات دوره؛ ولا يخفض هذا التولّي دوره أبدًا. أما من دعاه مسؤول فيحتفظ بمساحات عمله وأدواره.
• المجموعات. الشخص في مجموعة تذكرها قاعدة عضو في مساحة عمل تلك القاعدة، بأقوى دور تمنحه مجموعاته، ولا يقلّ في مساحة العمل الافتراضية عن الدور الافتراضي. وتُطبَّق القواعد كلما أضاف الدليل شخصًا إلى مجموعة أو أخرجه منها: ينشئ Okta وMicrosoft Entra ID الشخص أولًا ثم يضيفانه إلى المجموعة بعد لحظة، فيتبعه الدور حينها. وتتعرّف القاعدة على المجموعة من اسمها دون اعتبار لحالة الأحرف، أو من المعرّف الذي يرسله الدليل بوصفه externalId. ومغادرة المجموعة تزيل تلك العضوية، ما لم تمنحها مساحة العمل الافتراضية أو قاعدة أخرى.
• ما يبقى لكم. العضويات التي أنشأها مسؤول يدويًا لا يزيلها الدليل ولا يغيّرها أبدًا. ولا يعطّل الدليل المالك ولا يزيله أبدًا، ومن حظره المالك يبقى محظورًا.
• المقاعد. تحتاج كل عضوية إلى مقعد شاغر. وحين لا يوجد مقعد، يرفض Polzy التغيير ويبلّغ الدليل عن الخطأ. تعطيل شخص يحرّر مقاعده؛ وإعادة تفعيله تحتاج إلى مقاعد شاغرة.
• سجل التدقيق. يُسجَّل كل تغيير يجريه الدليل في سجل التدقيق، مع الدليل (SCIM) بوصفه الفاعل.

عندما تغيّر مساحة العمل الافتراضية أو قواعد المجموعات في خطوة الأشخاص لتسجيل الدخول الموحّد، يُعاد توزيع كل من وزّعهم الدليل وفقها في الخلفية.

حلّ المشكلات

يعرض الدليل ردّ Polzy بالإنجليزية في سجل التزويد. الأكثر شيوعًا:

الحدود

• SCIM 2.0 للمستخدمين والمجموعات، مُختبَر مع تزويد Okta وMicrosoft Entra ID.
• دليل واحد لكل مؤسسة، عبر رمز واحد في كل مرة.
• يجب أن تكون أسماء المستخدمين عناوين بريد في نطاقاتكم المُتحقَّق منها، ولا يمكن أن يتغيّر اسم المستخدم.
• لا يمكن لـ SCIM ولمزامنة الأشخاص إدارة المؤسسة نفسها معًا.
• حذف شخص يزيل عضوياته لا بياناته: محو الشخص خطوة منفصلة يتّخذها مسؤول من سجلّه. راجع الأشخاص وجهات الاتصال والحقول.

روابط مفيدة

• Okta: Add SCIM provisioning to app integrations
• Microsoft: Develop and plan provisioning for a SCIM endpoint
• OneLogin: Create a SCIM app
• JumpCloud: Integrate with custom SCIM
• Ping Identity: Creating a SCIM connection
• إعداد تسجيل الدخول الموحّد الذي يُبنى عليه SCIM.