Configurar assinatura
 |
 |
 |
 |
Este artigo é válido a partir da versão 3.0 do sistema, após a migração da assinatura digital e eletrônica no SoftExpert Administração. Clique aqui para acessar a documentação válida para as versões anteriores.
Pré-requisito
- Acesso ao menu Administração > Configuração > Arquivo eletrônico > Assinatura digital (AD077).
Apresentação
O SoftExpert Suite disponibiliza dois tipos de assinatura para validação de documentos: assinatura digital e assinatura eletrônica. Embora os termos sejam frequentemente utilizados como sinônimos, eles possuem características, níveis de segurança e formas de configuração distintas no sistema.
A assinatura digital é um tipo específico de assinatura eletrônica que utiliza criptografia assimétrica, baseada em um par de chaves (privada e pública), garantindo alto nível de autenticidade, integridade e não repúdio do documento. Esse tipo de assinatura é validado por uma Autoridade Certificadora, credenciada à Infraestrutura de Chaves Públicas Brasileira (ICP-Brasil), e exige o uso de um certificado digital válido.
Já a assinatura eletrônica é um conceito mais amplo, que engloba diferentes formas de validação por meios eletrônicos. No SoftExpert Documento, esse tipo de assinatura é realizado por meio de integrações com plataformas externas, permitindo a assinatura de documentos de forma prática e segura em diversos cenários, como contratos, documentos de RH, notificações e outros processos corporativos.
Neste artigo, será possível identificar quais são as diferenças práticas entre eles no sistema e como realizar a configuração adequada de cada tipo, de acordo com a necessidade da organização.
Configurar assinatura digital
1. Acesse o menu Administração > Configuração > Arquivo eletrônico > Assinatura digital (AD077).
2. Clique no botão 
da barra de ferramentas.
3. Na tela que será aberta, informe um identificador e um nome para a configuração de assinatura digital.
4. Em seguida, no campo Tipo, selecione a opção Assinatura digital e configure os campos que serão habilitados:
| Certificados permitidos |
Selecione um dos seguintes certificados digitais para ser utilizado na assinatura:
|
| Utilizar carimbo de tempo | As assinaturas digitais serão validadas com o recurso de carimbo de tempo. O carimbo de tempo é uma referência temporal digital que permite atestar que um arquivo eletrônico foi registrado num determinado instante de tempo, garantindo assim, aos documentos digitais, uma segurança equivalente àquela existente em documentos de papel. |
| Incluir carimbo da assinatura digital em arquivos PDF | Nos arquivos .pdf, será apresentado um carimbo com as informações de cada assinatura aplicada a eles. O carimbo da assinatura somente será apresentado nos arquivos assinados a partir do momento em que esta opção for marcada. Para os arquivos assinados anteriormente, o carimbo não será exibido. |
| Permitir informar o local do carimbo da assinatura | Antes de realizar a assinatura, o usuário poderá selecionar a região onde o carimbo será adicionado no arquivo PDF. Essa opção é disponível apenas se a opção "Incluir carimbo da assinatura digital em arquivos PDF" estiver marcada. |
| Realizar assinatura automática de arquivos PDF | Permite que, após convertidos para PDF, os arquivos eletrônicos dos documentos da categoria em questão sejam enviados automaticamente para assinatura pelos membros de uma determinada lista de assinantes. Para isso, configure também os campos que serão habilitados, descritos a seguir. Para que este recurso funcione corretamente, é necessário também que a conversão dos arquivos para PDF esteja devidamente configurada na categoria em questão. |
| Lista de assinantes | Selecione a lista de assinantes contendo os certificados que realizarão a assinatura dos arquivos eletrônicos dos documentos desta categoria. |
| Utilizar condição para assinar os documentos |
Restringe a assinatura automática para ser realizada apenas em arquivos eletrônicos de documentos que tiverem um determinado valor em um atributo associado a eles. Para isso, é necessário configurar os seguintes campos:
Se a opção não for marcada, os arquivos eletrônicos de todos os documentos serão enviados para assinatura automática, sem restrição por atributo. |
5. Após finalizar a configuração da assinatura, clique em 
.
6. Para a assinatura digital, é possível habilitar a função de automatizar a assinatura dos documentos com arquivos eletrônicos .pdf. Para saber como configurar esse recurso, acesse o artigo Como usar a assinatura automática.
Configurar assinatura eletrônica
1. Acesse o menu Administração > Configuração > Arquivo eletrônico > Assinatura digital (AD077).
2. Clique no botão da barra de ferramentas.
3. Na tela que será aberta, informe um identificador e um nome para a configuração de assinatura digital.
4. No campo Tipo, selecione a integração de assinatura eletrônica desejada e configure os campos que serão habilitados de acordo:
Integração DocuSign
A assinatura dos arquivos eletrônicos de documentos será realizada via DocuSign. Para isso, primeiramente, é necessário realizar as configurações necessárias no DocuSign, no modo Administrador.
Preencha os seguintes campos:
- Chave do integrador: cole o valor do campo Chave do integrador do aplicativo criado no DocuSign.
- Identificador do usuário: cole o valor do campo ID de usuário gerado pelo DocuSign.
- Chave privada: cole o valor do campo Chave privada gerado pelo Docusign.
- Utilizar ambiente de demonstração: marque esta opção para utilizar o ambiente de demonstração para testar a assinatura digital. Se esta opção não for marcada, o ambiente de produção será utilizado.
- Permitir informar local das assinaturas e rubricas: será apresentado o botão Editar no DocuSign nos dados da assinatura. Desta forma, será aberto o sistema do DocuSign para a definição dos locais de assinatura e rubricas.
- URL para Webhook: esta URL deverá ser colada no DocuSign no processo de configuração da assinatura para ser utilizada na finalização.
- URL de redirecionamento DocuSign: copie a URL de redirecionamento e cole na configuração do DocuSign após clicar em "Adicionar URL".
Clique em Conceder permissões DocuSign. Na tela que será aberta, informe o usuário e senha do DocuSign e clique em Permitir.
Defina também o tipo de modelo que será aplicado:
- Fixo: será utilizado um mesmo modelo para assinar todos os arquivos eletrônicos dos documentos desta configuração, e não será possível alterá-lo no momento da assinatura. Neste caso, no campo Selecione um modelo, associe o modelo que será utilizado para a assinatura digital. Os modelos disponíveis serão aqueles configurados por meio do menu Modelo do DocuSign. Consulte a documentação específica do DocuSign para obter a descrição detalhada sobre como criar e configurar modelos.
- Variável: permite que o modelo seja selecionado/alterado no momento da assinatura do arquivo eletrônico. Se no campo Selecione um modelo for associado um modelo do DocuSign, ele será apresentado no momento da assinatura, sendo possível editá-lo.
Integração ClickSign
A assinatura de arquivos eletrônicos de documentos será realizada via ClickSign. Para isso, primeiramente, é necessário realizar as configurações necessárias no ClickSign com um usuário que tenha suporte à API.
Preencha os seguintes campos:
- Chave do integrador: informe a Integration key do aplicativo criado no ClickSign.
- Utilizar ambiente de demonstração: marque esta opção para utilizar o ambiente de demonstração para testar a assinatura digital. Se esta opção não for marcada, o ambiente de demonstração não será utilizado.
- HMAC SHA256 Secret: informe a chave secreta fornecida pelo ClickSign.
- URL para Webhook: este campo apresenta a URL que será utilizada pelo ClickSign ao finalizar a assinatura.
- Enviar lembrete automático a cada: marque esta opção para que o Clicksign envie uma notificação aos assinantes enquanto eles não assinarem o documento. No campo ao lado, informe a frequência em que a notificação deverá ser enviada.
- Prazo para assinatura: informe o número de dias que os assinantes terão para assinar os arquivos eletrônicos dos documentos desta configuração.
Integração BRy
A assinatura de arquivos eletrônicos de documentos será realizada via BRy. Para isso, primeiramente, é necessário realizar as configurações necessárias no BRy.
Preencha os seguintes campos:
- Client ID: informe o Client_ID gerado anteriormente no BRy.
- Client Secret: informe o Client_Secret gerado anteriormente no BRy.
- Tipo de assinatura permitido: marque os tipos de assinaturas que serão permitidos para a configuração em questão.
- Utilizar ambiente de demonstração: marque esta opção para utilizar o ambiente de demonstração para testar a assinatura digital. Se esta opção não for marcada, o ambiente de demonstração não será utilizado.
- Adicionar marca d'água: marque esta opção para ser adicionada uma marca d'água nas assinaturas digitais desta configuração. Selecione no campo ao lado as respectivas páginas que deverão conter a marca.
- Prazo para assinatura: informe o número de dias que os assinantes terão para assinar os arquivos eletrônicos dos documentos desta configuração.
- Cadastrar webhook: este botão será habilitado após salvar o registro. Clique neste botão para que o sistema realize a consulta automática de informações sobre as coletas e processos de assinaturas, atualizando a situação e os eventos de assinatura eletrônica sem a necessidade de uma ação do usuário.
Integração GOV.BR
A assinatura de arquivos eletrônicos de documentos será realizada via GOV.BR. Para isso, primeiramente, é necessário receber autorização da Secretaria de Governança Digital (SGD) do Ministério da Economia (ME).
Em seguida, preencha os seguintes campos:
- Identificador do usuário: informe o identificador do usuário que foi informado junto da autorização da SGD concedida por e-mail.
- Client Secret: informe o client secret que foi informado junto da autorização da SGD concedida por e-mail.
- Utilizar ambiente de demonstração: marque esta opção para utilizar o ambiente de demonstração para testar a assinatura digital. Se esta opção não for marcada, o ambiente de demonstração não será utilizado.
- Incluir carimbo da assinatura digital em arquivos PDF: marque esta opção para que um carimbo com os dados dos assinantes seja incluído na última página do documento. Será incluído um carimbo para cada assinante.
Integração OneSpan
A assinatura dos arquivos eletrônicos dos documentos será realizada via OneSpan. Para isso, primeiramente, é necessário realizar as configurações necessárias no OneSpan.
Em seguida, preencha os seguintes campos:
- Client ID: informe o Client_ID gerado anteriormente no OneSpan.
- Client Secret: informe o Client_Secret gerado anteriormente no OneSpan.
- URL do serviço: selecione um dos servidores disponibilizados pelo OneSpan para usar na assinatura.
- Utilizar ambiente de demonstração: marque esta opção para utilizar o ambiente de demonstração para testar a assinatura digital. Se esta opção não for marcada, o ambiente de demonstração não será utilizado.
- URL para Webhook: este campo apresenta a URL que será utilizada pelo OneSpan ao finalizar a assinatura.
- Key para Webhook: informe um token de segurança para garantir segurança na chamada de assinatura.
- Prazo para assinatura: informe o número de dias que os assinantes terão para assinar os arquivos eletrônicos dos documentos desta configuração.
Integração D4Sign
A assinatura dos arquivos eletrônicos dos documentos será realizada via D4Sign. Para isso, primeiramente, é necessário realizar as configurações necessárias no D4Sign.
Em seguida, preencha os seguintes campos:
- Token API: informe o Token API gerado anteriormente no D4Sign.
- Crypt key: informe a Crypt key gerada anteriormente no D4Sign.
- HMAC SHA256 Secret: informe a HMAC SHA256 Secret gerada anteriormente no D4Sign.
- Cofre: informe o nome do cofre criado no D4Sign no momento de configurar a integração.
- Utilizar ambiente de demonstração: marque esta opção para utilizar o ambiente de demonstração para testar a assinatura digital. Se esta opção não for marcada, o ambiente de demonstração não será utilizado.
- URL para Webhook: este campo apresenta a URL que será utilizada pelo D4Sign ao finalizar a assinatura.
Integração Adobe Acrobat Sign
A assinatura dos arquivos eletrônicos de documentos será realizada via Adobe Acrobat Sign.
Preencha os seguintes campos:
Client ID: dentro do Adobe Acrobat Sign, ao clicar em “Exibir / Editar” um aplicativo de API, é exibida a informação “ID de aplicativo”. Copie o valor e cole aqui.
Client Secret: abaixo da seção “ID de aplicativo”, na seção “Client Secrets”, copie o valor exibido na coluna “Velue” e cole aqui.
Clique em Conceder permissões Adobe Acrobat Sign.
Na tela que será aberta, informe o usuário e senha do Adobe Acrobat Sign e clique em Permitir acesso.
5. Após finalizar a configuração da assinatura conforme o tipo selecionado, clique em .
Todas as informações necessárias para o preenchimento dos campos acima são adquiridas através da integração com os portais. Para saber como realizar a integração segundo o portal desejado, acesse os seguintes artigos:
Conclusão
Desta maneira, a configuração está pronta para ser associada nas categorias dos documentos que passarão por assinatura. Para isso, acesse o artigo Associar configuração da assinatura na categoria.