Histórico da Página
Tempo aproximado para leitura: 20 min
ÍNDICE
- Visão Geral
- Configuração
- Criar Oauth Provider
- Criar Oauth App
- Permissionamento de Usuário
- Dataset Parâmeros
- Assinatura de Contratos
- (Fluig) Solicitação de Contratos - Encaminhar para Assinatura
No Workflow de Solicitação de Contratos, foi implementada a funcionalidade de Assinatura Digital de Contratos. Esta funcionalidade possibilita realizar a assinatura digital dos contratos através do Fluig, eliminando a necessidade de ter uma versão em papel do documento a ser assinado, otimizando assim o processo de aprovação dos mesmos.
A autenticação da assinatura digital será garantida pela parceira Soluti, que fornecerá um certificado digital via aplicativo (Certillion ID) para que o usuário realize a assinatura A assinatura do documento é feita através do o plug-in Vertsign e poderá ocorrer de duas formas: com ou sem certificado digital.
Nota: Funcionalidade disponível a partir da versão 12.1.24.
02. ConfiguraçãoDownload e ativaçãoa. Criar Oauth Provider - Painel de Controle / aba WCM / Oauth Provider2.1 Realizar o download do componente
Ação | Descrição |
---|---|
Acesse |
No Fluig, acesse o Painel de Controle, vá até a aba WCM / Oauth Provider
Preencha os campos obrigatórios, considerando:
- O campo oAuth Provider deve ser preenchido como "WCM";
- Os campos Acess Token URL, Request Token URL, User Authorization URL, deverão ser preenchidos com as URLs padrões da aPI Fluig, sendo elas:
Acess Token URL: http://<computername>/portal/api/rest/oauth/access_token
Request Token URL: http://<computername>/portal/api/rest/oauth/request_token
- User Authorization URL: http://<computername>/portal/api/rest/oauth/authorize
b. Criar Oauth App - Painel de Controle / aba WCM / Oauth App
No Fluig, acesse o Painel de Controle, vá até a aba WCM / Oauth App
Preencha os campos obrigatórios, considerando:
- O campo oAuthProvider deve ser preenchido com o oAuthProvider criado anterioriormente (item a).
Após adicionar o Oauth Application, selecione o mesmo e clique em Usuário Aplicativo, em seguida clique no botão Gerar Token para que o usuário seja criado.
Ao gerar um Usuário Aplicativo, automaticamente será criado um Usuário Fluig correspondente, usuário este que irá executar as assinaturas digitais dentro do processo de Solicitação de Contratos, porém, para que esta ação seja possível, é necessário permitir que este tenha acesso aos documentos a serem autenticados. Para tanto, é necessário incluí-lo aos devidos Grupos de acesso às Pastas de Contratos, conforme configuração do cliente.
Acesse o Painel de Controle, na aba Gerais / Grupos. Adicione um novo grupo.
Acesse o Painel de Controle, na aba Gerais / Usuários. Localize o Usuário Aplicativo e edite-o. Inclua o Grupo criado anteriormente e salve.
Acesse a pasta onde serão armazenadas as minutas de contrato, acesse as propriedades da mesma e vincule o grupo criado anteriormente, com o Nível de Segurança Total (T).
d. Dataset Parâmetros
Atualize o dataset dsParamsSIGAJURI com as informações do ambiente do cliente, considerando:
A coluna sOathAppPublic deve ser preenchida com o conteúdo do campo Consumer Key do Oauth App criado anteriormente;
A coluna sOathAppPrivatedeve ser preenchida com o conteúdo do campo Consumer Secret do Oauth App criado anteriormente;
A coluna OathTokenPublic deve ser preenchida com o conteúdo do campo Access Token gerado para o usuário do Oauth App criado anteriormente;
A coluna OathTokenPrivatedeve ser preenchida com o conteúdo do campo Token Secret gerado para o usuário do Oauth App criado anteriormente;
A coluna sFluigHostName deve ser preenchida com o endereço IP do cliente.
Nota: Caso o Token do Usuário Aplicativo seja renovado, os parâmetros deste Dataset deverão ser atualizados.
a TOTVS Store - https://totvs.store/br/vertsign.html - e faça o download do componente. |
2.2 Ativação do componente
Ação | Descrição |
---|---|
No fluig, com um usuário admin, acesse: Painel de Controle / Aplicativos / Central de Componentes; | Escolha o arquivo baixado e clique em “Enviar” |
Buscar o componente e ativar | Ainda na Central de Componentes, após o deploy do componente, busque por “Vert_Component”. Selecione o componente e clique em "Ativar" |
Verifique se o componente foi ativado corretamente | Após a ativação, recarregue a página e veja se a opção de menu “Vertsign” foi criada. |
03. Instalação
3.1 Formulários
Nesta etapa os formulários serão instalados para realizar o cadastro de assinantes, cadastro de parâmetros gerais do app e formulário para auxiliar no envio e retorno de documentos enviados para assinatura.
- Cadastro de Assinantes: Formulário responsável por armazenar os dados dos assinantes inseridos através da widget. O fluig irá armazenar o nome, e-mail e CPF.
- Parâmetros Gerais:Formulário responsável por armazenar os parâmetros do app. Ele será atualizado conforme a instalação é realizada.
- Formulário Auxiliar: Formulário responsável por registrar cada documento enviado para assinatura, trazendo em cada registro informações relevantes sobre o documento enviado. Este formulário não será acessado de forma direta pelo usuário.
Ação | Descrição |
---|---|
Instalar os Formulários Acessar o Menu: Vertsign Instalação e Configuração | Na sessão 1. Formulários clique no botão Instalar. |
Visualizar a pasta Vertsign | Feita a instalação, será criada uma pasta chamada Vertsign dentro da pasta raiz do fluig. |
3.2 Datasets
Esta etapa é responsável por realizar a instalação dos datasets que farão a integração entre o fluig e a Certisign.
Abaixo estão os datasets que serão instalados:
- ds_upload_vertsign: Lista todos os documentos do formulário auxiliar que estão pendentes de envio e envia para a Certisign.
- ds_package_vertsign: Verifica se os documentos foram assinados no portal de assinaturas da Certisign e retorna o manifesto para o ECM do fluig.
- ds_documents_vertsign: Lista todos os documentos que foram enviados para a Certisign. Posteriormente será utilizado para realizar o cancelamento de um documento enviado.
- ds_upload_vertsign_manual: Dataset responsável por enviar os documentos para assinatura. É executado após cada envio.
- ds_auxiliar_vertsign: Dataset responsável por auxiliar a widget executando os webservices do fluig.
- ds_delete_vertsign: Deleta um arquivo do Portal de Assinaturas da Certisign.
- ds_documents_autocomplete_vertsign: Dataset responsável por listar todos os arquivos disponíveis para envio.
- ds_admin_vertsign: Dataset responsável por listar todos os usuários administradores da plataforma.
- ds_signers_vertsign: Dataset responsável por listar todos os assinantes cadastrados.
Ação | Descrição |
---|---|
Instalar os Datasets Acessar o Menu: Vertsign Instalação e Configuração | Na sessão 2. Datasets clique no botão Instalar. |
3.2.1 Agendador de tarefas
Após a instalação, os datasets marcados como Sincronizado = Sim serão criados no Agendador de tarefas do fluig. Por padrão serão executados uma ver por dia, mas pode ser editado.
Ação | Descrição |
---|---|
Para visualizar os datasets no Agendador de tarefas basta acessar: Painel de Controle > Parâmetros Técnicos > Agendador de tarefas |
3.3 Serviços
Nesta etapa será realizada a instalação dos serviços utilizados pelo app:
- ECMCardService_Vertsign: Webservice responsável por realizar operações referentes a formulários no fluig.
- ECMCustomFieldsService_Vertsign: Webservice responsável por interagir com os campos customizados do fluig.
- ECMDocumentService_Vertsign: Webservice responsável por realizar operações referentes a documentos do fluig.
- ECMFolderService_Vertsign: Webservice responsável por realizar operações referentes a pastas no fluig.
- ECMTokenService_Vertsign: Webservice responsável por interagir com os token’s do fluig. Pode ser utilizado para pesquisar e validar os token’s existentes.
Ação | Descrição |
---|---|
Instalar os Serviços Acessar o Menu: Vertsign Instalação e Configuração | Na sessão 3. Serviços clique no botão Instalar. |
Feita a instalação dos serviços, eles poderão ser encontrados em: Painel de Controle > Desenvolvimento > Serviços |
3.4 Campo Customizado
Nesta etapa da instalação será instalado o campo customizado que será atualizado a cada alteração de status do documento enviado para assinatura.
Ação | Descrição |
---|---|
Instalar os Serviços Acessar o Menu: Vertsign Instalação e Configuração | Na sessão 4. Campo Customizado clique no botão Instalar. |
03. Instalação
Card documentos | ||||
---|---|---|---|---|
|
03. Assinatura de Contratos
(Fluig) Solicitação de Contratos - Encaminhar para Assinatura
Após a etapa Gerar Minuta Final, ao enviar o formulário, selecione a etapa Encaminhar para Assinatura no campo próxima atividade.
Será apresentado no início do formulário o grupo de campos Assinatura Digital. No campo Documento, selecione um documento em formato PDF a ser autenticado. Os usuários selecionados no campo Assinadores serão adicionados e separados por ";" no campo disposto logo abaixo.
Nota: Somente documentos em formato PFD serão listados para seleção.
Após preencher os campos da Assinatura Digital, envie o formulário.
Selecione a etapa Valida Assinatura no campo próxima atividade. A etapa Valida Assinatura é uma etapa automática, ela é responsável por encaminhar a solicitação (Assinar Contrato) para os respectivos usuários de acordo com a sequência de inclusão dos mesmos na lista de Assinadores determinada na etapa Encaminhar para Assinatura.
Os assinadores receberão a solicitação de contratos na etapa Assinar Contrato, de acordo com a decisão automática da etapa anterior. Para que o assinador possa assinar digitalmente o contrato, ele deve possuir a assinatura Certillion e através do aplicativo (Certillion ID) obter o Token a ser informado para realizar a autenticação.
Primeiro Assinador:
Segundo Assinador:
Após todos os Assinadores da lista realizarem as assinaturas, o Workflow será movido automaticamente para a etapa final Finaliza Contrato.
Card documentos