Iniciar sesiónReservar sesión

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

18 minutos de lectura

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.

Una cadena de recuadros de izquierda a derecha: «nexusctl claim-code (terminal)», «Reclamar esta instalación (navegador: código + huella digital)», «El primer administrador y la organización», «Llave de acceso (segunda verificación)», «Hoy, cuando todo es nuevo», «Seis cosas antes de que alguien inicie sesión», «Invitar a personas». Debajo del recuadro de reclamación, descienden dos ramificaciones rojas: «código demasiado antiguo: CLAIM_CODE_EXPIRED, generar un código nuevo» y «las huellas digitales difieren: CLAIM_FINGERPRINT_MISMATCH, detenerse». Una línea fina bajo los tres primeros recuadros lleva la etiqueta «cada paso desactiva definitivamente el anterior».
La primera ejecución, desde la terminal hasta la primera página Hoy, y los dos puntos en los que puede detenerse.

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.example

nexusctl 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

  1. 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.
  2. En Reclamar esta instalación, escriba el código en Grupo uno, Grupo dos y Grupo tres, un grupo de cuatro en cada uno.
  3. Compare la Huella digital de esta instalación de la página con la de la terminal, los ocho grupos, uno por uno.
  4. Si todos los grupos coinciden, marque Los ocho grupos coinciden con lo que muestra mi terminal.
  5. Pulse Reclamar esta instalación; la página confirmará la reclamación y le dará paso al primer administrador.
Reclamar esta instalación
Reclamar esta instalación
La página de reclamación. El código se introduce en tres grupos, la huella digital completa se muestra en ocho grupos de cuatro para compararla con la terminal, y la tarjeta de la derecha indica de dónde procede el código y cuántos intentos quedan.

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.

La huella digital no coincide
La huella digital no coincide
La página a la que lleva una huella digital que no coincide. Los grupos que difieren aparecen marcados y los pasos indican cómo comprobar la dirección y el certificado antes de escribir cualquier otra cosa.

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».

El primer administrador
El primer administrador
El primer administrador y la organización en una sola página. Las dos opciones que nunca pueden cambiar, el nombre corto y dónde se guardan los datos, lo indican junto al campo, y el inicio de sesión de emergencia queda sellado para la caja fuerte.

La llave de acceso (passkey): la segunda verificación

  1. Pulse Configurar la llave de acceso e iniciar sesión.
  2. 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.
  3. 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.

Hoy, cuando todo es nuevo
Hoy, cuando todo es nuevo
La página Hoy el primer día. Cada área vacía indica qué aparecerá allí y cómo ponerlo en marcha, y «Qué ha cambiado» ya recoge la propia configuración.

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.

Seis cosas antes de que alguien inicie sesión
Seis cosas antes de que alguien inicie sesión
Seis comprobaciones en cualquier orden, contabilizadas con palabras. Las opciones que quedan fijas una vez que las personas inician sesión se enumeran junto con el motivo, para que nadie se lleve sorpresas más adelante.

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.

  1. Elija el proveedor y el estándar que utiliza.
  2. 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.
  3. Indique quién puede iniciar sesión, por ejemplo, cualquier persona con una dirección @harrow.example.
  4. 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.
  5. 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.

Conecte su proveedor de identidad
Conecte su proveedor de identidad
Inicio de sesión corporativo con prueba. El proveedor, el estándar en letra pequeña y una prueba de inicio de sesión cuyo resultado se redacta con palabras antes de que nadie dependa de él.

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.

Invitar a un colega
Invitar a un colega
Una invitación elige el rol de la persona antes de que llegue, Miembro o Administrador, y puede incluir una nota breve.

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.