Versión 1.0.0-alpha.1 más reciente
Capítulo 2.12
La primera ejecución
De una instalación no reclamada a personas trabajando. Genere el código de reclamación, reclame la instalación en un navegador, cree el primer administrador con una llave de acceso (passkey), conecte el inicio de sesión de la empresa e invite a todos los demás.
Esta página fue traducida por IA a partir del original en inglés. Si algo no está claro, la página en inglés es la referencia. Leer esta página en inglés

Cuando termina una instalación, esta no pertenece a nadie. No tiene organización, ni persona, ni sesión, y nadie puede iniciar sesión. Espera a que una persona demuestre, en un navegador, que se está comunicando con la instalación que se acaba de crear. En Harrow Port Authority esa persona fue Aoife Brennan, directora de TI, con Tomás Reilly a su lado frente a la terminal. Este capítulo sigue sus primeros veinte minutos.
El orden es fijo y cada paso cierra definitivamente el anterior: reclamar la instalación, crear el primer administrador y la organización, configurar una llave de acceso y llegar a la página Hoy. Después de eso vienen los seis aspectos que hay que preparar, el inicio de sesión corporativo e invitar a todos los demás, en el orden que mejor le convenga.
Generar el código de reclamación
El código de reclamación demuestra que la persona frente al navegador también puede ver la terminal de alguien con acceso al clúster. Solo esa persona puede generar uno. Ejecute esto donde su kubeconfig alcance el clúster:
nexusctl claim-code --administrator aoife.brennan@harrow.examplenexusctl claim-code solicita al servicio de claves de la instalación, nexus-keys, que genere el código. Sin nexusctl, el mismo comando se ejecuta en el propio pod del servicio de claves:
kubectl -n nexus exec deploy/nexus-keys -- nexus-keys claim-code \
--administrator aoife.brennan@harrow.example --source "Tomás Reilly, ops terminal"--source son unas pocas palabras que indican quién generó el código. La página de reclamación las muestra bajo «Creado por», para que la persona que reclama sepa de dónde procede el código.
Code 7KQM-4TXD-PL9R works once, for 30 minutes, until 09:55 · 5 tries
Fingerprint of this installation, to compare in the browser:
3F9A C21B 77E0 5D4C 9B12 A6F3 0E88 41D7
Hay tres aspectos importantes sobre el código.
- Dura 30 minutos. Un código visto por encima del hombro de alguien pronto deja de servir.
- Permite 5 intentos. Tras el quinto intento fallido se agota, independientemente del tiempo transcurrido.
- Es para una sola persona. El correo electrónico que indique será el del primer administrador. Viaja junto con la reclamación, y el formulario del primer administrador lo muestra como fijo, sin necesidad de volver a escribirlo.
La huella digital consta de ocho grupos de cuatro caracteres y constituye la identidad propia de la instalación. Déjela en pantalla. La comparará, grupo por grupo, en el navegador.
Reclamar la instalación
- En el equipo que vaya a utilizar como primer administrador, abra la dirección de instalación de la consola, aquí
https://console.harrow.example/install. Esta le llevará a la página adecuada según el estado de la instalación: la página de reclamación mientras esté abierta, la página del primer administrador una vez reclamada, y la consola si ya ha iniciado sesión. - En Reclamar esta instalación, escriba el código en Grupo uno, Grupo dos y Grupo tres, un grupo de cuatro en cada uno.
- Compare la Huella digital de esta instalación de la página con la de la terminal, los ocho grupos, uno por uno.
- Si todos los grupos coinciden, marque Los ocho grupos coinciden con lo que muestra mi terminal.
- Pulse Reclamar esta instalación; la página confirmará la reclamación y le dará paso al primer administrador.
La reclamación hace tres cosas. Convierte a este navegador en el único lugar donde se puede crear el primer administrador. Registra quién reclamó la instalación y cuándo en el registro de auditoría. Y desactiva definitivamente la página de reclamación. A partir de ese momento, la dirección de reclamación responde que la instalación ya ha sido reclamada.
Si la huella digital no coincide, deténgase
Una huella digital diferente significa que otra instalación está respondiendo en esta dirección. Podría tratarse de una dirección mal escrita, un registro de DNS (Domain Name System) obsoleto o una máquina configurada para interceptar al primer administrador. Si la reclamara, esa máquina tendría el control de su organización.
No la reclame ni escriba el código en esa página. Cierre la página y compruebe dos cosas: que console.harrow.example resuelve a su ingress y que el certificado que muestra el navegador ha sido emitido por la CA (autoridad de certificación) que usted espera. Su propia instalación permanece intacta y aún sin reclamar.
Si se envía una reclamación con una huella digital que no corresponde a la instalación, el servicio de claves la rechaza con CLAIM_FINGERPRINT_MISMATCH (403). No se reclama nada. A continuación, la página muestra las dos huellas digitales una al lado de la otra con los grupos diferentes marcados, así como los pasos para comprobar la dirección y el certificado.
Crear el primer administrador y la organización
La página siguiente lleva por título «Dos formularios breves y estará dentro». El primer administrador puede añadir a todos los demás, y casi todo lo que aparece aquí se puede cambiar más adelante. Hay dos cosas que no se pueden cambiar, y la página las señala.
| Campo | Qué se introduce | ¿Se puede cambiar más adelante? |
|---|---|---|
| Nombre completo | Su nombre | Sí |
| Correo electrónico de trabajo | La dirección para la que se generó el código de reclamación; se muestra y no se vuelve a escribir | Es la dirección del administrador |
| Rol en Nexus | Administrador de la organización. La primera persona es siempre un administrador. | No se elige aquí |
| Segunda verificación | Llave de acceso en este portátil | Sí, se pueden añadir más |
| Nombre (de la organización) | Harrow Port Authority | Sí |
| País | Dónde tiene su sede la organización | Sí |
| Nombre corto en las direcciones | Generado a partir del nombre, como harrow-port-authority |
No. Los enlaces y las exportaciones lo utilizan. |
| Dónde se guardan los datos | Esta instalación | No. Cambiarlo más adelante implica una nueva instalación. |
| Idioma y fechas | Inglés (Reino Unido), con la fecha de hoy | Sí |
| Zona horaria | La zona horaria del servidor | Cada persona ve las horas en la suya propia |
El nombre corto consta de letras minúsculas, dígitos y guiones, de hasta 100 caracteres, generado a partir del nombre de la organización sin acentos. Revíselo antes de pulsar nada. Aparece en todos los enlaces que las personas comparten y en todas las exportaciones que realizan, mientras exista la organización.
En esta página también se establece una contraseña. Nunca es suficiente por sí sola: un administrador jamás inicia sesión únicamente con una contraseña. La segunda verificación, más abajo, es lo que permite iniciar sesión.
Al mismo tiempo se genera un inicio de sesión de administrador de emergencia. Se sella y se imprime una sola vez para guardarlo en la caja fuerte. Solo funciona cuando el inicio de sesión corporativo está caído, y cada uso queda registrado y se notifica a todos los administradores. Guárdelo en la caja fuerte el mismo día que lo imprima.
La página también indica que no se informa a Adverant de quién es usted. Estos datos permanecen en la instalación. Una licencia incluye el nombre de la empresa, nunca el de las personas que la integran.
Pulse Crear e iniciar sesión. La creación del administrador y de la organización tarda unos segundos. La página responde «Creado para aoife.brennan@harrow.example. Ahora configure su llave de acceso: así es como iniciará sesión».
La llave de acceso (passkey): la segunda verificación
- Pulse Configurar la llave de acceso e iniciar sesión.
- Su navegador le pedirá que cree una llave de acceso. En un portátil con Touch ID o Windows Hello, confirme con su huella, rostro o PIN. Si el equipo no puede crear una llave de acceso por sí mismo, el navegador muestra un código QR (respuesta rápida): apunte hacia él con la cámara de su teléfono y siga las instrucciones en el teléfono.
- La página responde «Su llave de acceso está configurada y ha iniciado sesión como aoife.brennan@harrow.example.» y abre la consola.
Dispone de diez minutos desde que pulsa Crear e iniciar sesión para crear la llave de acceso, en el mismo navegador. Pasado ese tiempo, la configuración se cierra y el administrador existe sin llave de acceso. Un operador tendrá que ayudar, tal y como se describe más abajo en el apartado de reintentos.
A partir de ahora, el primer administrador inicia sesión con esa llave de acceso. La contraseña completa de un administrador, escrita por sí sola, nunca abre una sesión: el servicio de inicio de sesión responde solicitando la segunda verificación. Esa es una propiedad del diseño y la razón por la que la llave de acceso es importante. Perder una llave de acceso significa perder la forma de entrar, así que añada una segunda, en un teléfono o en una llave de seguridad, el primer día.
Más adelante, las personas inician sesión en la instalación con una llave de acceso, con Google, con GitHub o con el inicio de sesión de su empresa, según lo que permita la organización.
| Código | Qué significa | Qué hacer |
|---|---|---|
PASSKEY_UNSUPPORTED |
Este navegador no puede crear una llave de acceso. No se ha configurado nada. | Abra la página en un navegador compatible con llaves de acceso, en el mismo equipo. |
PASSKEY_CANCELLED |
El aviso se cerró o no se eligió nada a tiempo. No se ha enviado nada. | Vuelva a pulsar el botón. |
La primera página Hoy
La consola se abre en Hoy, y el primer día casi todo está vacío. Cada área vacía explica qué aparecerá allí y ofrece el botón para ponerlo en marcha; así, «Necesita un administrador» indica que las solicitudes esperarán allí una vez que se incorporen personas, con el botón Invitar a personas a su lado. La lista de comprobación de configuración indica cuántos pasos se han completado, en cualquier orden. El único historial real, la propia configuración, ya figura bajo «Qué ha cambiado»: la instalación configurada y la llave de acceso del primer administrador creada.
Seis cosas antes de que alguien inicie sesión
La página Seis cosas antes de que alguien inicie sesión enumera lo que debe cumplirse antes de invitar a las personas. No es un asistente paso a paso. Hágalo en cualquier orden y la página llevará la cuenta («Tres de seis cumplidas»).
| Elemento | Qué hace que se cumpla |
|---|---|
| Licencia | Una licencia Enterprise importada. Capítulo 2.13, Licencias. Community no necesita licencia. |
| Dirección y certificado | La dirección pública responde con un certificado cuya cadena está completa. |
| Copias de seguridad | Una programación de copias de seguridad establecida, con un destino en el que se pueda escribir. |
| Inicio de sesión corporativo | Conectado y probado. Hasta entonces, las personas utilizan llaves de acceso. |
| Correo | Un servidor de correo configurado. Hasta entonces, no se pueden enviar invitaciones. |
| Modelo de IA | Un modelo de IA (inteligencia artificial): una clave de modelo de la organización o un modelo en su propio hardware. Hasta entonces, el asistente permanece a la espera. Capítulo 2.14, Proveedores y modelos de IA. |
Invitar a personas se habilita cuando se cumplen las seis.
La misma página enumera lo que queda fijo una vez que las personas inician sesión, explicando el motivo en cada caso: el nombre corto en las direcciones, dónde se guardan los datos y el custodio de claves (las claves pueden pasar de un custodio por software a hardware, pero nunca a la inversa). También se incluye el nombre de la organización, porque conviene revisarlo, aunque se puede cambiar.
Nexus no responderá a la solicitud de IA de nadie hasta que la organización disponga de un modelo. No hay ninguna clave compartida detrás de una instalación ni ningún sistema de respaldo, por lo que una organización sin clave de modelo recibe un rechazo directo que indica al administrador qué debe añadir.
Inicio de sesión de la empresa
La mayoría de las organizaciones quieren que las personas inicien sesión con las cuentas que ya tienen. Conecte su proveedor de identidad en la página de inicio de sesión corporativo: mediante OIDC (OpenID Connect) en Community, o mediante OIDC o SAML (Security Assertion Markup Language) en Enterprise.
- Elija el proveedor y el estándar que utiliza.
- Introduzca la identidad de la aplicación y el secreto de la aplicación que le haya facilitado su proveedor de identidad. El secreto no vuelve a mostrarse nunca después de guardarlo.
- Indique quién puede iniciar sesión, por ejemplo, cualquier persona con una dirección
@harrow.example. - Pulse Probar inicio de sesión e inicie sesión con su propia cuenta. El resultado explica con palabras quién ha iniciado sesión y qué ha enviado el proveedor.
- Guarde.
Community dispone de un inicio de sesión corporativo para la organización. Enterprise añade la obligatoriedad y la sincronización de directorio. La obligatoriedad desactiva las contraseñas, de modo que todo el mundo debe utilizar el inicio de sesión corporativo, y cualquier intento con contraseña se rechaza con SSO_REQUIRED y un botón hacia la vía de acceso correcta. La sincronización de directorio copia personas y grupos de su directorio cada 15 minutos, y puede asignar el rol de administrador a partir de un grupo designado.
Cuando el inicio de sesión corporativo deja de responder, las personas que ya habían iniciado sesión mantienen su sesión abierta, y los nuevos inicios de sesión se rechazan con IDP_UNREACHABLE (503). En ese caso, un administrador puede utilizar el inicio de sesión de administrador de emergencia de la caja fuerte, junto con su llave de acceso. Cada uso se anota en el registro de auditoría, se comunica a todos los administradores y finaliza al cabo de cuatro horas o cuando vuelve a funcionar el inicio de sesión corporativo.
Invitar a personas
Una vez configurado el correo, invite a las personas desde la página Personas. Para cada una, indique su correo electrónico y un rol:
- El Miembro utiliza todo lo que tiene la organización y no cambia ningún ajuste.
- El Administrador también gestiona personas, modelos, presupuestos y ajustes.
Una invitación dura 7 días. La persona la abre, ve quién la ha invitado, su rol y lo que verá, e inicia sesión. En su primer inicio de sesión se le solicita una segunda verificación.
Los miembros invitados inician sesión en la consola y realizan allí su trabajo diario: Hoy, el asistente, el chat de equipo, archivos y búsqueda, cuadernos, agentes y flujos de trabajo, según lo permita su rol. Los administradores ven además las páginas de administración. Un miembro que abre una página de administrador recibe la página «No es administrador». Esta muestra los ajustes en modo de solo lectura, explica el motivo y ofrece la opción de solicitarlo a un administrador.
Los registros requieren aprobación
Las personas también pueden solicitar unirse registrándose por su cuenta. En una instalación, el registro de un desconocido no crea una cuenta operativa. nexus-auth lo rechaza con SIGNUP_REQUIRES_APPROVAL (403) y lo retiene a la espera de la aprobación de un administrador.
Existen otros dos controles de registro en el servicio alojado de Adverant que están desactivados en todas las instalaciones, sin ninguna opción para activarlos. El CAPTCHA de internet requeriría conexión a internet en cada registro. El filtro de red de registro requeriría una base de datos de geolocalización con licencia que la instalación no incluye. La aprobación es la barrera de entrada de la instalación.
Reintentos, códigos caducados y otros rechazos
Cada rechazo durante la primera ejecución explica qué ha ocurrido, confirma que no ha cambiado nada cuando así sea e indica qué hacer a continuación.
| Código | Estado | Cuándo | Qué hacer |
|---|---|---|---|
CLAIM_CODE_EXPIRED |
410 | Han pasado los 30 minutos. No se ha reclamado nada y nada ha cambiado. | Genere un código nuevo con nexusctl claim-code --administrator <email> y, a continuación, pulse Tengo un código nuevo. |
CLAIM_FINGERPRINT_MISMATCH |
403 | La huella digital enviada no es la de esta instalación. | Deténgase. Compruebe la dirección y el certificado. |
TRANSITION_NOT_PERMITTED |
409 | Se ha vuelto a solicitar un paso que ya se había realizado: la reclamación en una instalación ya reclamada, o el primer administrador por segunda vez. | Inicie sesión en la consola; el primer administrador añade a todos los demás. |
TRANSITION_NOT_PERMITTED |
409 | El paso de la llave de acceso, desde un navegador sin ningún primer administrador en espera, o pasados sus diez minutos. | Véase más abajo. |
RATE_LIMITED |
429 | Demasiados intentos en las páginas de primera ejecución en un minuto. No se ha enviado nada. | Espere los segundos que indique la página y vuelva a intentarlo. |
Un código sin intentos restantes muestra el mensaje «A este código no le quedan intentos». Genere uno nuevo, igual que con un código caducado. Solo puede hacerlo alguien con acceso al clúster, que es precisamente de lo que se trata.
Las páginas de primera ejecución admiten 20 intentos por minuto entre todas ellas. Si usted no ha realizado esos intentos, otra persona en su red está probando la página, y conviene saberlo.
Cuando se ha omitido el paso de la llave de acceso
Si se creó el primer administrador pero no se generó ninguna llave de acceso en el plazo de diez minutos, o si se cerró el navegador, el administrador existe pero no tiene forma de iniciar sesión. El paso de la llave de acceso responde TRANSITION_NOT_PERMITTED con las palabras «Si creó el primer administrador en este navegador hace más de diez minutos, acuda a un operador: el administrador existe y aún no tiene llave de acceso». En ese momento la reclamación ya se ha consumido, por lo que un nuevo código de reclamación no servirá de ayuda. Consulte al operador que ejecutó la instalación antes de intentar cualquier otra cosa.
Cuando el navegador ha perdido la reclamación
La reclamación reside en el navegador que la realizó, en una cookie que la página no puede leer. Si ese navegador la pierde entre la reclamación y la creación del primer administrador —por ejemplo, en una ventana privada que se ha cerrado—, el formulario del primer administrador también acepta el archivo de reclamación y su secreto de configuración, pegados manualmente.
Una vez que Aoife tuvo su llave de acceso, Tomás cerró su terminal. La página de reclamación estaba desactivada, el primer administrador ya existía y cualquier otra vía de entrada pasaba ahora por ella.






