Inicio de sesión automático¶

El inicio automático utiliza un token de corta duración para acceder sin repetir la contraseña. Entregue el enlace solo a un usuario autenticado previamente por su sistema externo. Quien reciba el enlace obtiene acceso a la cuenta para la que se emitió el token.

Obtener un token¶

Una sesión ordinaria o clave personal solo puede emitir un token para su propio usuario. El rol administrativo no elimina esta restricción. Para que un sistema externo emita tokens para usuarios, un administrador crea un token de API con ámbito autologin/generate y lo envía en la cabecera Bearer.

Solicitud v3:

POST /watcher/client-api/v3/autologin/generate
Authorization: Bearer <token>
Content-Type: application/json

{"login":"resident-example"}

La respuesta contiene autologin_token. La solicitud admite login; el servidor fija la vigencia: cinco minutos para usar el token y ocho horas para la sesión creada.

No incluya la clave personal del usuario en la URL: el enlace requiere autologin_token de la respuesta.

Abrir la interfaz web¶

Construya el enlace codificando el token como valor del parámetro URL:

https://watcher.example.com/watcher/client/#/auth/signin/auto?autologin_token=<encoded_token>

La interfaz obtiene el token del parámetro tras #, lo intercambia mediante API y guarda la sesión. Este escenario no necesita el antiguo formulario HTML que enviaba a una ruta de inicio automático independiente.

Intercambiar el token en una aplicación propia¶

En lugar de abrir la interfaz web, la aplicación puede enviar:

POST /watcher/client-api/v3/autologin
Content-Type: application/json

{"autologin_token":"<autologin_token>"}

La respuesta contiene access_token y refresh_token, como el inicio de sesión normal en API. Las siguientes solicitudes usan Authorization: Bearer <access_token>.

Un token inválido o caducado se rechaza con un error de validación. Solicite otro al sistema de confianza. No guarde enlaces de inicio automático en registros públicos ni utilice el mismo token como enlace permanente.