> For the complete documentation index, see [llms.txt](https://library.zoom.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://library.zoom.com/technical-library/technical-library-ar/rkn-almsuwl/account-and-endpoint-management/scim-guide.md). # دليل SCIM لـ Entra ID وOkta دليل لإنشاء تعيينات SCIM مخصصة بين Entra ID أو Okta وZoom ## نظرة عامة تتيح واجهة برمجة التطبيقات SCIM2 الخاصة بـ Zoom كتالوجًا كبيرًا من سمات المستخدم التي تتحكم في الترخيص، وحقوق المنتج، والأدوار، والمناطق، والتكوين لكل خدمة. إن عمليات التكامل الافتراضية للتزويد لكلٍ من Microsoft Entra ID وOkta لا تعيّن سوى مجموعة فرعية صغيرة من هذه السمات — وهي كافية لإنشاء المستخدمين وتحديثهم وتعطيلهم، لكنها ليست كافية لتزويد مواقع Zoom Phone، وحِزم مركز الاتصال، وأدوار Revenue Accelerator، أو أيٍّ من العشرات من السمات الأخرى التي يدعمها Zoom. يشرح هذا الدليل الطريقة القابلة للتكرار لإضافة *أي* سمة SCIM من Zoom إلى إعدادات التزويد لديك. وبدلًا من توثيق سمة واحدة بمعزل عن غيرها، فإنه يوضح النموذج الأساسي بحيث يمكن للمسؤولين البحث عن سمة في مرجع واجهة برمجة التطبيقات SCIM2 الخاصة بـ Zoom و كوَّنها بشكل مستقل، دون انتظار نشر مقال خاص بمنتج معين. ### كيفية استخدام هذا الدليل اقرأ قسم المقدمة بدءًا من [**فهم سمات SCIM**](#understanding-scim-attributes) أولًا، إلى جانب الأقسام التي تليه — المتطلبات المسبقة، وبيانات الدليل، والسيناريوهات المرجعية، والتحقق من جانب Zoom. تنطبق هذه العناصر بغض النظر عن موفر الهوية (IdP) الذي تستخدمه. ثم تابع قسم Microsoft Entra ID أو قسم Okta بحسب ما تستخدمه. كل جزء من هذين الجزءين مكتمل من أول خطوة في التكوين وحتى التحقق والأمثلة العملية؛ ولن تحتاج إلى التنقل بينهما. للاطلاع على مفاهيم SSO وSCIM الأساسية التي تقوم عليها هذه الإرشادات، راجع [دليل SSO الميداني](https://library.zoom.com/admin-corner/account-and-endpoint-management/sso-field-guide)، الـ [مقالة Zoom SSO والتزويد الخاصة بـ Entra ID](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064121)، و الـ [مقالة Zoom SSO الخاصة بـ Okta](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063256). {% hint style="danger" %} **تحذير** يؤثر التزويد المُهيأ بشكل غير صحيح على المستخدمين الحاليين، بما في ذلك إزالة التراخيص المستخدمة بالفعل. تحقّق من كل تغيير مقابل مستخدم اختبار واحد قبل تطبيقه على مجموعة حية. {% endhint %} ### **المتطلبات الأساسية لاستخدام SCIM** ينطبق كل ما في هذا الجزء بغض النظر عن موفّر الهوية. اقرأ هذا قبل الانتقال إلى التعليمات الخاصة بموفّر الهوية لديك. #### المتطلبات المشتركة لكلا موفري الهوية * الأعمال أو التعليم أو خطة Enterprise لحساب Zoom مع موافقة معتمدة [URL فارغ](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0061540) * Zoom مالك الحساب أو مسؤول الصلاحيات * [تسجيل الدخول لمرة واحدة](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060673) مفعّل على حساب Zoom * أ [النطاق المرتبط الذي تم التحقق منه](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0066259) على حساب Zoom، بما يطابق نطاق البريد الإلكتروني للمستخدمين الذين يتم توفيرهم * تم بالفعل إعداد توفير SCIM بين موفّر الهوية وZoom * يجب أن يكون كائن الترخيص أو الخطة أو المكون الإضافي أو كائن التكوين الذي يتم تعيينه موجودًا بالفعل ومتاحًا على حساب Zoom تُسرد المتطلبات الخاصة بكل مزود هوية في بداية كل قسمٍ على حدة. #### القيود المشتركة بين كلا مزودي الهوية * يعيّن SCIM الاستحقاقات الموجودة فقط؛ ولا يمكنه إنشاء الكائنات التي يشير إليها. راجع القسم [**قبل محاولة التعيين المتقدم، يجب أن تكون الكائنات على جانب Zoom موجودة قبل أن يتمكن SCIM من الإشارة إليها**](#before-attempting-advanced-mapping-zoom-side-objects-must-exist-before-scim-can-reference-them) أدناه. * تقبل بعض السمات قيمة واحدة فقط لكل مستخدم. وتُعد خطة اتصال Zoom Phone أحد الأمثلة — لا يمكن تزويد حزم مكون إضافي مثل حزمة Customer Engagement Pack عبر SCIM. * الـ `userType` توثّق Zoom هذه السمة على أنها مخططة للإهمال. ## **مقدمة** ### **فهم سمات SCIM** المسؤولون الذين يفهمون كيفية تكوين سمة SCIM في Zoom يمكنهم كوَّن أي سمة يدعمها Zoom. المسؤولون الذين يتبعون وصفة يمكنهم كوَّن السمة الوحيدة التي تصفها تلك الوصفة. يغطي هذا القسم التكوين. وتأتي مواءمة سمة مع مصدر بيانات لاحقًا، في أقسام موفّر الهوية. #### لكل سمة مساحة اسم، واسم، ونوع بيانات، وقيمة مسموح بها لنبدأ بمثال كامل وعملي. هذا هو معرِّف تعيين مستخدم إلى موقع Zoom Phone: ``` urn:ietf:params:scim:schemas:extension:zoom:1.0:مستخدم:zoomPhoneSite ``` أربع خصائص لهذه السمة قيد الاستخدام. اثنتان منها ظاهرتان في السطر أعلاه. أما الاثنتان الأخريان فتأتيان من مرجع واجهة برمجة التطبيقات ويتم إدخالهما في مكان آخر ضمن موفر الهوية الخاص بك لاحقًا. ولأغراضنا المباشرة، نركز على اثنتين: الـ **مساحة الاسم** و الـ **الاسم**.
الخاصيةمستخرج من المثالما الذي يفعله
مساحة الاسمurn:ietf:params:scim:schemas:extension:zoom:1.0:مستخدميُخبر Zoom بالمخطط الذي ينتمي إليه الإعداد، ويعمل كأساس مشترك تقريبًا لكل سمة من سمات منتجات Zoom وسمات الترخيص. يُمرَّر إلى Zoom باعتباره النصف الأول من المعرِّف.
الاسمموقع Zoom Phoneيحدِّد إعداد Zoom المحدد الذي تتم كتابته — هنا، موقع Zoom Phone الخاص بالمستخدم. يُمرَّر إلى Zoom باعتباره النصف الثاني من المعرِّف. حسّاس لحالة الأحرف.
نوع البياناتسلسلةيُخبر موفّر الهوية بنوع القيمة التي تحتويها السمة حتى تُخزَّن وتُنسَّق بشكل صحيح. لا تُمرَّر كجزء من المعرِّف؛ وتُصرَّح بشكل منفصل كـ النوع في Entra ID، أو نوع البيانات في Okta.
القيمة المسموح بهاLON-01، اسم موقع Zoom Phoneالإعداد المطبق فعليًا على المستخدم. نص حر لبعض السمات، ومجموعة ثابتة لغيرها — أساسيات, بريميوم، أو إليت لمركز الاتصال الخاص بـ Zoom، على سبيل المثال. يُمرَّر إلى Zoom عند وقت التزويد، ويُوفَّر بواسطة التعيين بدلاً من المعرِّف.
{% hint style="danger" %} **تحذير** ينشر Zoom أكثر من مساحة اسم امتداد مستخدم واحدة. تستخدم سمات تهيئة المنتج والترخيص `urn:ietf:params:scim:schemas:extension:zoom:1.0:مستخدم`, والتي هي مساحة الاسم التي يستخدمها هذا الدليل طوال الوقت. حقول المؤسسة معياري مثل `القسم`, `مدير`، و `مركز التكلفة` استخدم `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User`. ثالثًا، `urn:us:zoom:scim:schemas:extension:1.0:ZoomUser`، يحمل معلومات نوع تسجيل الدخول التي يتم إرجاعها في استجابات واجهة برمجة التطبيقات بدلاً من تهيئتها أثناء التزويد. يتم قبول سمة مبنية على مساحة الاسم الخاطئة من قِبل موفر الهوية لديك ويتم تجاهلها بصمت بواسطة Zoom. {% endhint %} #### حدّد موقع السمة التي تحتاجها في مرجع واجهة برمجة التطبيقات SCIM2 الـ [مرجع واجهة برمجة التطبيقات SCIM2](https://developers.zoom.us/docs/api/scim2/#tag/user/post/scim2/Users) هي القائمة المرجعية المعتمدة لكل ما يقبله Zoom أثناء التزويد. عمليتان مهمتان: **إنشاء مستخدم** و **تحديث مستخدم**. اعمل أساسًا من **تحديث مستخدم**. يحدث الإنشاء مرة واحدة لكل شخص، لكن تغييرات السمات تحدث باستمرار — نقل إلى مكتب آخر، تغيير الخطة، تغيير دور، شخص يغادر — لذا فإن معظم ما يفعله التزويد فعليًا بمرور الوقت هو التحديثات. **تحديث مستخدم** كما يوثّق أيضًا قيم الإزالة التي **إنشاء مستخدم** ليس لديه سبب لتضمينها، مثل تعيين `zoomPhoneCallingPlan` إلى `-1` لإزالة جميع خطط الاتصال من مستخدم. للعثور على سمة: * افتح مرجع واجهة برمجة التطبيقات SCIM2 وانتقل إلى **تحديث مستخدم**. * في نص الطلب، حدِّد `urn:ietf:params:scim:schemas:extension:zoom:1.0:مستخدم` الكائن. تُدرَج كل سمة مغطاة في هذا الدليل بداخله. * اعثر على السمة الخاصة بك بالاسم، وسجّل التسجيل الخاص بها **نوع البيانات** و **القيم المسموح بها**. * اقرأ الوصف المرافق لها. تحمل الأوصاف سلوكًا لا يمكنك استنتاجه من اسم السمة — `zoomPhoneExtNumber` تم تعيينه إلى `0` يؤدي إلى تعيين تحويلة تلقائيًا، `zoomPhoneCallingPlan` تم تعيينه إلى `-1` يزيل جميع خطط الاتصال، و `zoomPhoneNumber` يجب أن يشير إلى رقم غير مخصص بالفعل في حساب Zoom. #### تجميع المعرِّف: الأصل، النقطتان، الفرع كل ما هو مُدرَج داخل ذلك `urn:ietf:params:scim:schemas:extension:zoom:1.0:مستخدم` الكائن هو **فرع** منه. أما الكائن نفسه فهو الـ **الأصل**'. يعني بناء معرِّف تسمية الأصل، ثم إضافة نقطتين، ثم إضافة الفرع: ``` الأصل urn:ietf:params:scim:schemas:extension:zoom:1.0:مستخدم النقطتان : الفرع zoomPhoneSite معرِّف urn:ietf:params:scim:schemas:extension:zoom:1.0:مستخدم:zoomPhoneSite ``` هذا هو البناء بأكمله. لا توجد أيّ قائمة بحث لطلبها من Zoom ولا شيء لتوليده — المعرِّف هو شيآن لديك بالفعل، مرتبطان بنقطتين. #### يبقى الأصل كما هو؛ ويتغير الفرع فقط لأن الأصل ثابت، فإن إعداد سمة ثانية أو خامسة أو خامسة عشرة هو الإجراء نفسه مع إلحاق فرع مختلف: ``` الأساس (الأصل) urn:ietf:params:scim:schemas:extension:zoom:1.0:مستخدم موقع Zoom Phone urn:ietf:params:scim:schemas:extension:zoom:1.0:مستخدم:zoomPhoneSite رقم Zoom Phone urn:ietf:params:scim:schemas:extension:zoom:1.0:مستخدم:zoomPhoneNumber تحويلة Zoom Phone urn:ietf:params:scim:schemas:extension:zoom:1.0:مستخدم:zoomPhoneExtNumber خطة مكالمات Zoom Phone urn:ietf:params:scim:schemas:extension:zoom:1.0:مستخدم:zoomPhoneCallingPlan ``` يحمل الأصل نفسه كل منتج آخر من منتجات Zoom. لا شيء في هذا البناء يتغير عندما يتغير المنتج: ``` حزمة البرامج مركز الاتصال urn:ietf:params:scim:schemas:extension:zoom:1.0:مستخدم:zoomContactCenterPackage دور Revenue Accelerator urn:ietf:params:scim:schemas:extension:zoom:1.0:مستخدم:zoomRevenueAcceleratorRole حزمة Workplace urn:ietf:params:scim:schemas:extension:zoom:1.0:مستخدم:zoomWorkplace Zoom Docs urn:ietf:params:scim:schemas:extension:zoom:1.0:مستخدم:zoomDocs ``` لذلك، تتعلم الأصل مرة واحدة. ومن ثم، يعني تكوين سمة جديدة البحث عن ثلاثة أمور فقط في مرجع واجهة برمجة التطبيقات: اسم العنصر الفرعي، ونوع بياناته، وقيمه المسموح بها. إذا كنت تستطيع تجميع أصل وعنصر فرعي، فقد تجاوزت أصعب جزء في هذا التكوين. وما يتبقى هو إخبار موفر الهوية الخاص بك بمصدر كل قيمة — وهو ما تغطيه أقسام Entra ID وOkta التالية — وتحديد السمات التي ينبغي البدء بها أولاً، وهو ما سيتم تناوله تالياً. #### نوعان من التعيين: أساسي ومتقدم لا تنطوي كل سمة على مستوى المخاطر نفسه، ومن المفيد فرزها قبل تكوين أي شيء. يستعير هذا الدليل المصطلحات **أساسي** و **متقدم** من الـ [دليل SSO الميداني](https://library.zoom.com/admin-corner/account-and-endpoint-management/sso-field-guide)، الذي يرسم الخط نفسه لتعيين استجابة SAML. تصف المصطلحات **ما الذي يفعله Zoom بالقيمة عند وصولها**، وليس مدى صعوبة كوَّن السمة. من الناحية الآلية، الاثنان متطابقان: فكلاهما موثَّق في نفس **تحديث مستخدم** جسم الطلب، وكلاهما يُبنى بالتركيب نفسه أب:ابن، وكلاهما مُعلَن ومُعيَّن عبر الخطوات نفسها في Entra ID وOkta. * **تعيين أساسي** يكتب نصًا في ملف تعريف مستخدم. يخزّن Zoom القيمة كما أُرسلت تمامًا ولا يتحقق منها مقابل أي شيء. * **تعيين متقدم** يُنشئ مطالبة على الحساب. يأخذ Zoom القيمة ويبحث عن كائن مطابق، أو عن مقعد شاغر في خطة مشتراة — وقد تفشل عملية البحث هذه.
تعيين أساسيتعيين متقدم
ما هي القيمةالنص المخزن في ملف المستخدم الشخصيمؤشر إلى كائن في Zoom، أو مطالبة بمقعد تم شراؤه
أمثلةالقسم, العنوان, مركز التكلفةموقع Zoom Phone, دور مركز اتصال زوم, زووم وورك بليس
الوالدالمستوى الأعلى، أو امتداد المؤسسةإضافة Zoom
الشروط المسبقة في Zoomلا شيءيجب أن يكون الكائن موجودًا، أو يجب أن يكون المقعد شاغرًا
إذا كانت القيمة خاطئةيظهر نص غير صحيح في الملف الشخصيتُرفض السمة، أو يتم تجاهلها بصمت
هذا التمييز يقود إلى قرارين عمليين. وهو يحدد **ما الذي يجب عليك بناؤه في Zoom أولًا** — لا شيء في التعيين الأساسي، وربما الكثير في المتقدم — وهو يحدد **ما تكلفة الخطأ**. قسم خاطئ هو خطأ تجميلي في ملف مستخدم. اسم موقع خاطئ أو مقعد ترخيص غير متاح يترك مستخدمًا من دون هاتف يعمل أو من دون المنتج الذي تم توظيفه لاستخدامه، وفي بيئة نشر حيّ يمكن أن يسلب استحقاقًا من شخص كان يملكه بالفعل. هذا الاختلاف في العواقب هو السبب في أن الاثنين يُعالجان بشكل منفصل أدناه. #### التعيين الأساسي: معلومات الملف الشخصي يملأ التعيين الأساسي الحقول الوصفية في ملف Zoom الشخصي الخاص بمستخدم. يخزن Zoom كل قيمة تمامًا كما تم إرسالها ولا يتحقق منها مطلقًا مقابل كائن موجود، لذا لا يوجد شيء يجب إنشاؤه مسبقًا في Zoom ولا شيء قد يتعطل إذا كانت قيمة ما خاطئة. **تكون حقول الهوية الأساسية مُعيَّنة عادةً بالفعل.** `اسم المستخدم`, `name.الاسم الأول`, `name.اسم العائلة`, `اسم العرض`، و `عناوين البريد الإلكتروني` توجد في المستوى الأعلى من جسم الطلب دون أي عنصرٍ أصل على الإطلاق، كما أن تكاملي Entra ID وOkta يعيّنانها مباشرةً بشكل افتراضي. تحقّق منها بدلًا من إعادة بنائها. `العنوان`, `أرقام الهواتف`، و `الإعدادات المحلية` هي أيضًا على المستوى الأعلى، ولكن قد تحتاج إلى إضافة. **تستخدم الحقول خطة Enterprise أحد الوالدين الثاني.** التركيب لا يتغير — وإنما يتغير العنصر الأب فقط: ``` الأساس (الوالد) urn:ietf:params:scim:schemas:extension:enterprise:2.0:User القسم urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department مركز التكلفة urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter رقم الموظف urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber مؤسسة urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization مدير urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager ``` لم يعد ملء القسم ومركز التكلفة من خلال SCIM يتطلب تعيين SAML. {% hint style="info" %} **توصية** قم بتعيين سمة أساسية واحدة أولاً — `القسم` هو مرشح جيد، ويتم العمل عليه بوصفه **السيناريو 0** في سيناريوهات المرجع — وشغّله من البداية إلى النهاية لمستخدم اختبار واحد قبل تهيئة أي شيء ضمن امتداد Zoom. A `القسم` القيمة التي تظهر بشكل صحيح في ملف تعريف Zoom تثبت تعريف المخطط، والتعيين، والنطاق، وقدرتك على قراءة سجلات التزويد. كل سمة متقدمة تلي ذلك تختلف فقط في الجهة التي تشير إليها، لا في كيفية إعدادها. {% endhint %} #### التعيين المتقدم: تكوين المنتج وحقوق الاستخدام يُسنِد التعيين المتقدّم الأشياء التي يمكن للمستخدم القيام بها: موقع و خطة مكالمات في Zoom Phone، ودور مركز الاتصال وحزمة البرامج، وحزمة Workplace، وقطاع Revenue Accelerator. تعيش هذه السمات تحت الأصل الأب لامتداد Zoom المستخدم عبر هذا الدليل. الفرق المهم هو أن هذه القيم لا تُخزَّن — بل يتم **حلّها**. يأخذ Zoom القيمة التي ترسلها ويبحث عن كائن مطابق أو مقعد متاح. حيث يكتب التعيين الأساسي نصًا في الملف الشخصي، فإن التعيين المتقدّم يقدّم مطالبة على إعدادات الحساب والمخزون، ويمكن أن تفشل هذه المطالبة. لهذا السبب يخصّص هذا الدليل قسمًا كاملًا للشروط المسبقة. تعتمد كل سمة متقدّمة على أن يكون شيء ما قد تم إنشاؤه أو شراؤه أولًا في بوابة Zoom الإلكترونية، كما أن أوضاع الفشل أقل تسامحًا بكثير من خطأ إملائي في المسمى الوظيفي. #### الطبقات الثلاث المشتركة في كل إعداد بغض النظر عن السمة أو موفّر الهوية المستخدم، فإن العمل يتكوّن من الطبقات الثلاث نفسها. يختلف فقط موضع كل عنصر تحكم.
الطبقةالغرضMicrosoft Entra IDOkta
1. إعلانأخبر موفّر الهوية بأن السمة موجودة في تطبيق Zoom حتى تصبح متاحة كهدف للتعيين.الخطوة 1الخطوة 1
2. تعيينحدّد مصدر القيمة.الخطوة 2الخطوتان 2–3
3. تحديد النطاقحدّد المستخدمين الذين ينطبق عليهم الإعداد ومتى يتم تنفيذه.الخطوات 3–5الخطوات 4–5
بمجرد فهم هذا النمط، فإن إضافة سمة خامسة أو خامسة عشرة ليست سوى تكرار للطبقات الثلاث نفسها، وليست مشروعًا جديدًا. #### تختلف Entra وOkta في مصدر القيمة هذا هو الفارق المعماري الوحيد الأكثر تأثيرًا بين المسارين، وهو يفسّر لماذا ينتج عن نفس المتطلب التجاري إعدادات مختلفة بين Entra وOkta. * **يستمد Entra ID القيم من سمات كائن المستخدم فقط.** يجب أن تأتي القيمة من حقل في المستخدم — إما حقل موجود في الدليل أو سمة امتداد مصممة لغرض معين. وعندما لا تكون قيمة الدليل وقيمة Zoom السلسلة نفسها، تصبح هناك حاجة إلى تعبير للترجمة بينهما. * **يمكن لـ Okta استمداد القيم من ملف تعريف المستخدم أو من تعيين مجموعة.** إعلان سمة باستخدام **نوع السمة: مجموعة** يتيح تعيين القيمة مرة واحدة على مجموعة ثم وراثتها من قِبل كل عضو. وعندما يتبع الإعداد البنية التنظيمية، فإن هذا يزيل الحاجة إلى منطق ترجمة بالكامل. لا يوجد أيٌّ من النهجين أفضل على الإطلاق، لكنهما يقودان إلى إعدادات مختلفة. ### **متطلبات الإعداد المسبق على جانب Zoom** #### قبل محاولة التعيين المتقدم، يجب أن تكون الكائنات على جانب Zoom موجودة قبل أن يتمكن SCIM من الإشارة إليها SCIM هي آلية تعيين، وليست آلية إنشاء — فهي تربط المستخدم بإعداد موجود بالفعل على حساب Zoom، وهي **لا يمكنها** إنشاء هذا الإعداد نيابةً عن المستخدم. جزء كبير من سمات التعيين المتقدّم هي **مراجع**: يُتوقَّع أن تؤدي القيمة التي ترسلها إلى كائن موجود بالفعل في Zoom — موقع، أو دور، أو قالب، أو حزمة تم شراؤها، أو رقم أو رقم داخلي محدد. تحكم قاعدة واحدة جميع هذه الحالات: > إذا كانت السمة تُسمّي شيئًا ما، فيجب أن يكون هذا الشيء موجودًا بالفعل، وأن تكون تهجئته مطابقة تمامًا لما أُرسل، و— عندما يستند إلى مخزون محدود — يجب أن تكون هناك سعة غير مستخدمة. عندما لا يكون الكائن المشار إليه موجودًا، فإن SCIM لا ينشئه ولا يضع الطلب في قائمة انتظار. إما أن تفشل السمة فشلًا صريحًا، مع إرجاع الخطأ في سجل التزويد، أو يتم تجاهلها بصمت — يقبل Zoom الحمولة، ولا يطبّق شيئًا، ويبلغ عن نجاح. تقسّم الأقسام أدناه الشروط المسبقة حسب المنتج، مع مسار التنقل ومقال الدعم لكل عنصر. اقرأ ملاحظات مستوى الحساب أولًا، ثم القسم الخاص بكل منتج تنوي توفيره. #### تنطبق الشروط المسبقة على مستوى الحساب قبل أن يتم توفير أي منتج متطلبات الحساب المذكورة في بداية هذا الدليل — URL فارغ، وSSO، وتفويض SCIM، ونطاق مرتبط تم التحقق منه — هي شروط مسبقة لكل سمة تلي ذلك. يتم إعداد الأربعة جميعًا ضمن **متقدمة** → **الأمان** / **تسجيل الدخول لمرة واحدة** / **النطاقات المرتبطة**؛ انظر [إعداد SSO/SCIM لـ Zoom + Microsoft Entra ID](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064121). هناك نقطتان إضافيتان تستحقان التصريح بهما بوضوح: * **شراء مقعد ليس هو نفسه تعيينه.** ينفّذ SCIM عملية التعيين، ولكن يجب أن يكون المقعد موجودًا أولًا. انظر [تعيين تراخيص Zoom أو إزالتها من المستخدمين](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064911). * **يجب أن تنتمي المقاعد إلى الخطة الدقيقة المطلوبة.** إن إرسال سمة ترخيص عندما لا تحتوي تلك الخطة المحددة على مقاعد متاحة يؤدي إلى الفشل حتى إذا كانت خطة أخرى في الحساب تُظهر سعة متبقية. #### Zoom Phone يحتوي Zoom Phone على أكبر مجموعة من سمات المراجع لأن مستخدم الهاتف يتكوّن من عدة أجزاء من بنية تحتية تم شراؤها أو إنشاؤها مسبقًا. | السمة | ما الذي يجب أن يكون موجودًا بالفعل | كيفية إنشائه | | ------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | ترخيص Zoom Phone نفسه | مقعد متاح في Zoom Phone — الاستحقاق المسبق قبل أن يتم إرفاق أي شيء مما يلي. | اشترِ مسبقًا. انظر [شراء وتعيين تراخيص Zoom Phone](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0077929). | | `موقع Zoom Phone` | الموقع، مطابقًا تمامًا للقيمة المرسلة. يؤدي حذف السمة إلى تعيين الموقع الرئيسي للحساب، وهو موجود افتراضيًا بمجرد تفعيل عدة مواقع. | مركز الإدارة → تهيئة المنتج → نظام الهاتف → معلومات الشركة → **إضافة موقع**، أو **استيراد** للإنشاء بالجملة. انظر [إدارة عدة مواقع](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0069716). | | `zoomPhoneNumber` | الرقم، الذي تم شراؤه أو نقله إلى الحساب وهو غير مخصّص حاليًا. لا يمكن إعادة استخدام رقم يحتفظ به بالفعل مستخدم آخر أو قائمة انتظار مكالمات أو المجيب الآلي. | مركز الإدارة → تهيئة المنتج → الأرقام → أرقام الهاتف. اشترِ هنا أو انقل هنا، واترك الرقم المستهدف غير مخصّص حتى يتمكن SCIM من المطالبة به. انظر [استخدام إدارة الأرقام لإدارة أرقام الهاتف](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0074457) و [إدارة أرقام الهاتف](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060212). | | `zoomPhoneExtNumber` (قيم محددة فقط) | امتداد مكوّن من 3–6 أرقام، وغير مستخدم بالفعل. غير مطلوب عند إرسال `0`، الذي يفوّض التعيين إلى Zoom. | مركز الإدارة → تهيئة المنتج → نظام الهاتف → المستخدمون والغرف → يحدد الكائن الذي يحمل الامتداد → **الملف الشخصي** → **رقم داخلي** → **تعديل**। انظر [تغيير إعدادات مستخدم الهاتف](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0069338). | | `zoomPhoneCallingPlan` | خطة المكالمات، التي تم شراؤها وتتوفر لها سعة، والمشار إليها برمز الخطة الدقيق الخاص بها. | اشترِ مسبقًا. انظر [شراء وتعيين تراخيص Zoom Phone](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0077929) و [إدارة مستخدمي الهاتف](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0069309)। تُدرج رموز الخطة في [مرجع خطة مكالمات Zoom Phone](https://developers.zoom.us/docs/api/references/phone-calling-plans/)، أو تُرجَع كـ `النوع` من خلال [إدراج خطط المكالمات](https://developers.zoom.us/docs/api/references/phone-calling-plans/) واجهة برمجة التطبيقات إلى جانب أعداد المقاعد المتاحة. | | `zoomPhoneCallingPlanSubscription` (للحسابات متعددة الاشتراكات فقط) | الاشتراك المحدد الذي يجب أن تسحب منه الخطة، عندما يحتفظ الحساب بأكثر من اشتراك واحد للخطة نفسها. | الخطط والفوترة → إدارة الاشتراك. | **تكون مجموعة الامتدادات مشتركة بين أنواع الكائنات، وليس المستخدمين فقط.** تستهلك قوائم الانتظار، والمجيبون الآليون، ومجموعات الخط المشترك، وهواتف المنطقة المشتركة جميعها امتدادات من النطاق نفسه. وهذا هو السبب الأكثر شيوعًا لفشل "الامتداد مستخدم بالفعل" لأن الامتداد يبدو فارغًا عندما يتحقق المسؤول من قائمة المستخدمين فقط. **لا يمكن تعيين رقم تم نقله حتى تكتمل عملية النقل.** يجب أن يكون الرقم موجودًا في الحساب وغير مخصَّص؛ بدء عملية نقل لا يلبّي أيًا من الشرطين. **المواقع هي العائق الأكثر شيوعًا** لأن إنشاءها يحمل متطلبات خاصة بها. تُتحقق عناوين المواقع مقابل قاعدة بيانات عناوين حقيقية لأنها تقوم عليها خدمات إجراء مكالمات الطواريْ — تُرفَض تركيبات العناوين والرموز البريدية المُختلَقة مع خطأ في التحقق. عند استيراد المواقع بالجملة، يتوقع عمود المجيب الآلي القيمة `نعم` بدلًا من نص التسمية المعروض في الواجهة، ويُطبَّق اسم معرّف المتصل أساسًا على الولايات المتحدة وكندا ويمكن تركه فارغًا إذا تسبب في فشل التحقق. #### مركز الاتصال من Zoom يعتمد توفير مركز الاتصال على الدور والقالب. يجب أن تُحَلّ السمات الفردية إلى كائنات مركز الاتصال الموجودة، ويحمل القالب الإعدادات التي ليس لها سمة SCIM مخصّصة خاصة بها. | السمة | ما الذي يجب أن يكون موجودًا بالفعل | كيفية إنشائه | | ------------------------------- | ----------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `zoomContactCenterPackage` | الحزمة — `أساسيات`, `بريميوم`، أو `إليت` — تم شراؤها مع مقاعد غير مستخدمة. | الشراء مسبقًا؛ قد يتطلب Premium التواصل مع دعم Zoom لإجراء شراءٍ لحزم إضافية أولًا. انظر [تغيير إعدادات مستخدم مركز الاتصال من Zoom](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060874). | | `zoomContactCenterAddonsPlan` | خطة المكون الإضافي، مشتراة وبها سعة. | الشراء مسبقًا؛ خطة الحساب ومعلومات الفوترة. | | `دور مركز اتصال زوم` | الدور، معياري أو مخصص، بالاسم تمامًا. يؤدي حذفُه إلى أن يعيّن دور الوكيل الافتراضي، وهو موجود افتراضيًا. | إدارة مركز الاتصال → الأدوار → **إضافة** → كوَّن الأذونات → **حفظ**। انظر [إدارة أدوار مركز الاتصال من Zoom](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0061941). | | `zoomContactCenterRegion` | المنطقة. يؤدي حذفها إلى تعيين المنطقة الرئيسية للحساب، والتي يجب أن تُكوَّن. | إدارة مركز الاتصال → التفضيلات → المناطق → **إضافة منطقة** → يدخل اسمًا ويحدد منطقة SIP → **إضافة**। انظر [إدارة مناطق مركز الاتصال من Zoom](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0057668). | | `zoomContactCenterUserTemplate` | قالب المستخدم، بالاسم تمامًا. تُطبَّق قوالب الإضافة عند إنشاء المستخدم؛ وتُطبَّق قوالب التحديث عند التحديث. | إدارة مركز الاتصال → المستخدمون → القوالب → **إضافة قالب** → اختر **إضافة** → كوَّن الأدوار، الحزم، الطوابير، والمهارات → **إضافة**। انظر [إدارة قالب إعدادات مستخدم مركز الاتصال من Zoom](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0077757). | {% hint style="danger" %} **تحذير** يجب أن يفعّل دعم Zoom ميزة مناطق مركز الاتصال قبل أن يمكن إنشاء المناطق، وينتمي كل مستخدم إلى منطقة واحدة فقط. وبما أنه طلب دعم لا مجرد تبديل للخدمة الذاتية، فاطرحه مبكرًا إذا كان نشر متعدد المناطق مخططًا له. {% endhint %} **لا تملك صناديق الوارد والطوابير والمهارات أي سمة SCIM.** لتوفيرها، أنشئها مسبقًا في إدارة مركز الاتصال، وأرفقها بقالب مستخدم، وعيّن ذلك القالب عبر `zoomContactCenterUserTemplate`وبالتالي تصبح متطلبات مسبقة لـ *القالب* بدلًا من المستخدم الفردي — مما يجعل القالب أيضًا الكائن الوحيد الذي يجب الحفاظ عليه مع تغيّر تلك المتطلبات.
الكائنكيفية إنشائه
طابورإدارة مركز الاتصال → الطوابير → إضافة طابور → الاسم، القناة، الوكلاء → حفظ। انظر إدارة طوابير مركز الاتصال من Zoom.
مهارةإدارة مركز الاتصال → المهارات → يحدد فئة → إضافة مهارة → الاسم → إضافة। انظر إدارة المهارات وفئات المهارات.
صندوق الواردإدارة مركز الاتصال → صندوق الوارد → إضافة صندوق الوارد। انظر إدارة صناديق الوارد في Zoom مركز الاتصال.
**عندما يتم توفير قالب وسمات فردية معًا، فإن القيم الفردية هي التي تسود.** إرسال قالب إلى جانب `دور مركز اتصال زوم` يعني ذلك أن سمة الدور تتجاوز إعداد الدور في القالب، لذا يجب أن يكون كلٌّ من الدور المشار إليه والقالب موجودًا. #### Zoom Revenue Accelerator | السمة | ما الذي يجب أن يكون موجودًا بالفعل | كيفية إنشائه | | ------------------------------------------------------------------- | ------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `zoomRevenueAcceleratorPlan` و `zoomRevenueAcceleratorSubscription` | الخطة أو الاشتراك ZRA التي تم شراؤها مع مقعد متاح. | الشراء مسبقًا؛ خطة الحساب ومعلومات الفوترة. | | `zoomRevenueAcceleratorRole` | الدور، معياري أو مخصص — على سبيل المثال `مدير المبيعات` — مُسمّى تمامًا. | إدارة المستخدمين → الأدوار → **مسرّع الإيرادات** علامة تبويب → **+ إضافة دور** → الاسم والوصف → **إضافة** → كوَّن الأذونات → **حفظ التغييرات**। انظر [باستخدام إدارة الأدوار في Zoom Revenue Accelerator](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0059285). | | `zoomRevenueAcceleratorSegment` | القطاع الذي ينتمي إليه المستخدم. | إعدادات مسؤول Revenue Accelerator. | | `zoomRevenueAcceleratorRegion` | المنطقة — على سبيل المثال، `الولايات المتحدة`. | إعدادات مسؤول Revenue Accelerator. | #### تراخيص Zoom Workplace وأدوار الحساب إلى جانب المنتجات الثلاثة أعلاه، يحمل سجل المستخدم المعياري مراجع للدور والترخيص تتبع القاعدة نفسها. | السمة | ما الذي يجب أن يكون موجودًا بالفعل | كيفية إنشائه | | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `أدوار[]` (`القيمة` / `عرض`) | دور الحساب، المسمى بالضبط. تُشار الأدوار بواسطة SCIM، ولا يتم إنشاؤها بواسطته. | إدارة المستخدمين → الأدوار → **إضافة دور** → الاسم والوصف → كوَّن الأذونات. انظر [باستخدام إدارة الأدوار](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064983). | | `زووم وورك بليس` وخصائص الترخيص أو خصائص مكون إضافي أخرى — السبورة البيضاء، Scheduler، Clips Plus، التسميات التوضيحية المترجمة، Workforce Management، إدارة الجودة، إدارة الامتثال، CX Insights، مساعد المبيعات بالذكاء الاصطناعي، وخصائصها `...الاشتراك` النظائر | الحزمة المقابلة أو المكون الإضافي، المُشترى باستخدام المقاعد غير المستخدمة. | الخطط و فوترة → إدارة الخطة → تعديل الخطة → زيادة عدد التراخيص. انظر [ترقية الحساب ومكون إضافيّات](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063375). | | `نوع تسجيل الدخول` (`SSO` / `البريد الإلكتروني للعمل`)، تحت `urn:us:zoom:scim:schemas:extension:1.0:ZoomUser` | تم إعداد SSO على الحساب، لنوع تسجيل الدخول SSO. | متقدم → [تسجيل الدخول لمرة واحدة](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064121). | بالنسبة إلى سمة ترخيص أو مكون إضافي، لا يوجد كائن لتسميته، لكن الشرط المسبق مطابق في الأثر: من دون مقعد متاح في تلك المجموعة المحددة، تفشل عملية الإسناد. #### السمات التي بلا شرط مسبق كل سمة تعيين أساسية مؤهلة، كما هو مذكور ضمن **التعيين الأساسي: معلومات الملف الشخصي** — يخزن Zoom تلك القيم حرفيًا ولا يتحقق منها مطلقًا مقابل كائن موجود. وتعمل سمتان ضمن امتداد Zoom بالطريقة نفسها: * **القيم الموكلة تلقائيًا** — `zoomPhoneExtNumber` تُرسل كـ `0`, حيث يخصص Zoom الامتداد نفسه. * **سمات مخصصة للحساب** — الـ `{customAttribute}` حقل، يحتفظ بأي سلسلة نصية ترسلها. **مراجع افتراضية** تُعدّ حالة وسطية: حذف `موقع Zoom Phone`, `دور مركز اتصال زوم`، أو `zoomContactCenterRegion` يعود إلى الموقع الرئيسي، ودور الوكيل الافتراضي، والمنطقة الرئيسية على التوالي. يجب أن تكون هذه القيم الافتراضية موجودة هي نفسها، وهي موجودة افتراضيًا. **المجموعات استثناء جزئي.** عند تمكين توفير المجموعات، سيُنشئ SCIM مجموعة Zoom غير موجودة بعد، باستخدام اسم المجموعة المصدر كما هو مكتوب تمامًا. لا يطبّق أي تهيئة للمنتج على تلك المجموعة — تصل المجموعة مع الأعضاء ولا شيء غير ذلك. يجب أن تُضبط سياسات Zoom Phone، وأذونات الاتصال، وغيرها من الإعدادات على مستوى المجموعة ضمن إدارة المستخدمين → إدارة المجموعات بعد ظهور المجموعة. {% hint style="info" %} **توصية** اعتبر إعداد جانب Zoom مرحلةً تمهيديةً لها اعتمادها الخاص، وتُستكمل وتُتحقق منها قبل بدء عمل تعيين السمات. غالبًا ما تكون المواقع والأرقام والخطط والأدوار والقوالب مملوكة لفريق مختلف عن تهيئة موفّر الهوية، واكتشاف كائن مفقود أثناء اختبار التوفير يكلف أكثر بكثير من التأكد من وجوده مسبقًا. {% endhint %} ### **تهيئة بيانات الدليل لديك** ينقل SCIM أي شيء يحتويه المصدر. لا يتحقق منه، ولا يطبّعه، ولا يصححه. قبل تعيين أي سمة، تأكد من ثلاثة أمور بشأن المصدر المقصود: * **يتم تعبئته لكل مستخدم ضمن النطاق.** الحقل غير المعبأ لا يرسل شيئًا، أو يرسل الافتراضي المُهيأ. * **قيمه متسقة في التنسيق وحروفها الكبيرة والصغيرة.** منطق المقارنة في كلا موفري الهوية دقيق. * **تتطابق قيمه مع القيم المتوقعة من Zoom تمامًا.** لا تُجري Zoom مطابقة تقريبية لأسماء الموقع، أو أسماء الدور، أو قيم الخطة. عندما لا يستطيع حقل موجود تلبية الشروط الثلاثة جميعها، فإن سمة مصممة لغرض ومعبأة عمدًا لهذا التكامل أكثر استدامة من إعادة توظيف حقل تكتب إليه أنظمة أخرى أيضًا. {% hint style="info" %} **توصية** حدّد مصدر الحقيقة قبل تعديل إعدادات موفر الهوية. معظم عمليات نشر SCIM الفاشلة هي مشاكل بيانات دليل تظهر على أنها مشاكل توفير. {% endhint %} ### **سيناريوهات مرجعية** تُستخدم أربعة سيناريوهات طوال هذا الدليل. متطلبات الأعمال والمتطلبات المسبقة من جانب Zoom متطابقة بغض النظر عن موفر الهوية، لذا تُعرَّف هنا مرة واحدة. ويختتم كل قسم خاص بموفر هوية بعرض كيفية تنفيذ الأربعة جميعًا في تلك المنصة. #### السيناريو 0: القسم، كتعيين أساسي أول يجب أن يظهر قسم المستخدم على ملفهم الشخصي في Zoom، مأخوذًا من الدليل. هذا هو التعيين الأساسي الموصى به سابقًا كاختبار أولي شامل من البداية إلى النهاية، وقد أُدرج هنا بحيث تُستكمل العملية في كلا قسمي موفّر الهوية. **متطلب مسبق من جانب Zoom.** لا شيء. يخزن Zoom القيمة تمامًا كما أُرسلت ولا يتحقق منها مطلقًا مقابل كائن موجود. **سمة.** لاحظ أن العنصر الأصل يختلف عن السيناريوهات الثلاثة أدناه — `القسم` توجد ضمن امتداد خطة Enterprise، وليس ضمن امتداد Zoom. | السمة | النوع | ملاحظات | | ----------------------------------------------------------------------------- | ----- | ------------------------------------------------------------------------------------------------------------------ | | `urn:ietf:params:scim:schemas:extension:خطة Enterprise:2.0:مستخدم:department` | سلسلة | نص حر. كلا موفري الهوية يحتويان بالفعل على `القسم` حقل في ملف تعريف المستخدم، لذا لا توجد حاجة إلى سمة مصدر جديدة. | **لماذا نبدأ هنا.** إن ظهور قيمة قسم بشكل صحيح في ملف تعريف Zoom يثبت تعريف المخطط، والتعيين، والنطاق، وقدرتك على قراءة سجلات التزويد — دون تعريض ترخيص أو إعداد هاتف للخطر. يختلف كل سيناريو متقدم أدناه فقط في ما تشير إليه السمة. **تحقق أولًا مما إذا كان قد تم تعيينه بالفعل.** تختلف التعيينات الافتراضية بين Entra ID وOkta، وتتغير مع قيام كلا المورّدين بتحديث تكاملات Zoom الخاصة بهما. راجع القائمة الحالية تحت **التهيئة** → **التعيينات** في Entra، أو **تعيينات سمات Zoom** مع **عرض السمات غير المعيّنة** مفعّل في Okta. إذا `القسم` إذا كان قد تم تعيينه بالفعل، فتحقق منه بدلاً من إعلان نسخة مكررة — وإذا كنت تريد، بدلًا من ذلك، سمةً كوَّنها من الصفر، `مركز التكلفة`, `مؤسسة`، و `رقم الموظف` تقع تحت العنصر الأصل نفسه وتتصرف بالطريقة نفسها. #### السيناريو 1: موقع Zoom Phone والتعيين التلقائي للرقم الداخلي يجب وضع المستخدمين في موقع Zoom Phone الصحيح بناءً على مكتبهم والحصول على رقم داخلي دون تدخل إداري. **المتطلب المسبق من جهة Zoom** يجب أن تكون المواقع موجودة بالفعل. أنشئها تحت **مركز المسؤول** → **إعدادات المنتج** → **نظام الهاتف** → **معلومات الشركة** → **إضافة موقع**، أو بشكل جماعي عبر **استيراد**. تتم التحقق من عناوين الموقع مقابل قاعدة بيانات عناوين حقيقية لأنها تدعم خدمات إجراء مكالمات الطواريْ، لذا ستفشل التركيبات الوهمية من العنوان والرمز البريدي في التحقق. **السمات.** كلاهما يأخذان مساحة الاسم `urn:ietf:params:scim:schemas:extension:zoom:1.0:مستخدم:` يتبعه الاسم. | السمة | النوع | ملاحظات | | -------------------- | ----- | ------------------------------------- | | `موقع Zoom Phone` | سلسلة | يجب أن يطابق اسم موقع Zoom حرفًا بحرف | | `zoomPhoneExtNumber` | سلسلة | `0` يؤدي إلى تعيين تلقائي | **لماذا القيمة `0` مهمّة.** Zoom هو النظام الوحيد الذي يعرف الامتدادات المستخدمة بالفعل — بما في ذلك الامتدادات المعيّنة لقوائم انتظار مكالمة ولموظفي الاستقبال الآليين بدلًا من المستخدمين. إن تفويض التعيين إلى Zoom يزيل فئة كاملة من حالات فشل التزويد. ويكون الحصول على الامتدادات من الدليل بدلًا من ذلك مناسبًا أثناء الترحيل، حيث يكون الحفاظ على أرقام الامتدادات الحالية مهمًا، لكن ينبغي أن يتحول التعيين إلى `0` بمجرد اكتمال الترحيل، حتى لا يعتمد المنضمون في المستقبل على الحفاظ على بيانات الدليل إلى أجل غير مسمى. {% hint style="info" %} **ملاحظة** يُسمّى موقع افتراضي على الحساب Zoom Phone عادةً بالضبط `الموقع الرئيسي`، الظاهر ضمن **مركز المسؤول** → **إعدادات المنتج** → **نظام الهاتف** → **معلومات الشركة**. تأكد من الاسم الموجود في الحساب المحدد قبل الاعتماد عليه، إذ يمكن إعادة تسميته. {% endhint %} #### السيناريو 2: خطة مكالمات Zoom Phone تختلف حسب البلد قامت مؤسسة متعددة الجنسيات بشراء خطط مكالمات Zoom Phone مستقلة وتحتاج إلى أن يتلقى كل مستخدم الخطة المطابقة لبلده. **متطلب مسبق من جانب Zoom.** يجب أن تكون خطط المكالمات قد تم شراؤها بالفعل وأن تكون متاحة في الحساب. وتُوثَّق قيم الخطط في [مرجع خطة مكالمات Zoom Phone](https://developers.zoom.us/docs/api/references/phone-calling-plans/). **سمة.** `zoomPhoneCallingPlan` (سلسلة نصية). **كيفية الحصول على رمز الخطة الصحيح.** `zoomPhoneCallingPlan` يأخذ رمز الخطة الرقمي، وليس اسم الخطة. وأكثر طريقة موثوقة للحصول عليه هي [إدراج خطط المكالمات](https://developers.zoom.us/docs/api/references/phone-calling-plans/) واجهة برمجة التطبيقات، التي تُرجع لكل خطة `الاسم`، خاصتها `النوع` — الرمز الذي تربطه — و `مشترك` و `متاح` أعداد المقاعد. تؤكد مكالمة واحدة لذلك أن الخطة موجودة، وتعطيك القيمة التي يجب إرسالها، وتتحقق من وجود سعة لكي يعيّنها. تعرض بوابة Zoom على الويب أسماء العرض فقط، لا الرموز أبدًا، لذا يجب على مسؤول يعمل من البوابة وحدها أن يترجم اسم العرض باستخدام [مرجع خطة مكالمات Zoom Phone](https://developers.zoom.us/docs/api/references/phone-calling-plans/) — حيث، على سبيل المثال، `UNLIMITED_PLAN_US_CA` هو `200` و `UNLIMITED_PLAN_GB_IE` هو `202`. تسرد المرجعية أسماء ثابتة بدلًا من صياغة البوابة، لذا تأكد من التطابق في خصائص الخطة — المنطقة، وخاضعة للقياس مقابل غير المحدودة — بدلًا من النص الحرفي. وبشكل منفصل، يعرض مرجع SCIM2 الخاص بـ Zoom اسم خطة فوترة مثل `phone_calling_usca_monthly_unlimited` في حمولة المثال الخاصة به. يُستخدم ذلك المعرِّف من أجل *شراء* اشتراك، لا ليُعيّن خطةً إلى مستخدم. إذا كنت بحاجة إلى تحديد الاشتراك الذي تستند إليه خطة ما، فيجب أن يكون ذلك ضمن `zoomPhoneCallingPlanSubscription`. **لماذا `-1` يُستخدم كخيار احتياطي.** يوثّق مرجع SCIM2 `-1` كالقيمة التي تزيل جميع خطط المكالمات. استخدامه للمستخدمين غير المطابقين ينتج نتيجة حتمية ومرئية — لا يتم تعيين أي خطة — بدلًا من الغموض الناتج عن إرسال أي قيمة على الإطلاق. كما يوفّر طريقة نظيفة لإلغاء تزويد استحقاقات المكالمات دون حذف المستخدم. #### السيناريو 3: حزمة برامج Zoom لمركز الاتصال، والدور، والمنطقة ينبغي تزويد وكلاء مركز الاتصال بحزمة البرامج ZCC المناسبة وبالدور الصحيح عند بدء الإعداد، بدلًا من إعدادهم يدويًا بعد ذلك. يوضح هذا السيناريو أن الطريقة غير مرتبطة بمنتج — فلا يتغير أي شيء في الإجراء، وإنما تتغير أسماء السمات والقيم المسموح بها. | السمة | النوع | القيم المسموح بها | | -------------------------- | ----- | ----------------------------------------------------------------------------- | | `zoomContactCenterPackage` | سلسلة | `أساسيات`, `بريميوم`, `إليت` | | `دور مركز اتصال زوم` | سلسلة | أي اسم دور في ZCC. القيمة الافتراضية هي `الوكيل` إذا تم حذفها. | | `zoomContactCenterRegion` | سلسلة | أي منطقة ZCC مُهيأة. تكون القيمة الافتراضية هي المنطقة الرئيسية إذا تم حذفها. | **عند حذف السمات عمدًا.** مغادرة `zoomContactCenterRegion` مغادرة غير مُعيَّنة في عمليات النشر أحادية المنطقة، حيث يكون الافتراضي الموثق من Zoom صحيحًا بالفعل. إن إغفال سمة يكون افتراضيها صحيحًا أفضل من تعيينها — فكل تعيين هو التزام صيانة. **ملاحظة تشغيلية.** يوثّق مرجع SCIM2 أيضًا `zoomContactCenterUserTemplate`، والتي تطبق قالب ZCC مُعدًا مسبقًا. تُطبَّق قوالب من نوع الإضافة عند إنشاء المستخدم، وتُطبَّق قوالب من نوع التحديث عند التحديث؛ وعندما يُقدَّم كلٌّ من قالب وقيم السمات الفردية في الطلب نفسه، تكون القيم الفردية ذات أولوية. وتستحق القوالب أن تؤخذ في الاعتبار عندما يكون إعداد ZCC معقدًا بما يكفي بحيث تصبح صيانته عبر العديد من تعيينات السمات الفردية مرهقة. ### **التحقق من جهة Zoom والأخطاء الشائعة** لكل موفّر هوية سجله الخاص، وهو مغطّى في الخطوة 6 من كل موفّر هوية. وسجل Zoom أدناه متطابق لكليهما وهو التسجيل النهائي لما تلقّته Zoom فعليًا. #### تُعرض سجلات المكالمات في سوق التطبيق Zoom لتوضيح التبادل الكامل بين الطلب والاستجابة 1. تسجيل الدخول إلى بوابة الويب الخاصة بـ Zoom بصفتك مالك الحساب. 2. انتقل إلى [**سوق التطبيق Zoom**](https://marketplace.zoom.us/) → **إدارة** → **التطبيقات في الحساب**. 3. يحدد التطبيق الذي يمثّل اتصال موفّر الهوية. بالنسبة إلى Entra، يُسمّى هذا عادةً **Azure Identity** أو ما شابه. 4. افتح **سجلات المكالمات** علامة التبويب. 5. استخدم **البحث حسب نقطة النهاية**، أو عوامل تصفية نطاق التاريخ والطريقة والحالة، لتحديد المكالمة ذات الصلة. 6. يحدد الصف لتوسيعه. 7. راجع `جسم الطلب` لمعرفة ما تم إرساله بالضبط، و `الاستجابة` لمعرفة ما الذي أعاده Zoom بالضبط، بما في ذلك معرِّف مستخدم Zoom المُنشأ، `حالة HTTP`، ومجموعة السمات الناتجة. يحتفظ Zoom بأحدث 100 سجل لطلبات واجهة برمجة التطبيقات، لذا تحقّق من أي فشل على الفور بدلًا من الانتظار حتى تُزاحمه أنشطة التزويد اللاحقة. #### أخطاء التزويد الشائعة وأسبابها
الرمزالرسالةالسبب والحل
400لم يتم تمكين تسجيل الدخول لمرة واحدة في الحساب.تسجيل الدخول لمرة واحدة شرط مسبق لـ SCIM. قم بتمكين تسجيل الدخول لمرة واحدة ثم كوَّنها على حساب Zoom أولاً.
400مستخدم غير نشط أو مقفل.لا يمكن تحديث مستخدم Zoom المستهدف في حالته الحالية. عالج حالة الحساب في بوابة الويب لـ Zoom.
403تم رفض الطلب بسبب أذونات غير كافية: "مستخدم:تحرير".تفتقر بيانات الاعتماد وراء اتصال SCIM إلى النطاق المطلوب. أعد تخويل الاتصال باستخدام حساب المالك أو حساب مسؤول.
404مستخدم غير موجود.لم يربط موفّر الهوية المستخدم بمستخدم Zoom موجود. تحقّق من سمة المطابقة وتنسيق اسم المستخدم.
409لا يتطابق نطاق البريد إلكتروني مع النطاق المرتبط بالحساب.نطاق البريد الإلكتروني للمستخدم غير مرتبط بـ حساب Zoom. اربط النطاق وتحقق منه قبل التزويد.
409لا يمكن إضافة المستخدمين المدفوعين.لا توجد رخصة من النوع المطلوب متاحة. سعة مجانية في الحساب، أو قم بتوفير مستخدم كـ Basic.
409لا يمكن إنشاء المزيد من المستخدمين باستخدام [bundle name].لا تتوفر مقاعد متبقية في الحزمة المحددة. ينطبق على خطة اشتراك Enterprise Premier Workplace Business Plus و خطة اشتراك Pro Plus و نظائر التعليم الخاصة بها.
429طلبات كثيرة جدًا.تجاوز التزويد حدود معدل Zoom. تحقّق مما إذا كان ذلك يستمر عبر الدورات.
#### أحد أوضاع الفشل لا ينتج أي خطأ على الإطلاق قيمة يقبلها Zoom ولكنها لا تتوافق مع أي شيء — اسم موقع مع مسافة زائدة في النهاية، أو اسم دور أُعيدت تسميته لاحقًا في Zoom — قد تُقبل نحويًا ولا تُطبَّق على أي شيء. لا توجد أي إدخالات في السجل تُشير إلى هذا الحدث. وتُغطَّى المتغيرات الخاصة بمنصة من المشكلة نفسها في الخطوة 6. {% hint style="info" %} **ملاحظة** عندما يختلف Zoom وموفر الهوية بشأن تكوين مستخدم، فاعتبر موفر الهوية هو المرجع المعتمد وصحّح القيمة هناك. يؤدي التحرير مباشرةً في بوابة الويب الخاصة بـ Zoom إلى حالةٍ تكتب فوقها فعالية التوفير التالي، مما يجعل المشكلة الأساسية أصعب في التشخيص. {% endhint %} ## **تهيئة SCIM باستخدام Entra ID** #### متطلبات إضافية لـ Entra ID * منح امتيازات مسؤول Entra ID مع إمكانية الوصول إلى خطة Enterprise Applications * نطاق البريد إلكتروني المستخدم من قبل مستخدميك والمتحقق منه كنطاق مخصص في مستأجر Entra ID #### قيود إضافية في Entra ID * تأتي تعيينات السمات حصريًا من Entra *كائن المستخدم* السمات. لا يمكن لـ مجموعة الأمان توفير قيمة لسمة Zoom مباشرةً؛ تتحكم عضوية المجموعة في النطاق، لا في القيمة. * تعمل دورات التزويد التدريجي تقريبًا كل 40 دقيقة. لا تكون التغييرات فورية بمجرد تمكين التزويد. * الـ `التعاون` قيمة `userType` غير مدعوم مع Entra ID بسبب قيد خاص بـ Microsoft. {% hint style="info" %} **ملاحظة** يمكن تنفيذ تكوين التوفير المعياري من أيٍّ من `entra.microsoft.com` أو `portal.azure.com`. ومع ذلك، لا يمكن الوصول إلى محرر المخطط المستخدم في الخطوة 1 إلا عبر عنوان URL لبوابة Azure مع `forceSchemaEditorEnabled` المعلمة المضافة. لا يؤثر هذا العلم على `entra.microsoft.com`. استخدم ارتباط Azure Portal في الخطوة 1 لجميع الخطوات في هذا الجزء لتجنب التبديل بين البوابات أثناء التكوين. {% endhint %} ### الخطوة 1: أعلن السمة في مخطط تطبيق Zoom يعد إعلان السمة إجراءً لمرة واحدة لكل سمة. أعلن عن كل سمة تنوي استخدامها قبل تكوين أي تعيينات، بحيث تكون جميع الأهداف متاحة في الخطوة 2. 1. تسجيل الدخول إلى Azure Portal باستخدام عنوان URL لمحرر المخطط: `https://portal.azure.com/?Microsoft_AAD_Connect_Provisioning_forceSchemaEditorEnabled=true#home` 2. تحت **خدمات Azure**, يحدد **Microsoft Entra ID**. 3. في قائمة التنقل اليسرى، تحت **إدارة**, انقر **تطبيقات Enterprise**. 4. في قائمة التطبيقات، انقر على تطبيق Zoom الخاص بك.\ **ملاحظة**: يتم تحديد اسم التطبيق بواسطة مسؤول Entra عند إنشاء التطبيق. وغالبًا ما يُسمّى **تكبير** أو **تسجيل الدخول الموحد في زوم**، ولكن قد يختلف ذلك في المستأجر الخاص بك. 5. في قائمة التنقل اليسرى، تحت **إدارة**, انقر **التهيئة**.\ **ملاحظة**: تقدم Azure حاليًا أحد تخطيطين. في التجربة القديمة، يحدد **تعديل تعيينات السمات** ضمن **إدارة التزويد**. في التجربة الأحدث، تفتح الصفحة على **نظرة عامة** علامة تبويب؛ يحدد **التهيئة** مرة أخرى من القائمة الموجودة على اليسار. يصل المساران إلى الوجهة نفسها. 6. انقر على **التعيينات** القائمة المنسدلة، ثم انقر على **توفير مستخدمي Microsoft Entra ID**.\ **ملاحظة**: في المستأجرات التي لا تزال تعرض التسمية القديمة، يظهر هذا الخيار باسم **توفير مستخدمي Azure نشط Directory**. 7. في الزاوية السفلية اليسرى، يحدد **عرض الخيارات المتقدمة** مربع اختيار. 8. انقر **تحرير قائمة السمات لـ Zoom**. 9. مرر إلى أول صف فارغ وأكمل ما يلي: * **الاسم**: يدخل سلسلة السمة الكاملة، على سبيل المثال `urn:ietf:params:scim:schemas:extension:zoom:1.0:مستخدم:zoomPhoneSite` * **النوع**: يحدد **سلسلة نصية** أو **قيمة منطقية**، مطابقًا لنوع البيانات الموثق في مرجع SCIM2 لواجهة برمجة التطبيقات. 10. كرر الخطوة 9 لكل سمة إضافية. 11. في الزاوية العلوية اليسرى، انقر **حفظ**. {% hint style="warning" %} **تنبيه** أسماء السمات حساسة لحالة الأحرف ويجب أن تتطابق تمامًا مع مرجع واجهة برمجة التطبيقات. `موقع Zoom Phone` صالح؛ `موقع زوم فون` و `زوم فون سايت` ليست. يتم قبول سمة ذات حالة غير صحيحة بواسطة محرر المخطط دون ظهور أخطاء وتفشل بصمت في Zoom API. بالنسبة للسمات الموثقة على أنها `منطقي`, **سلسلة نصية** يكون صالحًا أيضًا شريطة أن يوفّر المصدر المُعيَّن النص الحرفي `صحيح` أو `خطأ`. التحديد **سلسلة نصية** يكون غالبًا أكثر عملية عندما يكون المصدر سمة امتداد في Entra، والتي تخزّن نصًا. {% endhint %} ### الخطوة 2: ربط مصدر دليل بالسمة يوفّر Entra ID ثلاثة أنواع من التعيين، ويُعدّ الاختيار بينها القرار الأكثر تأثيرًا في التهيئة.
نوع التعيينيُستخدم عندماالسلوك
مباشرحقل Entra يحمل بالفعل القيمة الدقيقة التي يتوقعها Zoom.يمرر القيمة المصدر كما هي دون تغيير.
ثابتيجب أن يتلقى كل مستخدم ضمن النطاق القيمة نفسها.يرسل قيمة ثابتة إلى كل مستخدم مُوفَّر.
تعبيريجب أن تكون القيمة مشتقة أو مترجمة أو متغيرة حسب سمة المستخدم.يقيّم تعبيرًا مقابل الحقول المصدر ويرسل النتيجة.
**لإنشاء التعيين:** 1. ارجع إلى **التهيئة** → **التعيينات** → **توفير مستخدمي Microsoft Entra ID**. 2. في الزاوية السفلية اليسرى، انقر **إضافة تعيين جديد**. 3. كوَّن التعيين وفقًا للنوع المحدد — راجع الإرشادات أدناه. 4. انقر على **السمة الهدف** القائمة المنسدلة ويحدد السمة المُعلنة في الخطوة 1. 5. انقر على **مطابقة الكائنات باستخدام هذه السمة** القائمة المنسدلة ويحدد **لا**.\ **ملاحظة**: سمات Zoom المخصصة هي قيم تكوين، وليست مفاتيح مطابقة للهوية. السمة الوحيدة التي تربط مستخدمي Entra بمستخدمي Zoom — عادةً `اسم المستخدم` — ينبغي أن تُضبط على **نعم**. 6. انقر على **تطبيق هذا التعيين** القائمة المنسدلة ويحدد **دائمًا**، بحيث تنطبق القيمة عند الإنشاء والتحديثات اللاحقة أيضًا. 7. انقر **موافق**. 8. كرّر ذلك لكل سمة، ثم انقر **حفظ** في أعلى **تعيين السمات** الصفحة. #### يمرر التعيين المباشر حقلًا موجودًا دون تحويل * **نوع التعيين**: **مباشر** * **السمة المصدر**: حقل Entra تتطابق قيمته بالفعل مع ما يتوقعه Zoom، حرفًا بحرف * **القيمة الافتراضية إذا كانت null (اختياري)**: قيمة بديلة تُطبَّق عندما يكون الحقل المصدر فارغًا التعيين المباشر هو الخيار الأقل عرضة للأعطال، ويجب تفضيله كلما دعمت بيانات الدليل ذلك. إذا `physicalDeliveryOfficeName` — المعروض باسم **موقع المكتب** في ملف مستخدم Entra الشخصي — تحتوي بالفعل على قيم تطابق أسماء مواقع Zoom Phone تمامًا، فإن تعيينها مباشرة لا يتطلب أي منطق على الإطلاق. {% hint style="info" icon="lightbulb" %} **تلميح** املأ **القيمة الافتراضية إذا كانت null** عندما تتسبب قيمة مصدر مفقودة في فشل أو نتيجة غير مقصودة. افتراضي لـ `الموقع الرئيسي` في تعيين موقع يضمن أن المستخدمين الذين لا يملكون موقع مكتب ما زالوا يُوفَّرون بنجاح بدلًا من الانتهاء في حالة غير محددة. {% endhint %} #### التعيين الثابت يطبق قيمة واحدة على كامل المجموعة ضمن النطاق * **نوع التعيين**: **ثابت** * **القيمة الثابتة**: القيمة الثابتة المراد إرسالها التعيين الثابت يناسب عمليات النشر ذات التهيئة الواحدة، وهو أيضًا الآلية وراء عدة سلوكيات خاصة بـ Zoom. تعيين `zoomPhoneExtNumber` إلى ثابت بقيمة `0` يُرشد Zoom إلى يعيّن الامتداد التالي المتاح ضمن موقع المستخدم، مما يلغي تعارضات الامتداد تمامًا. #### التعيين بالتعبير يترجم أو يشتق قيمة عند وقت التوفير * **نوع التعيين**: **تعبير** * **تعبير**: متداخلة `IIF()` تعليمة تُقيِّم سمة مصدر واحدة أو أكثر تعيين التعبير مطلوب كلما لم تكن قيمة الدليل وقيمة Zoom هي السلسلة نفسها: ``` IIF([officeLocation]="لندن","LON-01", IIF([officeLocation]="مانشستر","MAN-01", "Main موقع")) ``` {% hint style="danger" %} **تحذير** تقارن التعبيرات النص تمامًا كما هو مكتوب، بما في ذلك حالة الأحرف. `GB` و `gb` هما قيمتان مختلفتان، وكذلك `المملكة المتحدة` و `المملكة المتحدة`. المقارنة التي تفشل لا تُحدث خطأ — بل تنتقل إلى الفرع الافتراضي، ويُزوَّد المستخدم بالتكوين الخاطئ بصمت. {% endhint %} لفّ قيم المصدر داخل `ToUpper()` وقارنها مع القيم الحرفية بحروف كبيرة لتحييد عدم اتساق حالة الأحرف: ``` IIF(ToUpper([country])="GB","202", IIF(ToUpper([country])="UNITED KINGDOM","202", "-1")) ``` #### تختلف صيغة حقل المصدر بحسب كيفية إنشاء مستخدم Entra هذا هو السبب الأكثر شيوعًا لعمليات ربط التعبيرات التي تبدو صحيحة ولكنها تتصرف بشكل غير متسق عبر مجموعة من المستخدمين. * **موقع الاستخدام** تفرض Microsoft أن يحتوي دائمًا على رمز ISO 3166-1 alpha-2 صالح، مثل `GB`، لأنه يتحكم في توفر الترخيص وميزة. هذا الحقل موثوق. * **البلد أو المنطقة** لا يخضع لأي إلزام من هذا النوع، وتعتمد محتوياته على طريقة الإنشاء. يحدد المستخدمون الذين تم إنشاؤهم عبر واجهة بوابة المسؤول لـ Entra من قائمة منسدلة بأسماء البلدان الكاملة، لذا يخزن الحقل عادةً `المملكة المتحدة`. أما المستخدمون الذين يتم إنشاؤهم عبر استيراد CSV أو PowerShell فعادةً ما تُملأ لديهم القيمة بـ `GB` — وفقًا للعرف، لا وفقًا للإلزام. في أي مستأجر تم فيه إنشاء المستخدمين بأكثر من طريقة واحدة، `البلد` لن يحتفظ بتنسيق متسق. إما وحِّد الحقل قبل إنشاء التعبير، أو اختبر كلا التنسيقين صراحةً كما هو موضح أعلاه. ### الخطوة 3: أدخل المستخدمين والمجموعات ضمن نطاق التزويد يحدد التعيين أي المستخدمين يتأثر بهم التكوين. المستخدمون خارج نطاق التعيين الخاص بالتطبيق لا يتأثرون أبدًا بأي ربط، مما يجعل التعيين عنصر التحكم الأساسي في الأمان أثناء الإطلاق. 1. انتقل إلى **Microsoft Entra ID** → **تطبيقات Enterprise** → تطبيق Zoom الخاص بك → **المستخدمون والمجموعات**. 2. انقر **إضافة مستخدم/مجموعة**. 3. تحت **المستخدمون والمجموعات**، يحدد المستخدم أو مجموعة الأمان المقصودة. 4. تحت **يحدد دورًا**، اختر الدور المناسب. 5. انقر **يعيّن**. عمليًا، لا تهم إلا قيمتا الدور هاتان. أما الخيارات الأخرى مثل **شركة** و **خطة اشتراك Pro** إما أنها تسميات قديمة يجري التخلص منها تدريجيًا أو أنها مخصصة لسيناريوهات غير شائعة.
دورتأثير
أساسييُهيّئ المستخدم بدون ترخيص اجتماع مدفوع. يحدد هذا عندما تكون سمة مخصصة — مثل خطة اتصال Zoom Phone — مسؤولة عن تعيين الاستحقاق المدفوع.
مرخَّصيُعيّن الخاص بـ حساب Zoom افتراضي خطة Enterprise لترخيص، على سبيل المثال Zoom Workplace Enterprise Plus. لا تسمح هذه الشاشة باختيار حزمة محددة؛ يتم تكوين القيمة افتراضيًا على جانب Zoom.
ينطبق اختيار هذا الدور مرة واحدة لكل مستخدم أو مجموعة تمت إضافتها إلى التطبيق، بغض النظر عن عدد السمات المخصصة التي يتم توفيرها. **لتوفير مجموعات Entra كمجموعات Zoom**، وهو معطّل بشكل افتراضي: 1. انتقل إلى **التهيئة** → **التعيينات** ويحدد **توفير مجموعات Microsoft Entra ID**. 2. تبديل **مُمكَّن** إلى **نعم**. 3. تأكد من أن التعيينات الافتراضي موجودة: `اسم العرض` → `اسم العرض`، و `الأعضاء` → `الأعضاء`. 4. انقر **حفظ**. 5. ارجع إلى **المستخدمون والمجموعات** وتأكد من أن المجموعة نفسها مُعيّنة إلى التطبيق، وليس فقط أعضاؤها الفرديون. لا يعالج توفير المجموعات إلا المجموعات المعيّنة مباشرةً. {% hint style="warning" %} **تنبيه: ما الذي يفعله SCIM وما لا يفعله مع المجموعات** إذا لم تكن هناك بالفعل مجموعة Zoom باسم مطابق، فسيقوم SCIM بإنشاء واحدة باستخدام اسم مجموعة Entra `اسم العرض` تمامًا كما هو مكتوب. يتم إنشاء المجموعة مع الأعضاء ولكن **من دون أي إعداد للمنتج**. لا يزال يتعين على مسؤول أن يفتح **إدارة المستخدمين** → **إدارة المجموعات** في بوابة Zoom على الويب وطبّق الإعدادات المقصودة — سياسات Zoom Phone على مستوى مجموعة، وأذونات الاتصال، أو تكوين المنتج الآخر. يوفّر SCIM وجود مجموعة وعضويتها؛ ولا يحدد ما تفعله تلك المجموعة داخل Zoom. {% endhint %} ### الخطوة 4: التحقق باستخدام Provision on Demand **Provision on Demand** يعمل بشكل مستقل عن **حالة التوفير** تبديل، وهو السبب الدقيق في أنه الأداة الصحيحة للتحقق. يمكن إكمال كل خطوة حتى هذه النقطة — بما في ذلك هذه الخطوة — بينما يظل التوفير متوقفًا. 1. انتقل إلى **التهيئة** → **نظرة عامة على التوفير**. 2. انقر **Provision on Demand**. 3. ابحث عن مستخدم اختبار واحد، ثم يحدد، ثم انقر **توفير**. 4. راجع النتيجة. يعرض Entra المراحل الأربع التي ينفذها لكل فعالية توفير — **استيراد**, **تحديد ما إذا كان ضمن النطاق**, **مطابقة**، و **توفير** — كل عنصر قابل للتوسيع على حدة. 5. تأكد من أن قيم السمات المعروضة تطابق ما تقصده. 6. تسجيل الدخول إلى بوابة الويب الخاصة بـ Zoom وتأكد من أن التكوين قد تم تطبيقه. {% hint style="info" %} **توصية** تحقق من مستخدم يمثل *الأصعب* حالة في مجموعتك — مستخدم من الخارج، مستخدم تم إنشاؤه بطريقة مختلفة، أو مستخدم يكون حقل المصدر لديه فارغًا. إن الاختبار الذي يغطي الحالة المباشرة فقط لن يكشف أنماط الفشل الموضحة في الخطوة 2. {% endhint %} ### الخطوة 5: تمكين التزويد المستمر إن تمكين التزويد يضع التكوين قيد التنفيذ الفعلي لكل مستخدم ضمن النطاق. أكمل وتحقق من الخطوات 1 إلى 4 أولًا. 1. انتقل إلى **Microsoft Entra ID** → **تطبيقات Enterprise** → تطبيق Zoom الخاص بك → **التهيئة** → **التهيئة**. 2. تبديل **حالة التوفير** إلى **قيد التشغيل**. 3. انقر **حفظ**. يمكن أن تستغرق الدورة الأولى ما يصل إلى نحو 40 دقيقة. تعمل الدورات التدريجية اللاحقة على فترات تبلغ نحو 40 دقيقة. تتم مزامنة المنضمون الجدد وتغييرات السمات وعمليات إلغاء التنشيط وفق تلك الجدولة بدلًا من ذلك فورًا. ### الخطوة 6: التحقق باستخدام سجلات التزويد في Entra 1. انتقل إلى **Microsoft Entra ID** → **تطبيقات Enterprise** → تطبيق Zoom الخاص بك → **راقب** → **سجلات التزويد**. 2. ابحث أو رشّح عن مستخدم الاختبار، ثم يحدد الحدث ذي الصلة. يفتح عرض التفاصيل بأربعة علامات تبويب: **الخطوات**, **استكشاف الأخطاء وإصلاحها والتوصيات**, **الخصائص المعدلة**، و **الملخص**. 3. راجع **الملخص** لتأكيد ما إذا كانت العملية قد نجحت أو فشلت. 4. إذا فشلت، فافتح **استكشاف الأخطاء وإصلاحها والتوصيات**، الذي يعرض الإجراء الذي تمت محاولته، واسم المستخدم الرئيسي المتأثر، و— ضمن **التفاصيل** — رمز الخطأ ورسالة الخطأ الكاملة التي تُرجعها واجهة برمجة التطبيقات الخاصة بـ Zoom. هذا أكثر موثوقية من فحص شاشة التعيين لأنه يعرض القيم الفعلية المنقولة بدلاً مما كان من المفترض أن ينتجه التعيين. وعندما يكون سجل Entra غير حاسم، انتقل إلى سجلات مكالمات سوق التطبيق لتطبيق Zoom الموصوفة تحت **التحقق من جهة Zoom والأخطاء الشائعة**، والتي تُظهر عرض تبادل الطلب والاستجابة الخام. #### سلوك الإعداد الأولي وإنهاء الإعداد في Entra ID * النطاق هو عنصر التحكم الأساسي في الأمان. لا يتم تعديل المستخدمين خارج نطاق التعيين الخاص بالتطبيق أبدًا بواسطة أي تعيين في هذا التكوين. * يؤدي إلغاء تنشيط مستخدم في Entra، أو إزالته من النطاق، إلى عكس عملية التزويد تلقائيًا وإغلاق حلقة إنهاء الإعداد. * كل فشل ينتج عنه إدخال سجل مطابق — مع التحفظ المذكور أعلاه بشأن الفشل الصامت. ### الخطوة 7: تطبيق السيناريوهات المرجعية في Entra ID السيناريوهات والمتطلبات المسبقة وتعريفات السمات موجودة في ال [**السيناريوهات المرجعية**](#reference-scenarios) هذا القسم. تُعرض هنا فقط تعيينات Entra. **السيناريو 0 — القسم.** في الخطوة 1، عرّف `urn:ietf:params:scim:schemas:extension:خطة Enterprise:2.0:مستخدم:department` على أنها **سلسلة نصية**، مع الحرص على استخدام مساحة أسماء المؤسسة بدلاً من مساحة أسماء Zoom. قم بتعيينه على أنه **مباشر** من Entra `القسم` الحقل. لا **القيمة الافتراضية إذا كانت null** حاجة إليه — فالحقل المصدر الفارغ يرسل ببساطة لا شيء، ولا يلزم وجود أي كائن على جانب Zoom. **السيناريو 1 — موقع Zoom Phone والامتداد التلقائي.** عيّن `موقع Zoom Phone` على أنها **مباشر** من `physicalDeliveryOfficeName`، مع **القيمة الافتراضية إذا كانت null** تم تعيينه إلى `الموقع الرئيسي`. `zoomPhoneExtNumber` على أنها **ثابت** بقيمة `0` ما لم تكن تنقل إعدادًا موجودًا مسبقًا للامتدادات. عندما لا تتطابق قيم موقع المكتب مع أسماء مواقع Zoom تمامًا، فاستبدلها بـ **تعبير** تعيينًا بالشكل الموضح في الخطوة 2. **السيناريو 2 — خطة المكالمات المتغيرة حسب البلد.** لأن Entra لا يمكنه استمداد قيمة من مجموعة، فالتعبير مطلوب. وسّعه بطبقات إضافية `IIF()` لكل بلد، وراعِ كلًا من صيغتي الرمز المكون من حرفين والنص الكامل كما هو موضح في الخطوة 2: ``` IIF(ToUpper([country])="GB","202", IIF(ToUpper([country])="UNITED KINGDOM","202", IIF(ToUpper([country])="US","200", IIF(ToUpper([country])="UNITED STATES","200", "-1")))) ``` حيثما تُسند سمة خطة المكالمات الاستحقاق المدفوع، يحدد **أساسي** بدلاً من **مرخَّص** في الخطوة 3. يحدد **مرخَّص** يطبق ترخيص الحساب الافتراضي بالإضافة إلى ذلك، وهو ما قد لا تكون النتيجة التجارية المقصودة. **السيناريو 3 — حزمة برامج مركز الاتصال، والدور، والمنطقة.** عيّن `zoomContactCenterPackage` مع **تعبير** مدفوعًا بحقل في الدليل يميز مستويات الوكلاء، و `دور مركز اتصال زوم` على أنها **مباشر** من حقل يحتوي على اسم الدور. مغادرة `zoomContactCenterRegion` غير معيّن في عمليات النشر أحادية المنطقة. ## **تهيئة SCIM مع Okta** #### متطلبات إضافية لـ Okta * صلاحيات المسؤول في Okta مع إمكانية الوصول إلى محرر الملف الشخصي #### قيود إضافية في Okta * عندما ينتمي مستخدم إلى عدة مجموعات تقدم قيماً متعارضة للسمّة نفسها، فلا تُرسل سوى قيمة المجموعة ذات الأولوية الأعلى. راجع الخطوة 5. {% hint style="warning" %} **تنبيه: ملفان شخصيان، وغرضان** يحافظ Okta على ملفين شخصيين متميزين يهمان هنا، وفهم الفصل بينهما يمنع معظم الالتباس الأولي. الـ **ملف مستخدم Okta** هو المكان الذي يتم فيه *تُخزَّن* مقابل شخص في الدليل. الـ **ملف تطبيق مستخدم Zoom** هو المكان الذي يتم فيه *يُرسَل* إلى Zoom، وتحمل سماته الاسم الخارجي ومساحة الاسم في SCIM. يحتاج التكوين لكل مستخدم إلى الاثنين معًا، بالإضافة إلى تعيين اتصال بينهما. ويحتاج التكوين على مستوى مجموعة فقط إلى سمة ملف تطبيق، مع تعيين القيمة على إسناد المجموعة. {% endhint %} ### الخطوة 1: أعلن السمة في ملف مستخدم تطبيق Zoom هذا هو السمة التي تنقل قيمةً إلى Zoom فعليًا. ويُعدّ تعريفها إجراءً لمرة واحدة لكل سمة. 1. سجّل الدخول إلى وحدة تحكم المسؤول في Okta. 2. في قائمة التنقل اليسرى، انقر **التطبيقات**، ثم انقر **التطبيقات**. 3. تحت **الحالة**, انقر **نشط**. 4. انقر على **تكبير** التطبيق.\ **ملاحظة** يتم تحديد اسم التطبيق بواسطة مسؤول Okta عند إنشاء التطبيق. وغالبًا ما يُسمّى **تكبير**، ولكن قد يختلف ذلك في المستأجر الخاص بك. 5. انقر على **التهيئة** علامة التبويب. 6. تحت **تعيينات سمات Zoom**, انقر **انتقل إلى محرر الملف الشخصي**. 7. تحت **السمات**, انقر **+ إضافة سمة**. 8. أكمل ما يلي: * **نوع البيانات**: يحدد **سلسلة** أو **منطقي**، بما يتوافق مع مرجع SCIM2 لواجهة برمجة التطبيقات. * **اسم العرض**: يدخل اسم السمة، على سبيل المثال `موقع Zoom Phone`. * **اسم المتغير**: يدخل نفس الاسم. * **الاسم الخارجي**: يدخل اسم السمة تمامًا كما هو موثق من قبل Zoom، على سبيل المثال `موقع Zoom Phone`. * **النطاق الخارجي**： يدخل `urn:ietf:params:scim:schemas:extension:zoom:1.0:مستخدم:zoomPhoneSite` * **الوصف** (اختياري): التسجيل سبب وجود السمة ومصدر قيمها. * **نوع السمة**: يحدد **شخصي** لقيمة خاصة بكل مستخدم، أو **مجموعة** لقيمة موروثة عبر الانتماء إلى مجموعة. 9. انقر **حفظ**، أو **حفظ وإضافة أخرى**. {% hint style="danger" %} **تحذير** يجب أن يكون كلٌّ من الاسم الخارجي ومساحة الاسم الخارجية صحيحين. وتحدد الإرشادات المنشورة من Zoom مساحة الاسم الخارجية على أنها URN الكامل *بما في ذلك* اسم السمة — على سبيل المثال `urn:ietf:params:scim:schemas:extension:zoom:1.0:مستخدم:zoomRevenueAcceleratorRole` — وليس مساحة الاسم وحدها. يختلف هذا عن اصطلاح SCIM العام. اتّبع التنسيق الموضّح أعلاه، لأنه يعكس الإعداد الذي توثّقه Zoom على أنه يعمل. أسماء السمات حسّاسة لحالة الأحرف طوال الوقت. يتم قبول سمة مكتوبة بحالة غير صحيحة بواسطة محرر الملف الشخصي دون إظهار خطأ، ويفشل ذلك بصمت لدى Zoom API. {% endhint %} ### الخطوة 2: أنشئ سمة مصدر على ملف تعريف مستخدم Okta أكمل هذه الخطوة حيث يتم الاحتفاظ بالقيمة لكل مستخدم. تخطَّها إذا كانت القيمة متطابقة لكل مستخدم، أو إذا كان سيتم توفيرها على مستوى مجموعة بدلاً من ذلك. 1. في قائمة التنقل اليسرى، انقر **الدليل**، ثم انقر **محرر الملف الشخصي**. 2. انقر على **المستخدمون** علامة التبويب. 3. في **المستخدمون** المربع، ضمن **عوامل التصفية**, انقر **الكل**. 4. إلى يمين **Okta**، انقر فوق **مستخدم** الملف الشخصي. 5. تحت **السمات**, انقر **+ إضافة سمة**. 6. أكمل ما يلي: * **نوع البيانات**: طابق سمة Zoom المعلنة في الخطوة 1. * **اسم العرض** و **اسم المتغير**: أدخل اسمًا، على سبيل المثال `موقع Zoom Phone`. * **تعداد** (اختياري): يحدد **تحديد قائمة قيم معدّدة** حيث لا تقبل سمة Zoom سوى مجموعة ثابتة من القيم. * **السمة مطلوبة** (اختياري): يحدد **نعم** حيث يجب أن يحمل كل مستخدم ضمن النطاق قيمة. 7. انقر **حفظ**. {% hint style="info" icon="lightbulb" %} **تلميح** استخدم الاسم نفسه لسمة الملف الشخصي لمستخدم Okta ولسمة الملف الشخصي لتطبيق Zoom. لا يتطلب Okta ذلك، لكن تطابق الأسماء يجعل قائمة التعيينات ذاتية التوثيق ويقلل بصورة ملموسة وقت استكشاف الأخطاء وإصلاحها مع زيادة عدد السمات. {% endhint %} استخدم **تعداد** الخيار حيثما يوثق Zoom مجموعة قيم ثابتة — حزم البرامج لمركز الاتصال، ورموز حزم Workplace، وقيم خطط Revenue Accelerator. يؤدي تقييد الحقل عند نقطة الإدخال إلى منع تحول خطأ مطبعي إلى فشل توفير صامت يظهر بعد أسابيع كاستحقاق مفقود. ### الخطوة 3: تعيين سمة المصدر إلى سمة Zoom 1. انتقل إلى **التطبيقات** → **التطبيقات** → **نشط** → **تكبير** التطبيق. 2. انقر على **التهيئة** علامة التبويب. 3. تحت **تعيينات سمات Zoom**، حدد موقع السمة المعلنة في الخطوة 1 وانقر فوق أيقونة التحرير الموجودة إلى يسارها.\ **ملاحظة**: إذا لم تكن السمة مرئية، فانقر فوق **عرض السمات غير المعيّنة**. 4. انقر على **قيمة السمة** القائمة المنسدلة ويحدد **تعيين من ملف Okta الشخصي**. 5. انقر فوق القائمة المنسدلة للمصدر — التي تعرض `تسجيل الدخول | سلسلة نصية` افتراضي — وحدد سمة الملف الشخصي لمستخدم Okta التي تم إنشاؤها في الخطوة 2. 6. يحدد **إنشاء وتحديث**.\ **ملاحظة**: **إنشاء فقط** يطبق القيمة عند توفير مستخدم Zoom لأول مرة ولا يطبقها مجددًا. حدده عمدًا للقيم التي ينبغي عدم استبدالها بعد التعيين الأولي؛ حدد **إنشاء وتحديث** في جميع الحالات الأخرى لكي تنتشر تغييرات الدليل. 7. انقر **حفظ**. 8. كرر ذلك لكل سمة. {% hint style="warning" %} **تنبيه: اشتقاق قيمة أو ترجمتها** عندما لا تكون قيمة Okta وقيمة Zoom السلسلة النصية نفسها، فإن حقل **قيمة السمة** يقبل أيضًا لغة تعبيرات Okta، التي تدعم المنطق الشرطي ودوال السلاسل النصية. تختلف صياغة التعبيرات والدوال المتاحة حسب إصدار Okta؛ تحقق من صحة أي تعبير باستخدام مستخدم اختبار واحد عبر **معاينة** قبل تطبيقه على نطاق أوسع، وراجع وثائق لغة التعبيرات الحالية من Okta لمعرفة الدوال المدعومة. عندما تكون الترجمة بسيطة ومجموعة القيم صغيرة، يكون تحديد قيمة Zoom مباشرةً على سمة Okta كقائمة معددة — أو استخدام سمة على مستوى مجموعة، كما في الخطوة 5 — أسهل في الصيانة عادةً من استخدام تعبير. {% endhint %} ### الخطوة 4: تمكين التوفير إلى تطبيق لا يكون لتعيينات السمات أي تأثير حتى يتم تمكين عمليات التوفير المقابلة. مكّنها قبل تعيين القيم في الخطوة 5. 1. انتقل إلى **التطبيقات** → **التطبيقات** → **نشط** → **تكبير** التطبيق. 2. انقر على **التهيئة** علامة التبويب. 3. تحت **التوفير إلى تطبيق**, انقر **تعديل**. 4. مكّن الإعدادات الموضحة أدناه، ثم انقر فوق **حفظ**. | الإعداد | تأثير | | -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | | **إنشاء مستخدمين** | ينشئ مستخدمًا في Zoom أو يربطه به عندما يُعيّن تطبيق لمستخدم في Okta. | | **تحديث سمات المستخدم** | يحدّث سمات مستخدم في Zoom عند تعيين تطبيق. تستبدل التغييرات اللاحقة في الملف الشخصي لمستخدم Okta القيمة المقابلة في Zoom تلقائيًا. | | **إلغاء تنشيط المستخدمين** | يلغي تنشيط حساب Zoom عند إلغاء تعيين تطبيق في Okta، أو عند إلغاء تنشيط حساب Okta. يمكن إعادة تنشيط الحسابات بإعادة تعيين تطبيق. | {% hint style="danger" %} **تحذير** **تحديث سمات المستخدم** هو ما يجعل تعيينات السمات المخصصة سارية على المستخدمين الحاليين. بدونه، لا تُطبق التعيينات إلا عند إنشاء مستخدم، ولن يصل أي تغيير لاحق في Okta إلى Zoom. {% endhint %} ### الخطوة 5: تعيين القيم للمستخدمين أو المجموعات **لتعيين قيمة لمستخدم فردي:** 1. انتقل إلى **الدليل** → **الأشخاص** وانقر فوق اسم المستخدم. 2. انقر على **الملف الشخصي** علامة تبويب، ثم انقر فوق **تعديل**. 3. املأ السمة التي تم إنشاؤها في الخطوة 2 بالقيمة التي يتوقعها Zoom. 4. انقر **حفظ**. تُنقل القيمة على الفور. أكد النتيجة في بوابة Zoom على الويب قبل تطبيق التغيير نفسه على نطاق أوسع. **لتعيين قيمة إلى مجموعة** — النمط الأكثر قابلية للتوسع حيث يتبع التكوين البنية التنظيمية: 1. أكد أن السمة أُعلنت في الخطوة 1 باستخدام **نوع السمة: مجموعة**. إذا أُعلنت كـ **شخصي**، فأعلن مكافئًا على مستوى مجموعة بتكرار الخطوة 1 على **مستخدم Zoom** الملف الشخصي ضمن **الدليل** → **محرر الملف الشخصي** → **المستخدمون** → **الكل**، مع تحديد **مجموعة** كنوع السمة. 2. انتقل إلى **الدليل** → **المجموعات** → **الكل** علامة تبويب، ثم انقر فوق **إضافة مجموعة**. 3. أدخل **الاسم** واختياري **الوصف**، ثم انقر **حفظ**. 4. افتح المجموعة وانقر فوق **التطبيقات** علامة التبويب. 5. انقر **تعيين تطبيق**، ثم انقر **يعيّن** إلى يمين **تكبير** التطبيق. 6. املأ السمات على مستوى المجموعة بالقيم التي ينبغي أن تنطبق على كل عضو. 7. انقر **حفظ والعودة**، ثم انقر **تم**. 8. انقر فوق **الأشخاص** علامة تبويب، ثم انقر فوق **تعيين الأشخاص**. 9. ابحث عن المستخدمين بالاسم الأول أو عنوان البريد الإلكتروني الأساسي أو اسم المستخدم، وانقر فوق زر إضافة بجانب كل منهم. 10. انقر **تم**. يرث الأعضاء قيم سمات المجموعة تلقائيًا. ويرثها المستخدمون الذين تتم إضافتهم لاحقًا عند انضمامهم، ما يجعل هذا النمط مستدامًا لعمليات الإعداد المستمرة بدلًا من كونه عملية ترحيل لمرة واحدة. #### تحل أولوية المجموعة القيم المتعارضة عندما ينتمي مستخدم إلى عدة مجموعات عندما يكون مستخدم عضوًا في أكثر من مجموعة تقدم قيمة للسمة نفسها، ينقل Okta القيمة من المجموعة ذات الأولوية الأعلى. 1. انتقل إلى **التطبيقات** → **التطبيقات** → **نشط** → **تكبير** التطبيق. 2. انقر على **التعيينات** علامة التبويب. 3. تحت **عوامل التصفية**, انقر **المجموعات**. 4. اسحب المجموعات وأفلتها بالترتيب المقصود. {% hint style="info" %} **توصية** رتب المجموعات من الأكثر تحديدًا إلى الأكثر عمومية، بحيث تكون للمجموعة ذات النطاق الضيق — موقع أو دور معين — الأولوية على المجموعة العامة الشاملة. يؤدي عكس هذا الترتيب إلى تجاوز المجموعة العامة لكل مجموعة محددة، وهو ما يظهر عادةً بتلقي مجموعة كاملة من المستخدمين للتكوين غير المقصود نفسه. {% endhint %} ### الخطوة 6: التحقق باستخدام سجل نظام Okta 1. انتقل إلى **التقارير** → **سجل النظام**. 2. رشّح حسب مستخدم الهدف أو حسب تطبيق Zoom، وضيّق النطاق الزمني إلى محاولة التوفير. 3. افتح فعالية ذات الصلة وراجع التفاصيل، التي تتضمن النتيجة وأي خطأ أرجعه تطبيق المصب. تظهر أيضًا حالات فشل التوفير غير المحلولة في **التهيئة** علامة تبويب لتطبيق Zoom. عندما لا يكون سجل Okta حاسمًا، انتقل إلى سجلات مكالمة سوق التطبيق لـZoom الموضحة ضمن **التحقق من جهة Zoom والأخطاء الشائعة**، والتي تُظهر عرض تبادل الطلب والاستجابة الخام. {% hint style="warning" %} **تنبيه: الفشل الصامت الخاص بـ Okta** السمة المعلنة في ملف مستخدم Zoom الشخصي ولكن لم تُعيّن مطلقًا، أو التي عُيّنت دون **تحديث سمات المستخدم** تمكين في الخطوة 4، لا تنقل شيئًا مع بقائها مرئية في قائمة التعيينات. لا يظهر أي خطأ. إذا لم تصل قيمة إلى Zoom ولم يعرض سجل النظام أي فعالية مقابلة على الإطلاق، فتحقق من التعيين وإعدادات التوفير قبل إجراء مزيد من التحقيق. {% endhint %} #### سلوك الإعداد وإلغاء الإعداد في Okta * النطاق هو عنصر التحكم الأساسي للسلامة. لا تُعدّل أي تعيينات في هذا التكوين المستخدمين الذين لم يُعيّن لهم تطبيق Zoom في Okta. * مع **إلغاء تنشيط المستخدمين** تمكين، يؤدي إلغاء تعيين تطبيق أو إلغاء تنشيط حساب Okta إلى إلغاء تنشيط حساب Zoom تلقائيًا. * تؤدي إعادة تعيين تطبيق إلى إعادة تنشيط حساب Zoom الذي أُلغي تنشيطه سابقًا، ما يجعل عضوية المجموعة آلية قابلة للتطبيق لإدارة المغادرين والعائدين. ### الخطوة 7: تطبيق السيناريوهات المرجعية في Okta السيناريوهات والمتطلبات المسبقة وتعريفات السمات موجودة في ال [**السيناريوهات المرجعية**](#reference-scenarios) القسم. يُعرض هنا تكوين Okta فقط. **السيناريو 0 — القسم.** في الخطوة 1، أعلن السمة باستخدام **اسم العرض** و **اسم المتغير** `القسم`, **الاسم الخارجي** `القسم`، و **النطاق الخارجي** `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User`. استخدم **نوع السمة: شخصي**. يحتوي ملف مستخدم Okta الشخصي الأساسي بالفعل على سمة `القسم` ، لذا يمكن تخطي الخطوة 2 — عيّن مباشرةً منها في الخطوة 3، مع تحديد **إنشاء وتحديث**. {% hint style="warning" %} **تنبيه: تنسيق مساحة الاسم لسمات امتداد المؤسسة** يصف التحذير في الخطوة 1 اصطلاح Zoom المتمثل في إلحاق اسم السمة بمساحة الاسم الخارجية. هذه الإرشادات موثقة للسمات ضمن امتداد Zoom. `القسم` تنتمي إلى امتداد مؤسسة SCIM القياسي، حيث يكون سلوك Okta المعتاد هو إبقاء مساحة الاسم والاسم الخارجي في حقلين منفصلين، كما هو موضح أعلاه. إذا لم تصل القيمة إلى Zoom، فجرب النموذج الملحق — `urn:ietf:params:scim:schemas:extension:خطة Enterprise:2.0:مستخدم:department` — وأكد النموذج الذي نجح في سجل مكالمة سوق التطبيق. {% endhint %} **بدائل إذا كانت `القسم` مُعيّنة بالفعل.** يتصرف أي مما يلي بالطريقة نفسها، ويقع ضمن الأصل نفسه، ولا يحمل أي شروط مسبقة — استبدل اسم السمة في كل من **الاسم الخارجي** ومساحة الاسم، وأضف سمة مصدر مطابقة في الخطوة 2 إذا لم يكن ملف Okta الشخصي يحتوي عليها بالفعل: | السمة | ملاحظات | | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | `مركز التكلفة` | حقل الأعمال، يختلف بين المستخدمين لذا تكون القيمة الخاطئة مرئية | | `مؤسسة` | غالبًا ما تكون متطابقة بين جميع المستخدمين، مما يجعل اكتشاف الخطأ أصعب | | `رقم الموظف` | غالبًا ما تكون مُعيّنة بالفعل كحقل هوية — تحقق قبل الإعلان | | `الضمائر` | يقع ضمن **تكبير** الامتداد بدلًا من امتداد المؤسسة، لذلك يستخدم مساحة الاسم نفسها لكل سيناريو آخر في هذا الدليل ويتجنب سؤال التنسيق أعلاه بالكامل | **السيناريو 1 — موقع Zoom Phone والامتداد التلقائي.** أعلن `موقع Zoom Phone` مع **نوع السمة: مجموعة** واضبط قيمتها على مجموعة Okta لكل موقع، بحيث تحدد عضوية المجموعة موقع مباشرةً ولا تكون هناك حاجة إلى منطق ترجمة. أعلن `zoomPhoneExtNumber` كسمة شخصية بقيمة افتراضي قدرها `0` ما لم تكن ترحّل تكوينًا موجودًا مسبقًا للامتدادات. **السيناريو 2 — خطة المكالمات المتغيرة حسب البلد.** أعلن `zoomPhoneCallingPlan` مع **نوع السمة: مجموعة** وأنشئ مجموعة واحدة لكل منطقة خطة اتصال، مع ضبط قيمة الخطة في تعيين تطبيق Zoom لكل مجموعة. يرث المستخدمون الخطة الصحيحة من خلال العضوية، وتكون القيمة المخزنة في Okta هي القيمة الدقيقة التي يتوقعها Zoom. يجعل ذلك أيضًا التكوين مرئيًا وقابلًا للتدقيق من **التعيينات** علامة تبويب، كما أنه يتجاوز أوجه عدم الاتساق في كيفية ملء بيانات الدليل الأساسية. توفر المجموعة التي تحمل `-1` طريقة واضحة لإلغاء توفير استحقاقات الاتصال دون حذف مستخدم. **السيناريو 3 — حزمة برامج مركز الاتصال، والدور، والمنطقة.** أعلن `zoomContactCenterPackage` كسمة معددة مقيّدة بالقيم الثلاث المسموح بها، بحيث لا يمكن أبدًا إدخال حزمة البرامج غير صالحة. أعلن `دور مركز اتصال زوم` كسمة على مستوى مجموعة، لأن دور يتبع عادةً بنية الفريق. مغادرة `zoomContactCenterRegion` غير معيّن في عمليات النشر أحادية المنطقة. ## استكشاف الأخطاء وإصلاحها ### الأخطاء #### المستخدم غير موجود أو لا ينتمي إلى هذا الحساب يحدث هذا الخطأ عندما يفشل عنوان البريد الإلكتروني لمستخدم مستهدف في التوفير بسبب وجود حساب بالفعل. يُشجَّع مسؤولو Zoom على التواصل مباشرةً مع المستخدم ودعوة المستخدم يدويًا إلى الحساب.

مثال على خطأ في التوفير.

#### لا يمكنك إضافة مستخدمين مدفوعين يحدث هذا الخطأ عندما تحاول SCIM توفير مستخدم بينما لا توجد تراخيص كافية في الحساب. ولحل الخطأ، يجب توفير المستخدم كمستخدم أساسي، أو يجب جعل ترخيص متاحًا للتوفير.

مثال على خطأ في التوفير.

### استخدام سجلات SCIM لاستكشاف أخطاء توفير المستخدم وإصلاحها يوفّر Zoom أحدث 100 من سجلات طلبات واجهة برمجة التطبيقات في [سوق التطبيق Zoom](https://marketplace.zoom.us/). يمكن لمسؤول Zoom استخدام هذه السجلات لتأكيد المعلومات التي يتم إرسالها واستلامها عبر واجهات برمجة التطبيقات للتوفير. للوصول إلى السجلات، سجّل الدخول إلى سوق التطبيق Zoom بصفتك مسؤول Zoom وانقر على **إدارة**. في الصفحة التالية، **سجلات المكالمة** ضمن **إدارة التطبيق الشخصي**. من هناك، انقر على إدخال لتوسيع سجلات واجهة برمجة التطبيقات ومراجعة المحتويات. تُظهر الصورة التالية مثالًا على طلب توفير مستخدم SCIM، مع تمييز سمات هوية المستخدم والترخيص للرجوع إليها.

مثال على طلب توفير مستخدم SCIM.

مثل تعيين الاستجابة، لا يمكن لـ Zoom تطبيق سوى المعلومات التي يرسلها موفّر الهوية في طلب التوفير. استخدم هذه السجلات للتأكد من أن سمات هوية المستخدم والترخيص يتم إرسالها من موفّر الهوية. إذا كانت المعلومات المتوقعة مفقودة من هذه العبارات، فتواصل مع جهة الاتصال الخاصة بك لدى موفّر الهوية للحصول على الدعم. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://library.zoom.com/technical-library/technical-library-ar/rkn-almsuwl/account-and-endpoint-management/scim-guide.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.