Entrar

Autenticar

POST https://{organization}.myguper.com/api/connect/auth

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

Name Type Description
x-guper-authorization * string User token issued by Guper.
Content-Type * string Always `application/json` for endpoints that accept a JSON body.

Cuerpo de la petición

Content-Type: json

{
    "login": "tintin",
    "password": "a10b20c30",
    "challenge": "a1b2c3d4...64 hex chars",
    "nonce": "48293"
}

Respuestas

{
    "personId": 44,
    "type": "user",
    "dateTime": "2023-08-24T17:13:52-03:00"
}
Copied to clipboard