Configure o spoke DocuSign eSignature usando a concessão JWT

Integrar o. ServiceNow Instância e DocuSign usando concessão JWT para autenticar ServiceNow solicitações.

Antes de Iniciar

• Solicitar uma assinatura de IntegrationHub.
• Ative o spoke DocuSign eSignature.
• Função necessária: administrador

Importante:

Se você estiver configurando o spoke DocuSign eSignature usando a concessão JWT, não será necessário configurar o spoke usando a concessão de código de autorização.

Configure a conta do DocuSign

Crie uma aplicação OAuth personalizada de sua conta do Docusign para habilitar a autenticação OAuth 2.0 com o Spoke do Docusign eSignature.

Antes de Iniciar

Requisitos do DocuSign:

• Conta do DocuSign
• Aplicativo DocuSign configurado para integrar com ServiceNow
• Função necessária: Administrador do DocuSign

Por Que e Quando Desempenhar Esta Tarefa

Conclua estas etapas na sua conta do DocuSign. Consulte DocuSign Developer Center documentação para obter instruções sobre como criar e configurar aplicações personalizadas. O DocuSign usa um webhook com script para enviar dados de documentos assinados para ServiceNow instância. Isso permite que os designers de fluxo pausem um fluxo até que um documento seja assinado e usem dados do documento no fluxo.

Procedimento

1. Na sua conta do DocuSign, registre sua aplicação.
2. Gere uma chave de integrador e uma chave secreta.
3. Registre os valores da chave do integrador e da chave secreta para registrar o app como um provedor OAuth de terceiros em seu ServiceNow instância.
   Esses valores são necessários quando você Registre DocuSign como provedor OAuth
4. Clique em ADICIONAR PAR DE CHAVES RSA e registram o. ID do par de chaves , Chave pública e Chave privada .
5. Adicione ServiceNow URL de redirecionamento do OAuth em sua conta do DocuSign.
   1. Navegar até Integrações > App e chaves.
   2. Em Chaves de integração e apps , encontre o app necessário.
   3. Para o aplicativo necessário, clique em Ações lista suspensa e clique em Editar .
   4. Em Configurações adicionais clique em Adicionar URI E adicione o endpoint de retorno de chamada OAuth neste formato: https://<instance>.service-now.com/oauth_redirect.do .
      
6. Obtenha o valor de URI de base da conta Da conta do DocuSign.
   1. Navegar até Integrações > App e chaves.
   2. Em Minhas informações de conta , você pode encontrar o valor de URI de base da conta .
      
   3. Copie e registre este valor para uso posterior.

Gere o certificado JKS

Gere um certificado JKS para a autenticação JWT do Spoke do Docusign eSignature.

Antes de Iniciar

Função necessária: administrador

Procedimento

1. Abra o editor de texto para código como Sublime Text.
2. Crie um novo arquivo.
3. Cole a Chave privada que você gerou anteriormente no seu app integrador DocuSign.
   Para obter mais informações, consulte Configure a conta do DocuSign.

   Nota:

   Inclua o início e o término da chave privada.
4. Salve o arquivo com a extensão .key, por exemplo, privatekey.key .
5. Abra o terminal e navegue até o diretório em que você salvou o arquivo com .key extensão.
6. Crie um certificado assinado por CA usando sua chave privada executando o comando:

   openssl req -new -x509 -key <file-name>.key -out <certificate-name>.pem -days 1095

   O sistema solicita que você forneça os detalhes necessários, como Nome do país, Nome da província e assim por diante.
7. Insira os detalhes necessários.
8. Crie o arquivo PKCS 12 usando sua chave privada e o certificado assinado pela CA executando o comando:

   openssl pkcs12 -export -in <certificate-name>.pem -inkey <file-name>.key -certfile <certificate-name>.pem -out <PKCS-12-file-name>.p12 

   O sistema solicita que você forneça uma senha.
9. Forneça a senha de exportação.
10. Crie o arquivo JKS executando este comando:

    keytool -importkeystore -srckeystore <PKCS-12-file-name>.p12 -srcstoretype pkcs12 -destkeystore <JKS-certificate-filename>.jks -deststoretype JKS

    O sistema solicita que você forneça uma senha.
11. Forneça as senhas do armazenamento de chaves de destino e de origem.

Anexe um certificado Java Key Store ao Spoke do Docusign eSignature

Habilite a autenticação de token de concessão do portador JWT anexando um certificado Java KeyStore (JKS) válido ao Spoke do Docusign eSignature.

Antes de Iniciar

• Garanta a disponibilidade de um certificado Java KeyStore válido
• Função necessária: administrador

Procedimento

1. Navegar até Tudo > Definição do Sistema > Certificados.
2. Clique em Nova.
3. Preencha o formulário.

   Tabela 1. Campos do formulário da certificação X.509

   Campo	Descrição
   Nome	Insira um nome para identificar exclusivamente o registro. Por exemplo, Certificado DocuSign .
   Notificar no vencimento	Defina os usuários a serem notificados quando o certificado expirar.
   Aviso emitido antes do vencimento (em dias)	Insira o número de dias para enviar uma notificação antes que o certificado expire.
   Ativo	Habilitar
   Tipo	Selecione Armazenamento de chaves Java.
   Dias até o vencimento	Insira o número de dias até que o certificado expire.
   Senha do armazenamento de chaves	Insira uma senha associada ao certificado.
   Descrição resumida	Insira um resumo sobre o certificado.

4. Clique no ícone Anexos ( E anexe um certificado JKS.
5. Clique em Validar armazenamentos/certificados .

Crie uma chave de assinatura JWT para Spoke do Docusign eSignature

Crie uma chave de assinatura JSON Web Token (JWT) para atribuir ao seu certificado Java KeyStore.

Antes de Iniciar

Função necessária: administrador

Procedimento

1. Navegar até Tudo > OAuth de Sistema > Chaves de JWT.
2. Clique em Nova.
3. Preencha o formulário.

   Tabela 2. Campos do formulário de chaves de JWT

   Campo	Descrição
   Nome	Insira um nome para identificar exclusivamente a chave de assinatura JWT. Por exemplo, Chaves JWT do DocuSign .
   Armazenamento de chaves de assinatura	Selecione o certificado JKS válido anexado na tarefa anterior. Por exemplo, Certificado DocuSign .
   ID de chave	Insira um ID de chave para identificar qual chave é usada quando várias chaves são usadas para assinar tokens.
   Algoritmo de assinatura	Selecione um algoritmo para assinar com a chave JWT.
   Senha da chave de assinatura	Insira uma senha associada à chave de assinatura.
   Ativo	Habilitar.

4. Clique em Enviar.

Crie um provedor JWT para Spoke do Docusign eSignature

Adicione um provedor JSON Web Token (JWT) ao seu Instância da ServiceNow.

Antes de Iniciar

Função necessária: administrador

Procedimento

1. Navegar até Tudo > OAuth de Sistema > Provedores JWT.
2. Clique em Nova.
3. No formulário, preencha os campos.

   Tabela 3. Campos de formulário do Provedor JWT

   Campo	Descrição
   Nome	N insira um n ame para identificar exclusivamente o provedor JWT. Por exemplo, Provedor JWT da DocuSign .
   Intervalo de Vencimento (s)	Insira um número em segundos para definir L. ifespan de Provedor JWT tokens .
   Configuração de Assinatura	Selecione um Chave de assinatura JWT. Por exemplo, Chaves JWT do DocuSign .

4. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.
   As listas relacionadas Declarações padrão e Declarações personalizadas são exibidas.
5. Na mesma página do registro do provedor JWT, insira valores para iss , sub e aud em Declarações padrão lista relacionada.

   Sinistro	Valor
   iss	<your_integration_key>
   sub	<your_user_ID>
   aud	account-d.docusign.com

   Para obter mais informações, consulte Como obter um token de acesso com concessão JWT em DocuSign Developer Center .

6. Insira um registre no Declarações personalizadas lista relacionada e. preencha o formulário .

   Tabela 4. Campos da lista relacionada de declarações personalizadas

   Campo	Valor
   Nome da declaração	scope
   Tipo de valor da declaração	cadeia de caracteres
   Valor do sinistro	representação de assinatura

7. Clique em Atualizar.

Registre DocuSign como provedor OAuth

Use as informações geradas durante a configuração da conta do Docusign para registrar o Docusign como um provedor OAuth e permitir que a instância solicite tokens OAuth 2.0.

Antes de Iniciar

Função necessária: administrador

Procedimento

1. Navegar até Tudo > OAuth de Sistema > Registro de aplicações.
2. Clique em Nova.
   O sistema exibe a mensagem Que tipo de aplicação OAuth?
3. Selecione Conecte-se a um provedor OAuth de terceiros .
   O sistema exibe um formulário Registros de aplicações em branco.
4. Preencha o formulário.

   Campo	Valor necessário
   Nome	Insira qualquer nome para identificar exclusivamente o registro. Por exemplo, insira DocuSign OAuth .
   ID de cliente	Insira a chave do integrador que você gerou durante a configuração da conta do DocuSign.
   Segredo do cliente	Insira o segredo do cliente gerado durante a configuração da conta do DocuSign.
   Tipo de concessão padrão	Selecione Portador JWT.
   URL de Autorização	Para ambiente de área restrita do desenvolvedor, insira https://account-d.docusign.com/oauth/auth . Para o sistema de produção ao vivo, insira https://account.docusign.com/oauth/auth .
   URL do token	Para ambiente de área restrita do desenvolvedor, insira https://account-d.docusign.com/oauth/token . Para o sistema de produção ao vivo, insira https://account.docusign.com/oauth/token . Para obter mais informações, consulte, Colocar em operação e. Referência do endpoint de informações do usuário em DocuSign Developer Center documentação.

5. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.
   • O sistema valida as credenciais OAuth e preenche o. URL de redirecionamento .
   • O sistema é preenchido Perfil de entidade OAuth com Tipo de concessão . Portador JWT . Por exemplo, Perfil de entidade OAuth criado com padrão Nome , DocuSign OAuth default_profile
6. Insira um registro no Escopos da entidade OAuth lista relacionada e preencha os valores.

   Tabela 5. Campos da lista relacionada escopos da entidade OAuth

   Campo	Valor
   Nome	scope
   Escopo do OAuth	representação de assinatura

7. Copie o valor de URL de redirecionamento .
8. Clique em Atualizar.
9. Faça login na sua conta do DocuSign para editar a configuração da aplicação DocuSign personalizada.
   Consulte DocuSign Developer Center para obter instruções.
10. Cole o valor da URL de redirecionamento no URI de redirecionamento da sua aplicação DocuSign personalizada.
    Por exemplo, cole https://instance.service-now.com/oauth_redirect.do

Resultado

A instância pode solicitar tokens OAuth 2,0 para o spoke.

Nota:

Quando um token OAuth expira, o spoke gera automaticamente um novo token na maioria dos casos. Se um token expirar e não for gerado novamente, um administrador poderá gerar novamente o token OAuth do spoke.

Obter consentimento

Obtenha consentimento explícito para ServiceNow Aplicação do DocuSign.

Função necessária: administrador

Obtenha consentimento para um administrador da organização

Consulte Documentação do desenvolvedor do DocuSign (consentimento do administrador para aplicações internas) para obter instruções para obter consentimento para um administrador da organização.

Crie registros de credencial para Spoke do Docusign eSignature

Crie registros de credencial para a aplicação OAuth personalizada do Docusign que você criou durante a configuração da conta do Docusign. Os aliases de conexão e credencial do spoke do Docusign usam essas credenciais para autorizar ações.

Antes de Iniciar

Função necessária: administrador

Procedimento

1. Navegar até Tudo > Conexões e Credenciais > Credenciais.
2. Clique em Nova.
   O sistema exibe a mensagem Que tipo de credenciais você deseja criar? .
3. Selecione Credenciais OAuth 2.0.
   A janela pop-up exibe um formulário Credenciais do OAuth 2,0 em branco.
4. Preencha esses valores.

   Campo	Valor necessário
   Nome	Insira qualquer nome para identificar exclusivamente o registro. Por exemplo, insira Credenciais do DocuSign .
   Ativo	Habilitar
   Perfil de Entidade OAuth	Selecione o perfil OAuth que você criou ao registrar a aplicação DocuSign personalizada como um provedor OAuth. Por exemplo, selecione DocuSign OAuth default_profile .
   Aplica-se a	Selecione os MID Servers que podem usar esta credencial. Por exemplo: selecione Todos os MID Servers.
   Ordem	Selecione a ordem para aplicar esta credencial. Por exemplo: insira 100.

5. Salve o registro.
6. Clique em Obter token OAuth Link relacionado para gerar o token OAuth.

Criar registros de conexão para Spoke do Docusign eSignature

Crie registros de conexão para sua conta do Docusign. Os aliases de conexão e credencial do spoke do Docusign usam essas credenciais para executar ações em Docusign.

Antes de Iniciar

Função necessária: administrador

Procedimento

1. Navegar até Tudo > Conexões e Credenciais > Aliases de conexão e credenciais.
2. Aberto para o registro de DocuSign .
3. Em Conexões clique em Novo .
   O sistema exibe um formulário Conexão HTTP(s) em branco.
4. Insira estes valores.

   Campo	Valor necessário
   Nome	Insira qualquer nome para identificar exclusivamente o registro de conexão. Por exemplo, insira Conexão do DocuSign .
   Credencial	Selecione o registro de credencial que você criou para o DocuSign. Por exemplo, selecione Credenciais do DocuSign .
   URL de conexão	Para ambiente de demonstração, insira https://demo.docusign.net . Para o sistema de produção ao vivo, insira o URI de base, como na2.docusign.net ou eu.docusign.net . Para obter instruções sobre como obter o URI de base, consulte Colocar em operação e. Referência do endpoint de informações do usuário em DocuSign Developer Center documentação.

5. Clique em Enviar.

O que Fazer Depois

Sincronize o ServiceNow com o Docusign para acessar contas e modelos do Docusign e envelopes do Docusign spoke. Consulte Sincronizar DocuSign com a ServiceNow.