# تفاصيل خاصة بالمزوّد

### Microsoft Exchange Online والبيئة الهجينة

#### <mark style="color:أزرق;">ما واجهات برمجة تطبيقات Microsoft 365 التي تستخدمها للتقويم؟</mark>

يعتمد التكامل مع تقويم Zoom على Microsoft Graph واجهة برمجة التطبيقات (MGAPI). لقد بدأت Microsoft [التخلص التدريجي من أساليب Exchange Web Services (EWS)](https://techcommunity.microsoft.com/blog/exchange/retirement-of-exchange-web-services-in-exchange-online/3924440) والتي كانت متاحة سابقًا للاتصال ببيانات Microsoft 365 مع خدمات Zoom. تعتبر Zoom هذه طرق EWS خيارات قديمة.

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

تطبيقات جدولة غرفة المؤتمر لتطبيقات Zoom متاحة في دليل خطة Enterprise لتطبيقات Entra ID Application، وتم تسجيلها باستخدام معرفات التطبيق التالية، اعتمادًا على طريقة تكوين واجهة برمجة التطبيقات Graph لديك:

* a651cfda-cbdd-4a39-bd03-fa829c3c1b29 (وصول المفوّض الكامل)
* f56e91e5-5a82-452f-b435-d4d78aeaf064 (أذونات تطبيق)

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

لا حاجة إلى إضافة تطبيقات يدويًا من بوابة Entra ID. سيؤدي استخدام واجهة Zoom على الويب لطلب الموافقات على طلبات الإذن إلى إضافة تطبيق إلى المستأجر الخاص بك تلقائيًا.
{% endhint %}

<mark style="color:أزرق;">**ما الفرق بين الوصول الكامل للمفوّض وأذونات التطبيق؟**</mark>

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

الأذونات للتطبيق (المعروفة أيضًا باسم الوصول عبر التطبيق فقط) هي النهج المُوصى به من Microsoft للتطبيقات ضمن خطة Enterprise التي تعمل كخدمات في الخلفية ولا يمكن تحديد البيانات المطلوبة لمستخدم واحد.

Microsoft Graph واجهة برمجة التطبيقات مع وصول تفويضي كامل هو خيار بديل، لكنه يتطلب حساب خدمة مخصصًا ومزيدًا من الجهد للإعداد الأولي والصيانة.

تقوم المخططات التالية بعرض الطرق المفوضة والمعتمدة على تطبيق مع معلومات الاعتماد أثناء النقل.

<div align="left"><figure><img src="https://3637835738-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-12302adcdb9cba6191bdd89be5dadd380d3039d6%2Fimage.png?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>

تُعد طريقة التفويض، رغم أنها توفر التفويض، ترسل بيانات الاعتماد إلى تطبيق Zoom.

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

<div align="left"><figure><img src="https://3637835738-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-d147c0cdcfd42094c405fd0ea7960c31b60e07b0%2Fimage.png?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>

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

تطبيقات التقويم وجهة الاتصال لـ Zoom متاحة في دليل خطة Enterprise لتطبيقات Entra ID Application ويتم تسجيلها مع Application IDs التالية، اعتمادًا على طريقة تكوين Graph API لديك:

* f46ceaed-fb2d-4694-803b-6341837f0ed2 (أذونات تطبيق)
* fc108d3f-543d-4374-bbff-c7c51f651fe5 (وصول OAuth المفوض)

<mark style="color:أزرق;">**ما القيود المتعلقة بطرق التكامل مع Microsoft Graph واجهة برمجة التطبيقات؟**</mark>

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

* عدة تقاويم (يتم دعم التقويم الأساسي لـ مستخدم فقط)
* إنشاء التقويم ضمن الإعدادات الخاصة بـ التقويم لديك
* إجراء بحث داخل التقويم
* تضمين المرفقات
* اقتراح وقت جديد
* العثور على وقت
* الأوقات المقترحة

#### <mark style="color:أزرق;">ما نوع موافقة Entra ID المطلوبة؟</mark>

يمكن للمنظمات اختيار السماح لمستخدميها بالموافقة على قيام تطبيق Zoom بالوصول إلى بيانات الشركة، أو طلب إذن مسؤول لديه Global Admin permission لإجراء الموافقة أولاً نيابةً عن الشركة بأكملها. بالإضافة إلى ذلك، يمكن استخدام سياسات Entra ID User Consent للسماح للمستخدمين بالموافقة على التطبيقات التي تتطلب أذونات واجهة برمجة التطبيقات المعتبرة “low impact” دون أي إجراء من قِبل المسؤولين.

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

يحدد الخيار الأنسب لـمؤسسة الخاصة بك. تجنب الخيار لـالسماح للمستخدمين بطلب موافقة مسؤول لطلبات محددة، لأن هذا سير العمل قد لا يطبق الأذونات بشكل صحيح.

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

#### <mark style="color:أزرق;">ما أذونات واجهة برمجة التطبيقات المطلوبة؟</mark>

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

**Graph واجهة برمجة التطبيقات للتقويم الشخصي وجهات الاتصال**

| تطبيق المورد    | إذن                 | الوصف                                                     | السبب                                        |
| --------------- | ------------------- | --------------------------------------------------------- | -------------------------------------------- |
| Microsoft Graph | offline\_access     | الاحتفاظ بالوصول إلى البيانات التي منحتَه حق الوصول إليها | يتيح الوصول إلى الرموز المميزة للتحديث       |
| Microsoft Graph | openid              | تسجيل دخول المستخدمين                                     | يصادق على المستخدم ويصدر الرمز المميز للوصول |
| Microsoft Graph | Calendars.ReadWrite | وصول كامل إلى تقاويم المستخدم                             | مزامنة أحداث التقويم                         |
| Microsoft Graph | Contacts.ReadWrite  | وصول كامل إلى جهات اتصال مستخدم                           | مزامنة جهات الاتصال                          |

**واجهة برمجة التطبيقات لـ تكاملات غرفة المؤتمر**

| تطبيق المورد    | إذن                 | الوصف                                                     | السبب                                        |
| --------------- | ------------------- | --------------------------------------------------------- | -------------------------------------------- |
| Microsoft Graph | offline\_access     | الاحتفاظ بالوصول إلى البيانات التي منحتَه حق الوصول إليها | يتيح الوصول إلى الرموز المميزة للتحديث       |
| Microsoft Graph | openid              | تسجيل دخول المستخدمين                                     | يصادق على المستخدم ويصدر الرمز المميز للوصول |
| Microsoft Graph | Calendars.ReadWrite | وصول كامل إلى تقاويم المستخدم                             | مزامنة أحداث التقويم                         |
| Microsoft Graph | Place.Read.All      | اقرأ جميع مواقع الشركة                                    | اجمع قائمة الغرف                             |
| Microsoft Graph | Contacts.ReadWrite  | وصول كامل إلى جهات اتصال مستخدم                           | مزامنة جهات الاتصال                          |

### Microsoft Exchange Server

#### <mark style="color:أزرق;">ما إصدارات Exchange Server المدعومة؟</mark>

يدعم Zoom تكامل التقويم مع Exchange Server 2007 و2010 و2013 و2016 و2019.

#### <mark style="color:أزرق;">ما طرق المصادقة المتاحة لتكامل Exchange Server؟</mark>

يدعم تكامل التقويم بين Zoom وخوادم Exchange المحلية استخدام المصادقة الأساسية فقط.

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

يمكن لتطبيقات Zoom اختياريًا استخدام اتصال MAPI للتواصل مع عميل Outlook المحلي من أجل بيانات التقويم. هذه الطريقة محدودة للغاية لأنها متاحة فقط على Windows (دون دعم macOS أو الأجهزة المحمولة)، ولا تدعم بيانات جهة الاتصال، وتتطلب أيضًا تشغيل عميل Outlook. بالإضافة إلى ذلك، سيرى المستخدمون تحذير أمان من Outlook إذا بدأ Zoom Client قبل تشغيل Outlook. لمزيد من المعلومات، راجع مقالة الدعم [تكامل التقويم القائم على العميل](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0068389).