Proteger el acceso con un código de un solo uso
XOA-HL puede pedir un código de un solo uso de seis cifras de una aplicación de autenticación después de la contraseña. El código cambia con el tiempo (TOTP). Cada cuenta que accede con contraseña local lo activa para sí misma. Pruébelo primero con una cuenta sin permisos de administrador creada para esta prueba.
v5.113.2_e281c536-ce47 (ca44911, Xen Orchestra 5.113.2). El inicio de sesión y la ventana de tiempo del código se probaron el 28 de octubre de 2026 con una única cuenta desechable sin privilegios de administrador en la ejecución de laboratorio D3. El interruptor de la página de usuario y el diálogo QR, el botón Remove de Settings, un reloj incorrecto del appliance y los tokens creados después de activar OTP no se probaron en esa ejecución ce47; los controles de configuración y eliminación descritos abajo se basan, para ce47, en la revisión del código fuente fijado. Una ejecución posterior de validación del RPM ce51 probó esos casos por separado. Sus resultados no establecen el comportamiento del appliance ce47. Las versiones posteriores pueden diferir.Antes de empezar
| Necesita | Por qué |
|---|---|
| Una aplicación de autenticación TOTP en un dispositivo bajo su control | Genera los códigos a partir de un secreto compartido |
| La hora correcta en el appliance y en ese dispositivo | XO acepta el código actual y los de los intervalos de 30 segundos inmediatamente anterior y posterior |
| Otro administrador o un plan de recuperación independiente | Sin ello, perder el dispositivo puede bloquear al único administrador |
| Una sesión de navegador que mantendrá abierta durante la prueba | Permite quitar el código si falla la comprobación |
El navegador comprueba el código introducido durante la configuración usando su propio reloj. Al acceder, el appliance comprueba el código con su reloj. Por tanto, que un código sea aceptado al configurarlo no demuestra que la hora del appliance sea correcta.
Active un código de un solo uso para su cuenta
- Acceda con la cuenta que desea proteger. Abra su página de usuario mediante el icono de usuario del menú (
/#/user). - Busque el interruptor OTP authentication y actívelo. El diálogo Add OTP authentication muestra un código QR y el secreto como texto.
- Escanee el QR o escriba el secreto en la aplicación de autenticación. La nueva entrada tiene como emisor
Xen Orchestray como nombre el correo o identificador de la cuenta. - Introduzca el código actual en OTP code y confirme. Si es incorrecto, el diálogo se abre de nuevo: introduzca el código que muestra ahora la aplicación. Cancel deja desactivado el código de un solo uso.
Si falta el interruptor, deténgase y anote la versión instalada. Esta compilación usa el plan de código abierto predeterminado de XO, que muestra el interruptor; la causa no es la falta de suscripción. Informe de la diferencia.
Comprobación: el interruptor está activado y su página de usuario muestra el secreto y su QR al lado. Cualquiera que los vea puede generar códigos válidos: no comparta la página ni haga capturas. Este QR identifica al emisor como XenOrchestra (sin espacio) para el mismo secreto. Conserve la entrada que ya tiene en la aplicación; no vuelva a escanearlo.
Compruebe el acceso en una sesión nueva
- Mantenga abierta la sesión actual. Abra una ventana privada del navegador y acceda con su usuario y contraseña.
- Una segunda página pide un Code. Introduzca el código actual de la aplicación y seleccione Sign in.
- Un código erróneo o caducado muestra
Invalid code. Espere al siguiente e inténtelo de nuevo. - Compruebe que ha accedido a la cuenta correcta y cierre la ventana privada.
El laboratorio ce47 aceptó el código actual y los códigos del paso de 30 segundos inmediatamente anterior o siguiente. Se rechazaron los códigos de dos pasos antes o después. Es una ventana de tiempo, no una garantía de que un código sea válido exactamente 30 segundos después de leerlo.
Comprobación: el acceso pidió un código y aceptó el correcto. Si sigue fallando, use la sesión abierta para quitar el código, compruebe ambos relojes y actívelo de nuevo.
Lo que no protege un código de un solo uso
- El mismo código puede volver a usarse dentro de su ventana de tiempo aceptada. No lo considere consumido tras un inicio de sesión correcto.
- Los códigos erróneos repetidos no provocan un bloqueo OTP en el flujo ce47 probado: tras cinco códigos erróneos, el correcto se aceptó de inmediato. Mantenga una contraseña robusta.
- Activarlo no termina las sesiones existentes ni revoca tokens. Todo token de autenticación válido omite la comprobación del código, incluso los creados después: los tokens son credenciales independientes. Tras activarlo, abra Authentication tokens en su página de usuario y elimine los que no reconozca o ya no necesite. Un script que use un token eliminado dejará de funcionar.
- Solo protege el acceso web de XO para esta cuenta. No protege SSH ni la consola del appliance, XO Lite ni la cuenta root del host, ni otras cuentas de XO.
- Los proveedores externos de acceso y su autenticación multifactor quedan fuera del alcance de esta guía.
Quite un código de un solo uso
- Su propia cuenta: en su página de usuario, desactive OTP authentication y confirme Remove OTP authentication.
- Otra cuenta, como administrador: abra Settings → Users. En la columna OTP, seleccione Remove para esa cuenta y confirme. Compruebe primero quién lo solicita, por ejemplo por otro canal. Después el usuario podrá configurar un dispositivo nuevo.
Las cuentas sin código muestran Not configured en esa columna. Si el único administrador pierde el dispositivo, la interfaz no ofrece una vía de acceso. Desde la consola del appliance todavía puede recuperar el acceso de administrador. Es más sencillo tener un segundo administrador: mantenga uno.
Comprobación: el interruptor está desactivado y la columna OTP de la cuenta muestra Not configured. En una ventana privada nueva, la cuenta accede con su usuario y contraseña locales sin código. Mantenga conectado al administrador de recuperación hasta confirmarlo.
Fuentes
- Página de usuario y configuración: sección OTP de la página de usuario, página de usuario y tokens, diálogo de configuración, acciones de activación y eliminación, columna OTP en ajustes de usuarios.
- Acceso y tokens: páginas de acceso, formulario de acceso, autenticación y omisión por tokens, ventana temporal TOTP, comando de recuperación, etiquetas de interfaz.
- Compilación y configuración del navegador: plan predeterminado XO, autenticador del navegador, API de preferencias del usuario, compilación HomeLab.