Pular para o conteúdo principal

Login

O GranaTech utiliza um processo de autenticação baseado em tokens para manter as sessões dos usuários. Este guia explica como realizar o login e autenticar o usuário usando curl ou ferramentas similares.

Fluxo de Login​

  1. O usuário envia suas credenciais (nome de usuário e senha) para o endpoint de login.
  2. Se as credenciais forem válidas, o servidor retorna um objeto JSON contendo informações do usuário e tokens de sessão.
  3. Estes tokens devem ser incluídos em todas as requisições subsequentes para autenticação.

Login via curl​

Para autenticar usando curl, siga estes passos:

1. Enviar credenciais​

curl -X POST https://bff-dev.granatech.com.br/api/auth/signin \
  -H "Content-Type: application/json" \
  -d '{"id":"seu_username","password":"sua_senha"}' \
  -i

O parâmetro -i é usado para incluir os cabeçalhos na saída.

Exemplo de resposta de autenticação​

Após uma autenticação bem-sucedida, você receberá uma resposta JSON semelhante a esta:

{
  "id": "1234567890.1",
  "user": {
    "id": "1234567890.1",
    "name": "Usuario Exemplo",
    "corbanId": 1,
    "roles": [
      {
        "id": "role-id-exemplo",
        "name": "ADMIN_CORBAN",
        "createdAt": "2024-10-13T23:53:40.906Z",
        "permissions": ["READ", "CREATE", "UPDATE", "DELETE"],
        "corbanId": null
      }
    ]
  },
  "session": "SEU_TOKEN_DE_SESSAO_AQUI",
  "refreshToken": "SEU_REFRESH_TOKEN_AQUI"
}

Substitua seu_username e sua_senha pelas credenciais do usuário. Após o login, use os tokens session e refreshToken nas requisições subsequentes para autenticação.