Entrar

Generar desafio

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

Genera un desafio Proof of Work que debe resolverse antes de autenticarse. El cliente calcula SHA-256(challenge + nonce) hasta que el hash sea lexicograficamente menor o igual al target retornado. El nonce resuelto se envia junto con las credenciales de inicio de sesion al endpoint Auth.

Cada nuevo challenge para el mismo login invalida el anterior, impidiendo ataques de fuerza bruta en paralelo. La dificultad escala exponencialmente segun el numero de solicitudes de challenge dentro de una ventana deslizante de 15 minutos.

Try-it values populated from environment ACME (Demo)

Modes

Llamado por servicios internos (panel Admin, otros microservicios) usando autenticacion por firma RSA.

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: application/json

{
    "login": "maria.silva"
}

Respuestas

{
    "challenge": "a1b2c3d4e5f6...64 hex characters",
    "target": "0000ffffffffffff...64 hex characters"
}
Copied to clipboard