دليل خطوة بخطوة للترخيص متعدد الأطراف (PMP و SMP) على خادم الاجتماعات من Cisco

المقدمة

يوضح هذا المستند كيفية تخصيص ترخيص Personal Multiparty Plus (PMP+) أو ترخيص Shared Multiparty Plus (SMP+) لمستخدمي CMS.

المتطلبات الأساسية

يدعم CMS (Cisco Meeting Server) الآن الترخيص متعدد الأطراف، مثل نموذج الترخيص متعدد الأطراف الذي تم تقديمه أول مرة على Cisco Conductor وخادم Cisco TelePresence. يمكن أن تكون التراخيص متعددة الأطراف لكل مستخدم (ترخيص PMP+)، أو مشتركة (ترخيص SMP+). لضمان نشر التراخيص بشكل صحيح، هناك عدد من الخطوات التي يجب إتخاذها.

المتطلبات

توصي Cisco بأن تكون لديك معرفة بالمواضيع التالية:

• CMS
• تطبيق عميل واجهة برمجة التطبيقات (API) أو الإلمام بترميز REST API
• تراخيص PMP و SMP 

المكونات المستخدمة

لا يقتصر هذا المستند على إصدارات برامج ومكونات مادية معينة.

يمكن تعيين تراخيص متعددة الأطراف فقط على CMS من خلال تكوين واجهة برنامج التطبيقات (API). لذلك من أجل نشر تراخيص متعددة الأطراف، يلزم أن يكون لديك:

• CMS
• ترخيص CallBridge (المعروف أيضا بمفتاح إصدار CMS)
• ترخيص PMP و/أو SMP واحد أو أكثر
• الوصول إلى بيانات الاعتماد إلى واجهة برمجة تطبيقات CMS
• أداة PostMan REST

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

معلومات أساسية

ملاحظة: يصف هذا المستند خطوات التكوين باستخدام عميل Postman REST. لاحظ أنه يمكن تطبيق أوامر واجهة برمجة التطبيقات (API) المناسبة من خلال أي أداة REST API أخرى تختارها. 

سيتم تحرير المعلمات التالية في هذه المقالة:

• UserProfile - يحدد ما إذا كان المستخدم لديه ترخيص PMP معين إليه (سمة withLicense)
• LDAPservers، ldapMappings، ldapSources (إختياري، مستخدم في هذا المثال) - يجب تحديد ترخيص واحد على الأقل من كل منهما، من أجل تعيين ترخيص PMP لمجموعة فرعية من المستخدمين
• ملفات تعريف النظام (إختياري) - تستخدم في حالة تعيين PMP لجميع المستخدمين بشكل عام
• إعدادات المستأجر (إختياري) - يتم إستخدامها إذا تم تعيين ترخيص PMP لكل مستأجر 

التكوين

يتم تعيين تراخيص PMP لكل مستخدم، ولكن في CMS لا يمكنك تحرير سمات المستخدمين الفرديين. يستند تعيين الترخيص إلى سمة userProfile. لا يمكن إقران ملف تعريف المستخدم بمستخدمين أفراد. وبدلا من ذلك، يمكن إقران userProfile:

• بشكل عام: ربط ملف تعريف المستخدم ب /API/v1/system/profile
• لكل مستأجر: ربط ملف تعريف المستخدم ب /API/V1/Tenants/<TenantID>
• وفقا ل ldapSource: اقتران ملف تعريف المستخدم ب /API/v1/ldapSources/<ldapSourceID> - لهذه الخطوة، ستحتاج إلى التأكد من تكوين LDAP من خلال API وحده ومن تكوينه بالكامل، بما في ذلك LDAPserver واحد على الأقل وLDAPmapping واحد على الأقل وLDAPsource واحد على الأقل

أي إجتماع لا يمكن ربطه بمستخدم معين لديه ترخيص PMP معين، سيتم تعيينه افتراضيا على إستخدام ترخيص SMP بدلا من ذلك. لا يتطلب نوع ترخيص SMP أي تعيين. 

بمجرد إتخاذ قرار بتنفيذ LDAP من خلال واجهة برمجة التطبيقات (API)، ستحتاج إلى إزالة تكوينات LDAP من واجهة المستخدم الرسومية (GUI) عبر الويب الخاصة ب CMS.

1. إعداد مصادر LDAP

تنقسم إعدادات LDAP في واجهة برمجة التطبيقات إلى ثلاثة أجزاء: خادم (خوادم) LDAP، تعيينات LDAP ومصادر LDAP، وجميعها مطلوبة.

مصدر LDAP هو المصدر الفعلي للمستخدمين. أنت ينبغي يتلقى واحد LDAP نادل وواحد LDAP يعين لكل مصدر. يمكن للعديد من المصادر مشاركة خادم LDAP نفسه و/أو تعيين LDAP.

الخطوة 1. قم بتسجيل الدخول إلى CMS وانتقل إلى التكوين > Active Directory.

• حذف الإعدادات الموجودة على صفحة الويب. انقر فوق إرسال ومزامنة الآن
• تحقق من عدم وجود مستخدمين تحت الحالة > المستخدمين

الخطوة 2. قم بإنشاء خادم LDAP.

• أستخدم أداة واجهة برمجة تطبيقات PostMan REST لنشرها على /ldapServers

عنوان	ldap.example.com
portNumber	389
username	cn=administrator،cn=users،dc=example،dc=com
كلمة المرور	كلمة المرور
آمن	خطأ

• لاحظ معرف خادم LDAP في رأس الاستجابة

الخطوة 3. قم بإنشاء تخطيط LDAP.

• أستخدم واجهة برمجة تطبيقات Postman REST أداة النشر إلى/ldapMappings

تعيين الاسم	$cn$
jidMapping	$sAMAccountName$@example.com
coSpaceUriMapping	$sAMAccountName$.space
coSpaceNameMapping	فضاء إجتماعات $cn$
coSpaceCallIdMapping	$ipPhone$

• لاحظ معرف تعيين LDAP الذي تم إرجاعه في رأس الاستجابة

الخطوة 4. إنشاء مصادر LDAP.

• أستخدم أداة REST API ل POST إلى /ldapSources
• أدخل عامل التصفية كسطر واحد (في المثال الظاهر تم تقسيمه في ثلاثة أسطر من أجل إمكانية القراءة). ملاحظة معرف مصدر LDAP

الخادم	<LdapsErverID الذي تم إنشاؤه في الخطوة 1.2>
رسم الخرائط	<LdapmAppingID الذي تم إنشاؤه في الخطوة 1.3>
baseDN	dc=example، dc=com
تصفية	(و     (عضو=cn=smpUsers، ou=Demo Users، dc=example، dc=com)     (!         (عضو=cn=PMPusers، ou=Demo Users، dc=example، dc=com)      ) )

سيقوم مصدر LDAP هذا باستيراد جميع المستخدمين الموجودين في مجموعة SMPUsers LDAP، ولكنهم ليسوا في مجموعة PMPusers.

• أستخدم أداة REST API ل POST إلى /ldapSources
• ملاحظة معرف مصدر LDAP

الخادم	<LdapsErverID الذي تم إنشاؤه في الخطوة 1.2>
رسم الخرائط	<LdapmAppingID الذي تم إنشاؤه في الخطوة 1.3>
baseDN	dc=example، dc=com
تصفية	(عضو=cn=PMPusers، ou=Demo Users، dc=example، dc=com)

سيقوم مصدر LDAP هذا باستيراد جميع المستخدمين الموجودين في مجموعة PMPusers.

الخطوة 5. مزامنة المستخدمين.

• أستخدم أداة Postman REST API ل POST إلى /ldapSyncs

ldapSource

<1st LDAPSourceID الذي تم إنشاؤه في الخطوة 1.4>

• أستخدم أداة Postman REST API ل POST إلى/ldapSyncs

ldapSource

<2nd LDAPSourceID الذي تم إنشاؤه في الخطوة 1.4>

الخطوة 6. التحقق من المستخدمين.

يمكنك تشغيل GET on /ldapSyncs لسرد أحداث مزامنة LDAP الجارية والجدولة حاليا. إذا تم تنفيذ Syncs بالفعل، فسيتم حذف عقد API بالفعل (هذا هو السلوك الافتراضي، ويمكن تغييره). يمكنك التحقق من قائمة المستخدمين المستوردين من خلال مسؤول الويب أيضا.

2. إنشاء ملفات تعريف المستخدمين وربطهم بمصادر LDAP

الخطوة 1. إنشاء ملف تعريف مستخدم لمستخدمي SMP.

• أستخدم واجهة برمجة تطبيقات Postman REST أداة إلى الاختبار الذاتي لبدء التشغيل (POST)               إلى /userProfiles

هازالترخيص

زائف

الخطوة 2. إنشاء ملف تعريف مستخدم لمستخدمي PMP.

• أستخدم واجهة برمجة تطبيقات Postman REST أداة إلى الاختبار الذاتي لبدء التشغيل (POST)               إلى /userProfiles

هازالترخيص

صحيح

الخطوة 3. تعيين SMP كافتراضي.

يجب تحديث ملف التعريف العمومي باستخدام ملف تعريف مستخدم SMP.

• أستخدم أداة واجهة برمجة تطبيقات PostMan REST لوضع ملفات /نظام/ملفات تعريف

ملف تعريف المستخدم

<معرف ملف تعريف المستخدم الذي تم إنشاؤه في الخطوة 2.1>

الخطوة 4. إقران تراخيص PMP بالمستخدمين في مجموعة مستخدمي PMP.

تحديث LdapSource لأعضاء PMPusers ومجموعة مستخدمي PMP.

• أستخدم أداة Postman REST API لوضع على /ldapSources/<2^nd LDAPourceID الذي تم إنشاؤه في الخطوة 1.4>

ملف تعريف المستخدم

<معرف ملف تعريف المستخدم الذي تم إنشاؤه في الخطوة 2.2>

• تكرار عملية مزامنة LDAP، حسب الخطوة 5

التحقق من الصحة

يمكن التحقق من عملية الاستيراد الناجحة للمستخدمين على صفحة واجهة المستخدم الرسومية (GUI) على ويب CMS ضمن الحالة > المستخدمون.

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

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