المحتويات

المقدمة

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

المتطلبات

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

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

التكوين

عملية نشر واحدة مجمعة

إعدادات خادم Active Directory

إعدادات الاستيراد

تعبيرات تعيين الحقل

نشر يتسم بالمرونة/قابلية التطوير

واجهة الويب API

كائنات واجهة برمجة تطبيقات LDAP

خوادم LDAP

LdapMappings:

مصادر LDAP:

ترحيل تكوينات واجهة المستخدم الرسومية (GUI) عبر الويب إلى واجهة برمجة التطبيقات (API)

الخطوة 1. إعدادات Active Directory الخاصة بواجهة مستخدم الويب

الخطوة 2: انتقل إلى معلمات LDAP داخل واجهة برمجة التطبيقات

الخطوة 3. إنشاء LDAPserver داخل API

الخطوة 4. إنشاء ldapMappings داخل API

الخطوة 5. إنشاء LDAPsources داخل واجهة برمجة التطبيقات

الخطوة 6. التحقق من تغيير الإعدادات من خلال LDAPsync

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

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

المقدمة

يصف هذا المستند العملية بالتفصيل لدمج البروتوكول الخفيف للوصول إلى الدليل (LDAP) مع خادم الاجتماعات (CMS) من Cisco.

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

المتطلبات

لا توجد متطلبات خاصة لهذا المستند.

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

تستند المعلومات الواردة في هذا المستند إلى CMS 3.0.

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

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

وسيركز ذلك على عدد من المواضيع التي تتناول تكامل برنامج العمل المتعلق باللينينية مع نظام إدارة المحتوى. كما يتضمن خطوات حول كيفية ترحيل تكوينات TZVreplacethis إلى API.

ملاحظة: خوادم LDAP الوحيدة المدعومة ل CMS هي Microsoft Active Directory و OpenLDAP و Directory LDAP3 و Oracle Internet Directory.

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

ملاحظة: يسمح WebAdmin فقط بتكوين خادم LDAP واحد.

التكوين

عملية نشر واحدة مجمعة

السيناريو الوحيد الذي يمكنك تكوين تكوين LDAP داخل واجهة الويب هو إذا كان لديك نشر واحد مجمع ل CMS.

ملاحظة: ستتم إزالة Active Directory من واجهة المستخدم الرسومية (GUI) للويب في الإصدارات اللاحقة من CMS.

إعدادات خادم Active Directory

تكوين الاتصال بخادم LDAP باستخدام:

العنوان

هذا هو اسم المضيف أو عنوان IP الخاص بخادم LDAP.

المنفذ

389 ل Unsecure & 636 ل Secure Connection (يجب تحديد خانة الاختيار Secure Connection)

Username

الاسم المميز (DN) للمستخدم المسجل. قد ترغب في إنشاء

مستخدم خاص لهذا الغرض. مثال: cn=Tyler Evans،cn=Users،OU=Engineering،dc=YourCompany،dc=com

كلمة المرور

كلمة المرور لاسم المستخدم الذي تستخدمه

اتصال آمن

حدد هذا المربع إذا كنت تستخدم منفذ 636

إعدادات الاستيراد

يتم إستخدام "إعدادات الاستيراد" للتحكم في المستخدمين الذين سيتم استيرادهم:

الاسم المميز المستند

العقدة الموجودة في شجرة LDAP والتي سيتم إستيراد المستخدمين منها.

فيما يلي إختيار معقول ل DN الأساسي لاستيراد المستخدمين

مثال: cn=Users،dc=sales،dc=YourCompany،dc=com

تصفية

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

سجل. يتم وصف الصياغة الخاصة بحقل عامل التصفية في RFC4515.

مثال: بريد=*

تعبيرات تعيين الحقل

تتحكم تعبيرات تعيين الحقل في كيفية إنشاء قيم الحقل في سجلات مستخدم Meeting Server من تلك الموجودة في سجلات LDAP المقابلة.

اسم العرض

اسم المستخدم

اسم المساحة

جزء مستخدم URI الخاص بالمساحة

جزء مستخدم URI الخاص بالمساحة الثانوية

معرف مكالمة فضائية

نشر يتسم بالمرونة/قابلية التطوير

هناك سيناريوهان حيث تحتاج إلى تكوين LDAP داخل واجهة برمجة التطبيقات. أحد السيناريوهات هو عندما يكون لديك نشر مجمع ل 3 عقد أو أكثر ويكون السيناريو الثاني هو عندما يكون لديك أكثر من TZVreplacethis هذا الخادم.

واجهة الويب API

انتقل إلى واجهة ويب API من خلال تسجيل الدخول إلى مسؤول الويب الخاص بك ل CMS > التكوين > API. هنا حيث يمكنك إنشاء جميع تكوينات واجهة برمجة التطبيقات (API) لديك.

كائنات واجهة برمجة تطبيقات LDAP

بعد التنقل إلى واجهة برمجة التطبيقات (API) في الخطوة المذكورة سابقا، يمكنك الآن كتابة "LDAP" في شريط التصفية. سيعرض هذا كل تكوينات LDAP التي يمكنك إجراؤها.

الكائنات الموجودة في التدرج الهرمي في عقد "/ldapMappings" و "/ldapServers" و "/ldapSources" في شجرة الكائنات تتصل بتفاعل خادم الاجتماعات مع خادم واحد أو أكثر من خوادم LDAP (على سبيل المثال، Active Directory) التي يتم إستخدامها لاستيراد حسابات المستخدمين إلى خادم الاجتماعات من Cisco.

خوادم LDAP

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

* = مطلوب

العنوان*

عنوان خادم LDAP المراد الاتصال به

الاسم

الاسم المقترن (من الإصدار 2.9 وما بعده)

portNumber *

المنفذ 389 (غير آمن) أو المنفذ 636 (آمن)

Username

اسم المستخدم الذي سيتم إستخدامه عند إسترداد المعلومات من خادم LDAP

كلمة المرور

كلمة مرور الحساب المقترن باسم المستخدم

آمن *

ما إذا كان سيتم إجراء اتصال آمن بخادم LDAP أم لا. إذا كان "صحيحا" فعندئذ TLS

في حالة إستخدام "خطأ"، سيتم إستخدام بروتوكول TCP.

usePagedResults

ما إذا كان سيتم إستخدام التحكم في النتائج المقسمة إلى صفحات LDAP في عمليات البحث أثناء

مزامنة LDAP؛ في حالة عدم تعيين عنصر التحكم في النتائج المقسمة إلى صفحات سيتم إستخدامه. أوراكل إنترنت

يتطلب الدليل تعيين هذه المعلمة إلى "false" (من الإصدار 2.1).

LdapMappings:

يلزم أيضا تعيين LDAP واحد أو أكثر، مما يحدد شكل أسماء حسابات المستخدم التي ستتم إضافتها إلى النظام عند إستيراد المستخدمين من خوادم TZVreplacethis التي تم تكوينها.

* = مطلوب

jidMapping*

قالب إنشاء JIDs للمستخدم من LDAP المقترن

إدخالات الخادم، على سبيل المثال

$sAMAccountName$@example.com.

ملاحظة: تستخدم معرفات المستخدم التي تم إنشاؤها بواسطة jidMapping أيضا كمعرفات URI

لذلك يجب أن يكون فريدا وليس نفس أي معرف URI أو معرف مكالمة.

تعيين الاسم

قالب إنشاء أسماء مستخدمين من الاقتران

إدخالات خادم LDAP، على سبيل المثال "$cn$" لاستخدام الشائع

الاسم.

cdrTagMapping

القالب الخاص بإنشاء قيمة cdrTag الخاصة بالمستخدمين. يمكن ضبطه

إما إلى قيمة ثابتة أو يتم إنشاؤها من حقول LDAP الأخرى

لهذا المستخدم. يتم إستخدام CdrTag الخاص بالمستخدم في وحدات التحكم في الوصول عن بعد (CDR) الخاصة ب CallLegStart.

راجع مرجع CDR لخادم الاجتماعات من Cisco للحصول على تفاصيل.

coSpaceUriMapping

في حالة توفير هذه المعلمات، فإنها تضمن أن كل مستخدم

الحساب الذي تم إنشاؤه بواسطة تعيين LDAP هذا له إرتباط

برنامج CoSpace شخصي.

coSpaceSecondaryUriMapping

ولإعداد CoSpace هذا حسب الطلب، سيتم إعداد هذه المعلمات

توفير القالب لتعيين URI ل CoSpaces، معروض

الاسم ومعرف المكالمة المكون. على سبيل المثال، إعداد

يضمن CoSpaceNameMapping إلى "$cn$ Personal CoSpace"

أن كل مستخدم coSpace موسوم بالاسم المتبع من قبل

"PersonalSpace".

coSpaceNameMapping

coSpaceCallIdMapping

AuthenticationIdMapping

قالب إنشاء معرفات المصادقة من

إدخالات"خوادم LDAP المقترنة، على سبيل المثال

"$userPrincipalName$"

مصادر LDAP:

بعد ذلك يجب تكوين مجموعة من مصادر LDAP، والتي تقوم بربط هذه الخادمات التي تم تكوينها TZVreplacethis وتعيينات TZVReplacethis مع المعلمات الخاصة بها، والتي تتوافق مع الاستيراد الفعلي لمجموعة من المستخدمين. TZVreplacethis يأخذ مصدر TZVreplacethis هذا الخادم / TZVreplacethis مجموعة التعيين هذه ويستورد مجموعة مصفاة من المستخدمين من هذا الخادم TZVreplacethis. يتم تحديد عامل التصفية هذا من خلال "baseDn" الخاص بمصدر TZVReplacethis (العقدة الخاصة بشجرة الخادم TZVreplacethis والتي يمكن العثور على المستخدمين تحتها) وعامل تصفية لضمان إنشاء حسابات المستخدمين فقط للكائنات TZVreplacethis التي تطابق نمطا معينا.

* = مطلوب

خادم*

معرف خادم LDAP الذي تم تكوينه مسبقا

رسم الخرائط*

معرف تعيين LDAP الذي تم تكوينه مسبقا (

baseDn*

الاسم المميز للعقدة في شجرة خادم LDAP التي يجب إستيراد المستخدمين منها، على سبيل المثال "cn=Useers،dc=،dc=com"

تصفية

مستأجر

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

nonMemberAccess

ترحيل تكوينات واجهة المستخدم الرسومية (GUI) عبر الويب إلى واجهة برمجة التطبيقات (API)

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

يرجى الملاحظة: ماذا يحدث عند نقل AD من GUI إلى API؟ إذا قمت بتكوين API أولا قبل إزالة إعدادات GUI Active Directory، ستظل معلومات المستخدم بدون تغيير، كما يبقى معرف المكالمة والسر نفس الشيء. ومع ذلك، إذا قمت بإزالة واجهة المستخدم الرسومية (GUI) قبل تكوين واجهة برمجة التطبيقات بعد ذلك، فسيحصل جميع المستخدمين على معرف مكالمة وسر جديدين.

الخطوة 1. إعدادات Active Directory الخاصة بواجهة مستخدم الويب

انتقل إلى التكوينات > Active Directory. هنا، سترى تكوينات LDAP لواجهة المستخدم الرسومية (GUI) للويب. قم بأخذ لقطة شاشة لهذا الأمر أو انسخ هذه المحتويات ولصقها في notepad+ لأنك ستحتاج إلى هذا لاحقا.

الخطوة 2: انتقل إلى معلمات LDAP داخل واجهة برمجة التطبيقات

انتقل إلى التكوينات > API > اكتب "LDAP" في شريط المرشح.

سترى هنا قائمة بتكوينات LDAP. سنركز على LdapMappings و ldapServers و ldapSources. لذلك، لنبدأ ب ldapServers.

الخطوة 3. إنشاء LDAPserver داخل API

من هذه القائمة، انقر فوق LDAPservers ثم حدد "إنشاء جديد". قم الآن بعرض لقطة الشاشة أو Notepad++ الخاصة بالمحتويات التي كانت داخل GUI Active Directory لواجهة المستخدم الرسومية (GUI) على الويب لديك. أنت الآن بصدد نسخ "إعدادات خادم Active Directory" من واجهة المستخدم الرسومية (GUI) للويب إلى تكوينات واجهة برمجة التطبيقات (API) المقابلة. انظر هنا:

الخطوة 4. إنشاء ldapMappings داخل API

بعد اكتمال الخطوة 4.، انتقل إلى ldapMapping داخل واجهة برمجة التطبيقات (API). التكوينات > API > مرشح "ldapMapping" وانقر فوق إنشاء جديد.

هنا، انسخ تعبيرات تخطيط الحقل من واجهة المستخدم الرسومية (GUI) للويب. انتقل إلى التكوينات > Active Directory > تعبيرات التعيين المودعة في تكوين API ل LDAPmapping. بعد ذلك، انتقل إلى التكوين > API > مرشح "تعيين الحقول" ثم انقر فوق إنشاء.

تعبيرات تعيين الحقل (واجهة المستخدم الرسومية (GUI) عبر الويب)

API

اسم العرض

تعيين الاسم

Username

jidMapping

اسم المساحة

جزء مستخدم URI الخاص بالمساحة

CoSpaceURIMapping

جزء مستخدم URI الثانوي للمساحة

coSpaceSecondaryUriMapping

معرف إستدعاء المساحة

الخطوة 5. إنشاء LDAPsources داخل واجهة برمجة التطبيقات

قم الآن بترحيل إعدادات دليل الشركة/الاستيراد من واجهة المستخدم الرسومية (GUI) للويب إلى تكوينات واجهة برمجة تطبيقات مصادر LDAP، والتكوين > API > تصفية "ldapSources" وانقر فوق السهم المجاور ل LdapSources ثم حدد إنشاء جديد.

حدد تخطيط LDAP وخادم TZVREPLACETHIS الذي قمت بتكوينه في الخطوات 3. و 4.

هنا ستحدد تخطيط LDAP و TZVREPLACETHIS خادم قمنا بتكوينه للتو ثم ستقوم بإضافة BASEDN والتصفية من واجهة المستخدم الرسومية (GUI) للويب إلى تكوين واجهة برمجة التطبيقات (API).

إعدادات الاستيراد (واجهة المستخدم الرسومية (GUI) عبر الويب)

API LdapSource

الاسم المميز للأساس

baseDn

تصفية

تصفية

الخطوة 6. التحقق من تغيير الإعدادات من خلال LDAPsync

يمكنك الآن تأكيد أن ذلك يعمل. انتقل إلى LDAPsyncs في API، Configuration > API > مرشح 'ldapSyncs' وانقر عليه وحدد إنشاء جديد.

لن تضطر إلى تعبئة أي شيء، وستحدد إنشاء فقط. سيؤدي ذلك إلى بدء عملية المزامنة. بعد 30 ثوان - 1 دقيقة، قم بتحديث الصفحة للتحقق من حصولك على حالة كاملة وإرجاع 200 موافق.

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

تأكد من تكوين كافة الحقول بشكل صحيح.

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

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