Autenticar
Autentica a un usuario por login + password y devuelve la identidad
correspondiente (personId, type).
Opcionalmente acepta un challenge y nonce de Proof of Work obtenidos del endpoint
Generar desafío.
Cuando se proporcionan, el servidor valida que SHA-256(challenge + nonce) <= target antes
de verificar las credenciales. Esto previene ataques de fuerza bruta al exigir trabajo
computacional antes de cada intento de inicio de sesión.
Importante: Los campos challenge y nonce son actualmente opcionales por
compatibilidad. Se volverán obligatorios en una versión futura.
Todos los clientes deben integrar el flujo de Proof of Work lo antes posible.
Una credencial incorrecta responde siempre el mismo 401 — la respuesta
nunca indica si el login existe. Después de 8 intentos fallidos para el
mismo login, el endpoint responde 429 y deja de verificar la
contraseña durante 15 minutos; un inicio de sesión exitoso reinicia el
contador.
Try-it values populated from environment ACME (Demo)
Autenticación
Token
Most Connect endpoints require a valid x-guper-authorization token.
Token issuance itself (/api/connect/auth) is the exception — it
uses the x-guper-apikey and x-guper-apisecret credentials.
Encabezados
Cuerpo de la petición
Content-Type:
json