الانتقال إلى المحتوى الرئيسي
توفير SCIM متاح في خطة Enterprise. تكامل الدليل (Microsoft Graph) متاح في خطتَي Teams وEnterprise. كلاهما على مستوى المؤسسة ويُهيِّئه المسؤول.
هناك طريقتان لربط Microsoft Entra ID (المعروف سابقاً باسم Azure Active Directory) بـ Wave Connect. كلتاهما تُنشئ مستخدمي Wave Connect وتُحدّثهم من دليلك. وتختلفان في من تتم مزامنته، وكيفية إنهاء الخدمة، وما الذي يُبقي الاتصال قائماً.

أي طريقة أختار؟

توفير SCIM هو النهج الذي توصي به Microsoft لإبقاء التطبيق متزامناً مع Entra ID. اختر تكامل Graph فقط في خطة Teams أو لاستيراد لمرة واحدة.

إعداد توفير SCIM

1

إنشاء رمز SCIM في Wave Connect

انتقل إلى الإعدادات → الأمان وابحث عن بطاقة مزامنة الدليل. انقر على تكوين لفتح نافذة ضبط SCIM. انسخ نقطة نهاية SCIM (https://app.wavecnct.com/api/scim)، ثم انقر على إنشاء الرمز. أدخل اسماً للرمز وانقر على إنشاء. انسخ الرمز الآن، فهو يُعرض مرة واحدة فقط.
2

إنشاء التطبيق المؤسسي

في مركز إدارة Microsoft Entra، انتقل إلى Enterprise applications → New application → Create your own application. أدخل اسماً مثل “Wave Connect”، واختر Integrate any other application you don’t find in the gallery (Non-gallery)، ثم انقر على Create.
3

إدخال بيانات اعتماد SCIM

افتح التطبيق الجديد وانتقل إلى Provisioning → Get started. اضبط Provisioning Mode على Automatic. ضمن Admin Credentials، الصق نقطة نهاية SCIM في Tenant URL والرمز في Secret Token. انقر على Test Connection، ثم Save.
4

مراجعة تعيينات السمات

ضمن Mappings، افتح Provision Microsoft Entra ID Users وقارنه بالجدول أدناه. تغطي إعدادات Entra الافتراضية معظم الصفوف. تحتاج فقط إلى تعديل صفوف البريد الإلكتروني الأساسي وlocale وexternalId. أبقِ Provision Microsoft Entra ID Groups مفعّلاً إذا أردت أن تتحول مجموعات Entra إلى فرق في Wave Connect.
5

تعيين المستخدمين والمجموعات

انتقل إلى Users and groups وعيّن الأشخاص والمجموعات الذين ينبغي أن يكون لهم حساب Wave Connect. يُوفَّر المستخدمون المُعيَّنون فقط.
6

بدء التوفير

بالعودة إلى Provisioning، اضبط Provisioning Status على On وانقر على Save، أو انقر على Start provisioning. يُشغّل Entra دورة أولية، ثم دورة تزايدية كل 40 دقيقة تقريباً. للتحقق من مستخدم واحد دون انتظار، استخدم Provision on demand.

تعيين السمات

يقرأ Wave Connect سمات SCIM هذه. يوضح عمود حقل Wave Connect المكان الذي تصل إليه كل قيمة.
تغطي تعيينات Entra الافتراضية بالفعل userName وname.givenName وname.familyName وtitle وأرقام الهواتف وaddresses[type eq "work"].locality وactive. ثلاثة صفوف فقط تحتاج إلى تعديل: تأكد من أن تعيين بريد العمل يضبط primary على True، وغيّر هدف preferredLanguage من preferredLanguage إلى locale، وغيّر مصدر externalId من mailNickname إلى objectId.
ملاحظات أخرى حول التعيين:
  • يتم التحقق من أرقام الهواتف وتُخزَّن بالتنسيق الدولي. تُستبعد القيم النائبة والقيم التي تحتوي على رقم داخلي فقط بدلاً من إفشال المزامنة.
  • ضبط roles[].value على USER أو ADMIN أو OWNER (بأحرف كبيرة) يحدد دور المؤسسة. لا يرسل Entra الأدوار افتراضياً، لذا يُنشأ المستخدمون الجدد بدور مستخدم.
  • لا يُخزَّن حقل department من ملحق المؤسسات في الملف التعريفي. يمكن لدعم Wave Connect تفعيل تعيين الفرق حسب القسم.
  • يجب أن تكون قيمة locale إحدى اللغات التي يدعمها Wave Connect، وإلا يحصل المستخدم على الإنجليزية.

المجموعات تتحول إلى فرق

عند تفعيل توفير المجموعات، تتحول كل مجموعة Entra مُعيَّنة للتطبيق إلى فريق في Wave Connect. يصبح displayName الخاص بالمجموعة اسم الفريق، ويُخزَّن objectId الخاص بالمجموعة كمعرّف خارجي للفريق. إذا كان هناك فريق بالاسم نفسه موجوداً بالفعل في Wave Connect، تُدمج المجموعة فيه. ينتمي مستخدم Wave Connect إلى فريق واحد. إذا كان المستخدم في عدة مجموعات مُعيَّنة، تفوز آخر مجموعة يوفّرها Entra. يمكن أن تضم المؤسسة ما يصل إلى 75 فريقاً. حذف مجموعة في Entra يحذف الفريق في Wave Connect. يُحتفظ بمستخدميه وتُنقل جهات اتصاله إلى المؤسسة. يمكن أن يكون لكل فريق قالب مختلف، لذا يحصل المستخدمون في مجموعات مختلفة تلقائياً على تخطيط البطاقة الصحيح والعلامة التجارية والحقول المقفلة. راجع القوالب.

إنهاء الخدمة

عند إلغاء تعيين مستخدم من التطبيق أو تعطيله أو حذفه حذفاً مبدئياً في Entra، ترسل خدمة التوفير active = false. يُلغي Wave Connect تنشيط المستخدم:
  • لم يعد بإمكانه تسجيل الدخول وتُلغى جلساته.
  • يظهر بشارة SUSPENDED في المستخدمون.
  • يُحتفظ ببطاقة NFC الخاصة به وملفه التعريفي وجهات اتصاله.
  • لا يزال يُحتسب كمقعد.
يحتفظ Entra بالمستخدم المحذوف حذفاً مبدئياً لمدة 30 يوماً ثم يرسل طلب حذف. عندئذٍ يزيل Wave Connect المستخدم نهائياً، ويحذف ملفه التعريفي وجهات اتصاله، ويفك ربط بطاقة NFC الخاصة به ليمكن تعيينها لشخص آخر. إذا كنت لا تريد فترة السماح البالغة 30 يوماً، افتح الإعدادات → الأمان → مزامنة الدليل → تكوين وفعّل حذف المستخدم فورًا بدلاً من تعليقه. عندئذٍ يؤدي إلغاء التنشيط إلى حذف المستخدم نهائياً على الفور. لاستعادة مستخدم مُلغى تنشيطه، عيّنه للتطبيق مرة أخرى في Entra. ترسل دورة التوفير التالية active = true وتُعيد تنشيط الحساب.
يمكنك تفعيل تسجيل الدخول الموحد على التطبيق المؤسسي نفسه. راجع تسجيل الدخول الموحد (SAML).

تكامل الدليل (Microsoft Graph)

يربط تكامل الدليل Wave Connect بمستأجرك عبر Microsoft Graph API باستخدام حساب أحد المسؤولين. إعداده أبسط من SCIM، لكنه يُزامن المستأجر بأكمله ويعتمد على الحساب الذي أجرى الربط.

كيفية الاتصال

هناك نقطتا دخول. تُنشئ كلتاهما التكامل نفسه لكن بإعداد افتراضي مختلف لـ مزامنة المستخدمين، وهو المفتاح الذي يطبّق تغييرات الدليل تلقائياً.
  1. انتقل إلى الملحقات → Microsoft Entra ID وانقر على تثبيت التطبيق.
  2. أبقِ استيراد المستخدمين الجدد تلقائيًا من Microsoft Entra ID مفعّلاً، أو أوقفه إذا كنت تريد استيراداً يدوياً فقط. انقر على متابعة.
  3. سجّل الدخول بحساب Microsoft يمكنه منح موافقة المسؤول على المستأجر، واقبل طلب الموافقة.
مع تفعيل هذا المفتاح، يُنشأ كل مستخدم في المستأجر في Wave Connect مع وصول إشعارات التغيير، وتُطبَّق التغييرات المستقبلية تلقائياً. يظهر هذا الخيار باسم مزامنة المستخدمين في الإعدادات الخاصة بالتكامل.
مع تفعيل مزامنة المستخدمين، يضيف هذا التكامل مستخدم Wave Connect، ومقعداً، لكل مستخدم في المستأجر، بما في ذلك الضيوف. لا توجد طريقة لحصره في مجموعة معينة.

الأذونات

يطلب Wave Connect النطاقات المفوَّضة openid وoffline_access وprofile وUser.Read.All وDirectory.Read.All على حساب المسؤول الذي يجري الربط. يقرأ Wave Connect الدليل فقط، ولا يكتب أبداً في Entra. يعمل التكامل برمز التحديث الخاص بذلك المسؤول. إذا أُلغي الرمز (على سبيل المثال عند مغادرة المسؤول، أو إعادة تعيين كلمة مروره مع إلغاء الجلسات، أو منع سياسة وصول مشروط لعملية التحديث)، يحذف Wave Connect التكامل ويتعين على أحد المسؤولين إعادة ربطه.

ما الذي تتم مزامنته

اتجاه المزامنة: Entra ID → Wave Connect (وارد فقط). تُجلب صور الملفات التعريفية فقط أثناء الاستيراد اليدوي أو المعاينة وتُخزَّن كنسخة في Wave Connect. لا يحصل المستخدمون الذين تُنشئهم مزامنة المستخدمين على صورة.

مزامنة المستخدمين وإلغاء التنشيط

بعد الربط، يشترك Wave Connect في إشعارات تغيير Microsoft Graph للمستخدمين (الإنشاء والتحديث والحذف). تستمر الاشتراكات ثلاثة أيام وتُجدَّد تلقائياً من إشعارات دورة حياة Graph. تُتجاهل الإشعارات ما دامت مزامنة المستخدمين متوقفة. عند حذف مستخدم في Entra، أو تعطيل حسابه (accountEnabled = false)، يُلغي Wave Connect تنشيطه: يُمنع تسجيل الدخول، ويظهر بشارة SUSPENDED في المستخدمون، ويُحتفظ ببطاقته وملفه التعريفي وجهات اتصاله. ولا يزال يُحتسب كمقعد. إعادة تفعيل الحساب في Entra لا تُعيد تنشيطه في Wave Connect. تواصل مع support@wavecnct.com لإعادة تنشيط مستخدم، أو احذفه من المستخدمون.

القيود

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

قطع الاتصال

انتقل إلى الملحقات → Microsoft Entra ID → الإعدادات وانقر على قطع الاتصال. يحذف هذا الاتصال المخزَّن في Wave Connect. لا يُلغى أي شيء لدى Microsoft، وينتهي اشتراك Graph ببساطة في غضون ثلاثة أيام. يُحتفظ بمستخدمي Wave Connect الحاليين ولا يُحدَّثون بعد ذلك. لإزالة وصول Wave Connect من جانب Microsoft، ألغِ موافقة التطبيق المؤسسي في مركز إدارة Entra.

استخدام الطريقتين معاً

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

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

تحقق من أن Tenant URL هو بالضبط https://app.wavecnct.com/api/scim دون شرطة مائلة في النهاية، وأن Secret Token هو الرمز الكامل من نافذة ضبط SCIM. لا يمكن نسخ الرمز إلا عند إنشائه، لذا أنشئ رمزاً جديداً إذا فقدته. تُحذف الرموز عندما تغادر المؤسسة خطة Enterprise.
يوفّر Entra المستخدمين في دورات كل 40 دقيقة تقريباً. استخدم Provision on demand على المستخدم لدفعه فوراً، وراجع Provisioning logs لمعرفة النتيجة. يعني فشل الطلب عادةً أن سمة مطلوبة مفقودة: name.givenName أو name.familyName أو بريد أساسي عند التحديث.
مع SCIM، يجب أن يكون المستخدم مُعيَّناً للتطبيق. إذا أُلغي تعيينه، عيّنه مرة أخرى وسيرسل Entra active = true. مع تكامل Graph، لا تُعيد إعادة التفعيل تنشيط المستخدم أبداً. تواصل مع support@wavecnct.com لإعادة تنشيطه.
عندما يُنشئ SCIM مستخدماً يعود بريده الإلكتروني بالفعل إلى حساب Wave Connect شخصي (غير تابع لمؤسسة)، ويكون نطاق البريد أحد نطاقاتك الموثَّقة، يُنقل ذلك الحساب إلى مؤسستك ويُحدَّث بدلاً من إنشاء حساب جديد. يُحتفظ ببطاقته وجهات اتصاله الحالية. وثّق النطاق قبل التوفير حتى تُنقل هذه الحسابات بدلاً من تكرارها.
مع SCIM، بريد تسجيل الدخول هو البريد الأساسي، الذي يأخذه التعيين الموصى به من mail. مع تكامل Graph، هو userPrincipalName (أو mail للضيوف). إذا كان لمستخدم mail وUPN مختلفان، فعيّن userPrincipalName إلى البريد الأساسي في Entra بدلاً من ذلك، حتى تتفق الطريقتان.