¶ [Tutorial] Integração da assinatura avançada ao seu sistema
¶ Introdução
Esse documento, tem como objetivo ajudar a implementação da assinatura externa de documentos dentro do Assine Aqui.
¶ Informações do Documento
É necessário obter algumas informações iniciais antes de implementar a assinatura via assine aqui, que são:
- Id do documento que deseja assinar;
- Nome do documento que deseja assinar;
- Id do sistema cliente (ClientId) que fará a integração;
- String do corpo do documento que deseja assinar.
- URL de retorno para a aplicação de origem.
¶ Criação da URL de assinatura
Após reunir essas informações, será necessário criar a URL para a integração, segue o exemplo abaixo:
¶ Integração ao seu sistema
A premissa da utilização da assinatura avançada do Assine Aqui, consiste na utilização de uma Popup criada via Javascript para abrir a tela de assinatura externa a partir de qualquer sistema que queira integrar, a Popup deverá ser criada e redirecionada para a URL de assinatura criada acima:
Figura 1: Tela inicial de assinatura externa
¶ Assinando com o Gov.br
Ao selecionar para entrar com o Gov.br, ele pedirá seu usuário e senha do Gov.br e em seguida mostrará as informações do documento e do assinante, assim como, o provedor de assinatura e o sistema de origem:
Figura 2: Tela de assinatura via Gov.br- Confirmação da Assinatura
Após carregar a tela, ele pedirá seu CPF para gerar um código de confirmação com validade de 5 minutos que será enviado para seu e-mail cadastrado no Gov.br:
Figura 3: Tela de assinatura via Gov.br - Código de Confirmação
Assim que receber o código de confirmação no seu e-mail, é só inseri-lo no seu respectivo campo, também é possível reenviar o código caso seja necessário, depois de informado o código é só clicar em assinar e uma tela confirmando a assinatura irá aparecer, conforme figura 4:
Figura 4: Tela de assinatura via Gov.br - Confirmação da Assinatura
¶ Conclusão
Após esses passos, a integração com a assinatura externa do Assine Aqui estará concluída.