- Problema: usar uma autoridade de certificação não confiável ou um certificado autoassinado
Correção: use um certificado SSL emitido por uma CA pública para o servidor de retorno de chamada do webhook.
Última atualização em
23 de ago de 2023
Novidades
Introdução
- Guia de início rápido para admins
- Guia de início rápido para usuários
- Para desenvolvedores(as)
- Biblioteca de tutoriais em vídeo
- Perguntas frequentes
Administrar
- Visão geral do Admin Console
- Gerenciamento de usuários
- Adicionar usuários
- Criar usuários focados em funções
- Verificar usuários com erros de provisionamento
- Alterar nome/endereço de email
- Editar a associação de grupo de um usuário
- Editar a associação de grupo de usuários por meio da interface de grupo
- Promover um usuário a uma função de admin
- Tipos de identidade de usuário e logon único
- Alternar identidade de usuário
- Autenticar usuários com o MS Azure
- Autenticar usuários com a federação do Google
- Perfis de produto
- Experiência de logon
- Configurações de conta/grupo
- Visão geral das configurações
- Configurações globais
- Nível de conta e ID
- Nova experiência para destinatários
- Fluxos de trabalho de autoassinatura
- Envio em massa
- Formulários web
- Fluxos de trabalho de envio personalizados
- Fluxos de trabalho do Power Automate
- Documentos da biblioteca
- Coletar dados de formulário com contratos
- Visibilidade de documento limitada
- Anexar uma cópia em PDF do contrato assinado
- Incluir um link no email
- Incluir uma imagem no email
- Arquivos anexados a emails receberão o nome
- Anexar relatórios de auditoria a documentos
- Mesclar vários documentos em um
- Baixar documentos individuais
- Fazer upload de um documento assinado
- Delegação para usuários da minha conta
- Permitir que destinatários externos deleguem
- Autoridade para assinar
- Autoridade para enviar
- Autoridade para adicionar selos eletrônicos
- Definir um fuso horário padrão
- Definir um formato de data padrão
- Usuários em vários grupos (UMG)
- Permissões de admin de grupo
- Substituir destinatário
- Relatório de auditoria
- Rodapé da transação
- Mensagens e orientações nos produtos
- PDFs acessíveis
- Nova experiência de criação
- Cliente do setor de saúde
- Configuração da conta
- Adicionar logotipo
- Personalizar nome do host e URL da empresa
- Adicionar nome da empresa
- Redirecionamento de URL pós-conclusão de contrato
- Preferências de assinatura
- Assinaturas bem formatadas
- Permitir que destinatários assinem por
- Permitir que signatários alterem seus nomes
- Permitir que os destinatários usem a assinatura salva
- Divulgação do cliente e Termos de uso personalizados
- Navegar pelos destinatários em campos de formulário
- Reiniciar fluxo de trabalho do contrato
- Recusar-se a assinar
- Permitir fluxos de trabalho de carimbo
- Exigir que signatários informem o cargo ou empresa
- Permitir que os signatários imprimam e insiram uma assinatura manuscrita
- Mostrar mensagens ao assinar eletronicamente
- Exigir que signatários usem um dispositivo móvel para criar assinaturas
- Solicitar endereço IP dos signatários
- Excluir o nome da empresa e o cargo dos carimbos de participação
- Assinaturas digitais
- Selos eletrônicos
- Identidade digital
- Configurações de relatório
- Nova experiência de relatório
- Configurações clássicas de relatório
- Configurações de segurança
- Configurações de logon único
- Configurações de lembrete pessoal
- Política de senha de logon
- Nível de segurança da senha de logon
- Duração da sessão da Web
- Tipo de criptografia PDF
- API
- Acesso às informações de usuários e grupos
- Intervalos de IP permitidos
- Compartilhamento de conta
- Permissões de compartilhamento da conta
- Controles de compartilhamento de contrato
- Verificação de identidade de signatário
- Senha de assinatura do contrato
- Nível de segurança da senha do documento
- Bloquear signatários por geolocalização
- Autenticação por telefone
- Autenticação baseada em conhecimento (KBA)
- Permitir extração de página
- Validade do link do documento
- Fazer upload de um certificado de cliente para webhooks e retornos de chamada
- Carimbo de data e hora
- Configurações de envio
- Mostrar a página Enviar após o logon
- Solicitar nome do destinatário ao enviar
- Bloquear valores de nome para usuários conhecidos
- Funções de destinatário permitidas
- Permitir testemunhas eletrônicas
- Grupos de destinatários
- CCs
- Acesso ao contrato do destinatário
- Campos obrigatórios
- Anexar documentos
- Compactar campo
- Modificar contratos
- Nome do contrato
- Idiomas
- Mensagens privadas
- Tipos de assinatura permitidos
- Lembretes
- Proteção com senha de documentos assinados
- Enviar notificação de contrato por meio de
- Opções de identificação do signatário
- Proteção de conteúdo
- Habilitar transações da Notarize
- Expiração do documento
- Visualizar, posicionar assinaturas e adicionar campos
- Ordem de assinatura
- Liquid Mode
- Controles de fluxo de trabalho personalizados
- Opções de upload para a página de assinatura eletrônica
- URL de redirecionamento para confirmação pós-assinatura
- Modelos de mensagem
- Configurações de Bio-Pharma
- Integração de fluxo de trabalho
- Configurações de autenticação
- Integração de pagamento
- Mensagens para signatários
- Configurações de SAML
- Configuração de SAML
- Instalar o serviço de federação do Microsoft Active Directory.
- Instalar Okta
- Instalar OneLogin
- Instalar a federação de identidade da Oracle
- Configuração de SAML
- Governança de dados
- Configurações de carimbo de data e hora
- Arquivo externo
- Idiomas da conta
- Configurações de email
- Migração de echosign.com para adobesign.com
- Opções de configuração para destinatários
- Orientações com respeito aos requisitos normativos
- Acessibilidade
- HIPAA
- GDPR
- 21 CFR parte 11 e EudraLex anexo 11
- Clientes do setor de saúde
- Suporte a IVES
- “Armazenamento” de contratos
- Considerações para a UE e Reino Unido
- Baixar contratos em massa
- Reivindicar um domínio
- Links para denunciar abuso
Enviar, assinar e gerenciar contratos
- Opções do destinatário
- Cancelar um lembrete de email
- Opções na página de assinatura eletrônica
- Visão geral da página de assinatura eletrônica
- Abrir para ler o contrato sem campos
- Recusar-se a assinar um contrato
- Delegar autoridade de assinatura
- Reiniciar o contrato
- Baixar um PDF do contrato
- Exibir o histórico do contrato
- Exibir as mensagens do contrato
- Converter de uma assinatura eletrônica para uma assinatura manuscrita
- Converter de uma assinatura manuscrita para uma assinatura eletrônica
- Navegar pelos campos do formulário
- Limpar os dados dos campos de formulário
- Ampliação e navegação da página de assinatura eletrônica
- Alterar o idioma usado nas ferramentas e informações do contrato
- Revisar os Avisos legais
- Ajustar as preferências de cookies do Acrobat Sign
- Enviar contratos
- Criar campos em documentos
- Ambiente de criação no aplicativo
- Detecção automática de campo
- Arrastar e soltar campos usando o ambiente de criação
- Atribuir campos de formulário aos destinatários
- Função de preenchimento prévio
- Aplicar campos com um modelo de campo reutilizável
- Transferir campos para um novo modelo de biblioteca
- Ambiente de criação atualizado ao enviar contratos
- Criar formulários e tags de texto
- Criar formulários usando o Acrobat (Acroforms)
- Campos
- Perguntas frequentes sobre criação
- Ambiente de criação no aplicativo
- Assinar contratos
- Gerenciar contratos
- Visão geral da página Gerenciar
- Delegar contratos
- Substituir destinatários
- Limitar a visibilidade do documento
- Cancelar um contrato
- Criar novos lembretes
- Revisar lembretes
- Cancelar um lembrete
- Acessar fluxos do Power Automate
- Mais ações...
- Como a pesquisa funciona
- Visualizar um contrato
- Criação de um modelo a partir de um contrato
- Ocultar ou reexibir contratos
- Fazer upload de um contrato assinado
- Modificar os arquivos e campos de um contrato enviado
- Editar o método de autenticação de um destinatário
- Adicionar ou modificar uma data de expiração
- Adicionar uma nota ao contrato
- Compartilhar um contrato individual
- Deixar de compartilhar um contrato
- Baixar um contrato individual
- Baixar os arquivos individuais de um contrato
- Baixar o relatório de auditoria de um contrato
- Baixar o conteúdo dos campos de um contrato
- Relatório de auditoria
- Relatórios e exportações de dados
- Visão geral
- Conceder aos usuários acesso aos relatórios
- Gráficos de relatório
- Exportações de dados
- Renomear um relatório ou exportação
- Duplicar um relatório ou exportação
- Agendar um relatório ou exportação
- Excluir um relatório ou exportação
- Verificar o uso de transações
Recursos e fluxos de trabalho avançados de contratos
- Formulários web
- Criar um formulário web
- Editar um formulário web
- Desabilitar ou habilitar um formulário web
- Ocultar ou reexibir um formulário web
- Localizar o URL ou o código de script
- Preencher campos de formulário web com parâmetros de URL
- Salvar um formulário web para concluir mais tarde
- Redimensionar um formulário web
- Modelos reutilizáveis (modelos de biblioteca)
- Formulários do governo dos EUA na biblioteca do Acrobat Sign
- Criar um modelo de biblioteca
- Alterar o nome de um modelo de biblioteca
- Alterar o tipo de um modelo de biblioteca
- Alterar o nível de permissão de um modelo de biblioteca
- Copiar, editar e salvar um modelo compartilhado
- Baixar os dados de campo agregado de um modelo de biblioteca
- Transferir a propriedade de formulários web e modelos de biblioteca
- Fluxos de trabalho do Power Automate
- Visão geral da integração com o Power Automate e direitos incluídos
- Habilitar a integração do Power Automate
- Ações no contexto da página Gerenciar
- Acompanhamento do uso do Power Automate
- Criar um novo fluxo (exemplos)
- Acionadores usados para fluxos
- Importação de fluxos de fora do Acrobat Sign
- Gerenciar fluxos
- Editar fluxos
- Compartilhar fluxos
- Desabilitar ou habilitar fluxos
- Excluir fluxos
- Modelos úteis
- Somente admins
- Arquivar o contrato
- Arquivar o contrato de formulário web
- Salvar documentos de formulários web concluídos na biblioteca do SharePoint
- Salvar documentos de formulários web concluídos no OneDrive for Business
- Salvar documentos concluídos no Google Drive
- Salvar documentos de formulários web concluídos no Box
- Extração de dados do contrato
- Notificações de contrato
- Enviar notificações personalizadas por email com o conteúdo do contrato e o contrato assinado
- Receba notificações do Adobe Acrobat Sign em um canal do Teams
- Receba notificações do Adobe Acrobat Sign no Slack
- Receba notificações do Adobe Acrobat Sign no Webex
- Geração de contrato
- Gerar documento a partir de um modelo do Word e formulário do Power App, e enviar para assinatura
- Gere um contrato a partir de um modelo do Word no OneDrive e obter a assinatura
- Gerar contrato para a linha selecionada do Excel e enviar para revisão e assinatura
- Fluxos de trabalho de envio personalizados
- Compartilhar usuários e contratos
Integrar a outros produtos
- Visão geral das integrações do Acrobat Sign
- Acrobat Sign para Salesforce
- Acrobat Sign para Microsoft
- Outras integrações
- Integrações gerenciadas por parceiro
- Como obter uma chave de integração
Acrobat Sign Developer
- APIs REST
- Webhooks
Suporte e solução de problemas
Autenticação SSL bidirecional
O SSL bidirecional, geralmente chamado de SSL do lado do cliente ou TLS mútuo, é um modo de SSL no qual o servidor e o cliente (navegador da Web) apresentam certificados para se identificarem.
Os administradores de conta podem configurar um certificado do lado do cliente na página Configurações de segurança.
O Acrobat Sign verifica os certificados SSL ao fornecer cargas para o URL do webhook. Os webhooks que falharem na verificação de certificado SSL não entregarão a carga JSON com sucesso.
Use o SSL bidirecional para autenticar o cliente (Acrobat Sign) e o serviço de escuta para garantir que apenas o Acrobat Sign possa acessar o URL do webhook.
Se o webhook foi criado por um Aplicativo de parceiro, ele usará um certificado de cliente (se disponível) da Conta de aplicativo do parceiro para se identificar ao fazer chamadas de retorno do webhook.
Veja a seguir as perguntas mais comuns sobre o processo de verificação do servidor Web e a verificação da certificação do cliente.
Verificação do servidor Web
Durante o registro de um webhook, o Acrobat Sign verifica o URL do servidor do webhook.
Os clientes não poderão registrar o webhook se a conexão com o URL de retorno de chamada do webhook não puder ser concluída no Acrobat Sign.
Não.
O URL de retorno de chamada do webhook só pode ser HTTPS na porta 443 ou 8443.
O Acrobat Sign bloqueia o tráfego HTTPS de saída para todas as outras portas.
Uma boa maneira de verificar o certificado do servidor é usar a Ferramenta de diagnóstico de instalação DigiCert® SSL.
Insira apenas o nome do host, por exemplo: www.digicert.com
Problemas comuns incluem:
- Problema: o servidor não está enviando o certificado intermediário
Correção: instale os certificados intermediários no servidor de retorno de chamada do webhook.
Consulte https://www.digicert.com/kb/ssl-certificate-installation.htm para obter informações detalhadas.
Verificação de certificado de cliente
Para configurar um SSL bidirecional para um webhook, exigimos que o administrador faça upload de um arquivo .p12 (ou .pfx) que contenha a chave privada. O arquivo é armazenado com segurança na conta do cliente e o administrador tem controle total para removê-lo a qualquer momento.
Em uma configuração de webhook bidirecional, o Acrobat Sign é o chamador/cliente e precisa da chave privada para provar que a chamada é feita pelo Acrobat Sign em nome da conta do cliente.
-
Verifique se o SSL bidirecional está habilitado
O SSL bidirecional deve estar habilitado no servidor de retorno de chamada do webhook.
Usando qualquer navegador da Web, conecte-se ao URL de retorno de chamada do webhook. Você deve obter:
400 Solicitação inválida Nenhum certificado SSL foi enviado
Isso significa que o servidor espera que o cliente envie certificados de cliente (ou seja, SSL bidirecional habilitado para o servidor).
Se você não vir a mensagem acima, o SSL bidirecional não está ativado.
Observação:Você pode usar o Postman e fazer uma solicitação POST para o URL de retorno de chamada do webhook. Você deve obter um resultado semelhante.
-
A credencial do cliente pode ser um certificado autoassinado ou um certificado emitido por uma autoridade de certificação. No entanto, ele deve estar em conformidade com as seguintes extensões X.509 v3:
Extensão X.509 v3
Valor
ExtendedKeyUsage
clientAuth (OID: 1.3.6.1.5.5.7.3.2)
KeyUsage
digitalSignature
O certificado do cliente deve ser um arquivo PKCS12 com a extensão .p12 ou .pfx e deve incluir ambos os certificados do cliente (para que o servidor possa verificar a identidade do cliente) e a chave privada do cliente (para que o cliente possa assinar digitalmente mensagens para que o servidor verifique durante o handshake SSL).
Use o comando openssl para verificar o arquivo p12 (pfx):
openssl pkcs12 -info -in outfile.p12
A senha da chave privada deve ser solicitada. A saída deve conter ambos os certificados, bem como uma chave privada criptografada, como:
Bag Attributes localKeyID: 9D BD 22 80 E7 B2 B7 58 9E AE C8 42 71 F0 39 E1 E7 2B 57 DB subject=/C=US/ST=California/L=San Jose/O=Adobe Inc./CN=sp.adobesignpreview.com issuer=/C=US/O=DigiCert Inc/CN=DigiCert TLS RSA SHA256 2020 CA1 -----BEGIN CERTIFICATE----- MIIGwDCCBaigAwIBAgIQAhJSKDdyQZjlbYO5MJAYOTANBgkqhkiG9w0BAQsFADBP MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMSkwJwYDVQQDEyBE ... JAKQLQ== -----END CERTIFICATE----- Bag Attributes: <No Attributes> subject=/C=US/O=DigiCert Inc/CN=DigiCert TLS RSA SHA256 2020 CA1 issuer=/C=US/O=DigiCert Inc/OU=www.digicert.com/CN=DigiCert Global Root CA -----BEGIN CERTIFICATE----- MIIEvjCCA6agAwIBAgIQBtjZBNVYQ0b2ii+nVCJ+xDANBgkqhkiG9w0BAQsFADBh MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3 ... -----END CERTIFICATE----- Bag Attributes localKeyID: 9D BD 22 80 E7 B2 B7 58 9E AE C8 42 71 F0 39 E1 E7 2B 57 DB Key Attributes: <No Attributes> -----BEGIN ENCRYPTED PRIVATE KEY----- MIIFDjBABgkqhkiG9w0BBQ0wMzAbBgkqhkiG9w0BBQwwDgQI7eNh2qlsLPkCAggA ... FHE= -----END ENCRYPTED PRIVATE KEY-----Os certificados devem incluir, no mínimo, o certificado da entidade final e os certificados intermédios. O ideal é incluir também o certificado da CA raiz.
Alerta:Verifique se o arquivo .p12 ou .pfx está protegido por senha.
-
Criar um certificado de cliente autoassinado (opcional)
Os certificados do cliente podem ser emitidos por uma autoridade de certificação ou autoassinados, dependendo da sua necessidade.
Para gerar um certificado de cliente autoassinado, use o seguinte comando openssl:
openssl req -newkey rsa:4096 -keyform PEM -keyout ca.key -x509 -days 3650 -outform PEM -out ca.cer
Cuidado:Mantenha os arquivos resultantes em segredo, pois eles são seus certificados da CA autoassinados.
Em seguida, gere o arquivo .p12 do cliente:
- Gerar uma chave privada para o cliente SSL:
openssl genrsa -out client.key 2048
- Use a chave privada do cliente para gerar uma solicitação de certificado:
openssl req -new -key client.key -out client.req
- Emita o certificado do cliente usando a solicitação de certificado e a chave/certificado da CA:
openssl x509 -req -in client.req -CA ca.cer -CAkey ca.key -set_serial 101 -extensions client -days 365 -outform PEM -out client.cer
- Converta o certificado do cliente e a chave privada para o formato pkcs#12 para uso pelos navegadores:
openssl pkcs12 -export -inkey client.key -in client.cer -out client.p12
- Remova a chave privada do cliente, o certificado do cliente e os arquivos de solicitação do cliente, pois o pkcs12 tem tudo o que você precisa.
rm client.key client.cer client.req
- Gerar uma chave privada para o cliente SSL:
-
- Use Postman para carregar o arquivo PFX do cliente em Configurações > Certificados.
- Selecione Adicionar certificado para adicionar o certificado do cliente.
- Configure o cabeçalho HTTP para x-adobesign-clientid:
Depois de configurado, envie uma solicitação POST para o URL de retorno de chamada do webhook.
Você deve obter uma resposta 200.
-
Por que o Acrobat Sign rejeita meu arquivo PFX mesmo depois de verificá-lo com o Postman?
Se você seguiu o processo acima para a verificação do arquivo pfx e o Acrobat Sign ainda rejeita o arquivo pfx, é provável que o arquivo tenha sido gerado por uma ferramenta da Microsoft que pode produzir um arquivo PKCS12 não padrão.
Nesse caso, use os comandos openssl abaixo para extrair os certificados e a chave privada do arquivo pfx e, em seguida, gere um arquivo PKCS12 formatado corretamente:
// Extrair certificados e chave privada do arquivo .pfx openssl pkcs12 -info -in microsoftclientssl.pfx -passin pass:"" -out clientcert.crt -nokeys openssl pkcs12 -info -in microsoftclientssl.pfx -passin pass:"" -out clientcert.key -nodes -nocerts // Criar novo arquivo PKCS12 openssl pkcs12 -export -inkey clientcert.key -in clientcert.crt -out clientcert.pfx
