Errores que evitar

Lee esta página antes de cada etapa del despliegue. Cada fila indica lo que ves cuando el error te alcanza, cómo evitarlo y la página que contiene el procedimiento completo. Las cinco primeras filas de la página de inicio son las que frenan más despliegues.

Antes de recibir tu organización

Error	Lo que ves	Cómo evitarlo	Detalles
Una regla de tráfico saliente que permite la consola pero olvida los destinos de la instalación	La instalación falla antes de que el cliente llegue nunca a la consola, y parece un producto roto más que una ruta cerrada	Permite el registro de paquetes o tu espejo, openlatch.ai para los scripts de instalación y github.com para una instalación con npm	Requisitos de red
Permitir por dirección IP	La ruta funciona un tiempo y luego se rompe	No hay ningún rango de direcciones estático. Permite app.openlatch.ai por nombre y SNI	Requisitos de red
Un proxy solo NTLM	El cliente no puede autenticarse ante el proxy en ninguna máquina	NTLM no es compatible, por diseño. Prevé una ruta Kerberos (Negotiate) o sin autenticación para el cliente antes de la primera oleada	Requisitos de red
Un archivo de configuración automática de proxy en Linux	La instalación rechaza la ruta de configuración automática	Define la ruta explícitamente en Linux. El sistema operativo evalúa la configuración automática solo en Windows y macOS	Requisitos de red
Puntos de acceso de modelos almacenados en búfer o con inspección de flujos en un proxy	El agente parece atascarse y luego lo imprime todo de una vez	Mantén los puntos de acceso a los que ya llegan tus agentes exentos del almacenamiento en búfer de respuestas y de la inspección de flujos	Requisitos de red
Una plataforma no compatible en la oleada	La instalación no tiene paquete para la máquina	Windows en ARM64 y las distribuciones Linux basadas en musl, como Alpine, no son compatibles. Comprueba las versiones mínimas en la lista de comprobación	Lista de comprobación de requisitos previos
Una máquina compartida tratada como una sola instalación	Solo queda cubierta la persona que instaló	La instalación y el estado local son propios de cada usuario. Cada usuario de una máquina compartida hace su propia instalación	Lista de comprobación de requisitos previos

Cuando recibes tu organización

Error	Lo que ves	Cómo evitarlo	Detalles
Iniciar sesión por primera vez sin la invitación, o desde otra dirección	La consola te lleva a crear una organización nueva en lugar de abrir la tuya	Abre el enlace de la invitación, desde la dirección que diste a tu contacto de OpenLatch	Primeros pasos en la consola
El navegador de un administrador no llega a challenges.cloudflare.com	La comprobación del inicio de sesión falla cada vez	Permítelo para los navegadores que inician sesión en la consola. Ninguna máquina que ejecuta el cliente lo necesita	Requisitos de red
Esperar a que aparezca el asistente de configuración	El propietario invitado de una organización creada por OpenLatch nunca lo ve por sí solo	Ábrelo desde Home › Reopen setup	Primeros pasos en la consola
Fiarse solo de la prueba de conexión del inicio de sesión único	La prueba se supera, y aun así las personas no pueden iniciar sesión	La prueba solo comprueba que la URL de metadatos o la URL de inicio de sesión del proveedor de identidad responde. Guarda primero, luego prueba y después inicia sesión tú mismo por SAML en una ventana privada antes de invitar a nadie	Primeros pasos en la consola
Dominios de correo permitidos demasiado amplios	Personas a las que no invitaste se registran en la organización	Mantén los dominios acotados y admite a todos los demás por invitación	Primeros pasos en la consola
Inscribir un parque con una clave personal	Una clave personal no puede tener host:enroll, solo su propietario la ve, y deja de funcionar cuando esa persona se marcha	Crea una clave de organización con Host enrollment en Settings › API keys, una por oleada	Primeros pasos en la consola
Desactivar Collect identity signals from endpoints	Ningún agente se asocia nunca a un propietario	Deja el interruptor activado allí donde quieras que los agentes se atribuyan a una persona	Primeros pasos en la consola
Dejar la conservación de la auditoría en su valor por defecto	Una vez activada la purga automática, los registros que superan el periodo se purgan cada 24 horas	Define el periodo de conservación y la purga automática antes de empezar el despliegue	Primeros pasos en la consola

Durante el despliegue

Error	Lo que ves	Cómo evitarlo	Detalles
Revocar la clave de una oleada antes de que sus máquinas ejecuten el cliente actual	Una máquina con un cliente anterior sigue autenticándose con la clave: deja de recibir actualizaciones, y la consola rechaza su clave (OL-1201)	El cliente actual cambia la clave por una credencial de host propia y deja de usarla una vez inscrito. Deja que la oleada se actualice antes de revocar su clave	Planificar el despliegue
Una clave pasada en una línea de comandos	El cliente la rechaza	Proporciónala desde tu almacén de secretos como archivo de clave, con --api-key-file u OPENLATCH_API_KEY_FILE, o por el entorno como OPENLATCH_API_KEY. Trata el cuerpo de un script de despliegue como legible	Desplegar el cliente
Una ruta de proxy guardada solo en las variables del shell de la instalación	La máquina sale directamente tras el siguiente reinicio	El cliente arranca con la sesión del usuario y no hereda ninguna variable del shell. Deja que la instalación registre la ruta, o proporciónala con openlatch init --proxy	Desplegar el cliente
Una contraseña de proxy dentro de la URL del proxy	El cliente rechaza la URL	Proporciona la credencial mediante OPENLATCH_PROXY o la solicitud interactiva, que la traslada a un archivo cifrado que solo puede leer su propietario	Desplegar el cliente
Un host detrás de un proxy sin exclusión del bucle local	Las llamadas del agente al cliente salen hacia el proxy corporativo, que responde con un error	Exporta NO_PROXY=127.0.0.1,localhost en el shell que lanza el agente, cuando el agente no recibe esa entrada en la instalación	Desplegar el cliente
Instalar el cliente antes que los agentes	Un agente instalado después no está conectado	Instala primero los agentes, o vuelve a ejecutar openlatch init después. Repetirlo nunca es destructivo	Desplegar el cliente
Una instalación desatendida sin --yes, o sin clave	La inscripción no puede preguntar, y se detiene con OL-1600	Ejecuta openlatch init --yes con una clave de inscripción: --api-key-file, OPENLATCH_API_KEY_FILE u OPENLATCH_API_KEY. Indica la organización con --org cuando la cuenta pertenece a varias	Desplegar el cliente
Desplegar con el inicio de sesión en el navegador	Cada máquina espera a una persona con cuenta de consola frente a un terminal, y una instalación desatendida se detiene con OL-1600	Despliega con una clave de organización, piloto incluido. El inicio de sesión en el navegador sirve para probar OpenLatch, o para una persona en su propia máquina	Desplegar el cliente
Una clave escrita en una línea de comandos en una instalación a mano	La clave acaba en el historial de tu shell	Léela en OPENLATCH_API_KEY sin escribirla en la línea, y borra la variable después de la instalación	Desplegar el cliente
Tratar Intune como un instalador interactivo	Se omiten máquinas o se instalan días después	Ejecuta un script en contexto de usuario que obtenga la clave por sí mismo, cuenta con que las asignaciones tarden días, y usa la aplicación Win32 cuando una máquina reciba su primer agente después de que terminen los reintentos del script	Desplegar el cliente
Una directiva de Jamf que se ejecuta como root	Una directiva de Jamf normalmente ejecuta sus scripts como root, así que el cliente se instala y se inscribe para root en lugar del desarrollador	Busca el usuario con la sesión iniciada en la consola y ejecuta la instalación y la inscripción como ese usuario, con launchctl asuser y sudo -u. Termina con un error cuando nadie tiene la sesión iniciada, para que el siguiente check-in lo reintente	Desplegar el cliente
Ampliar una oleada demasiado pronto	Los problemas encontrados en la oleada 1 se repiten en cincuenta máquinas	Amplía solo cuando una oleada cumpla sus criterios de salida, y ejecuta una instalación gestionada sobre una muestra antes de la ejecución completa	Planificar el despliegue

Al verificar

Error	Lo que ves	Cómo evitarlo	Detalles
Una máquina en marcha que no cubre nada	El cliente está en marcha y la consola tiene un registro, pero uno de los agentes nunca se conectó	Cuenta una máquina como terminada solo cuando openlatch doctor no informe de ningún problema	Verificar cada máquina y cada oleada
Un agente que sigue pendiente de su desarrollador	El agente está conectado en teoría pero no en la práctica	Algunos agentes piden al desarrollador que confirme la conexión una vez. Persigue esos casos antes de cerrar una oleada	Verificar cada máquina y cada oleada
Esperar ver la máquina en la consola de inmediato	La máquina falta justo después de la instalación	Aparece en las 24 horas siguientes, y en minutos en una red sana. Una hora de última actividad que deja de avanzar apunta a la ruta	Verificar cada máquina y cada oleada
Seguir un remedio de inicio de sesión en una máquina desplegada	openlatch doctor nombra openlatch system auth login, y la persona de la máquina no tiene cuenta de consola	Ejecuta en su lugar openlatch init --yes con una clave de organización	Desplegar el cliente
Esperar un propietario sin un directorio conectado	El agente queda registrado como no atribuido	Conecta un directorio, o pide a un editor que indique el propietario a mano	Primeros pasos en la consola

Al operar

Error	Lo que ves	Cómo evitarlo	Detalles
Actualizar los archivos sin reiniciar el cliente	La máquina informa de una discrepancia de versión	Termina la ventana de mantenimiento con openlatch restart, o con el cierre e inicio de sesión que tu entorno ya programa	Operar
Fijar la versión y desactivar también la comprobación	Las máquinas dejan de indicar que existe una versión más reciente	Fija la versión con OPENLATCH_AUTO_UPDATE=false y deja activado OPENLATCH_UPDATE_CHECK	Operar
Un corte prolongado	Pasado el límite de 100 MB, se descartan los registros no enviados más antiguos, con un aviso OL-1204 en el registro	Restablece la ruta antes de alcanzar el límite; mientras tanto, las políticas siguen decidiendo	Operar
Tratar una purga como una desinstalación completa	Los archivos instalados y la línea PATH se quedan en la máquina	openlatch uninstall --purge elimina el directorio de estado y la credencial guardada. Elimina los archivos instalados por separado	Desinstalar
Eliminar un agente en la consola antes de desinstalar	El agente vuelve con el siguiente evento	Retira primero el cliente de la máquina	Desinstalar
Una reejecución programada de la instalación en un host que cortaste	La gestión de equipos que vuelve a ejecutar la instalación inscribe de nuevo el host, y vuelve a contar	Protege la receta para que solo inscriba una vez: deja un marcador y omite la inscripción cuando lo encuentra. Si no, saca la máquina del ámbito de la directiva, o revoca la clave con la que se inscribe, antes de elegir Cut it off	Desplegar el cliente
Bloquear la telemetría en la red	La máquina pierde también la consola	La telemetría y los informes de fallos viajan con el tráfico propio del cliente. Desactívalos en el cliente	Tratamiento de datos y seguridad
El bundle del certificado de relé en una URL pública, en un repositorio o en una capa de imagen	Nada al principio; quien lo tenga puede interceptar cada máquina que confíe en él	Guarda el bundle en tu almacén de secretos; impórtalo en tiempo de ejecución en los contenedores	Usar el certificado de relé de tu organización
El bundle, con su clave privada, enviado por la gestión de dispositivos	El perfil se instala, y la clave llega al canal de gestión de cada máquina	Envía solo relay-ca.cer, el certificado público	Usar el certificado de relé de tu organización
Una clave EC escrita con parámetros de curva explícitos, lo que LibreSSL escribe por defecto en macOS	La instalación sale con el estado 8 y OL-2111	Usa la receta RSA 3072, o una curva con nombre P-256 o P-384	Usar el certificado de relé de tu organización
La instalación ejecutada como root o SYSTEM	La CA de relé queda de confianza para la cuenta equivocada, y la persona de la máquina sigue viendo el diálogo	Ejecuta la instalación como el usuario de la máquina	Usar el certificado de relé de tu organización
Un perfil de configuración abierto a mano en macOS 13 o posterior	El certificado no es de confianza, y la instalación muestra el diálogo	Entrégalo por la gestión de dispositivos a nivel de equipo y compruébalo con openlatch doctor	Usar el certificado de relé de tu organización