Entrar

Gerar desafio

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

Gera um desafio Proof of Work que deve ser resolvido antes da autenticacao. O cliente calcula SHA-256(challenge + nonce) ate que o hash seja lexicograficamente menor ou igual ao target retornado. O nonce resolvido e entao enviado junto com as credenciais de login para o endpoint Auth.

Cada novo challenge para o mesmo login invalida o anterior, impedindo ataques de forca bruta em paralelo. A dificuldade escala exponencialmente com base no numero de pedidos de challenge dentro de uma janela deslizante de 15 minutos.

Try-it values populated from environment ACME (Demo)

Modes

Chamado por servicos internos (painel Admin, outros microsservicos) usando autenticacao por assinatura RSA.

Autenticação

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.

Cabeçalhos

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.

Corpo da requisição

Content-Type: application/json

{
    "login": "maria.silva"
}

Respostas

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