Realizando Login no Cerberus

Neste tutorial vamos aprender o seguinte:

1. Como realizar uma requisição para efetuar login com uma aplicação client no Cerberus;
2. Como testar se a requisição foi aceita e retornou as informações corretamente;
3. Como realizar login com um usuário (servidor tce);
4. Como usar o access_token retornado para efetuar requisições para a api;

Obtendo um token para acessar a API.

Enviando a requisição para fazer o login com a aplicação client

Exemplo de como realizar a requisição.

1. Para obter o token é preciso enviar uma requisição do tipo POST para o endpoint http://localhost:9999/oauth/token, onde será necessário enviar o Authorization do tipo Basic Auth, usando o Username e o Password. O Username é o nome do client (por exemplo: meuApp). O Password é a Secret, e será preciso definir um header Content-Type=application/x-www-form-urlencoded e como Body definimos grant_type=client_credentials.
   

   Exemplo de requisição de uma aplicação client usando o postman.

   
   
2. Exemplo de como deve ser enviado o Authorization
   
   
   
3. Exemplo de como deve ser enviado o Body
   
   
   
   
4. Se tudo der certo o Cerberus irá retornar o access_token da aplicação client.
   
   
   
   

Para decodificar o access token pode ser usado o site jwt.io.

https://jwt.io/

Efetuar login na API com usuário (servidor tce).

Para efetuar o login com um servidor do tce é preciso enviar uma requisição do tipo POST para o endpoint de login do Cerberus, por exemplo: http://localhost:9999/login definir o tipo como x-www-form-urlencoded com os seguintes parâmetros:  sistema, login, password, tipoUsuario e clientId; 

1. sistema - id e nome do sistema cliente que o usuário deseja realizar o login, exemplo: 17:diligencia;
2. login - login de rede do servidor tce;
3. password - mesma senha do usuário de rede;
4. tipoUsuario - será informado o valor 1 que indica que é um servidor tce;
5. clienteId - da aplicação client, exemplo: diligencia;
   
   

   Exemplo de requisição de como efetuar login como um servidor do tce usando o postman.

   
   
   
6. Se tudo deu certo você será redirecionado para aplicação a qual deseja acessar e receberá um access_token;

Realizando uma requisição para um endpoint da api.

Depois que o usuário conseguiu efetuar com sucesso o login ele está liberado para fazer requisições;

Para fazer uma requisição para API será necessário informar um endpoint, por exemplo: http://localhost:9005/servidor/id_servidor e no header informar um Authorization do tipo Bearer token.

Observação.: Esse id do servidor foi obtido ao decodificar o token. Foi necessário passar o id do servidor apenas para testar esse endpoint;

1. Exemplo de como deve ser enviado a requisição para consumir um serviço da API
   
   Exemplo de como consultar um servidor pelo seu id
   
   
   
2. Se ocorreu tudo corretamente será retornado o que foi consultado;