Ir al contenido

Funcionarios y sesiones

Toda escritura en una HardState Log se autoriza por firma: no hay API keys ni sesiones de escritura en el servidor. Esta página trata de quién tiene las llaves: los funcionarios con llaves de acceso, las sesiones que abren y las llaves de sistema para procesos sin una persona detrás.

Quién firma Cuándo usarlo Cómo se autoriza Se atribuye a
Sesión de una persona (role: session) El equipo, la tableta o la app de campo de un empleado de ventanilla o un inspector durante su turno La persona la aprueba una vez con su llave de acceso (session.open); vence (≤ 30 días) Esa persona, por su nombre
Llave de sistema (role: system) Un proceso sin una persona detrás: una pasarela de pago, un sistema de citas, un escáner Un administrador la registra una vez (key.add), limitada a algunos tipos de paso El sistema, por su nombre
Llave de acceso, paso a paso Poco volumen, o actos de alto impacto que deben firmarse en persona Ya registrada en la bitácora de la institución Esa persona

Prefiera las sesiones para todo aquello de lo que responde una persona: la responsabilidad sigue siendo personal, y un dispositivo perdido se cierra con un clic. Use llaves de sistema solo para pasos que no realiza ninguna persona, y siempre con alcance.

Los funcionarios firman con la llave de acceso que ya tienen en su dispositivo: Face ID, Touch ID, un PIN de Windows Hello, un teléfono o una llave de seguridad física. No hay billeteras, ni tokens, ni frases semilla. Una llave de acceso es una credencial WebAuthn ligada al dominio de la institución; la llave privada nunca sale del dispositivo.

  1. Invitar. Un administrador envía un enlace de invitación desde la consola, o da de alta al funcionario desde el mismo dispositivo.

  2. Crear una llave de acceso. El funcionario abre el enlace y crea una llave de acceso con el aviso de su propio dispositivo.

  3. Aprobar. Un administrador aprueba la llave nueva. Desde ese momento queda registrada en la bitácora (key.add) y puede firmar.

Sesiones: firmar una vez, trabajar todo el turno

Sección titulada «Sesiones: firmar una vez, trabajar todo el turno»

Firmar cada paso con un aviso de la llave de acceso no funciona para una jornada de atención en ventanilla. En su lugar, el funcionario abre una sesión:

  1. El funcionario abre una sesión con un solo toque de su llave de acceso (session.open). Puede limitarla a ciertos tipos de paso y fijar cuánto dura (hasta 30 días).

  2. Durante el resto del turno, “Registrar un paso” firma con la llave de la sesión, sin un aviso por cada paso.

  3. La sesión se cierra sola cuando vence, o el funcionario (o un administrador) la cierra desde la consola en cualquier momento.

Los pasos firmados con una sesión se atribuyen a la persona que la abrió, por su nombre. Así es como el software de una institución registra los puntos de control automáticamente: el funcionario autoriza una vez la llave del software como su sesión, y a partir de ahí el software firma cada paso. Vea Integración con la API.

Llaves de sistema para procesos sin supervisión

Sección titulada «Llaves de sistema para procesos sin supervisión»

Cuando ninguna persona realiza un paso — una pasarela de pago que confirma un cobro, un sistema de citas que abre un expediente —, un administrador registra una llave de sistema (key.add) en lugar de una sesión. Es válida hasta que se revoca, se atribuye al sistema por su nombre y siempre debe limitarse al conjunto de types más reducido que funcione (por ejemplo, ["fee.paid"]).

Las llaves privadas de sesión y de sistema nunca salen de la máquina que las usa: un archivo con permisos 0600 o, mejor, un HSM o un KMS en la nube. Las llaves privadas de las llaves de acceso nunca salen del dispositivo del funcionario. HardState nunca ve ninguna llave privada, ni la necesita.

Siguiente ¿Quiere conectar esto con su propio software? Siga en Integración con la API.

HardState es una empresa de Zevlat Intelligence. © 2026 Zevlat Intelligence.