# Configurar y operar un Enterprise Connector

Origen de datos, TLS, estado, registros y diagnóstico en la aplicación Enterprise Connector de su propia máquina.

Una vez registrado un conector, su configuración reside en la aplicación del conector instalada en la máquina de su red, no en la consola. Esta página describe esa aplicación.

## La ventana de la aplicación

Arriba a la izquierda, el **selector de conector** determina cuál de los conectores instalados está consultando. Todas las páginas situadas bajo el selector se refieren al conector seleccionado, así que compruébelo primero cuando una página muestre valores inesperados.

Las páginas disponibles dependen del tipo del conector seleccionado:

| Área | Páginas | Disponible para |
|---|---|---|
| **Home** | Agents, Status | Todos los conectores |
| **Configure** | Data source, Identity | Conectores de autenticación |
| **Configure** | Provisioning target, Identity | Conectores de aprovisionamiento |
| **Insight** | Logs, Diagnostics | Diagnostics para conectores de autenticación, Logs para todos los conectores |
| **Explore** | Users, Groups, Directory structure | Conectores de autenticación |
| **Update** | Release notes, Update | Todos los conectores |

## Data source (conectores de autenticación)

**Configure → Data source** contiene la conexión con Active Directory o LDAP. Los cambios surten efecto sin reiniciar el servicio.

**Conexión**

| Campo | Significado |
|---|---|
| **Protocol** | `ldaps://` (cifrado, recomendado) o `ldap://`. Elegir la variante sin cifrar muestra una advertencia, porque las credenciales de bind y los datos del directorio viajan entonces en claro. |
| **Host**, **Port** | Dirección del controlador de dominio o del servidor LDAP, normalmente el puerto 636 para LDAPS y el 389 para LDAP. |
| **Bind DN**, **Bind password** | La cuenta de servicio con la que se autentica el conector. El acceso de lectura basta mientras no se activen la sincronización ascendente o la reescritura de contraseñas. |
| **Base DN** | La raíz del subárbol en el que trabaja el conector. |
| **Custom CA certificates (PEM)** | Certificados de las autoridades en las que la conexión LDAPS debe confiar además del almacén de confianza del sistema. Independientes de los certificados configurados para la conexión con la plataforma. |
| **Ignore invalid certificates** | Desactiva la verificación de certificados para la conexión LDAPS. Utilícelo solo como medida transitoria. |

**Users** y **Groups** admiten cada uno un **additional base DN**, que se añade a la base DN, y un **filtro**. Juntos determinan qué objetos entrega el conector a la plataforma. Los filtros estrechos mantienen rápida la sincronización e impiden que cuentas de servicio o de sistema acaben como usuarios.

**Test settings** ejecuta una prueba de conexión con los valores que hay en ese momento en el formulario e informa de lo que ha encontrado, incluido el número de objetos. Utilícelo después de cada cambio, antes de guardar.

Las operaciones de directorio utilizan de forma predeterminada un tiempo límite de diez segundos, suficiente para un controlador de dominio cargado en un enlace lento. Un inicio de sesión de usuario que lo supere se registra como inicio de sesión fallido, así que investigue los tiempos límite repetidos en el lado del directorio en lugar de ampliar la tolerancia.

## Provisioning target (conectores de aprovisionamiento)

**Configure → Provisioning target** controla lo que puede alcanzar un conector de aprovisionamiento:

- **Allowed target origins** es la lista de sistemas a los que este conector puede reenviar peticiones de aprovisionamiento, una entrada por línea. Una entrada puede indicar un origen, por ejemplo `https://scim.example`, o un origen con un prefijo de ruta para acotarlo aún más. **Una lista vacía lo rechaza todo**, y ese es el estado previsto hasta que se autorice un destino de forma deliberada.
- **Custom CA certificates** e **Ignore invalid certificates** funcionan como sus equivalentes de la página del origen de datos, referidos a la conexión con el destino.

La lista de permitidos es un límite de contención: acota qué sistemas de su red pueden alcanzarse en absoluto a través de este conector. Manténgala tan estrecha como permita la integración.

## Identity (conexión con la plataforma)

**Configure → Identity** cubre la forma en que el conector se comunica con la plataforma:

- **Custom CA certificates (PEM)** son los certificados de las autoridades en las que debe confiar la conexión con la plataforma, necesarios cuando su red intercepta TLS o el certificado de la plataforma procede de una autoridad privada. Este ajuste lo aplica el servicio del conector al arrancar, así que el servicio debe reiniciarse tras un cambio.
- **Ignore invalid certificates** desactiva la verificación de esa conexión. Utilícelo solo como medida transitoria.
- **Export keypair** empaqueta el par de claves del conector en un bloque cifrado con una frase de contraseña. Lo necesita para registrar otro conector del mismo directorio o para trasladar este conector a otra máquina. La frase de contraseña protege la clave privada y no puede recuperarse, así que guarde ambas partes en un lugar seguro y elimine el bloque exportado una vez utilizado.

## Status

**Home → Status** muestra tres indicadores para el conector seleccionado: el **Service** local, la conexión con **Identity** y la conexión con el **Data source** o el **Provisioning target**. Debajo aparece en vivo la actividad reciente: ejecuciones de sincronización con su número de usuarios, inicios de sesión correctos y fallidos, cambios de contraseña y tráfico de aprovisionamiento con su número de errores.

Es la vía más rápida para distinguir un problema del conector de un problema de la plataforma. Un conector cuyo servicio está disponible y cuya conexión con la plataforma funciona, pero cuyo origen de datos está caído, apunta al servicio de directorio o a las credenciales de la página del origen de datos.

## Explorar el directorio

**Explore → Users**, **Groups** y **Directory structure** muestran, directamente desde el origen, lo que el conector ve realmente con las base DN y los filtros actuales. Utilícelas para comprobar un filtro antes de activar la sincronización y para averiguar si un usuario que falta en la plataforma ya falta en el origen o queda excluido por un filtro.

## Logs

**Insight → Logs** enumera los archivos de registro del conector seleccionado y ofrece una vista **Live** que sigue el archivo actual. Los archivos de registro se rotan y tienen un tamaño limitado, por lo que no pueden crecer sin límite.

Los registros permanecen en la máquina. Nada de su contenido llega a la plataforma mientras no envíe un paquete de diagnóstico.

## Diagnóstico

**Insight → Diagnostics** genera un paquete de soporte a partir de las categorías que seleccione:

| Categoría | Contenido |
|---|---|
| **Logs** | Los archivos de registro del conector. Incluidos de forma predeterminada. |
| **Settings** | La configuración del origen de datos: host, bind DN, base DN y filtros. La contraseña de bind se omite. |
| **Connection test** | El resultado de una prueba de conexión nueva. |
| **Users**, **Groups**, **Directory structure** | Datos del directorio tal como los lee el conector. No se incluyen de forma predeterminada, porque contienen datos personales. |

**Download** guarda el paquete en local para que pueda revisarlo antes de compartirlo. **Upload to support** lo transfiere directamente. Revise las categorías seleccionadas antes de subirlo: las categorías de directorio contienen datos personales de sus usuarios.

## Notas de operación

- Los conectores se ejecutan como servicios de Windows y siguen trabajando con la ventana de la aplicación cerrada.
- Detener un conector de autenticación detiene los inicios de sesión de su directorio, salvo que otro conector de ese directorio esté en línea.
- El origen de datos, el destino de aprovisionamiento y los filtros de directorio surten efecto de inmediato. Los certificados de la conexión con la plataforma surten efecto tras reiniciar el servicio.
- La página **Update → Release notes** enumera los cambios de cada versión.

## Resolución de problemas

- **Identity está conectado, pero el conector no es utilizable.** El conector ha alcanzado la plataforma, pero no ha sido aceptado. Suele ocurrir tras eliminar o volver a crear el conector en la consola. Registre el conector de nuevo con una URL de aprovisionamiento nueva.
- **El origen de datos aparece como desconectado.** Pruebe la conexión en la página del origen de datos. Las causas frecuentes son una contraseña caducada de la cuenta de bind, una regla de cortafuegos entre la máquina y el controlador de dominio, y un certificado LDAPS en el que la máquina no confía.
- **Los inicios de sesión fallan mientras la sincronización funciona.** La cuenta de bind puede leer, pero los usuarios no pueden hacer bind, o el filtro de usuarios los excluye. Compruebe el filtro de usuarios en la página del origen de datos y verifique la cuenta en **Explore → Users**.
- **Faltan usuarios después de una sincronización.** Compruebe primero la additional base DN y el filtro de usuarios, y confirme después en **Explore → Users** que el conector ve las cuentas.
- **Se rechaza un cambio de contraseña.** En un directorio con protección de contraseñas de extremo a extremo, la política de contraseñas la aplica el conector. Actualice el conector cuando el mensaje no coincida con la política configurada en la consola.

## Véase también

- [Instalar un Enterprise Connector](https://dts-identity.com/es/docs/directories/enterprise-connector-installation.md) para los requisitos, la instalación, las actualizaciones y la eliminación.
- [Enterprise Connectors](https://dts-identity.com/es/docs/directories/enterprise-connectors.md) para la parte de la consola.
- [Directorios de usuarios](https://dts-identity.com/es/docs/directories/user-directories.md) para la sincronización, la reescritura de contraseñas y los propios ajustes de directorio.
