Configurar o Docusign eSignature spoke usando a concessão de código de autorização

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 3 min. de leitura

    • Integre a instância ServiceNow e o spoke Docusign eSignature usando o código de autorização para autenticar ServiceNow solicitações.

    Antes de Iniciar

    • Solicitar uma assinatura de Integration Hub.
    • Ative o spoke Docusign eSignature.
    • Função necessária: administrador
    Importante:
    Se você estiver configurando o spoke Docusign eSignature usando a concessão de código de autorização, não precisará configurar o spoke usando a concessão JWT.

    Configurar a conta do Docusign

    Configure uma aplicação OAuth personalizada da sua conta do Docusign para habilitar a autenticação com o spoke Docusign eSignature.

    Por Que e Quando Desempenhar Esta Tarefa

    Conclua essas etapas na sua conta do Docusign. Consulte a documentação do Docusign Developer Center 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 a instância ServiceNow. Isso permite que os designers de fluxo pausem um fluxo até que um documento seja assinado e usem os dados do documento no fluxo.

    Antes de Iniciar

    Requisitos da Docusign:
    • Conta do Docusign
    • App Docusign configurado para integração com ServiceNow
    • Função necessária: administrador do Docusign

    Procedimento

    1. Faça login na conta do Docusign como administrador.
    2. Na sua conta do Docusign, registre sua aplicação.
      Nota:
      Certifique-se de selecionar a opção de concessão de código de autorização para a aplicação do usuário.
    3. Gere uma chave de integrador e uma chave secreta.
    4. Registre os valores da chave do integrador e da chave secreta para registrar o app como um provedor OAuth de terceiros em sua instância ServiceNow.
      Você precisa desses valores quando Configurar a conexão do spoke do Docusign eSignature.
    5. Adicione o ServiceNow URL de redirecionamento do OAuth à sua conta do Docusign.
      1. Navegar até Integrações > App e chaves.
      2. Em Aplicações e chaves de integração, encontre a aplicação necessária.
      3. Para o app necessário, clique na lista suspensa Ações e clique em Editar.
      4. Em Configurações adicionais, clique em Adicionar URI e adicione o endpoint de retorno de chamada do OAuth neste formato: https://<instance> .service-now.com/oauth_redirect.do .
        Adicione o URI de redirecionamento na conta do Docusign.
    6. Obtenha o valor do URI de base da conta da conta do Docusign.
      1. Navegar até Integrações > App e chaves.
      2. Em Informações da minha conta, você pode encontrar o valor do URI de base da conta.
        URI de base da conta.
      3. Copie e registre este valor para uso posterior.

    Configurar a conexão do spoke do Docusign eSignature

    Integre a instância da ServiceNow e a instância da conta do Docusign usando a concessão de código de autorização para autenticar as solicitações da ServiceNow.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > Flow Designer.
    2. Clique na guia Conexões.
    3. Insira Docusign no campo Pesquisar todas as conexões.
    4. Localize o alias do Docusign e clique em Exibir detalhes.
      Nota:
      Não clique em Adicionar conexão.
      Modelo de conexão do spoke Docusign eSignature
    5. Se você estiver configurando o spoke pela primeira vez, clique em Configurar.
      Configurar uma conexão pela primeira vez para o spoke Docusign eSignature
    6. No formulário Configurar conexão, preencha os campos.
      Tabela 1. Formulário "Configurar conexão"
      Campo Descrição
      Nome da conexão Nome exclusivo para identificar a conexão.
      URL de Conexão URI de base da conta para se conectar ao ambiente Docusign. Este valor pode ser obtido da sua conta do Docusign. Para obter mais informações, consulte Configurar a conta do Docusign.
      Versão da API Versão da API Docusign. O valor padrão é v2.1.
      URL de Autorização URL de autorização da Docusign.
      • Para o 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 de Token URL do qual a instância ServiceNow obtém o token de acesso.
      • Para o 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 Referência de endpointpós-go-live e de informações do usuário na documentação do Docusign Developer Center.
      ID do cliente OAuth Chave do integrador da sua conta do Docusign.
      Segredo do cliente OAuth Chave secreta (segredo do cliente) da sua conta do Docusign.
      URL de redirecionamento do OAuth Endpoint de retorno de chamada do OAuth neste formato: https://<instance> .service-now.com/oauth_redirect.do .
      Nota:
      Certifique-se de adicionar este URL à sua conta do Docusign. Para obter mais informações, consulte Configurar a conta do Docusign.

      Conexão Docusign.

    7. Clique em Configurar e obter token do OAuth.