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
Sección titulada «Quién firma»| 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.
Llaves de acceso, no criptomonedas
Sección titulada «Llaves de acceso, no criptomonedas»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.
Dar de alta a un funcionario
Sección titulada «Dar de alta a un funcionario»-
Invitar. Un administrador envía un enlace de invitación desde la consola, o da de alta al funcionario desde el mismo dispositivo.
-
Crear una llave de acceso. El funcionario abre el enlace y crea una llave de acceso con el aviso de su propio dispositivo.
-
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:
-
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). -
Durante el resto del turno, “Registrar un paso” firma con la llave de la sesión, sin un aviso por cada paso.
-
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"]).
Custodia
Sección titulada «Custodia»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.