Instalar un Enterprise Connector
Requisitos, descarga, instalación, registro, actualizaciones, migración y eliminación del Enterprise Connector on-premises.
Esta página trata la parte del software: qué instala en su propia red, cómo lo registra, lo mantiene actualizado y lo vuelve a eliminar. La parte de la consola (crear un conector, su URL de aprovisionamiento, el estado, la eliminación) se describe en Enterprise Connectors.
Qué se instala
Una instalación de Windows alberga la aplicación del agente y uno o varios conectores. Son cosas distintas:
| Componente | Qué es | Se ejecuta |
|---|---|---|
| Aplicación del agente | La ventana de gestión que se abre en la máquina. Registra conectores, guarda su configuración y muestra el estado, los registros y el diagnóstico. | A demanda, iniciada por usted. |
| Servicio de broker local | Se registra como el servicio de Windows iec-nats en el primer arranque. Transporta la comunicación interna entre la ventana y los conectores instalados. Vinculado únicamente a la máquina local. | De forma permanente, como servicio de Windows. |
| Servicio del agente | Un servicio de Windows por cada conector registrado, con el nombre iec-agent-<agent id>. Mantiene la conexión saliente hacia la plataforma y realiza el trabajo propiamente dicho. | De forma permanente, como servicio de Windows. |
Como cada conector es un servicio de Windows propio, los conectores siguen funcionando con la ventana de la aplicación cerrada y vuelven a arrancar después de un reinicio. La ventana solo hace falta para configurarlos, revisarlos o actualizarlos.
Una misma máquina puede alojar varios conectores, incluidos conectores de distinto tipo y conectores que apuntan a directorios diferentes.
Requisitos
- Windows en x64. El instalador y la aplicación requieren derechos de administrador local, y la aplicación solicita una elevación en cada arranque porque gestiona servicios de Windows.
- Solo HTTPS saliente. El conector establece la conexión con el host de su plataforma por el puerto 443 (HTTPS y WebSocket sobre TLS) y la mantiene abierta. En su lado no hace falta ninguna regla de cortafuegos de entrada ni ningún puerto publicado.
- Accesibilidad del sistema de origen. Un conector de autenticación necesita alcanzar su controlador de dominio o su servidor LDAP, normalmente por el puerto 636 para LDAPS o el 389 para LDAP. Un conector de aprovisionamiento necesita alcanzar el destino SCIM al que va a servir.
- Una cuenta de servicio para el directorio. Un conector de autenticación se vincula a Active Directory o LDAP con una cuenta de lectura dedicada (una cuenta con permisos de escritura solo si se activa la sincronización ascendente o la reescritura de contraseñas).
- Ningún acceso entrante a la propia máquina. La comunicación interna entre la ventana y los servicios está vinculada a la máquina local y se rechaza en cualquier otra dirección.
Elija una máquina que esté siempre encendida y cerca del servicio de directorio, por ejemplo un servidor de gestión de la misma sede. Para mayor resiliencia, instale un segundo conector del mismo directorio en otra máquina en lugar de un segundo conector en la misma.
Nota: el instalador todavía no está firmado, por lo que Windows SmartScreen advierte en el primer arranque. Compruebe antes la suma de verificación que se muestra junto a la descarga.
Descargar el instalador
- En la consola, abra Directorios → Enterprise Connectors y cree el conector que quiere registrar (consulte Enterprise Connectors).
- Abra el conector recién creado. Mientras no esté registrado, su página ofrece Download for Windows junto con la versión y la suma de verificación SHA-1 del instalador.
- Descargue el instalador y cópielo en la máquina de destino.
Si no se muestra la tarjeta de descarga, el servicio de descarga no está configurado para su instancia. Solicite el paquete de instalación a su contacto de soporte.
Instalar la aplicación
- Ejecute el instalador en la máquina de destino y confirme la solicitud de elevación. Se instala para todos los usuarios y crea un acceso directo en el escritorio.
- Inicie la aplicación. En el primer arranque registra e inicia el servicio de broker local.
- La aplicación pide establecer una contraseña en el primer arranque y la solicita en cada arranque posterior. Cualquiera que tenga acceso a la máquina y a esta contraseña puede gestionar los conectores que hay en ella, así que trátela como una credencial administrativa.
La contraseña protege únicamente la ventana de gestión local. No tiene relación con su cuenta de la consola y no se utiliza para la conexión con la plataforma.
Registrar un conector
El registro vincula la instalación local con el conector que creó en la consola.
- En la consola, abra el conector y copie su URL de aprovisionamiento. Solo se muestra a los administradores que pueden editar el directorio (y la API de gestión solo la devuelve a clientes con
enterpriseConnectors.write), ya que el primer registro establece la clave de cifrado del directorio. - En la aplicación, abra Agents y elija Provision agent.
- Pegue la URL de aprovisionamiento y envíe el formulario.
La aplicación genera un par de claves, lo canjea por las credenciales permanentes del conector, instala el servicio del conector y lo inicia. En pocos segundos la consola muestra el conector como Ready.
La URL de aprovisionamiento es de un solo uso y caduca a los pocos días. Un conector ya registrado no puede registrarse una segunda vez con la misma URL. Si la URL ha caducado, elimine el conector pendiente en la consola y cree uno nuevo.
Interceptación de TLS y autoridades de certificación privadas
Si su red termina y vuelve a firmar TLS, o si el host de su plataforma utiliza un certificado de una autoridad privada, despliegue advanced TLS options durante el registro:
- Custom CA certificates (PEM) permite pegar los certificados de las autoridades en las que el conector debe confiar además del almacén de confianza de Windows. Es la vía recomendada.
- Ignore invalid certificates desactiva la verificación por completo, tanto para el registro como para la conexión permanente del conector. Utilícelo solo como medida transitoria.
Ambos ajustes pueden modificarse más tarde en la página Identity de la aplicación. Consulte Configurar y operar un Enterprise Connector.
Varios conectores para el mismo directorio
Todos los conectores de autenticación de un directorio deben ejecutarse con el mismo par de claves: el primer conector que se registra establece la clave del directorio, y el registro de cualquier conector posterior se rechaza si su clave difiere. Para añadir un segundo conector a un directorio existente:
- En la máquina que ya ejecuta un conector, abra Identity, introduzca una frase de contraseña y elija Export keypair. Guarde el bloque cifrado y la frase de contraseña en un lugar seguro.
- En la consola, cree el segundo conector y copie su URL de aprovisionamiento.
- En la segunda máquina, elija Provision agent, pegue la URL, despliegue keypair import y pegue el bloque exportado junto con su frase de contraseña.
La frase de contraseña es la única protección de la clave privada exportada y la única forma de volver a abrir el bloque. Elimine la copia exportada en cuanto el segundo conector esté en funcionamiento.
Trasladar un conector a otra máquina
Utilice los mismos pasos de exportación e importación descritos arriba y retire después la instalación antigua:
- Exporte el par de claves en la máquina antigua.
- Cree un conector nuevo en la consola y regístrelo en la nueva máquina con el par de claves exportado.
- Compruebe que el conector nuevo informa Ready y atiende los inicios de sesión.
- Desinstale el conector en la máquina antigua y elimine su registro en la consola.
Migrar un conector anterior
Si en la máquina hay instalado un conector de la versión principal anterior, la página Agents muestra un aviso Previous connector found. Al elegir Import previous connector se trasladan su registro, su par de claves y sus ajustes de directorio, y a continuación se detiene y se elimina el antiguo servicio de Windows. El conector conserva su identidad en la consola, por lo que no hace falta volver a registrarlo ni generar una nueva URL de aprovisionamiento.
Todo lo que no haya podido trasladarse se enumera como advertencia después de la importación, por ejemplo un filtro de directorio guardado en un formato antiguo que hay que volver a crear en la página Data source. Revise los ajustes del origen de datos y ejecute una prueba de conexión antes de dar por concluida la migración.
Mantenerlo actualizado
Las actualizaciones llegan en dos capas, ambas gestionadas en la página Update de la aplicación:
- La actualización de la aplicación afecta a la propia ventana de gestión. Elija Download update y después Install & restart. La ventana se cierra brevemente; los servicios de conector siguen funcionando.
- Las actualizaciones de agente afectan a los binarios del servicio. Cada versión de la aplicación incluye los binarios de conector correspondientes, por lo que, tras una actualización de la aplicación, la lista Agents marca los conectores afectados con update available. Elija Update en cada conector o utilice la tarjeta Agent updates de la página Update. El servicio del conector se reinicia como parte de la actualización.
Cuando varios conectores sirven a un mismo directorio, actualice uno cada vez para que los inicios de sesión sigan funcionando durante el reinicio. La página Release notes de la aplicación enumera los cambios de cada versión.
Iniciar, detener y reiniciar
La lista Agents ofrece Start, Stop y Restart para cada conector instalado. Una parada se conserva: el conector permanece detenido entre reinicios hasta que vuelva a iniciarlo.
Mientras un conector de autenticación está detenido, su directorio no tiene ninguna vía hacia Active Directory o LDAP, salvo que otro conector de ese directorio esté en línea. Los inicios de sesión de los usuarios de ese directorio fallan durante ese periodo y las sincronizaciones programadas se omiten.
Desinstalar
Eliminar un conector concreto
- En la aplicación, abra Agents y elija Stop para el conector. La desinstalación solo se ofrece para un conector detenido.
- Elija Uninstall. El servicio de Windows se detiene y se elimina, y se borra la carpeta local del conector.
- En la consola, elimine el registro del conector en Directorios → Enterprise Connectors.
Si se elimina el último conector de autenticación de un directorio, ese directorio se queda sin conexión con su origen: los inicios de sesión y la sincronización se detienen hasta que se registre otro conector. La clave compartida del directorio sobrevive a la eliminación, por lo que un conector de sustitución debe registrarse con el mismo par de claves, exportado de antemano.
Eliminar toda la instalación
- Desinstale primero todos los conectores en la aplicación, tal como se ha descrito. El desinstalador de la aplicación elimina la aplicación y el servicio de broker local, pero no los servicios de conector que sigan registrados.
- Desinstale la aplicación desde Configuración → Aplicaciones en Windows.
- Elimine los registros de los conectores en la consola.
Resolución de problemas
- SmartScreen bloquea el instalador. Compare la suma de verificación SHA-1 que se muestra en la consola con el archivo descargado y continúe después mediante Más información → Ejecutar de todas formas.
- El registro falla con un ticket caducado o desconocido. La URL de aprovisionamiento es de un solo uso y de vida corta. Elimine el conector pendiente en la consola, cree uno nuevo y regístrelo con su URL nueva.
- El registro se rechaza por una clave pública distinta. Otro conector del mismo directorio se registró con un par de claves diferente. Exporte el par de claves del conector en funcionamiento e impórtelo durante el registro.
- El registro falla con un error de certificado. Su red intercepta TLS, o el certificado de la plataforma procede de una autoridad privada. Pegue los certificados de la autoridad en las opciones avanzadas de TLS.
- El servicio del conector no arranca. Abra Insight → Logs en la aplicación para ese conector. Un servicio que no alcanza la plataforma lo reintenta de forma continua, por lo que un fallo persistente suele deberse a una restricción de cortafuegos o de proxy saliente en el puerto 443.
- Un servicio de Windows aparece como marcado para eliminación. Cierre cualquier consola de Servicios abierta y la pestaña Servicios del Administrador de tareas, y vuelva a intentarlo. Si el estado persiste, reinicie la máquina.
- La consola muestra el conector sin conexión aunque el servicio está en marcha. El conector se está ejecutando, pero no consigue completar la conexión saliente. Compruebe la página Status de la aplicación y después los registros.
Véase también
- Enterprise Connectors para crear, supervisar y eliminar conectores en la consola.
- Configurar y operar un Enterprise Connector para el origen de datos, TLS, el estado, los registros y el diagnóstico.
- Directorios de usuarios para los ajustes de directorio que atiende un conector de autenticación.
Enterprise Connectors
Gestione los conectores locales que conectan su red con la plataforma para autenticación, sincronización y aprovisionamiento.
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.