Sincronizar o grupo [ Adobe Sign com ServiceNow

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

    • Sincronize ServiceNow com o grupo necessário em Adobe Sign para acessar os documentos específicos do grupo e acordos do Adobe Sign spoke.

    Antes de Iniciar

    • Solicite a assinatura do Integration Hub.
    • Ativar o Adobe Sign spoke
    • Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Essas etapas são executadas para sincronizar apenas um grupo Adobe Sign. Para sincronizar outro grupo Adobe Sign, repita este processo.

    Criar aplicação OAuth personalizada na conta Adobe Sign

    Crie uma aplicação OAuth personalizada a partir da sua conta Adobe Sign para habilitar a autenticação OAuth 2.0 com o Adobe Sign spoke.

    Antes de Iniciar

    • Adobe Sign conta
    • Função necessária: Adobe Sign credenciais de administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Conclua essas etapas na sua conta Adobe Sign. Veja o Adobe Sign desenvolvimento Documentação do para obter instruções sobre como criar e configurar aplicações personalizadas.

    Procedimento

    1. Na sua conta Adobe Sign, crie uma aplicação.
    2. Copie e registre o ID e o segredo da aplicação para uso posterior.
      Esses detalhes são necessários para registrar a aplicação como um provedor OAuth de terceiros em sua instância ServiceNow.

    Resultado

    A aplicação OAuth personalizada da sua conta Adobe Sign é criada e pode ser integrada à instância ServiceNow.

    Configurar o webhook

    Configure o webhook em sua aplicação Adobe Sign para permitir que Adobe Sign envie dados para ServiceNow quando um participante assinar um acordo ou documento.

    Antes de Iniciar

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Se o escopo da aplicação Adobe Sign for Conta, use o mesmo webhook para todos os grupos definidos no escopo da conta. Se o escopo da aplicação Adobe Sign for Grupo, você deverá configurar para cada grupo.

    Procedimento

    1. Na sua conta Adobe Sign, crie um webhook com essas configurações.
      1. Insira a URL de destino em URL neste formato: https://<instance-name> .service-now.com/api/sn_adobesign_spoke/adobesign_webhook .
      2. Insira Todos os eventos de Acordo e MegaAssine todos os eventos em Eventos.
      3. Selecione todos os eventos de acordo necessários em Parâmetros de notificação.
        Veja o Adobe Sign desenvolvimento Documentação para obter mais informações sobre como criar webhooks em sua conta Adobe Sign.
    2. Em sua instância ServiceNow, adicione os detalhes do cliente.
      1. Navegar até Spoke do Adobe Sign > Detalhes do Cliente.
      2. Abra o registro, ID de cliente do Adobe Sign.
      3. No formulário, preencha estes valores.
        Campo Descrição
        Chave de Autenticação Chave para autenticação. Insira UB7E5BXCXY.
        ID de cliente ID da aplicação criada durante a configuração da conta Adobe Sign.
      4. Clique em Atualizar.

    Resultado

    O webhook foi criado em sua conta Adobe Sign e os eventos de assinatura em Adobe Sign são atualizados nas tabelas de Adobe Sign spoke.

    Registrar Adobe Sign como provedor OAuth

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

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > OAuth de Sistema > Registro de aplicações.
    2. Clique em Nova.
      O sistema exibe a mensagem Que tipo de aplicação OAuth?
    3. Selecione Conectar-se a um provedor OAuth de terceiros.
    4. No formulário, preencha os campos.
      Campo Valor necessário
      Nome Nome para identificar exclusivamente o registro. Por exemplo, insira o perfil OAuth do Adobe Sign.
      ID de cliente ID da aplicação criada durante a configuração da conta Adobe Sign.
      Segredo do cliente Segredo da aplicação criado durante a configuração da conta Adobe Sign.
      Script do API da OAuth Script opcional para personalizar solicitação e resposta.
      URL de logotipo URL que contém uma imagem a ser usada como logotipo da aplicação.
      Tipo de concessão padrão Tipo de concessão usado para estabelecer o token. Selecione Código de autorização.
      Tempo de vida do token de atualização Tempo, em segundos, em que o token de atualização é válido. O tempo padrão é 8.640.0000 segundos.
      PKCE necessário Opção para permitir que clientes públicos exijam o PKCE para uma autorização.
      Nota:
      Você pode usar somente o Código de autorização como o Tipo de concessão padrão quando o PKCE estiver habilitado.
      Aplicação Escopo da aplicação que contém este registro. Selecione Spoke do Adobe Sign.
      Nota:
      Você deve garantir que o escopo da aplicação seja Spoke do Adobe Sign.
      Acessível de Escopo da aplicação a partir do qual este registro fica acessível.
      Ativo Opção para usar ativamente o registro da aplicação.
      URL de Autorização Endpoint do código de autorização do OAuth. Por exemplo, https://secure.<region> .echosign.com/public/oauth/v2 .
      URL de Token Endpoint do token do servidor OAuth. Por exemplo, https://secure.<region> .echosign.com/oauth/v2/token .
      URL de revogação do token Endpoint de revogação de token do servidor OAuth.
      Redirecional URL Endpoint de retorno de chamada do OAuth. O sistema gera o URL ao salvar o registro da aplicação.
      Atualizar URL do Token URL para atualizar um token. Por exemplo, https://secure.<region> .echosign.com/oauth/v2/refresh .
      Nota:
      Este campo está oculto no layout do formulário. Configure o layout do formulário para mostrar este campo.
      Usar autenticação mútua Opção de usar autenticação mútua para solicitação e revogação de token. Esta opção exige que um perfil de autenticação mútua seja especificado.
    5. Inserir registros para modificadores de escopo do grupo na lista relacionada Escopos de Entidade OAuth neste formato,<scope> :<modifier> .
      Por exemplo, se o escopo user_read do modificador de grupo estiver habilitado na aplicação Adobe Sign, insira o registro a seguir na lista relacionada Escopos de entidade OAuth.
      Campo Valor
      user_read: grupo user_read: grupo
    6. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.
      O sistema valida as credenciais do OAuth e preenche a URL de redirecionamento.
    7. Copie e registre a URL de redirecionamento.
    8. Faça login na sua conta Adobe Sign e edite a configuração da aplicação personalizada Adobe Sign.
      Veja o Adobe Sign desenvolvimento Documentação para obter instruções.
    9. Cole o valor da URL de redirecionamento no URI de redirecionamento da sua aplicação Adobe Sign personalizada.
      Por exemplo, cole https://adobesign1.service-now.com/oauth_redirect.do.

    Resultado

    A instância pode solicitar tokens OAuth 2.0 para o spoke e um token de atualização é criado para gerar novamente os tokens.

    Criar registros de credenciais para o Adobe Sign spoke

    Autorize as ações Adobe Sign spoke criando registros de credenciais para a aplicação registrada em Adobe Sign. O alias de conexão e credencial Adobe Sign spoke usa essas credenciais para autorizar ações.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > 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.
    4. No formulário, preencha os campos.
      Campo Valor necessário
      Nome Nome para identificar exclusivamente o registro. Por exemplo, credenciais do Adobe Sign.
      Ativo Opção de usar ativamente o registro de credencial.
      Perfil de Entidade OAuth Perfil OAuth criado durante o registro de Adobe Sign spoke como um provedor OAuth. Por exemplo, selecione o perfil OAuth do Adobe Sign.
      Aplica-se a O MID Servers que podem usar estas credenciais. Por exemplo: selecione Todos os MID Servers.
      Ordem Ordem na qual as credenciais são usadas. Por exemplo: insira 100.
    5. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.
    6. Para gerar o token OAuth, clique no link relacionado Obter Token OAuth.

    Resultado

    O registro de credencial para Adobe Sign spoke foi criado.

    Criar alias de conexão e credencial para o grupo Adobe Sign

    Gerencie informações de conexão e credencial de um grupo Adobe Sign para autorizar as ações específicas do grupo criando alias de conexão e credencial para o grupo Adobe Sign.

    Antes de Iniciar

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Uma amostra de alias de conexão e credencial é fornecida para fins de demonstração. Se você estiver usando o alias de amostra, não será necessário criar um alias de conexão e credencial. No entanto, o administrador deve criar um alias para todos os outros grupos Adobe Sign para sincronizar esse grupo com a instância ServiceNow.

    Procedimento

    1. Navegar até Todos > Conexões e Credenciais > Aliases de conexão e credencial.
    2. Clique em Nova.
    3. No formulário, preencha os campos.
      Tabela 1. Formulário Aliases de conexão e credencial
      Campo Descrição
      Nome Nome para identificar exclusivamente o alias. Por exemplo, AdobeSign_Legal.
      ID ID exclusivo gerado pelo sistema.
      Aplicação Escopo da aplicação que contém este registro. Selecione Spoke do Adobe Sign.
      Tipo Tipo de alias. Selecione Conexão e credencial.
      Tipo de conexão Tipo de conexão. Selecione HTTP.
      Suporte a várias conexões ativas Opção para especificar se o alias é compatível com várias conexões ativas.
    4. Clique em Salvar.

    Resultado

    O alias de conexão e credencial é criado para o grupo Adobe Sign, e o grupo pode ser sincronizado com a instância ServiceNow.

    Criar registro de conexão e atributos de conexão para o Adobe Sign spoke

    Execute ações em Adobe Sign criando registros de conexão e atributos de conexão para o seu grupo Adobe Sign. O alias de conexão e credencial Adobe Sign spoke usa essas conexões para executar ações em Adobe Sign.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > Conexões e Credenciais > Aliases de conexão e credencial.
    2. Aberto para o registro de Adobe Sign.
    3. Na lista relacionada Conexões, clique em Novo.
    4. No formulário, preencha os campos.
      Tabela 2. Formulário de conexão HTTP
      Campo Valor necessário
      Nome Nome para identificar exclusivamente o registro. Por exemplo, Conexão do Adobe Sign.
      Credenciais Registro de credencial criado para Adobe Sign spoke. Por exemplo, credenciais do Adobe Sign.
      Alias de conexão Registro de alias associado a esta conexão.
      Construtor de URL
      Nota:
      Não marque a caixa de seleção.
      URL de Conexão URL de conexão. Por exemplo, https://api.eu1.echosign.com/.
      Usar MID Server Opção para usar MID Server. Se a caixa de seleção estiver marcada, defina os campos na lista relacionada Configuração MID Server Avançada.
      Ativo Opção para usar a conexão ativamente.
      Domínio Domínio em que a ação ou atividade é executada.
    5. Clique em Enviar.
    6. Na lista relacionada Atributos de conexão, clique em Novo.
    7. No formulário, preencha os campos.
      Tabela 3. Formulário Atributos de conexão
      Campo Valor necessário
      Tipo Tipo de atributo de conexão. Selecione Cadeia de caracteres.
      Rótulo Nome para identificar o atributo de conexão. Insira Versão.
      Nome da coluna Valor gerado pelo sistema que se baseia no valor inserido em Rótulo.
      Aplicação Escopo da aplicação que contém este registro.
      Nota:
      Certifique-se de que o escopo da aplicação seja Spoke do Adobe Sign.
      Ativo Opção para usar ativamente o atributo de conexão.
      Somente leitura Opção para desabilitar modificações no atributo de conexão. Insira falso.
      Valor padrão Valor padrão do atributo de conexão. Insira v6.
    8. Clique em Enviar.

    Resultado

    O registro de conexão e o atributo de conexão são criados para o alias de conexão e credencial.

    Configurar acesso à aplicação para ServiceNow tabelas

    Permita que Adobe Sign spoke crie a função de usuário administrador de grupo quando um grupo Adobe Sign for sincronizado com tabelas ServiceNow, configurando o acesso à aplicação das tabelas ServiceNow necessárias.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > Definição do Sistema > Tabelas.
    2. Para cada uma das tabelas a seguir, certifique-se de que as opções Pode ler,Pode criare Pode atualizar estão selecionadas na lista relacionada Acesso à aplicação.
      Rótulo Nome
      Função sys_user_role
      Controle de Acesso sys_security_acl
      Funções de Acesso sys_security_acl_role
      Menu de aplicação sys_app_application
      Módulo sys_app_module
    3. Clique em Atualizar.

    Resultado

    O acesso à aplicação das tabelas ServiceNow necessárias está configurado.

    Criar Adobe Sign grupo em ServiceNow

    Sincronize ServiceNow com o grupo necessário em Adobe Sign criando um registro na tabela Detalhes do grupo do AdobeSign [sn_adobesign_spoke_adobesign_group_details].

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > Spoke do Adobe Sign > Grupos.
    2. Clique em Nova.
    3. No formulário, preencha os campos.
      Tabela 4. Formulário Detalhes do grupo do AdobeSign
      Nome do Grupo Nome para identificar exclusivamente o grupo Adobe Sign. Por exemplo, Jurídico.
      ID do grupo ID exclusivo associado ao registro.
      Alias de conexão Alias de conexão criado para sincronizar o grupo [ Adobe Sign com ServiceNow.

    Resultado

    O grupo Adobe Sign necessário é criado em ServiceNow e pode ser gerenciado a partir do Adobe Sign spoke.
    A função de usuário específica para o grupo é criada em ServiceNow, quando o grupo é criado na instância ServiceNow. Por exemplo, uma função de usuário de grupo de RH, sn_adobesign_spoke.HR, é criada quando o grupo de RH é criado em ServiceNow. O administrador ServiceNow pode atribuir essas funções de usuário de grupo a usuários e controlar o acesso a informações específicas de grupo, como:
    • Documentos e acordos
    • Aliases de conexão e credencial
    • Registros de credenciais
    • Registros das aplicações
    • Dados em tabelas do Adobe Sign spoke

    Somente o administrador ServiceNow tem acesso a informações sobre todos os grupos Adobe Sign que estão sincronizados com a instância ServiceNow.

    Sincronizar documentos no grupo [ Adobe Sign com ServiceNow

    Sincronize ServiceNow com o grupo necessário em Adobe Sign para acessar os documentos e acordos específicos do grupo, a partir do Adobe Sign spoke.

    Antes de Iniciar

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Certifique-se de que os grupos estejam definidos e configurados com seus respectivos aliases de conexão e credencial antes de sincronizar os documentos do grupo.

    Procedimento

    1. Navegar até Todos > Spoke do Adobe Sign > Documentos.
      A tabela Documentos do AdobeSign [sn_adobesign_spoke_adobe_sign_documents] é aberta.
    2. Clique na lista relacionada Obter documentos.
      Nota:
      • Se você fez login como administrador, pode sincronizar os documentos de todos os grupos Adobe Sign.
      • Se você fez login como administrador do grupo, poderá sincronizar somente os documentos específicos dos seus grupos Adobe Sign.

    Resultado

    Detalhes de todos os documentos específicos para os grupos Adobe Sign necessários são sincronizados com ServiceNow.