Criar Chave de Acesso para Emissor

Informações Gerais

Cada cliente emissor terá sua chave de acesso (Key) individual que será utilizada no momento da autenticação.

Como Criar Chave de Acesso para Emissor

Caso a Solução Parceira ainda não possua essa chave para vincular ao cliente emissor deverá seguir os seguintes passos para obtê-la:

Criação da Chave de Acesso para Emissor:

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 (chave aberta com até 80 caracteres) 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 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

}

Passo 6. Gerar um par de chaves RSA (tamanho de chave 2048 devendo ser exportada como PKCS1), onde a chave pública será utilizada para encriptar na Solução Fiscal a chave que será retornada para o emissor.

Passo 7. Realiza a requisição para criar a chave do emissor contendo no corpo os seguintes campos: cnpj e publicKey (obtida no passo anterior em base64). Esta requisição deve 
ser enviada para a URL: /Authenticate/CreateEmissorKey. Além disso, a requisição deve incluir os seguintes cabeçalhos:

• Content-Type: application/json
• Authorization: Token gerado a partir do login com a chave de acesso master. 

O corpo da requisição deve ser enviado no formato JSON, conforme exemplo abaixo:

Exemplo de Requisição

{

 "Cnpj": "32048439000180",

 "PublicKey": "{{PublicKey}}"

"solutionId":""

}

**Retorno Sucesso (200)**

{

"emissorKey":"QXF1aV9vX3JldG9ybm9fZGasdasdasJpYWRhX2NvbV9zdWNlc3NvX3BhcmFfdW1fY25sjdalsdjalkjG8=",

"expiresIn": 2592000

}

Sendo o conteúdo de EmissorKey a chave criada e ExpiresIn o tempo de expiração da chave em segundos.

Importante

Somente uma chave do emissor será mantida ativa, ou seja, caso seja gerada uma nova chave a anterior será revogada automaticamente!

Passo 8. Descriptografar o retorno da tag “emissorKey” através da chave privada RSA gerada anteriormente, obtendo assim a chave de acesso (Key) do emissor.

Guarde essa chave com segurança.

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