> 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.

يشرح هذا الدليل طريقة قابلة للتكرار لإضافة *أيّ سمة* من سمات Zoom SCIM إلى إعدادات التزويد لديك. وبدلًا من توثيق سمة واحدة بمعزل عن غيرها، يشرح النموذج الأساسي، ليتمكن المسؤولون من البحث عن سمة في مرجع واجهة برمجة تطبيقات 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 باستخدام Okta](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063256).

{% hint style="danger" %}
**تحذير**

تؤثر عملية التهيئة غير الصحيحة على المستخدمين الحاليين، بما في ذلك إزالة التراخيص المستخدمة بالفعل. تحقّق من كل تغيير مقابل مستخدم اختبار واحد قبل تطبيقه على مجموعة المستخدمين الفعلية.
{% endhint %}

### **المتطلبات الأساسية لاستخدام SCIM**

ينطبق كل ما في هذا الجزء بغض النظر عن موفر الهوية. اقرأ هذا قبل المتابعة إلى التعليمات الخاصة بموفر الهوية لديك.

#### المتطلبات المشتركة بين كلا موفري الهوية

* حساب Zoom من فئة Business أو Education أو خطة Enterprise معتمد [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 أو الخطة أو المكون الإضافي أو كائن التكوين المُسنَد موجودًا بالفعل وأن يكون متاحًا في حساب 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. ويمكن للمسؤولين الذين يتبعون وصفة أن كوَّنوا السمة فقط التي تصفها تلك الوصفة. يغطّي هذا القسم التركيب. أمّا ربط سمة بمصدر بيانات فيأتي لاحقًا، في أقسام موفّر الهوية.

#### <mark style="color:أزرق;">لكل سمة مساحة اسم، واسم، ونوع بيانات، وقيمة مسموح بها</mark>

لنبدأ بمثال كامل يعمل. إليك المعرِّف لتعيين مستخدم إلى موقع Zoom Phone:

```
urn:ietf:params:scim:schemas:extension:zoom:1.0:مستخدم:zoomPhoneSite
```

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

<table><thead><tr><th width="155.290771484375">خاصية</th><th>مستخرج من المثال</th><th>ما الذي يفعله</th></tr></thead><tbody><tr><td><strong>مساحة الاسم</strong></td><td><code>urn:ietf:params:scim:schemas:extension:zoom:1.0:مستخدم</code></td><td>يخبر Zoom بالمخطط الذي ينتمي إليه الإعداد، ويعمل كأساسٍ مشترك لمعظم سمات منتجات Zoom والترخيص تقريبًا. يُمرَّر إلى Zoom كنصف المعرِّف الأول.</td></tr><tr><td><strong>الاسم</strong></td><td><code>zoomPhoneSite</code></td><td>يُحدِّد إعداد Zoom المحدد الذي تتم كتابته — هنا، موقع Zoom Phone الخاص بالمستخدم. يُمرَّر إلى Zoom كنصف المعرِّف الثاني. حساس لحالة الأحرف.</td></tr><tr><td><strong>نوع البيانات</strong></td><td><code>string</code></td><td>يُخبر موفّر الهوية بنوع القيمة التي تحتوي عليها السمة، لضمان تخزينها وتنسيقها بشكل صحيح. ولا يُمرَّر كجزء من المعرِّف؛ بل يُحدَّد بشكل منفصل باسم <strong>النوع</strong> في Entra ID، أو باسم <strong>نوع البيانات</strong> في Okta.</td></tr><tr><td><strong>القيمة المسموح بها</strong></td><td><code>LON-01</code>، وهو اسم موقع Zoom Phone</td><td>الإعداد المطبَّق فعليًا على المستخدم. يكون نصًا حرًا لبعض السمات، ومجموعة محددة من الخيارات لسمات أخرى — <code>الأساسيات</code>, <code>Premium</code>، أو <code>النخبة</code> لمركز الاتصال في Zoom، على سبيل المثال. يُمرَّر إلى Zoom عند التهيئة، وتوفّره عملية الربط بدلًا من المعرِّف.</td></tr></tbody></table>

{% hint style="danger" %}
**تحذير**

تنشر Zoom أكثر من مساحة أسماء واحدة لامتدادات المستخدم. وتستخدم إعدادات المنتج وسمات الترخيص `urn:ietf:params:scim:schemas:extension:zoom:1.0:مستخدم`، وهي مساحة الأسماء التي يستخدمها هذا الدليل في جميع أجزائه. الحقول المؤسسية المعيارية مثل `department`, `manager`، و `costCenter` استخدام `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User`. ثالثًا، `urn:us:zoom:scim:schemas:extension:1.0:ZoomUser`، ويحمل معلومات نوع تسجيل الدخول التي تُعاد في استجابات واجهة برمجة التطبيقات، بدلًا من ضبطها أثناء التهيئة. يقبل موفّر الهوية لديك سمةً مبنية على مساحة أسماء غير صحيحة، ويتجاهلها Zoom بصمت.
{% endhint %}

#### <mark style="color:أزرق;">حدِّد السمة التي تحتاجها في مرجع واجهة برمجة التطبيقات SCIM2</mark>

ال [مرجع واجهة برمجة التطبيقات 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:User` كائن. كل سمة يتناولها هذا الدليل مُدرجة بداخله.
* ابحث عن السمة بالاسم، وسجّل **نوع البيانات** وخاصته **القيم المسموح بها**.
* اقرأ الوصف المصاحب لها. فالأوصاف توضّح سلوكًا لا يمكنك استنتاجه من اسم السمة — `zoomPhoneExtNumber` الذي يتم تعيينه إلى `0` يؤدي إلى تعيين رقم تحويلة تلقائيًا، `zoomPhoneCallingPlan` الذي يتم تعيينه إلى `-1` يزيل جميع خطط الاتصال، و `zoomPhoneNumber` يجب أن يشير إلى رقم غير معيّن بالفعل في حساب Zoom.

#### <mark style="color:أزرق;">تجميع المعرِّف: الأصل، النقطتان، الفرع</mark>

كل ما هو مدرج داخل ذلك `urn:ietf:params:scim:schemas:extension:zoom:1.0:مستخدم` الكائن هو **طفل** منه. والكائن نفسه هو **الأصل**. يتكوّن معرِّف عبر تسمية العنصر الأصل، ثم إضافة نقطتين، ثم إضافة العنصر الفرعي:

```
الأصل       urn:ietf:params:scim:schemas:extension:zoom:1.0:مستخدم
النقطتان        :
الابن        zoomPhoneموقع

معرِّف   urn:ietf:params:scim:schemas:extension:zoom:1.0:مستخدم:zoomPhoneموقع
```

هذا هو البناء بأكمله. لا يوجد جدول بحث لطلبه من Zoom ولا شيء لتوليده — المعرِّف هو شيئان لديك بالفعل، موصولان بنقطتين.

#### <mark style="color:أزرق;">يبقى الأب كما هو؛ ويتغير الابن فقط</mark>

لأن الأب ثابت، فإن إعداد السمة الثانية أو الخامسة أو الخامسة عشرة هو نفس الإجراء مع إلحاق ابن مختلف في النهاية:

```
الأساس (الأب)              urn:ietf:params:scim:schemas:extension:zoom:1.0:مستخدم

Zoom Phone موقع            urn:ietf:params:scim:schemas:extension:zoom:1.0:مستخدم:zoomPhoneموقع
Zoom Phone رقم          urn:ietf:params:scim:schemas:extension:zoom:1.0:مستخدم:zoomPhoneرقم
Zoom Phone تحويلة       urn:ietf:params:scim:schemas:extension:zoom:1.0:مستخدم:zoomPhoneرقمداخلي
Zoom Phone خطة المكالمات    urn:ietf:params:scim:schemas:extension:zoom:1.0:مستخدم:zoomPhoneخطةالمكالمات
```

العنصر الأصل نفسه يحمل كل منتج آخر من 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 — ثم تحديد السمات التي يجب تناولها أولًا، وهو ما سيأتي التالي.

#### <mark style="color:أزرق;">نوعان من التعيين: أساسي ومتقدم</mark>

ليست كل سمة تنطوي على الخطر نفسه، ومن المفيد فرزها قبل إعداد أي شيء.

يستعير هذا الدليل المصطلحات **أساسي** و **متقدم** من [دليل SSO الميداني](https://library.zoom.com/admin-corner/account-and-endpoint-management/sso-field-guide)، الذي يرسم التمييز نفسه عند تعيين استجابة SAML. تصف المصطلحات **ما يفعله Zoom بالقيمة عند وصولها**، لا مدى صعوبة تكوين السمة. ومن الناحية العملية، فهما متطابقان: إذ يوثَّق كلاهما في نص الطلب نفسه، **تحديث مستخدم** ويُنشأ كلاهما باستخدام البنية نفسها: أصل-نقطتان-فرع، كما يُعلَن عنهما ويُعيَّنان عبر الخطوات نفسها في Entra ID وOkta.

* **التعيين الأساسي** يكتب نصًا في ملف المستخدم الشخصي. يخزّن Zoom القيمة كما أُرسلت تمامًا، ولا يتحقق منها مطلقًا بمقارنتها بأي شيء.
* **التعيين المتقدم** يُقدّم مطالبةً على الحساب. يأخذ Zoom القيمة ويبحث عن عنصر مطابق، أو عن مقعد شاغر ضمن خطة تم شراؤها — وقد يفشل هذا البحث.

<table><thead><tr><th width="199.435791015625"></th><th>تعيين أساسي</th><th>تعيين متقدم</th></tr></thead><tbody><tr><td><strong>ما هي القيمة</strong></td><td>نص مخزَّن في ملف المستخدم</td><td>مؤشر إلى كائن في Zoom، أو استحقاق لمقعد تم شراؤه</td></tr><tr><td><strong>أمثلة</strong></td><td><code>department</code>, <code>title</code>, <code>costCenter</code></td><td><code>zoomPhoneSite</code>, <code>zoomContactCenterRole</code>, <code>zoomWorkplace</code></td></tr><tr><td><strong>الوالد</strong></td><td>على المستوى الأعلى، أو امتداد خطة Enterprise</td><td>إضافة Zoom</td></tr><tr><td><strong>الشروط المسبقة في زوم</strong></td><td>لا شيء</td><td>يجب أن يكون الكائن موجودًا، أو يجب أن يكون المقعد متاحًا</td></tr><tr><td><strong>إذا كانت القيمة خاطئة</strong></td><td>يظهر نص غير صحيح على ملف شخصي</td><td>تُرفض السمة، أو يتم تجاهلها بصمت</td></tr></tbody></table>

يترتب على هذا التمييز قراران عمليان. فهو يحدد **ما يجب إعداده في Zoom أولًا** — لا شيء في حالة الربط الأساسي، وربما الكثير في الحالة المتقدمة — كما يحدد **ما تكلّفه غلطة**. يُعدّ القسم غير الصحيح خطأً شكليًا في الملف الشخصي. أما اسم الموقع غير الصحيح أو عدم توفر مقعد ترخيص، فيترك المستخدم بلا هاتف يعمل أو بلا المنتج الذي عُيّن لاستخدامه، وفي بيئة تشغيل فعلية قد يؤدي ذلك إلى سحب استحقاق من شخص كان يملكه بالفعل.

هذا الاختلاف في العاقبة هو السبب في التعامل مع الاثنين بشكل منفصل أدناه.

#### <mark style="color:أزرق;">التعيين الأساسي: معلومات الملف الشخصي</mark>

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

**تكون حقول الهوية الأساسية معيّنة مسبقًا عادةً.** `اسم المستخدم`, `name.givenName`, `name.familyName`, `displayName`، و `emails` تكون في المستوى الأعلى من نص الطلب دون أي عنصر أب، وتُجري كل من عمليتَي تكامل Entra ID وOkta تعيينًا لها مباشرةً. تحقّق منها بدلًا من إعادة بنائها. `title`, `phoneNumbers`، و `locale` تكون أيضًا في المستوى الأعلى، لكن قد يلزم إضافتها.

**تستخدم حقول خطة 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:مؤسسة
مدير               urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager
```

لم يعد ملء القسم ومركز التكلفة عبر SCIM يتطلب تعيين SAML.

{% hint style="info" %}
**توصية**

عيّن سمة أساسية واحدة أولًا — `department` مرشّح جيد، ويتم تناوله على النحو التالي **السيناريو 0** في السيناريوهات المرجعية — ونفِّذه من البداية إلى النهاية لمستخدم اختباري واحد قبل إعداد أي شيء ضمن إضافة Zoom. A `department` إن ظهور القيمة بشكل صحيح في ملف تعريف Zoom يثبت صحة تعريف المخطط والتعيين والنطاق وقدرتك على قراءة سجلات التزويد. ولا تختلف كل سمة متقدمة ترد لاحقًا إلا في الشيء الذي تشير إليه، لا في طريقة إعدادها.
{% endhint %}

#### <mark style="color:أزرق;">التعيين المتقدم: تكوين المنتج والاستحقاقات</mark>

يعيّن التعيين المتقدم الأشياء التي يمكن للمستخدم القيام بها: موقع Zoom Phone وخطة الاتصال، ودور مركز الاتصال وحزمة البرامج، وحزمة Workplace، وقطاع Revenue Accelerator. تعيش هذه السمات تحت العنصر الأب لإضافة Zoom المستخدم طوال هذا الدليل.

الفرق المهم هو أن هذه القيم لا تُخزَّن، بل يتم **حلّها**. يأخذ Zoom القيمة التي ترسلها ويبحث عن كائن مطابق أو مقعد متاح. فبينما يكتب التعيين الأساسي نصًا في ملف تعريف، يقدّم التعيين المتقدم مطالبة بشأن إعدادات الحساب ومخزونه، وقد لا تُقبل هذه المطالبة.

ولهذا يخصّص هذا الدليل قسمًا كاملًا للشروط المسبقة. تعتمد كل سمة متقدمة على أن يكون شيء ما قد تم إنشاؤه أو شراؤه أولًا في بوابة Zoom على الويب، كما أن أوضاع الفشل أقل تسامحًا بكثير من مسمى وظيفي مكتوب خطأ.

#### <mark style="color:أزرق;">الطبقات الثلاث المشتركة بين كل إعداد</mark>

بغض النظر عن السمة أو موفر الهوية، فإن العمل هو الطبقات الثلاث نفسها. يختلف فقط الموقع الخاص بكل عنصر تحكم.

<table><thead><tr><th width="114.4166259765625">الطبقة</th><th>الغرض</th><th>Microsoft Entra ID</th><th>Okta</th></tr></thead><tbody><tr><td><strong>1. التعريف</strong></td><td>أخبر موفر الهوية بأن السمة موجودة في Zoom تطبيق حتى تصبح متاحًا كهدف للتعيين.</td><td>الخطوة 1</td><td>الخطوة 1</td></tr><tr><td><strong>2. التعيين</strong></td><td>حدّد من أين تأتي القيمة.</td><td>الخطوة 2</td><td>الخطوتان 2–3</td></tr><tr><td><strong>3. النطاق</strong></td><td>حدِّد على أيّ مستخدمين تنطبق التهيئة ومتى يتم تشغيلها.</td><td>الخطوات 3–5</td><td>الخطوات 4–5</td></tr></tbody></table>

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

#### <mark style="color:أزرق;">يختلف Entra وOkta في مصدر القيمة</mark>

هذا هو الفرق المعماري الأكثر أهمية بين المسارين، وهو يفسر لماذا ينتج عن نفس متطلب العمل تهيئات مختلفة بين Entra وOkta.

* **يستمد Entra ID القيم من سمات كائن المستخدم فقط.** يجب أن تأتي القيمة من حقل في المستخدم — سواء أكان حقل دليل موجودًا أم سمة امتداد مصممة لغرض. وعندما تختلف قيمة الدليل عن قيمة Zoom، يلزم استخدام تعبير للترجمة بينهما.
* **يمكن لـ Okta استمداد القيم من ملف تعريف المستخدم أو من تعيين مجموعة.** تعريف سمة باستخدام **نوع السمة: مجموعة** يتيح تعيين القيمة مرة واحدة لمجموعة، ثم توريثها لكل عضو. وعندما يتبع التكوين البنية التنظيمية، يغني ذلك تمامًا عن منطق الترجمة.

لا يوجد أي من النهجين أفضل عالميًا، لكنهما يؤديان إلى إعدادات مختلفة.

### **متطلبات التهيئة المسبقة من جانب Zoom**

#### <mark style="color:أزرق;">قبل محاولة التعيين المتقدم، يجب أن تكون الكائنات الموجودة في جانب Zoom موجودة حتى يتمكن SCIM من الإشارة إليها</mark>

SCIM آلية إسناد، وليست آلية إنشاء — فهي تربط مستخدمًا بتكوين موجود مسبقًا في حساب Zoom، ولا **يمكنها** إنشاء هذا التكوين نيابةً عن المستخدم.

تُعد نسبة كبيرة من سمات التعيين المتقدمة **مراجع**: يُفترض أن تُطابق القيمة التي ترسلها كائنًا موجودًا بالفعل في Zoom — مثل موقع أو دور أو قالب أو خطة تم شراؤها أو رقم أو تحويلة محددة. وتسري قاعدة واحدة عليها جميعًا:

> إذا كانت السمة تُسمّي شيئًا ما، فيجب أن يكون ذلك الشيء موجودًا بالفعل، وأن يُكتب تمامًا كما أُرسل، و— حيث يعتمد على مخزون محدود — يجب أن تكون لديه سعة غير مستخدمة.

عندما لا يوجد الكائن المشار إليه، لا يقوم SCIM بإنشائه ولا بوضع الطلب في قائمة الانتظار. إما أن تفشل السمة فشلًا صريحًا، مع إرجاع الخطأ في سجل التزويد، أو تُهمَل بصمت — يقبل Zoom الحمولة، ولا يطبّق شيئًا، ويُبلغ بالنجاح.

تقسّم الأقسام أدناه المتطلبات المسبقة حسب المنتج، مع مسار التنقل ومقال الدعم لإنشاء كل منها. اقرأ ملاحظات مستوى الحساب، ثم القسم الخاص بكل منتج تنوي تزويده.

#### <mark style="color:أزرق;">تنطبق المتطلبات المسبقة على مستوى الحساب قبل تزويد أي منتج</mark>

متطلبات الحساب المذكورة في بداية هذا الدليل — عنوان URL فارغ، وSSO، وتفويض SCIM، ونطاق مرتبط تم التحقق منه — هي شروط مسبقة لكل سمة ترد لاحقًا. كوِّن إعدادات الأمان وSSO ضمن [**مركز المسؤول**](https://zoom.com/account) → [**الأمان والثقة**](https://zoom.com/account/setting/security)، وأدِر النطاقات المرتبطة ضمن [**مركز المسؤول**](https://zoom.com/account) → **الحساب** → [**ملف تعريف الحساب**](https://zoom.com/account)؛ راجع [تكوين 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).
* **يجب أن تنتمي المقاعد إلى الخطة المحددة المطلوبة نفسها.** يؤدي إرسال سمة ترخيص عندما لا تتوفر مقاعد شاغرة في الخطة المحددة إلى فشل العملية، حتى إذا كانت هناك سعة فائضة في خطة أخرى ضمن الحساب.

#### <mark style="color:أزرق;">Zoom Phone</mark>

يحتوي Zoom Phone على أكبر مجموعة من السمات المرجعية لأن مستخدم الهاتف يُجمَّع من عدة أجزاء من بنية تحتية مشتراة مسبقًا أو مُنشأة مسبقًا.

| السمة                                                                | ما يجب أن يكون موجودًا بالفعل                                                                                                                  | كيفية إنشائه                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| -------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ترخيص Zoom Phone نفسه                                                | مقعد Zoom Phone متاح — الاستحقاق المسبق اللازم قبل أن يتمكن أي مما يلي من الارتباط.                                                            | اشترِ مسبقًا. راجع [شراء تراخيص Zoom Phone وإسنادها](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0077929).                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `zoomPhoneSite`                                                      | الموقع، المسمى تمامًا كما هي القيمة المُرسلة. يؤدي حذف السمة إلى تعيين الموقع الرئيسي للحساب، والذي يوجد افتراضيًا بمجرد تمكين عدة مواقع.      | [مركز المسؤول](https://zoom.com/account) → إعداد المنتج → نظام الهاتف → [معلومات الشركة](https://zoom.com/pbx/page/telephone/settings#/settings) → **إضافة موقع**، أو **استيراد** للإنشاء بالجملة. راجع [إدارة عدة مواقع](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0069716).                                                                                                                                                                                                                                             |
| `zoomPhoneNumber`                                                    | الرقم، الذي تم شراؤه أو نقله إلى الحساب وهو غير مخصص حاليًا. لا يمكن إعادة استخدام رقم يحتفظ به مستخدم آخر، أو طابور مكالمات، أو المجيب الآلي. | [مركز المسؤول](https://zoom.com/account) → إعداد المنتج → الأرقام → [أرقام الهاتف](https://zoom.com/cpw/page/phoneNumbers#/number-list). اشترِ الرقم أو انقله إلى هنا، واترك الرقم المستهدف دون إسناد لكي يتمكن 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://zoom.com/account) → إعداد المنتج → نظام الهاتف → [المستخدمون والغرف](https://zoom.com/pbx/page/telephone/phoneUsers#/users) → يحدد الكائن الذي يحتوي على التحويلة → **الملف الشخصي** → **رقم داخلي** → **تعديل**. اطّلع على [تغيير إعدادات مستخدم الهاتف](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/)، أو تُعاد كـ `type` بواسطة [قائمة خطط الاتصال](https://developers.zoom.us/docs/api/references/phone-calling-plans/) واجهة برمجة التطبيقات، إلى جانب أعداد المقاعد المتاحة. |
| `zoomPhoneCallingPlanSubscription` (لحسابات الاشتراكات المتعددة فقط) | الاشتراك المحدد الذي ينبغي أن تسحب منه الخطة، عندما يحتوي الحساب على أكثر من اشتراك واحد للخطة نفسها.                                          | الخطط وفوترة → إدارة الاشتراكات.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |

**مجموعة الأرقام الداخلية مشتركة بين أنواع العناصر، وليس المستخدمين فحسب.** تستهلك قوائم انتظار المكالمات، وموظفو الاستقبال الآليون، ومجموعات الخطوط المشتركة، وهواتف المناطق المشتركة أرقامًا داخلية من النطاق نفسه. وهذا هو السبب الأكثر شيوعًا لفشل «الرقم الداخلي قيد الاستخدام بالفعل»، لأن الرقم يبدو متاحًا عندما يتحقق مسؤول من قائمة المستخدمين فقط.

**لا يمكن تعيين الرقم المنقول إلى أن تكتمل عملية نقله.** يجب أن يكون الرقم موجودًا في الحساب وغير معيّن؛ فبدء عملية النقل لا يحقق أيًا من هذين الشرطين.

**تُعد المواقع العائق الأكثر شيوعًا** لأن إنشاءها يستلزم متطلبات خاصة بها. ويُتحقَّق من عناوين المواقع بمقارنتها بقاعدة بيانات للعناوين الفعلية، لأنها تدعم خدمات إجراء مكالمات الطواريْ — لذا تُرفض مجموعات العناوين والرموز البريدية المختلقة مع ظهور خطأ في التحقق. وعند استيراد المواقع بالجملة، يتوقع عمود المجيب الآلي القيمة `Yes` بدلًا من نص التسمية الظاهر في الواجهة، وينطبق اسم معرّف المتصل أساسًا على الولايات المتحدة وكندا، ويمكن تركه فارغًا إذا تسبب في فشل التحقق.

#### <mark style="color:أزرق;">Zoom مركز الاتصال</mark>

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

| السمة                           | ما يجب أن يكون موجودًا بالفعل                                                                                       | كيفية إنشائه                                                                                                                                                                                                                                                                                                                                                                                             |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `zoomContactCenterPackage`      | حزمة البرامج — `Essentials`, `Premium`، أو `Elite` — تم شراؤها باستخدام مقاعد غير مستخدمة.                          | اشترِ مسبقًا؛ قد يتطلب Premium التواصل مع دعم Zoom لشراء حزم إضافية أولًا. راجع [تغيير إعدادات مستخدمي مركز اتصال Zoom](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060874).                                                                                                                                                                                                     |
| `zoomContactCenterAddonsPlan`   | خطة المكون الإضافي، تم الشراء ولديها سعة.                                                                           | شراء مسبقًا؛ خطة الحساب ومعلومات الفوترة.                                                                                                                                                                                                                                                                                                                                                                |
| `zoomContactCenterRole`         | الدور، سواء كان معياريًا أو مخصصًا، والمسمى بدقة. حذفُه يعيّن دور الوكيل الافتراضي، الموجود افتراضيًا.              | [مركز المسؤول](https://zoom.com/account) ← إدارة تجربة العملاء → مركز الاتصال → [الأدوار](https://zoom.com/cci/index/admin#/admin-next/admin-roles) → **إضافة** → كوَّن الأذونات → **حفظ**. راجع [إدارة أدوار مركز الاتصال في Zoom](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0061941).                                                                                         |
| `zoomContactCenterRegion`       | المنطقة. يؤدي حذفها إلى تعيين المنطقة الرئيسية للحساب، والتي يجب تهيئتها.                                           | [مركز المسؤول](https://zoom.com/account) → إدارة تجربة العملاء → مركز الاتصال → [التفضيلات](https://zoom.com/cci/index/admin#/admin-preferences) → المناطق → **إضافة منطقة** → أدخل اسمًا وحدد منطقة SIP → **إضافة**. راجع [إدارة مناطق مركز الاتصال في Zoom](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0057668).                                                               |
| `zoomContactCenterUserTemplate` | قالب المستخدم، واسمه مطابق تمامًا. قوالب نوع الإضافة تُطبق عند إنشاء المستخدم؛ قوالب نوع التحديث تُطبق عند التحديث. | [مركز المسؤول](https://zoom.com/account) → إدارة تجربة العملاء → مركز الاتصال → المستخدمون → [القوالب](https://zoom.com/cci/index/admin#/admin-agents#templates) → **إضافة قالب** → اختر **إضافة** → كوَّن الأدوار والحزم وقوائم الانتظار والمهارات → **إضافة**. راجع [إدارة قالب إعدادات المستخدم في مركز الاتصال في Zoom](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0077757). |

{% hint style="danger" %}
**تحذير**

يجب أن تُمكِّن دعم Zoom ميزة مناطق مركز الاتصال قبل إمكانية إنشاء المناطق، وينتمي كل مستخدم إلى منطقة واحدة فقط. وبما أنها طلب دعم وليس تبديلًا ذاتيًا للخدمة، فاطرح ذلك مبكرًا إذا كان من المخطط نشر متعدد المناطق.
{% endhint %}

**لا تحتوي صناديق الوارد وقوائم الانتظار والمهارات على سمة SCIM.** لتوفيرها، أنشئها مسبقًا في [مركز المسؤول](https://zoom.com/account) → إدارة تجربة العملاء → مركز الاتصال، وأرفقها بقالب مستخدم، ثم عيّن ذلك القالب من خلال `zoomContactCenterUserTemplate`. وبذلك تصبح شروطًا مسبقة *للقالب* بدلًا من المستخدم الفردي، مما يجعل القالب أيضًا العنصر الوحيد الذي تجب صيانته عند تغير هذه المتطلبات.

<table><thead><tr><th width="123.2821044921875">كائن</th><th>كيفية إنشائه</th></tr></thead><tbody><tr><td>قائمة الانتظار</td><td><a href="https://zoom.com/account">مركز المسؤول</a> → إدارة تجربة العملاء → مركز الاتصال → <a href="https://zoom.com/cci/index/admin#/admin-queues">قوائم الانتظار</a> → <strong>إضافة قائمة انتظار</strong> → الاسم، قناة، الوكلاء → <strong>حفظ</strong>. راجع <a href="https://support.zoom.com/hc/en/article?id=zm_kb&#x26;sysparm_article=KB0061959">إدارة قوائم الانتظار في مركز الاتصال في Zoom</a>.</td></tr><tr><td>مهارة</td><td><a href="https://zoom.com/account">مركز المسؤول</a> → إدارة تجربة العملاء → مركز الاتصال → <a href="https://zoom.com/cci/index/admin#/admin-next/admin-skills">المهارات</a> → حدد فئة → <strong>إضافة مهارة</strong> → الاسم → <strong>إضافة</strong>. راجع <a href="https://support.zoom.com/hc/en/article?id=zm_kb&#x26;sysparm_article=KB0059519">إدارة المهارات وفئات المهارات</a>.</td></tr><tr><td>صندوق الوارد</td><td><a href="https://zoom.com/account">مركز المسؤول</a> → إدارة تجربة العملاء → مركز الاتصال → <a href="https://zoom.com/cci/index/admin#/admin-next/admin-inbox">صندوق الوارد</a> → <strong>إضافة صندوق وارد</strong>. راجع <a href="https://support.zoom.com/hc/en/article?id=zm_kb&#x26;sysparm_article=KB0059471">إدارة صناديق الوارد في مركز الاتصال في Zoom</a>.</td></tr></tbody></table>

**عند توفير قالب وسمات فردية معًا، تكون الأولوية للقيم الفردية.** إرسال قالب إلى جانب `zoomContactCenterRole` يعني أن سمة الدور تتجاوز إعداد الدور في القالب، لذا يجب أن يكون كل من الدور المُشار إليه والقالب موجودين.

#### <mark style="color:أزرق;">Zoom Revenue Accelerator</mark>

| السمة                                                               | ما يجب أن يكون موجودًا بالفعل                                                 | كيفية إنشائه                                                                                                                                                                                                                                                                                                                                          |
| ------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `zoomRevenueAcceleratorPlan` و `zoomRevenueAcceleratorSubscription` | الخطة أو الاشتراك المشتراة في ZRA مع مقعد متاح.                               | شراء مسبقًا؛ خطة الحساب ومعلومات الفوترة.                                                                                                                                                                                                                                                                                                             |
| `zoomRevenueAcceleratorRole`                                        | الدور، سواء كان معياريًا أو مخصصًا، مثل `مدير المبيعات` — بالاسم نفسه تمامًا. | [مركز المسؤول](https://zoom.com/account) → المستخدمون → [الأدوار](https://zoom.com/role#/) → **مسرّع الإيرادات** علامة تبويب → **+ إضافة دور** → الاسم والوصف → **إضافة** → كوَّن الأذونات → **حفظ التغييرات**. راجع [استخدام إدارة الأدوار في Zoom Revenue Accelerator](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0059285). |
| `zoomRevenueAcceleratorSegment`                                     | الشريحة التي ينتمي إليها المستخدم.                                            | إعدادات مسؤول Revenue Accelerator.                                                                                                                                                                                                                                                                                                                    |
| `zoomRevenueAcceleratorRegion`                                      | المنطقة — على سبيل المثال، `US`.                                              | إعدادات مسؤول Revenue Accelerator.                                                                                                                                                                                                                                                                                                                    |

#### <mark style="color:أزرق;">تراخيص Zoom Workplace وأدوار الحساب</mark>

إلى جانب المنتجات الثلاثة أعلاه، يحمل سجل المستخدم معياري المراجع الخاصة بالدور والترخيص التي تتبع القاعدة نفسها.

| السمة                                                                                                                                                                                                                                                                                  | ما يجب أن يكون موجودًا بالفعل                                                                | كيفية إنشائه                                                                                                                                                                                                                                          |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `roles[]` (`value` / `عرض`)                                                                                                                                                                                                                                                            | دور الحساب، مُسمّى بدقة. تتم الإشارة إلى الأدوار بواسطة SCIM، ولا يتم إنشاؤها بواسطته أبدًا. | [مركز المسؤول](https://zoom.com/account) → المستخدمون → [الأدوار](https://zoom.com/role#/) → **إضافة دور** → الاسم والوصف → كوَّن الأذونات. راجع [استخدام إدارة الأدوار](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064983). |
| `zoomWorkplace` وسمات الترخيص أو المكون الإضافي الأخرى — السبورة البيضاء، وScheduler، وClips Plus، والتسميات التوضيحية المترجمة، وWorkforce Management، وإدارة الجودة، وإدارة الامتثال، ورؤى تجربة العملاء، ومساعدة المبيعات بالذكاء الاصطناعي، وما يخصها من `...Subscription` النظراء | الحزمة المقابلة أو مكون إضافي، المشتراة مع المقاعد غير المستخدمة.                            | الخطط والفوترة → إدارة الخطة → تعديل الخطة → زيادة عدد التراخيص. راجع [ترقية الحساب والإضافات](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063375).                                                                           |
| `loginType` (`sso` / `workEmail`), ضمن `urn:us:zoom:scim:schemas:extension:1.0:ZoomUser`                                                                                                                                                                                               | تم تكوين SSO على الحساب، لنوع تسجيل دخول SSO.                                                | [مركز المسؤول](https://zoom.com/account) → الأمان والثقة → [تسجيل الدخول لمرة واحدة](https://zoom.com/account/sso/saml).                                                                                                                              |

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

#### <mark style="color:أزرق;">سمات بدون شرط مسبق</mark>

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

* **القيم المفوّضة تلقائيًا** — `zoomPhoneExtNumber` تُرسَل على هيئة `0`، حيث يخصّص Zoom الرقم الداخلي بنفسه.
* **السمات المخصّصة للحساب** — الـ `{customAttribute}` حقل، ويحتوي على أي سلسلة نصية ترسلها.

**المراجع ذات القيم الافتراضية** تمثّل حالة وسطية: إذ إن إغفال `zoomPhoneSite`, `zoomContactCenterRole`، أو `zoomContactCenterRegion` يعود في المقابل إلى الموقع الرئيسي، ودور الوكيل الافتراضي، والمنطقة الرئيسية، على التوالي. ويجب أن تكون هذه القيم الافتراضية موجودة بحد ذاتها، وهي موجودة افتراضيًا.

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

{% hint style="info" %}
**توصية**

اعتبر البناء على جانب Zoom مرحلةً تمهيديةً لها اعتمادها الخاص، وتُستكمل وتُتحقق قبل بدء عمل مطابقة السمات. غالبًا ما تكون المواقع والأرقام والخطط والأدوار والقوالب مملوكة لفريق مختلف عن إعدادات موفّر الهوية، واكتشاف كائن مفقود أثناء اختبار التزويد يكلف أكثر بكثير من التأكد من وجوده مسبقًا.
{% endhint %}

### **جارٍ إعداد بيانات الدليل الخاصة بك**

ينقل SCIM كل ما يحتويه المصدر. لا يتحقق منه، ولا يطبّعه، ولا يصححه. قبل تعيين أي سمة، تأكّد من ثلاثة أمور بشأن المصدر المقصود:

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

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

{% hint style="info" %}
**توصية**

حدّد مصدر الحقيقة قبل لمس تكوين مزود الهوية. معظم عمليات نشر SCIM الفاشلة هي مشاكل بيانات الدليل التي تظهر على أنها مشاكل تزويد.
{% endhint %}

### **السيناريوهات المرجعية**

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

#### <mark style="color:أزرق;">السيناريو 0: القسم، كتعيين أساسي أولي</mark>

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

**متطلب مسبق من جانب Zoom.** لا شيء. يخزّن Zoom القيمة تمامًا كما أُرسلت، ولا يتحقق مطلقًا من مطابقتها لكائن موجود.

**السمة.** لاحظ أن الأصل يختلف عن السيناريوهات الثلاثة أدناه — `department` يوجد ضمن إضافة خطة Enterprise، وليس إضافة Zoom.

| السمة                                                                   | النوع      | ملاحظات                                                                                                         |
| ----------------------------------------------------------------------- | ---------- | --------------------------------------------------------------------------------------------------------------- |
| `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department` | سلسلة نصية | نص حر. يتضمن موفّرا الهوية كليهما بالفعل `department` في الملف الشخصي للمستخدم، لذا لا حاجة إلى سمة مصدر جديدة. |

**لماذا تبدأ من هنا؟** إن ظهور قيمة القسم بشكل صحيح في ملف Zoom الشخصي يثبت صحة تعريف المخطط والتعيين والنطاق، كما يثبت قدرتك على قراءة سجلات التزويد، من دون تعريض ترخيص أو إعداد هاتف للخطر. لا تختلف السيناريوهات المتقدمة أدناه إلا في السمة التي تشير إليها.

**تحقّق أولًا مما إذا كان قد تم تعيينها بالفعل.** تختلف التعيينات الافتراضية بين Entra ID وOkta، وتتغير كلما حدّث المورّدان تكاملات Zoom لديهما. راجع القائمة الحالية ضمن **التزويد** → **التعيينات** في Entra، أو **تعيينات سمات Zoom** مع **عرض السمات غير المعيّنة** مفعّلًا في Okta. إذا كان `department` معيّنًا بالفعل، فتحقّق منه بدلًا من إعلان تعيين مكرر. وإذا أردت سمة أخرى لتكوَّنها من البداية، `costCenter`, `مؤسسة`، و `employeeNumber` تقع تحت الأصل نفسه وتعمل بالطريقة نفسها.

#### <mark style="color:أزرق;">السيناريو 1: موقع Zoom Phone والتعيين التلقائي لرقم داخلي</mark>

ينبغي وضع المستخدمين في موقع Zoom Phone الصحيح استنادًا إلى مكتبهم والحصول على رقم داخلي دون تدخل إداري.

**متطلب مسبق في Zoom** يجب أن تكون المواقع موجودة مسبقًا. أنشئها ضمن [**مركز المسؤول**](https://zoom.com/account) → **تهيئة المنتج** → **نظام الهاتف** → [**معلومات الشركة**](https://zoom.com/pbx/page/telephone/settings#/settings) → **إضافة موقع**، أو دفعةً واحدة عبر **استيراد**. يتم التحقق من عناوين الموقع باستخدام قاعدة بيانات للعناوين الحقيقية، لأنها تدعم خدمات إجراء مكالمات الطواريْ، لذا ستفشل عمليات التحقق من مجموعات العناوين والرموز البريدية الوهمية.

**السمات.** كلاهما يأخذ مساحة الأسماء `urn:ietf:params:scim:schemas:extension:zoom:1.0:مستخدم:` يتبع ذلك الاسم.

| السمة                | النوع      | ملاحظات                               |
| -------------------- | ---------- | ------------------------------------- |
| `zoomPhoneSite`      | سلسلة نصية | يجب أن يطابق اسم موقع Zoom حرفًا بحرف |
| `zoomPhoneExtNumber` | سلسلة نصية | `0` يؤدي إلى التعيين التلقائي         |

**لماذا تُعدّ القيمة `0` الأمور.** Zoom هو النظام الوحيد الذي يعرف الامتدادات المستخدمة بالفعل، بما في ذلك الامتدادات المخصصة لقوائم انتظار المكالمات وموظفي الاستقبال الآليين بدلاً من المستخدمين. ويؤدي تفويض التخصيص إلى Zoom إلى إزالة فئة كاملة من حالات فشل التجهيز. أما استقاء الامتدادات من الدليل، فهو مناسب أثناء الترحيل عندما يكون الحفاظ على أرقام الامتدادات الحالية مهماً، لكن ينبغي أن يتحول التعيين إلى `0` بمجرد اكتمال عملية الترحيل، حتى لا يعتمد المنضمون لاحقًا على استمرار صيانة بيانات الدليل إلى أجل غير مسمى.

{% hint style="info" %}
**ملاحظة**

عادةً ما يُسمّى الموقع الافتراضي في الحساب على Zoom Phone بالاسم التالي تمامًا `الموقع الرئيسي`، الظاهر ضمن [**مركز المسؤول**](https://zoom.com/account) → **إعدادات المنتج** → **نظام الهاتف** → [**معلومات الشركة**](https://zoom.com/pbx/page/telephone/settings#/settings). تأكد من الاسم في الحساب المحدد قبل الاعتماد عليه، إذ يمكن تغييره.
{% endhint %}

#### <mark style="color:أزرق;">السيناريو 2: خطة مكالمات Zoom Phone تختلف حسب البلد</mark>

قامت مؤسسة متعددة الجنسيات بشراء خطط مكالمات 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/) واجهة برمجة التطبيقات، التي تُرجع لكل خطة `name`، فإنّها `type` — الرمز الذي تربطه — و `subscribed` و `متاح` عدد المقاعد. لذا تؤكد مكالمة واحدة وجود الخطة، وتمنحك القيمة التي يجب إرسالها، وتتحقق من توفر سعة لتعيينها.

تعرض بوابة 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` بوصفه القيمة التي تزيل جميع خطط الاتصال. يؤدي استخدامها للمستخدمين غير المطابقين إلى نتيجة حتمية وواضحة — عدم تعيين أي خطة — بدلًا من الغموض الناجم عن عدم إرسال أي قيمة. كما توفر طريقة واضحة لإلغاء استحقاقات الاتصال من دون حذف المستخدم.

#### <mark style="color:أزرق;">السيناريو 3: حزمة البرامج الخاصة بـمركز الاتصال من Zoom، والدور، والمنطقة</mark>

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

| السمة                      | النوع      | القيم المسموح بها                                                            |
| -------------------------- | ---------- | ---------------------------------------------------------------------------- |
| `zoomContactCenterPackage` | سلسلة نصية | `Essentials`, `مميز`, `نخبة`                                                 |
| `zoomContactCenterRole`    | سلسلة نصية | اسم أي دور في ZCC. القيمة افتراضيًا هي `وكيل` إذا لم تُحدَّد.                |
| `zoomContactCenterRegion`  | سلسلة نصية | أي منطقة ZCC مُكوَّنة. القيمة الافتراضية هي المنطقة الرئيسية إذا تم الإغفال. |

**حول الإغفال المتعمد للسمات.** مغادرة `zoomContactCenterRegion` غير معيّن في عمليات النشر ذات المنطقة الواحدة، حيث تكون القيمة الافتراضية الموثّقة من Zoom صحيحة بالفعل. يُفضَّل إغفال سمة تكون قيمتها الافتراضية صحيحة بدلًا من تعيينها؛ فكل تعيين يفرض التزامًا بالصيانة.

**ملاحظة تشغيلية.** يوثّق المرجع SCIM2 أيضًا `zoomContactCenterUserTemplate`، الذي يطبّق قالب ZCC مُعدًّا مسبقًا. تُطبّق القوالب من نوع الإضافة عند إنشاء المستخدم، وتُطبّق القوالب من نوع التحديث عند التحديث. إذا أُرسل قالب وقيم سمات فردية في الطلب نفسه، تكون الأولوية للقيم الفردية. يجدر النظر في استخدام القوالب عندما يكون إعداد ZCC معقدًا بما يكفي لتصبح صيانته عبر العديد من تعيينات السمات الفردية مرهقة.

### **التحقق من جانب Zoom والأخطاء الشائعة**

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

#### <mark style="color:أزرق;">سجلات المكالمات في سوق التطبيق من Zoom هي عرض كامل لتبادل الطلب والاستجابة</mark>

1. تسجيل الدخول إلى بوابة الويب الخاصة بـ Zoom بصفتك مالك الحساب.
2. انتقل إلى [**سوق تطبيق Zoom**](https://marketplace.zoom.us/) → **إدارة** → **التطبيقات في الحساب**.
3. يحدد التطبيق الذي يمثّل اتصال موفّر الهوية. وبالنسبة إلى Entra، يكون اسمه عادةً **Azure Identity** أو ما شابه ذلك.
4. افتح **سجل المكالمات** علامة التبويب.
5. استخدم **البحث حسب نقطة النهاية**، أو عوامل التصفية لنطاق التاريخ والطريقة والحالة، للعثور على المكالمة ذات الصلة.
6. يحدد الصف لتوسيعه.
7. راجع `requestBody` لمعرفة ما أُرسل بالضبط، و `response` لمعرفة ما أعاده Zoom بالتحديد، بما في ذلك معرّف مستخدم Zoom الذي تم إنشاؤه، `httpStatus`، ومجموعة السمات الناتجة.

يحتفظ Zoom بأحدث 100 من سجلات طلبات واجهة برمجة التطبيقات، لذا تحرَّ سبب الفشل على الفور بدلًا من ذلك بعد أن تؤدي أنشطة التزويد اللاحقة إلى إزاحته.

#### <mark style="color:أزرق;">أخطاء التزويد الشائعة وأسبابها</mark>

<table><thead><tr><th width="99.69622802734375">الرمز</th><th>الرسالة</th><th>السبب والحل</th></tr></thead><tbody><tr><td>400</td><td>لم يتم تمكين تسجيل الدخول لمرة واحدة للحساب.</td><td>يُعد SSO شرطًا مسبقًا لـ SCIM. قم بتمكين SSO و كوَّنه على حساب Zoom أولاً.</td></tr><tr><td>400</td><td>المستخدم غير نشط أو مقفل.</td><td>لا يمكن تحديث مستخدم Zoom المستهدف في حالته الحالية. قم بحل حالة الحساب في بوابة الويب الخاصة بـ Zoom.</td></tr><tr><td>403</td><td>تم رفض الطلب بسبب أذونات غير كافية: "مستخدم:Edit".</td><td>بيانات الاعتماد خلف اتصال SCIM تفتقر إلى النطاق المطلوب. أعد تفويض الاتصال باستخدام حساب المالك أو حساب مسؤول.</td></tr><tr><td>404</td><td>المستخدم غير موجود.</td><td>لم يربط موفر الهوية المستخدم بمستخدم Zoom موجود. تحقق من سمة المطابقة وصيغة اسم المستخدم.</td></tr><tr><td>409</td><td>نطاق البريد إلكتروني لا يطابق النطاق المرتبط بالحساب.</td><td>نطاق البريد إلكتروني الخاص بالمستخدم غير مرتبط بحساب Zoom. اربط النطاق وتحقق منه قبل توفير المستخدم.</td></tr><tr><td>409</td><td>لا يمكن إضافة المستخدمين المدفوعين.</td><td>لا توجد رخصة من النوع المطلوب متاح. السعة المجانية على الحساب، أو قم بتوفير المستخدم كـ Basic.</td></tr><tr><td>409</td><td>لا يمكن إنشاء المزيد من المستخدمين باستخدام [bundle name].</td><td>لا توجد مقاعد متبقية في الحزمة المحددة. ينطبق ذلك على Workplace Business Plus، وخطة Enterprise Premier، وخطة اشتراك Pro Plus، وما يعادلها في قطاع التعليم.</td></tr><tr><td>429</td><td>طلبات كثيرة جدًا.</td><td>تجاوز التزويد حدود المعدل الخاصة بـ Zoom. تحقّق مما إذا كان ذلك يستمر عبر الدورات.</td></tr></tbody></table>

#### <mark style="color:أزرق;">أحد أوضاع الفشل لا يُنتج أي خطأ على الإطلاق</mark>

قد تكون هناك قيمة يقبلها Zoom لكنها لا تقابل أي شيء — مثل اسم موقع مع مسافة زائدة في النهاية، أو اسم دور تمت إعادة تسميته لاحقًا في Zoom — وقد تُقبل نحويًا ولا تُطبَّق على أي شيء. لا توجد أي إدخالة في السجل تشير إلى هذا الحدث. تُغطَّى المتغيرات الخاصة بمنصة نفسها لهذه المشكلة في الخطوة 6.

{% hint style="info" %}
**ملاحظة**

عندما يختلف Zoom ومزوّد الهوية بشأن إعدادات مستخدم، فاعتبر مزوّد الهوية هو الجهة المرجعية وصحّح القيمة هناك. يؤدي التحرير مباشرةً في بوابة Zoom على الويب إلى حالة تقوم فيها فعالية التزويد التالية بالكتابة فوقها، مما يجعل المشكلة الأساسية أصعب في التشخيص.
{% endhint %}

## **تكوين SCIM باستخدام Entra ID**

#### <mark style="color:أزرق;">متطلبات إضافية لـ Entra ID</mark>

* صلاحيات مسؤول Entra ID مع إمكانية الوصول إلى تطبيقات خطة Enterprise
* نطاق البريد إلكتروني الذي يستخدمه مستخدموك والمتحقق منه كنطاق مخصص في مستأجر Entra ID

#### <mark style="color:أزرق;">قيود إضافية في Entra ID</mark>

* تستمد تعيينات السمات قيمها حصريًا من سمات كائن *المستخدم* في Entra. لا يمكن لمجموعات الأمان توفير قيمة لسمات Zoom مباشرةً؛ إذ تتحكم عضوية المجموعة في النطاق، لا في القيمة.
* تعمل دورات التزويد التدريجي تقريبًا كل 40 دقيقة. لا تكون التغييرات فورية بمجرد تمكين التزويد.
* قيمة `Collaboration` لـ `userType` غير مدعوم مع Entra ID بسبب قيد خاص بـMicrosoft.

{% hint style="info" %}
**ملاحظة**

يمكن إجراء إعداد التوفير القياسي من أيٍّ من `entra.microsoft.com` أو `portal.azure.com`. ومع ذلك، لا يمكن الوصول إلى محرر المخطط المستخدم في الخطوة 1 إلا عبر عنوان URL لمدخل Azure مع إلحاق المعلمة `forceSchemaEditorEnabled` . وليس لهذا الخيار أي تأثير على `entra.microsoft.com`. استخدم رابط مدخل Azure في الخطوة 1 لجميع الخطوات في هذا الجزء لتجنب التبديل بين المدخلين أثناء الإعداد.
{% endhint %}

### الخطوة 1: صرّح بالسمة في مخطط تطبيق Zoom

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

1. سجّل الدخول إلى مدخل Azure باستخدام عنوان URL لمحرر المخطط: `https://portal.azure.com/?Microsoft_AAD_Connect_Provisioning_forceSchemaEditorEnabled=true#home`
2. ضمن **خدمات Azure**، يحدد **Microsoft Entra ID**.
3. في قائمة التنقل اليمنى، ضمن **إدارة**، انقر **تطبيقات خطة Enterprise**.
4. في قائمة التطبيقات، انقر على تطبيق Zoom الخاص بك.\
   **ملاحظة**: يحدد مسؤول Entra اسم التطبيق عند إنشائه. وغالبًا ما يكون اسمه **Zoom** أو **Zoom SSO**، لكن قد يختلف ذلك في مستأجرك.
5. في قائمة التنقل اليمنى، ضمن **إدارة**، انقر على **توفير الموارد**.\
   **ملاحظة**: تعرض Azure حاليًا أحد تخطيطين. في التجربة القديمة، يحدد **تعديل تعيينات السمات** ضمن **إدارة التوفير**. في التجربة الأحدث، تُفتح الصفحة على علامة تبويب **نظرة عامة** ؛ يحدد **توفير الموارد** مرة أخرى من القائمة على الجانب الأيسر. يؤدي كلا المسارين إلى الوجهة نفسها.
6. انقر على **التعيينات** في القائمة المنسدلة، ثم انقر على **توفير مستخدمي Microsoft Entra ID**.\
   **ملاحظة**: في المستأجرين الذين لا يزالون يعرضون التسميات القديمة، يظهر هذا الخيار باسم **توفير مستخدمي دليل Azure نشط**.
7. في الزاوية السفلية اليسرى، يحدد المستخدم خيار **عرض الخيارات المتقدمة** باستخدام مربع الاختيار.
8. انقر **تعديل قائمة السمات في Zoom**.
9. مرِّر إلى الصف الفارغ الأول وأكمل ما يلي:
   * **الاسم**: أدخل سلسلة السمات كاملةً، على سبيل المثال `urn:ietf:params:scim:schemas:extension:zoom:1.0:مستخدم:zoomPhoneSite`
   * **النوع**: يحدد **سلسلة نصية** أو **قيمة منطقية**، بما يتوافق مع نوع البيانات الموثّق في مرجع واجهة برمجة التطبيقات SCIM2.
10. كرر الخطوة 9 لكل سمة إضافية.
11. في الزاوية العلوية اليسرى، انقر على **حفظ**.

{% hint style="warning" %}
**تنبيه**

أسماء السمات حساسة لحالة الأحرف، ويجب أن تطابق مرجع واجهة برمجة التطبيقات تمامًا. `zoomPhoneSite` صالح؛ `zoomphonesite` و `ZoomPhoneSite` ليست كذلك. يقبل محرر المخطط سمةً كُتبت حالة أحرفها بشكل غير صحيح دون إظهار خطأ، وتفشل بصمت لدى Zoom API.

بالنسبة إلى السمات الموثّق نوعها على أنه `boolean`, **نص** يكون صالحًا أيضًا، بشرط أن يوفّر المصدر المعين النص الحرفي `true` أو `false`. ويُعد اختيار **نص** أكثر عمليةً غالبًا عندما يكون المصدر سمة امتداد في Entra، إذ تخزّن نصًا.
{% endhint %}

### الخطوة 2: اربط مصدر الدليل بالسمة

يوفر Entra ID ثلاثة أنواع من التعيين، ويُعد الاختيار بينها القرار الأكثر تأثيرًا في التهيئة.

<table><thead><tr><th width="133.376708984375">نوع التعيين</th><th>يُستخدم عندما</th><th>السلوك</th></tr></thead><tbody><tr><td><strong>مباشر</strong></td><td>يحتوي حقل Entra بالفعل على القيمة الدقيقة التي يتوقعها Zoom.</td><td>يمرر قيمة المصدر كما هي دون تغيير.</td></tr><tr><td><strong>ثابت</strong></td><td>يجب أن يتلقى كل مستخدم ضمن النطاق القيمة نفسها.</td><td>يرسل قيمة ثابتة إلى كل مستخدم تم توفيره.</td></tr><tr><td><strong>تعبير</strong></td><td>يجب أن تكون القيمة مشتقة أو مترجمة أو متغيرة حسب سمة المستخدم.</td><td>يقيّم تعبيرًا مقابل الحقول المصدر ويرسل النتيجة.</td></tr></tbody></table>

**لإنشاء التعيين:**

1. العودة إلى **توفير الموارد** → **عمليات التعيين** → **توفير مستخدمي Microsoft Entra ID**.
2. في الزاوية السفلية اليسرى، انقر على **إضافة تعيين جديد**.
3. كوَّن التعيين وفقًا للنوع المحدد — انظر الإرشادات أدناه.
4. انقر على **السمة الهدف** القائمة المنسدلة وحدد السمة المذكورة في الخطوة 1.
5. انقر على **طابِق الكائنات باستخدام هذه السمة** القائمة المنسدلة ويحدد **لا**.\
   **ملاحظة**: سمات Zoom المخصّصة هي قيم إعداد، وليست مفاتيح لمطابقة الهويات. السمة الوحيدة التي تربط مستخدمي Entra بمستخدمي Zoom — وتكون عادةً `اسم المستخدم` — يجب ضبطه على **نعم**.
6. انقر على **طبّق هذا التعيين** قائمة منسدلة ويحدد **دائمًا**، لذا تُطبَّق القيمة عند الإنشاء والتحديثات اللاحقة معًا.
7. انقر على **موافق**.
8. كرّر ذلك لكل سمة، ثم انقر على **حفظ** في أعلى صفحة **تعيين السمات** .

#### <mark style="color:أزرق;">يمرر التعيين المباشر حقلاً موجودًا كما هو دون تحويل</mark>

* **نوع التعيين**: **مباشر**
* **سمة المصدر**: حقل في Entra تتطابق قيمته مسبقًا مع ما يتوقعه Zoom حرفيًا
* **القيمة الافتراضية إذا كانت القيمة فارغة (اختياري)**: قيمة احتياطية تُطبَّق عندما يكون حقل المصدر فارغًا

يُعدّ التعيين المباشر الخيار الأقل عرضةً للأعطال، وينبغي تفضيله كلما أتاحت بيانات الدليل ذلك. إذا كان `physicalDeliveryOfficeName` — معروضًا باسم **موقع المكتب** في ملف تعريف مستخدم Entra — يحتوي بالفعل على قيم تطابق أسماء مواقع Zoom Phone تمامًا، لذا لا يتطلب ربطه مباشرةً أي منطق على الإطلاق.

{% hint style="info" icon="lightbulb" %}
**نصيحة**

املأ **القيمة الافتراضية إذا كانت null** كلما كانت قيمة المصدر المفقودة ستؤدي إلى فشل أو نتيجة غير مقصودة. تكون القيمة الافتراضية هي `الموقع الرئيسي` يضمن تعيين الموقع أن يتم إعداد المستخدمين الذين ليس لديهم موقع مكتب بنجاح، بدلًا من أن ينتهي بهم الأمر في حالة غير محددة.
{% endhint %}

#### <mark style="color:أزرق;">يطبّق التعيين الثابت قيمة واحدة على كامل المجموعة المشمولة</mark>

* **نوع التعيين**: **ثابت**
* **قيمة ثابتة**: القيمة الثابتة المطلوب إرسالها

يناسب التعيين الثابت عمليات النشر ذات الإعداد الواحد، كما أنه الآلية وراء عدة سلوكيات خاصة بـ Zoom. يؤدي ضبط `zoomPhoneExtNumber` على قيمة ثابتة قدرها `0` إلى توجيه Zoom لتعيين الامتداد التالي المتاح ضمن موقع المستخدم، ما يلغي تعارضات الامتدادات تمامًا.

#### <mark style="color:أزرق;">يترجم تعيين التعبير قيمةً أو يستخلصها في وقت التزويد</mark>

* **نوع التعيين**: **التعبير**
* **التعبير**: عبارة متداخلة من `IIF()` تقيّم سمة مصدر واحدة أو أكثر

يلزم تعيين التعبير كلما لم تكن قيمة الدليل وقيمة Zoom السلسلة النصية نفسها:

```
IIF([officeLocation]="London","LON-01",
IIF([officeLocation]="Manchester","MAN-01",
"الموقع الرئيسي"))
```

{% hint style="danger" %}
**تحذير**

تقارن التعبيرات النصوص تمامًا كما كُتبت، بما في ذلك حالة الأحرف. `GB` و `gb` قيمتان مختلفتان، وكذلك `United Kingdom` و `united kingdom`. لا يؤدي فشل المقارنة إلى ظهور خطأ؛ بل ينتقل التنفيذ إلى الفرع الافتراضي، ويُجهَّز المستخدم بإعدادات غير صحيحة دون أي تنبيه.
{% endhint %}

أحط قيم المصدر بـ `ToUpper()` وقارن بالقيم الحرفية المكتوبة بأحرف كبيرة لتوحيد اختلاف حالة الأحرف:

```
IIF(ToUpper([country])="GB","202",
IIF(ToUpper([country])="UNITED KINGDOM","202",
"-1"))
```

#### <mark style="color:أزرق;">تختلف صيغة الحقل المصدر بحسب كيفية إنشاء مستخدم Entra</mark>

هذا هو السبب الأكثر شيوعًا لتعيينات التعبير التي تبدو صحيحة ولكنها تتصرف بصورة غير متسقة عبر مجموعة من المستخدمين.

* **موقع الاستخدام** تفرض Microsoft أن يحتوي دائمًا على رمز صالح وفق معيار ISO 3166-1 alpha-2، مثل `GB`، لأنه يتحكم في توفر التراخيص والميزات. هذا الحقل موثوق.
* **البلد أو المنطقة** لا يخضع لأي متطلبات مماثلة، وتعتمد قيمه على طريقة الإنشاء. يحدد المستخدمون الذين أُنشئت حساباتهم عبر واجهة المستخدم الرسومية لبوابة مسؤول Entra اسمًا كاملًا للبلد من قائمة منسدلة، لذا يخزّن الحقل عادةً القيمة `United Kingdom`، بينما تُملأ عادةً حسابات المستخدمين التي أُنشئت عبر استيراد CSV أو PowerShell بالقيمة `GB` — حسب العُرف، لا بفرضٍ رسمي.

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

### الخطوة 3: إدخال المستخدمين والمجموعات ضمن نطاق التوفير

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

1. انتقل إلى **Microsoft Entra ID** → **تطبيقات خطة Enterprise** → تطبيق Zoom الخاص بك → **المستخدمون والمجموعات**.
2. انقر على **إضافة مستخدم/مجموعة**.
3. ضمن **المستخدمون والمجموعات**، يحدد المستخدم أو مجموعة الأمان المطلوبة.
4. ضمن **حدد دورًا**، اختر الدور المناسب.
5. انقر على **يعيّن**.

عمليًا، لا تهم سوى قيمتين للدور. أما الخيارات الأخرى مثل **شركة** و **خطة اشتراك Pro** إما تسميات قديمة يجري التخلص منها تدريجيًا، أو مخصصة لحالات استخدام غير شائعة.

<table><thead><tr><th width="157.5225830078125">الدور</th><th>تأثير</th></tr></thead><tbody><tr><td><strong>أساسي</strong></td><td>يُوفّر المستخدم بدون ترخيص اجتماع مدفوع. يحدد هذا عندمًا تكون سمة مخصصة — مثل خطة الاتصال في Zoom Phone — مسؤولة عن تعيين الاستحقاق المدفوع.</td></tr><tr><td><strong>مرخَّص</strong></td><td>يُعيّن حساب Zoom الخاص بـ <em>افتراضي</em> خطة الترخيص، مثل Zoom Workplace خطة Enterprise Plus. لا تتيح هذه الشاشة اختيار حزمة محددة؛ إذ يتم تكوين الافتراضي من جانب Zoom.</td></tr></tbody></table>

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

**لتهيئة مجموعات Entra كمجموعات Zoom**، وهو مُعطَّل افتراضيًا:

1. انتقل إلى **التوفير** → **عمليات التعيين** وحدد **توفير مجموعات Microsoft Entra ID**.
2. تبديل **ممكّن** إلى **نعم**.
3. تأكد من وجود التعيينات الافتراضية: `displayName` → `displayName`، و `members` → `members`.
4. انقر على **حفظ**.
5. ارجع إلى **المستخدمون والمجموعات** وتأكد من تعيين المجموعة نفسها إلى التطبيق، وليس أعضائها كلٌّ على حدة فقط. لا تعالج عملية توفير المجموعات إلا المجموعات المعيّنة مباشرةً.

{% hint style="warning" %}
**تنبيه: ما الذي يفعله SCIM وما لا يفعله مع المجموعات**

إذا لم تكن هناك مجموعة في Zoom تحمل اسمًا مطابقًا، فسينشئ SCIM مجموعة باستخدام قيمة displayName لمجموعة Entra `displayName` تمامًا كما كُتب. تُنشأ المجموعة بأعضائها، لكن **من دون أي إعداد للمنتجات**. ولا يزال على المسؤول فتح [**مركز المسؤول**](https://zoom.com/account) → **المستخدمون** → [**المجموعات**](https://zoom.com/account/group#/) في بوابة Zoom على الويب وتطبيق الإعدادات المطلوبة — مثل سياسات Zoom Phone على مستوى المجموعة، أو أذونات الاتصال، أو إعدادات المنتجات الأخرى. يوفّر SCIM المجموعة وعضويتها؛ لكنه لا يحدد وظيفة تلك المجموعة داخل Zoom.
{% endhint %}

### الخطوة 4: التحقق باستخدام التزويد عند الطلب

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

1. انتقل إلى **التوفير** → **نظرة عامة على التوفير**.
2. انقر على **التوفير عند الطلب**.
3. ابحث عن مستخدم اختباري واحد وحدده، ثم انقر على **توفير**.
4. راجع النتيجة. يعرض Entra المراحل الأربع التي ينفذها لكل فعالية توفير — **استيراد**, **تحديد ما إذا كان ضمن النطاق**, **مطابقة**، و **توفير** — ويمكن توسيع كل مرحلة على حدة.
5. تأكد من أن قيم السمات المعروضة تطابق ما تقصده.
6. تسجيل الدخول إلى بوابة الويب الخاصة بـ Zoom وتأكد من تطبيق التكوين.

{% hint style="info" %}
**توصية**

تحقق باستخدام مستخدم يمثل الحالة *الأصعب* ضمن مجموعتك — مستخدمًا في الخارج، أو أُنشئ بطريقة مختلفة، أو حقل المصدر لديه فارغ. لن يكشف اختبار يغطي الحالة المباشرة فقط عن أنماط الإخفاق الموضحة في الخطوة 2.
{% endhint %}

### الخطوة 5: تمكين التزويد المستمر

يؤدي تمكين التزويد إلى تفعيل التكوين فعليًا لكل مستخدم ضمن النطاق. أكمل الخطوات من 1 إلى 4 وتحقق منها أولًا.

1. انتقل إلى **Microsoft Entra ID** → **تطبيقات المؤسسات** → تطبيق Zoom الخاص بك → **توفير المستخدمين** → **توفير المستخدمين**.
2. تبديل **حالة توفير المستخدمين** إلى **تشغيل**.
3. انقر على **حفظ**.

قد تستغرق الدورة الأولى ما يصل إلى 40 دقيقة تقريبًا. وتعمل الدورات التزايدية اللاحقة على فواصل تقارب 40 دقيقة. تتم مزامنة المنضمين الجدد وتغييرات السمات وإلغاء التنشيط وفقًا لذلك الجدول، وليس فورًا.

### الخطوة 6: التحقق باستخدام سجلات تزويد Entra

1. انتقل إلى **Microsoft Entra ID** → **تطبيقات خطة Enterprise** → تطبيق Zoom الخاص بك → **مراقبة** → **سجلات التوفير**.
2. ابحث عن مستخدم الاختبار أو صفِّ النتائج للعثور عليه، ثم يحدد الفعالية ذات الصلة. يُفتح عرض التفاصيل بأربعة ألسنة: **الخطوات**, **استكشاف الأخطاء وإصلاحها والتوصيات**, **الخصائص المعدّلة**، و **الملخّص**.
3. راجع **الملخّص** للتأكد مما إذا كان الإجراء قد نجح أم فشل.
4. إذا فشل، فافتح **استكشاف الأخطاء وإصلاحها والتوصيات**، الذي يعرض الإجراء الذي جرت محاولته، واسم المستخدم الأساسي المتأثر، و— ضمن **التفاصيل** — رمز الخطأ ورسالة الخطأ الكاملة التي تُرجعها واجهة برمجة التطبيقات من Zoom.

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

#### <mark style="color:أزرق;">سلوك الانضمام والمغادرة في Entra ID</mark>

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

### الخطوة 7: تطبيق السيناريوهات المرجعية في Entra ID

ترد السيناريوهات والمتطلبات المسبقة وتعريفات السمات في [**السيناريوهات المرجعية**](#reference-scenarios) القسم. تُعرض هنا تعيينات Entra فقط.

**السيناريو 0 — القسم.** في الخطوة 1، أعلِن `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department` باسم **سلسلة نصية**، مع الحرص على استخدام مساحة أسماء المؤسسة بدلاً من مساحة Zoom. عيّنها على النحو التالي: **مباشر** من حقل Entra `department` حقل. لا **القيمة الافتراضية عند null** مطلوبة — فحقل المصدر الفارغ لا يرسل شيئًا، ولا يلزم وجود كائن على جانب Zoom.

**السيناريو 1 — موقع Zoom Phone ورقم داخلي تلقائي.** عيّن `zoomPhoneSite` كـ **مباشر** من `physicalDeliveryOfficeName`، مع **القيمة الافتراضية إذا كانت فارغة** مضبوطة على `Main موقع`. خريطة `zoomPhoneExtNumber` كـ **ثابت** بقيمة `0` إلا إذا كنت تُرحّل إعدادات امتدادات موجودة مسبقًا. عندما لا تتطابق قيم مواقع المكاتب تمامًا مع أسماء مواقع Zoom، استبدلها بـ **تعبير** تعيين بالشكل الموضح في الخطوة 2.

**السيناريو 2 — تختلف خطة الاتصال حسب البلد.** نظرًا إلى أن Entra لا يمكنه استمداد قيمة من مجموعة، يلزم استخدام تعبير. وسّعه بإضافة `IIF()` طبقات لكل بلد، مع مراعاة صيغتي alpha-2 والنص الكامل كما هو موضح في الخطوة 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` مع **تعبير** يستند إلى حقل في الدليل يميّز مستويات الوكلاء، و `zoomContactCenterRole` بصفته **مباشر** من حقل يحتوي على اسم الدور. مغادرة `zoomContactCenterRegion` دون تعيين في عمليات النشر ذات المنطقة الواحدة.

## **تهيئة SCIM باستخدام Okta**

#### <mark style="color:أزرق;">متطلبات إضافية لـ Okta</mark>

* صلاحيات مسؤول Okta مع الوصول إلى محرر الملف الشخصي

#### <mark style="color:أزرق;">قيود إضافية في Okta</mark>

* عندما ينتمي مستخدم إلى عدة مجموعات تقدم قيماً متعارضة للسمة نفسها، لا تُرسَل إلا قيمة المجموعة ذات الأولوية الأعلى. راجع الخطوة 5.

{% hint style="warning" %}
**تنبيه: ملفان شخصيان، غرضان**

تحتفظ Okta بملفَّي تعريف منفصلين مهمَّين هنا، ويساعد فهم هذا الفصل على تجنّب معظم الالتباس الأولي. الـ **ملف تعريف مستخدم Okta** هو الموضع الذي تكون فيه القيمة *مخزّنة* لشخص في الدليل. أما **ملف تعريف تطبيق مستخدم Zoom** هو الموضع الذي تكون فيه القيمة *مُرسَل* إلى Zoom، وتحمل سماته الاسم الخارجي ومساحة الاسم الخاصين بـ SCIM. تتطلب تهيئة كل مستخدم كليهما، بالإضافة إلى تعيين يحقق اتصالاً بينهما. أما التهيئة على مستوى المجموعة فتتطلب سمة ملف تعريف التطبيق فقط، مع تعيين القيمة عند إسناد المجموعة.
{% endhint %}

### الخطوة 1: أعلن السمة على ملف مستخدم تطبيق Zoom

هذه هي السمة التي تنقل قيمة فعليًا إلى Zoom. إعلانها إجراء لمرة واحدة لكل سمة.

1. تسجيل الدخول إلى وحدة تحكم المسؤول في Okta.
2. في قائمة التنقل اليسرى، انقر على **التطبيقات**، ثم انقر على **التطبيقات**.
3. ضمن **الحالة**، انقر على **نشط**.
4. انقر على **Zoom** التطبيق.\
   **ملاحظة**: يحدد مسؤول Okta اسم التطبيق عند إنشائه. وغالبًا ما يكون اسمه **Zoom**، لكنه قد يختلف في المستأجر لديك.
5. انقر على **توفير الموارد** علامة التبويب.
6. ضمن **تعيينات سمات Zoom**، انقر على **الانتقال إلى محرر الملف الشخصي**.
7. ضمن **السمات**، انقر على **+ إضافة سمة**.
8. أكمل ما يلي:
   * **نوع البيانات**: يحدد **string** أو **boolean**، بما يتوافق مع مرجع واجهة برمجة التطبيقات SCIM2.
   * **اسم العرض**: يدخل اسم السمة، على سبيل المثال `zoomPhoneSite`.
   * **اسم المتغير**: يدخل الاسم نفسه.
   * **الاسم الخارجي**: أدخل اسم السمة تمامًا كما هو موثّق من Zoom، على سبيل المثال `zoomPhoneSite`.
   * **مساحة أسماء خارجية**: يدخل `urn:ietf:params:scim:schemas:extension:zoom:1.0:User: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.
   * **اسم العرض** و **اسم المتغير**: أدخل اسمًا، مثل `zoomPhoneSite`.
   * **تعداد** (اختياري): يحدد **تعريف قائمة محددة من القيم** حيث لا تقبل سمة Zoom إلا مجموعة ثابتة من القيم.
   * **السمة مطلوبة** (اختياري): يحدد **نعم** حيث يجب أن تكون لكل مستخدم ضمن النطاق قيمة.
7. انقر على **حفظ**.

{% hint style="info" icon="lightbulb" %}
**نصيحة**

استخدم الاسم نفسه لسمة ملف تعريف مستخدم Okta ولسمة ملف تعريف تطبيق Zoom. لا يتطلب Okta ذلك، لكن تطابق الأسماء يجعل قائمة التعيين موثقة ذاتيًا ويقلل بشكل ملموس وقت استكشاف الأخطاء وإصلاحها مع ازدياد عدد السمات.
{% endhint %}

استخدم **تعداد** الخيار أينما توثّق Zoom مجموعة قيم ثابتة — مثل باقات مركز الاتصال ورموز باقات Workplace وقيم خطط Revenue Accelerator. إن تقييد الحقل عند إدخال القيمة يمنع خطأً مطبعيًا من التسبب في فشل صامت في إعداد الخدمة، لا يظهر إلا بعد أسابيع على هيئة استحقاق مفقود.

### الخطوة 3: اربط السمة المصدر بسمة Zoom

1. انتقل إلى **التطبيقات** → **التطبيقات** → **نشط** → **Zoom** تطبيق.
2. انقر على **توفير الموارد** علامة التبويب.
3. ضمن **تعيينات سمات Zoom**، اعثر على السمة التي أعلنت عنها في الخطوة 1، وانقر على رمز التعديل إلى يمينها.\
   **ملاحظة**: إذا لم تكن السمة ظاهرة، فانقر على **عرض السمات غير المعينة**.
4. انقر على القائمة المنسدلة **قيمة السمة** وحدد **التعيين من ملف تعريف Okta**.
5. انقر على القائمة المنسدلة للمصدر — التي تعرض `login | string` افتراضيًا — وحدد سمة ملف تعريف مستخدم Okta التي أنشأتها في الخطوة 2.
6. حدد **إنشاء وتحديث**.\
   **ملاحظة**: **إنشاء فقط** يطبّق القيمة عند إعداد مستخدم Zoom لأول مرة، ولا يطبقها مجددًا مطلقًا. حدده عمدًا للقيم التي ينبغي عدم استبدالها بعد التعيين الأولي؛ وحدد **إنشاء وتحديث** في جميع الحالات الأخرى كي تنتقل تغييرات الدليل.
7. انقر على **حفظ**.
8. كرر ذلك لكل سمة.

{% hint style="warning" %}
**تنبيه: اشتقاق قيمة أو ترجمتها**

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

عندما تكون الترجمة بسيطة ومجموعة القيم صغيرة، فإن تعريف قيمة Zoom مباشرةً في سمة Okta كقائمة مُعدّدة — أو استخدام سمة على مستوى المجموعة، كما في الخطوة 5 — يكون عادةً أكثر قابلية للصيانة من التعبير.
{% endhint %}

### الخطوة 4: تمكين التزويد إلى تطبيق

لا يكون لتعيينات السمات أي تأثير حتى يتم تمكين عمليات التزويد المقابلة. قم بتمكينها قبل تعيين القيم في الخطوة 5.

1. انتقل إلى **التطبيقات** → **التطبيقات** → **نشط** → **Zoom** تطبيق.
2. انقر على **توفير الموارد** علامة التبويب.
3. ضمن **الإعداد لتطبيق**، انقر على **تعديل**.
4. مكّن الإعدادات الموضحة أدناه، ثم انقر على **حفظ**.

| الإعداد                    | تأثير                                                                                                                                       |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| **إنشاء مستخدمين**         | ينشئ أو يربط مستخدمًا في Zoom عندما يعيّن التطبيق لمستخدم في Okta.                                                                          |
| **تحديث سمات المستخدم**    | يحدّث سمات مستخدم في Zoom عندما يعيّن التطبيق. تستبدل التغييرات اللاحقة في ملف تعريف مستخدم Okta تلقائيًا القيمة المقابلة في Zoom.          |
| **إلغاء تنشيط المستخدمين** | يعطّل حساب Zoom عندما لا يعيّن التطبيق في Okta، أو عندما يتم إلغاء تنشيط حساب Okta. ويمكن إعادة تنشيط الحسابات من خلال إعادة تعيين التطبيق. |

{% hint style="danger" %}
**تحذير**

**تحديث سمات المستخدم** هو ما يفعّل تعيينات السمات المخصصة للمستخدمين الحاليين. ومن دونه، لا تُطبَّق التعيينات إلا عند إنشاء المستخدم، ولن يصل إلى Zoom أي تغيير لاحق في Okta.
{% endhint %}

### الخطوة 5: يعيّن القيم للمستخدمين أو المجموعات

**لتعيين قيمة لمستخدم فردي:**

1. انتقل إلى **الدليل** → **الأشخاص** وانقر على اسم المستخدم.
2. انقر على علامة تبويب **الملف الشخصي** ، ثم انقر على **تعديل**.
3. املأ السمة التي أُنشئت في الخطوة 2 بالقيمة التي يتوقعها Zoom.
4. انقر على **حفظ**.

تُنقَل القيمة على الفور. أكّد النتيجة في بوابة Zoom على الويب قبل تطبيق التغيير نفسه على نطاق أوسع.

**لتعيين قيمة لمجموعة** — النمط الأكثر قابلية للتوسع، حيث يتبع التكوين البنية التنظيمية:

1. تأكد من التصريح بالسمة في الخطوة 1 باستخدام **نوع السمة: مجموعة**. إذا تم التصريح بها على أنها **شخصية**، فصرّح بسمة مكافئة على مستوى المجموعة بتكرار الخطوة 1 ضمن ملف **مستخدم Zoom** في **الدليل** → **محرر الملف الشخصي** → **المستخدمون** → **الكل**، مع اختيار **مجموعة** كنوع للسمة.
2. انتقل إلى **الدليل** → **المجموعات** → علامة التبويب **الكل** ، ثم انقر على **إضافة مجموعة**.
3. أدخل **اسمًا** و **وصفًا**اختياريًا، ثم انقر على **حفظ**.
4. افتح المجموعة وانقر على علامة التبويب **التطبيقات** .
5. انقر على **تعيين تطبيق**، ثم انقر على **تعيين** على يسار تطبيق **Zoom** .
6. املأ السمات على مستوى مجموعة بالقيم التي ينبغي أن تنطبق على كل عضو.
7. انقر على **حفظ والعودة**، ثم انقر على **تم**.
8. انقر على علامة التبويب **الأشخاص** للمجموعة، ثم انقر على **تعيين أشخاص**.
9. ابحث عن المستخدمين بالاسم الأول أو عنوان البريد الإلكتروني الأساسي أو اسم المستخدم، وانقر على زر إضافة بجانب كل منهم.
10. انقر على **تم**.

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

#### <mark style="color:أزرق;">تحل أولوية مجموعة تعارض القيم عندما ينتمي مستخدم إلى عدة مجموعات</mark>

عندما يكون مستخدم عضوًا في أكثر من مجموعة توفر قيمة للسمة نفسها، يرسل Okta القيمة من مجموعة ذات الأولوية الأعلى.

1. انتقل إلى **التطبيقات** → **التطبيقات** → **نشط** → **Zoom** تطبيق.
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 %}

#### <mark style="color:أزرق;">سلوك الإعداد وإلغاء الإعداد في Okta</mark>

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

### الخطوة 7: تطبيق السيناريوهات المرجعية في Okta

ترد السيناريوهات والمتطلبات الأساسية وتعريفات السمات في قسم [**السيناريوهات المرجعية**](#reference-scenarios) . يقتصر ما يلي على إعداد Okta.

**السيناريو 0 — القسم.** في الخطوة 1، عرّف السمة باستخدام **اسم العرض** و **اسم المتغير** `department`, **الاسم الخارجي** `department`، و **مساحة أسماء خارجية** `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User`. استخدم **نوع السمة: شخصي**. يتضمن ملف تعريف المستخدم الأساسي في Okta بالفعل `department` سمة، لذا يمكن تخطي الخطوة 2 — اربط مباشرةً منها في الخطوة 3، مع تحديد **إنشاء وتحديث**.

{% hint style="warning" %}
**تنبيه: تنسيق مساحة الاسم لخصائص امتداد المؤسسة**

يوضح التحذير في الخطوة 1 اصطلاح Zoom المتمثل في إلحاق اسم السمة بمساحة الأسماء الخارجية. وقد وُثّق هذا الإرشاد للسمات ضمن امتداد Zoom. `department` ينتمي إلى امتداد SCIM المؤسسي القياسي، حيث يتمثل السلوك المعتاد في Okta في الاحتفاظ بمساحة الأسماء والاسم الخارجي في حقلين منفصلين، كما هو موضح أعلاه. إذا لم تصل القيمة إلى Zoom، فجرّب الصيغة المُلحقة — `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department` — وتحقّق من النموذج الذي نجح في سجل مكالمات سوق التطبيق.
{% endhint %}

**البدائل إذا `department` تم تعيينه بالفعل.** تتصرف أيٌّ من العناصر التالية بالطريقة نفسها، وتقع تحت العنصر الأب نفسه، ولا تتطلب شروطًا مسبقة — استبدل اسم السمة في كليهما **الاسم الخارجي** ومساحة الاسم، وأضف سمة مصدر مطابقة في الخطوة 2 إذا لم يتضمن ملف تعريف Okta واحدة بالفعل:

| السمة            | ملاحظات                                                                                                                                                                           |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `costCenter`     | حقل أعمال، يختلف بين كل مستخدم وآخر، لذا تكون القيمة الخاطئة مرئية                                                                                                                |
| `مؤسسة`          | غالبًا ما يكون مطابقًا لدى كل مستخدم، مما يجعل اكتشاف الخطأ أصعب                                                                                                                  |
| `employeeNumber` | غالبًا ما يكون مُعيَّنًا بالفعل كحقل هوية — تحقّق قبل التصريح به                                                                                                                  |
| `pronouns`       | تندرج ضمن امتداد **Zoom** بدلاً من امتداد المؤسسة، لذا فهي تستخدم مساحة الاسم نفسها المستخدمة في كل السيناريوهات الأخرى في هذا الدليل، وتتجنب مسألة التنسيق المذكورة أعلاه تمامًا |

**السيناريو 1 — موقع Zoom Phone ورقم التحويلة التلقائي.** عرّف `zoomPhoneSite` مع **نوع السمة: مجموعة** وعيّن قيمتها في مجموعة Okta الخاصة بكل موقع، بحيث تحدد عضوية المجموعة الموقع مباشرةً دون الحاجة إلى منطق تحويل. عرّف `zoomPhoneExtNumber` كسمة شخصية بقيمة افتراضية `0` إلا إذا كنت تنقل إعدادًا موجودًا مسبقًا لأرقام التحويلات.

**السيناريو 2 — خطة اتصال تختلف حسب البلد.** عرّف `zoomPhoneCallingPlan` مع **نوع السمة: مجموعة** وأنشئ مجموعة واحدة لكل منطقة من مناطق خطط الاتصال، مع تعيين قيمة الخطة في تعيين تطبيق Zoom لكل مجموعة. يرث المستخدمون الخطة الصحيحة من خلال عضويتهم، وتكون القيمة المخزنة في Okta هي القيمة الدقيقة التي يتوقعها Zoom. كما يجعل ذلك الإعداد مرئيًا وقابلاً للتدقيق من **التعيينات** في علامة تبويب، ويضمن استمراره رغم أي اختلافات في طريقة تعبئة بيانات الدليل الأساسية. وتوفر المجموعة التي تحمل `-1` طريقة واضحة لإلغاء صلاحيات الاتصال دون حذف المستخدم.

**السيناريو 3 — حزمة البرامج والدور والمنطقة لمركز الاتصال.** عرّف `zoomContactCenterPackage` كسمة تعداد تقتصر على القيم الثلاث المسموح بها، بحيث يتعذر إدخال حزمة برامج غير صالحة. عرّف `zoomContactCenterRole` كسمة على مستوى المجموعة، لأن الدور يتبع عادةً هيكل الفريق. واترك `zoomContactCenterRegion` دون تعيين في عمليات النشر ذات المنطقة الواحدة.

## استكشاف الأخطاء وإصلاحها

### الأخطاء

#### <mark style="color:أزرق;">المستخدم غير موجود أو لا ينتمي إلى هذا الحساب</mark>

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

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdXyiyMnR4S4EhYFqFUXgrePk-RwciKw8-jcxKxViZiIZ4I2kp0j1f_alWR7Hq9WuYhwz6ohh4LodWERfiXSr27LFN20r-r95xBJ6AjD7lF9k58yIJeYLpMmHR3BHYcPTMYkVwqZw?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="563"><figcaption><p>مثال على خطأ في توفير الحساب.</p></figcaption></figure></div>

#### <mark style="color:أزرق;">لا يمكنك إضافة مستخدمين مدفوعي الاشتراك</mark>

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

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdXyiyMnR4S4EhYFqFUXgrePk-RwciKw8-jcxKxViZiIZ4I2kp0j1f_alWR7Hq9WuYhwz6ohh4LodWERfiXSr27LFN20r-r95xBJ6AjD7lF9k58yIJeYLpMmHR3BHYcPTMYkVwqZw?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="563"><figcaption><p>مثال على خطأ في توفير الحساب.</p></figcaption></figure></div>

### استخدام سجلات SCIM لاستكشاف أخطاء توفير حسابات المستخدمين وإصلاحها

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

تعرض الصورة التالية مثالًا على طلب توفير حساب مستخدم عبر SCIM، مع تمييز سمات هوية المستخدم والترخيص للرجوع إليها.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcIxosFPBR8E4f1hj0vZQ7_nxnRd_isIqJYhKTQbocw4UfXlCBCkscqx8bGvY8JwuazgtRROPJm9PCZfZ4hJ5GQBqBzJA-PgS-mXkptGa0xq82SMXjl9Ip-faCDk3OQuLUXK0iobQ?key=ug1dFE_WGWGnyMfD5tJnNw" alt=""><figcaption><p>مثال على طلب توفير حساب مستخدم عبر SCIM.</p></figcaption></figure></div>

على غرار تعيين الاستجابة، لا يمكن لـ 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://library.zoom.com/technical-library/technical-library-ar/rkn-almsuwl/account-and-endpoint-management/scim-guide.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
