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

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

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

    Antes de Iniciar

    • Solicitar uma assinatura de IntegrationHub.
    • Ative o spoke do DocuSign.
    • Função necessária: administrador
    Importante:
    Se você estiver configurando o spoke DocuSign usando a concessão de código de autorização, não será necessário 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 do DocuSign.

    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 do documento assinado 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 do DocuSign:
    • Conta do DocuSign
    • Aplicação DocuSign configurada 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ê precisará desses valores ao Configurar a conexão do spoke do DocuSign.
    5. Adicione o URL de redirecionamento do OAuth ServiceNow em sua conta do DocuSign.
      1. Navegar até Integrações > App e chaves.
      2. Em Aplicativos e chaves de integração, encontre o app necessário.
      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 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 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 base da conta.
        URI base da conta.
      3. Copie e registre este valor para uso posterior.

    Configurar a conexão do spoke do DocuSign

    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 para spoke do DocuSign
    5. Se você estiver configurando o spoke pela primeira vez, clique em Configurar.
      Configurar uma conexão pela primeira vez para o spoke do DocuSign
    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 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 do DocuSign. O valor padrão é v2.1.
      URL de Autorização URL de autorização do DocuSign.
      • Para o ambiente de área restrita do desenvolvedor, insira https://account-d.docusign.com/oauth/auth.
      • Para o sistema de produção em tempo real, insira https://account.docusign.com/oauth/auth.
      URL do token URL do qual a instância ServiceNow obtém o token de acesso.
      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 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 do DocuSign.

    7. Clique em Configurar e obter token do OAuth.