Autenticação da Solução

Como Realizar Autenticação da Solução

Para acessar as funcionalidades que requerem maior privilégio, a autenticação deve ser feita a nível de solução. Para isso, é necessário autenticar utilizando a chave Master, conforme segue:

Passo 1. Solução parceira deve possuir uma chave master habilitada, em caso de dúvidas, nosso time de RC poderá apoiar no processo de obtenção da chave master. Com esta chave em mãos, vamos para os próximos passos.

Passo 2. Obter uma chave pública através da URL /Authenticate/GetPublicKey

Passo 3. Encriptar a chave de acesso master (Key) utilizando a chave pública da Solução Fiscal. Para encriptar, utilize o algoritmo de criptografia RSA (tamanho de chave 2048).

Passo 4. Enviar a chave de acesso master (Key) encriptada no formato base64 na tag key para realizar o login da Solução na API de Autenticação da Solução Fiscal

Passo 5. Realizar a autenticação com a chave master através da URL /Authenticate/MasterLogin para obter o token de autorização, conforme exemplo abaixo.
 

Exemplo

{

   "key": "string",

   "solutionId": 123

}

Em caso de sucesso será retornado o Token que dará acesso as APIs da Solução Fiscal que exigem esse nível de acesso, além do tempo de expiração do token em segundos.

Possíveis retornos HTTP

• 200 - OK
• 400 – Ocorreu um problema na requisição
• 401 - Sem Autorização
• 429 – Muitas Solicitações
• 500 – Erro Interno do Servidor
• 503 - Serviço Indisponível