Configurar integración LDAP de CMS

Introducción

En este documento se describe paso a paso el proceso de integración del protocolo ligero de acceso a directorios (LDAP) con Cisco Meeting Server (CMS).

Prerequisites

Requirements

Cisco recomienda tener conocimientos de estos temas:

• CMS Callbridge versión 2.9 o posterior

• Protocolo ligero de acceso a directorios (LDAP) de Microsoft

Componentes Utilizados

La información de este documento se basa en CMS 3.0.

La información que contiene este documento se creó a partir de los dispositivos en un ambiente de laboratorio específico. Todos los dispositivos que se utilizan en este documento se pusieron en funcionamiento con una configuración verificada (predeterminada). Si tiene una red en vivo, asegúrese de entender el posible impacto de cualquier comando.

Antecedentes

Este documento se centra en una serie de temas relacionados con la integración LDAP con CMS. También incluye los pasos sobre cómo migrar las configuraciones de Active Directory desde la GUI de CMS en Configuration > Active Directory a API.

Nota: Los únicos servidores LDAP compatibles con CMS son Microsoft Active Directory, OpenLDAP, Directory LDAP3 y Oracle Internet Directory.

Nota: Las configuraciones LDAP en la GUI web podrían eliminarse en futuras versiones de CMS.

Configurar

El único escenario en el que configuraría la configuración LDAP dentro de la interfaz web es si tiene un único origen LDAP para importar a CMS.

Nota: Active Directory podría eliminarse de la GUI web en las versiones posteriores de CMS.

Configuración del servidor de directorios activos

Configure la conexión al servidor LDAP con:

Dirección	Este es el hostname o dirección IP de su servidor LDAP.
Puerto	389 para conexiones no seguras y 636 para conexiones seguras (debe marcar la casilla de verificación de conexiones seguras)
Nombre de usuario	El nombre distinguido (DN) de un usuario registrado. Puede crear un específicamente para este fin. Ejemplo: cn=Tyler Evans,cn=Users,OU=Engineering,dc=YourCompany,dc=com
Contraseña	La contraseña para el nombre de usuario que está utilizando
Conexión segura	Marque esta casilla si utiliza el puerto 636

Importar configuración

Configuración de importación se utiliza para controlar qué usuarios se importan:

Nombre distintivo basado	Nodo del árbol LDAP desde el que se importan usuarios. Este ejemplo es una opción razonable para que el DN base importe usuarios	Ejemplo: cn=Users,dc=sales,dc=YourCompany,dc=com
Filtro	una expresión de filtro que debe ser satisfecha por los valores de atributo en un LDAP de usuarios registro. La sintaxis del campo Filtro se describe en rfc4515.	Ejemplo: mail=*

Expresiones de asignación de campos

Las expresiones de asignación de campos controlan cómo se construyen los valores de campo de los registros de usuario de Meeting Server a partir de los de los registros LDAP correspondientes.

Mostrar nombre:

User Name

Nombre de espacio

Parte del usuario de URI de espacio

Parte de usuario de URI de espacio secundario

ID de llamada de espacio

Implementación flexible/escalable

Hay dos escenarios en los que debería configurar LDAP dentro de la API. Un escenario es cuando tiene una implementación agrupada de 3 o más nodos y el segundo escenario es cuando tiene más de un origen LDAP desde el cual importar usuarios.

API de interfaz web

Navegue hasta la interfaz web de la API iniciando sesión en el administrador web de su CMS > Configuration > API. Aquí es donde realiza todas sus configuraciones de API.

Objetos de API LDAP

Después de navegar a la API, escriba "ldap" en la barra de filtros para mostrar todas las configuraciones LDAP que puede realizar.

Los objetos de la jerarquía que residen en los nodos "/ldapMappings", "/ldapServers" y "/ldapSources" del árbol de objetos se relacionan con la interacción de Meeting Servers con uno o más servidores LDAP (por ejemplo, Active Directory) que se utilizan para importar cuentas de usuario en Cisco Meeting Server.

LdapServers

Se deben configurar uno o más servidores LDAP, cada uno de los cuales debe tener información asociada de nombre de usuario y contraseña para que el servidor de reuniones pueda utilizarla para conectarse a él con el fin de recuperar información de cuenta de usuario de él.

* = Obligatorio

Dirección*	dirección del servidor LDAP al cual conectarse
Nombre	nombre asociado (a partir de la versión 2.9)
portNumber *	Puerto 389 (no seguro) o puerto 636 (seguro)
Nombre de usuario	nombre de usuario que se utiliza para recuperar información del servidor LDAP
Contraseña	contraseña de la cuenta asociada con el nombre de usuario
Segura*	si se debe establecer una conexión segura con el servidor LDAP. Si es "true", entonces TLS se utiliza; si es "false", se utiliza TCP.
usePagedResults	si utilizar el control de resultados paginados LDAP en operaciones de búsqueda durante Sincronización LDAP; si no se establece, se utiliza el control de resultados paginados. Oracle Internet El directorio requiere que este parámetro se establezca en "false" (desde la versión 2.1).

LdapMappings

También se requieren una o más asignaciones LDAP, que definen la forma de los nombres de cuenta de usuario que se agregan al sistema cuando se importan usuarios desde servidores LDAP configurados.

* = Obligatorio

jidMapping*	La plantilla para generar JID de usuario desde el LDAP asociado entradas de servidores, por ejemplo $sAMAccountName$@example.com. Nota: los JID de usuario generados por jidMapping también se utilizan como URI por lo que debe ser único y no igual que cualquier URI o ID de llamada.
nameMapping	La plantilla para generar nombres de usuario a partir de la plantilla asociada Entradas de servidores LDAP; por ejemplo, "$cn$" para utilizar el nombre.
cdrTagMapping	Plantilla para generar el valor cdrTag de un usuario. Se puede establecer a un valor fijo o a partir de otros campos LDAP para ese usuario. El comando cdrTag del usuario se utiliza en los CDR de callLegStart. Consulte la Referencia de CDR de Cisco Meeting Server para obtener más información.
coSpaceUriMapping	Si se proporcionan estos parámetros, se aseguran de que cada usuario La cuenta generada por esta asignación LDAP tiene un personal coSpace.
coSpaceSecondaryUriMapping	Para que el espacio compartido se configure según sea necesario, estos parámetros proporcionar la plantilla para establecer el URI de coSpaces, mostrado nombre y ID de llamada configurada. Por ejemplo, configurar coSpaceNameMapping a "$cn$ personal coSpace" garantiza que el espacio compartido de cada usuario se etiqueta con su nombre seguido de "espacio compartido personal".
asignaciónNombreEspacioCo
coSpaceCallIdMapping
authenticationIdMapping	La plantilla para generar ID de autenticación desde el entradas de servidores LDAP asociadas, por ejemplo "$userPrincipalName$"

LdapSources

Luego, debe configurarse un conjunto de orígenes LDAP, que unen los servidores LDAP configurados y las asignaciones LDAP, junto con sus propios parámetros, que corresponden a la importación real de un conjunto de usuarios. Un origen LDAP toma una combinación de servidor LDAP / asignación LDAP e importa un conjunto filtrado de usuarios de ese servidor LDAP. Este filtro está determinado por los orígenes LDAP "baseDn" (el nodo del árbol de servidores LDAP bajo el cual se pueden encontrar los usuarios) y un filtro para garantizar que las cuentas de usuario sólo se crean para objetos LDAP que coinciden con un patrón específico.

* = Obligatorio

servidor*	El ID de un servidor LDAP previamente configurado
asignación*	El ID de una asignación LDAP previamente configurada (
BaseDn*	El nombre distinguido del nodo en el árbol de servidores LDAP desde el cual se van a importar los usuarios, por ejemplo "cn=Users,dc=,dc=com"
filtro
arrendatario
userProfile
nonMemberAccess

Migración de configuraciones GUI web a API

Esta sección trata sobre cómo migrar las configuraciones de la GUI web LDAP a la API. Si actualmente tiene configuraciones Ldap en la GUI web y desea migrar esta información a la API, utilice este ejemplo para evitar la pérdida de datos.

Paso 1. Anotación de la configuración de Active Directory GUI web

Navegue hasta Configuraciones > Active Directory para ver las configuraciones LDAP para su GUI web. Tome una captura de pantalla de esto o copie y pegue estos contenidos en un editor de texto para usarlos más tarde.

Paso 2: Navegue hasta los parámetros LDAP dentro de la API

Navegue hasta Configuraciones > API > Escriba "Ldap" en la barra de filtros.

Se muestra una lista de configuraciones LDAP. 

Paso 3. Crear ldapServer dentro de la API

De esta lista, haga clic en ldapServers y luego seleccione "Create New". Consulte la captura de pantalla o el editor de texto para ver el contenido que se encontraba en Active Directory de la GUI web. Ahora va a copiar la "Configuración del servidor de Active Directory" de la interfaz gráfica de usuario Web en las configuraciones de API correspondientes. 

Paso 4. Crear ldapMappings dentro de la API

Después de completar el paso 4.0, navegue hasta ldapMapping dentro de la API. Configurations > API > Filter "ldapMapping" y haga clic en Create New.

Copie las expresiones de asignación de campos de la GUI web desde Configuraciones > Active Directory > Expresiones de asignación de campos. A continuación, vaya a Configuration > API > filter "ldapmapping" y haga clic en Create.

Expresiones de asignación de campos (GUI web)	API
Mostrar nombre:	nameMapping
Nombre de usuario	jidMapping
Nombre de espacio
Parte del usuario de URI de espacio	coSpaceURIMapping
Parte de usuario URI secundario de espacio	coSpaceSecondaryUriMapping
ID de llamada de espacio

Paso 5. Crear ldapSources dentro de API

Ahora migre los ajustes de Corporate Directory/Import desde la GUI web a las configuraciones de LDAP Sources API, Configuration > API > filter "ldapSources" y haga clic en la flecha junto a LdapSources y luego seleccione create new.

Seleccione el mapeo LDAP y el servidor LDAP que configuró en los pasos 3. y 4.

Seleccione el mapeo LDAP y el servidor LDAP que acaba de configurar y, a continuación, agregue el DN base y el filtro de la guía web a la configuración de la API.

Configuración De Importación (Gui Web)	API LdapSource
Nombre distintivo base	baseDn
Filtro	filtro

Paso 6. Verificar cambio de configuración mediante ldapSync 

Ahora puede confirmar que funciona. Navegue hasta ldapSyncs en API, Configuration > API > filter ‘ldapSyncs’ y haga clic en él y seleccione Create New.

No tiene que rellenar nada, simplemente seleccione Create (Crear). Esto inicia el proceso de sincronización. Después de 30 segundos - 1 min, actualice la página para verificar que obtiene un estado completo y un 200 OK devuelto.

Verificación

Asegúrese de que todos los campos están configurados correctamente.

Troubleshoot

Actualmente, no hay información específica de troubleshooting disponible para esta configuración.