Solicitar Restablecimiento de Contraseña
Inicia el flujo de restablecimiento de contraseña para un usuario de la organización.
El llamador se autentica mediante firma RSA (middleware
OriginValidation), no con un token de usuario — ya que el usuario que
solicita el reset no ha iniciado sesión. El header user-agent identifica
al sistema llamador (ej: admin, storemanager) y se verifica
criptográficamente contra la llave pública correspondiente en
etc/keys/{user-agent}.pem.
El user-agent verificado se almacena como el origin de la solicitud.
Solo el mismo origin puede confirmar el reset posteriormente — este es el
origin lock, que impide que un token emitido por un sistema sea
utilizado por otro.
Anti-enumeración: Cuando el login no existe, el endpoint retorna
{ "requested": true } sin token ni personId. El llamador no puede
distinguir esto de una solicitud exitosa y siempre debe mostrar un mensaje
genérico ("revise su correo") al usuario final.
Cooldown: Se aplica un intervalo mínimo de 5 minutos por
(organization, login). Una segunda solicitud dentro de ese período
retorna HTTP 429.
El llamador es responsable de entregar el token al usuario (correo electrónico, WhatsApp, etc.) — Connect genera y valida el token, pero no envía ninguna notificación.
Try-it values populated from environment ACME (Demo)
Autenticación
Signature
RSA signature via OriginValidation middleware. Send the user-agent
header with the calling system's name (e.g. admin) and the
signature header with the RSA-signed nonce. No x-guper-authorization
token is required — the user is not authenticated.
Encabezados
Cuerpo de la petición
Content-Type:
application/json