Sincronizar grupo [ Adobe Sign com ServiceNow

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. 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 IntegrationHub.
    • Ativar o Adobe Sign spoke
    • Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Essas etapas são realizadas 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 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 da aplicação 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 na 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 Acordo todos os eventos e Mega-assinar 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 do para obter mais informações sobre como criar webhooks na 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 autenticar. Insira UB7E5BXCXY.
        ID de cliente ID da aplicação criado durante a configuração da conta Adobe Sign.
      4. Clique em Atualizar.

    Resultado

    O webhook é criado na sua conta Adobe Sign e os eventos de assinatura em Adobe Sign são atualizados nas tabelas do 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 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 criado 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 a solicitação e a 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 uma autorização do PKCE.
      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 Adobe Sign Spoke.
      Nota:
      Você deve garantir que o escopo da aplicação seja Adobe Sign Spoke.
      Acessível de Escopo da aplicação a partir do qual este registro pode ser acessado.
      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 do 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.
      URL de redirecionamento 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 requer que um perfil de autenticação mútua seja especificado.
    5. Insira registros para modificadores de escopo de 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 o URL de redirecionamento.
    7. Copie e registre o URL de redirecionamento.
    8. Faça login na sua conta Adobe Sign e edite a configuração da aplicação Adobe Sign personalizada.
      Veja o Adobe Sign desenvolvimento documentação para obter instruções.
    9. Cole o valor do URL de redirecionamento no URI de redirecionamento da 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 tokens novamente.

    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 MID Servers que podem usar esta credencial. Por exemplo, selecione Todos os MID Servers.
      Ordem Ordem em que 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 é criado.

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

    Gerencie as 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

    Um exemplo de alias de conexão e credencial é fornecido 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 Adobe Sign Spoke.
      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 oferece suporte a 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 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 para 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.
      Credencial 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 um MID Server. Se a caixa de seleção estiver marcada, defina os campos na lista relacionada Configuração avançada MID Server.
      Ativo Opção para usar ativamente a conexão.
      Domínio Domínio no qual 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 a versão.
      Nome da coluna Valor gerado pelo sistema que é baseado 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 Adobe Sign Spoke.
      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 o 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 de detalhes do grupo do AdobeSign
      Nome do grupo Nome para identificar exclusivamente o grupo Adobe Sign. Por exemplo, Legal.
      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 do 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 do ServiceNow pode atribuir essas funções de usuário do grupo aos usuários e controlar o acesso às informações específicas do 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 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 dos grupos Adobe Sign necessários são sincronizados com ServiceNow.