Ir para o conteúdo

Pré-requisitos do conector ServiceNow (Descontinuado) no Jitterbit Studio

Aviso

O conector ServiceNow foi descontinuado e não é mais compatível. Em uma versão futura, esse conector será removido permanentemente. Use o conector ServiceNow v2 em seu lugar.

Introdução

Para configurar uma conexão ServiceNow e usar suas atividades, você precisa ter uma instância ServiceNow com um endpoint de API OAuth, sua ID de cliente e segredo do cliente, e um usuário autenticador com permissões específicas.

Criar um endpoint de API OAuth e recuperar sua ID de cliente e segredo do cliente

Siga estas etapas para criar um endpoint de API OAuth e recuperar sua ID de cliente e segredo do cliente para usar na conexão ServiceNow:

  1. Acesse o Portal do Desenvolvedor ServiceNow e clique em Start Building para sua instância ServiceNow.

  2. De qualquer lugar dentro da instância ServiceNow, abra o menu All e navegue até System OAuth > Application Registry:

    Criação de instância ServiceNow

  3. Na página Application Registries, clique no botão New.

  4. Clique em Create an OAuth API endpoint for external clients.

  5. Digite estes detalhes para seu aplicativo:

    • Name: Digite um nome único para o aplicativo, como Jitterbit agent.

    • Client ID: Copie este valor. Este será o Client ID na conexão ServiceNow.

    • Client Secret: Digite um valor ou deixe em branco para que o ServiceNow gere um valor. Este será o Client Secret na conexão ServiceNow.

    • Active: Certifique-se de que Active está selecionado.

  6. Clique em Submit para criar o novo endpoint de API OAuth.

  7. Se deixou o Client Secret em branco para que o ServiceNow gerasse um valor, reabra a entrada para visualizar e copiar o segredo do cliente.

Observação

Retenha o Client ID e Client Secret em um local seguro de onde você possa recuperá-los ao configurar sua conexão ServiceNow.

Criar um usuário autenticador e definir permissões

As próximas seções descrevem como criar um usuário autenticador e definir as permissões necessárias para uso com o conector ServiceNow. O conector exige essas permissões para recuperar metadados do ServiceNow quando uma atividade é configurada.

Siga estas etapas:

  1. Elevar sua função: Você precisará ter temporariamente a função elevada security_admin para concluir as outras etapas nestas seções.

  2. Criar uma função personalizada para o usuário autenticador: O usuário autenticador exigirá uma função personalizada com permissões específicas.

  3. Criar um usuário autenticador: O usuário autenticador será o usuário inserido na conexão ServiceNow.

  4. Criar listas de controle de acesso para as atividades: Dois registros de Lista de Controle de Acesso separados usando a função personalizada são necessários para cada atividade ServiceNow do Jitterbit.

  5. Atribuir funções ao usuário autenticador: Atribua a função personalizada e duas funções de sistema adicionais ao usuário autenticador.

Elevar seu papel

Você precisará ter temporariamente a função elevada security_admin para completar os outros passos nessas seções.

  1. De qualquer lugar dentro da instância ServiceNow, clique no ícone do usuário localizado no canto superior direito da página e depois clique em Elevate role:

    Permissões da instância ServiceNow

  2. Selecione security_admin e clique em Update.

Nota

A função elevada security_admin termina quando a sessão expira ou quando você faz logout da instância ServiceNow.

Criar uma função customizada para o usuário autenticador

O usuário autenticador requer uma função customizada com permissões específicas.

  1. Clique no menu All e navegue até User Administration > Roles.

  2. Crie uma nova função customizada que será usada pelo usuário autenticador em nome do agente Jitterbit clicando em New.

  3. Preencha o formulário:

    • Name: Insira um nome apropriado para a função, como jitterbit_harmony_agent.

      Nota

      O nome de uma função não pode ser alterado após sua criação.

    • Application: Deixe como padrão Global.

    • Requires Subscription: Deixe como padrão Unspecified.

    • Elevated privilege: Deixe como padrão não selecionado.

    • Description: Insira uma descrição apropriada, como Usado pelo usuário autenticador em nome do agente Jitterbit.

  4. Clique em Submit para criar a nova função.

Criar um usuário autenticador

O usuário autenticador será o usuário inserido na conexão Jitterbit ServiceNow. Recomendamos criar um usuário separado com um nome apropriado em vez de usar um usuário existente.

  1. Clique no menu All e navegue até System Security > Users and Groups > Users.

  2. Crie um novo usuário que será o usuário autenticador em nome do agente Jitterbit clicando em New.

  3. Preencha o formulário, inserindo um User ID apropriado (como jitterbit_harmony_agent).

  4. Defina uma senha para o novo usuário clicando em Set Password e seguindo as instruções na tela resultante. Copie e salve a senha, pois ela será necessária pela conexão ServiceNow.

Nota

Você precisará desse nome de usuário e senha para a conexão ServiceNow.

Criar listas de controle de acesso para as atividades

Dois registros de Lista de Controle de Acesso (ACL) separados usando a função customizada são necessários para cada atividade Jitterbit ServiceNow. Siga essas etapas para cada atividade:

  1. Clique no menu All e navegue até System Security > Access Control.

  2. Crie um novo registro de Lista de Controle de Acesso (ACL) clicando em New.

  3. Configure essas configurações para o novo registro de ACL:

Nota

Se a operação apropriada do ServiceNow para uma atividade não estiver configurada na instância do ServiceNow, um erro será retornado em tempo de execução pelo conector.

  • Name: Para conceder acesso ao sys_db_object, insira sys_db_object e selecione Table [sys_db_object] no menu. Deixe o segundo menu definido como --None--.

  • Requires role: Em Role, clique duas vezes em Insert a new row e insira a função personalizada criada anteriormente (como jitterbit_harmony_agent). Clique na marca de seleção verde para adicionar a função à ACL.

  • Clique em Submit para criar a nova ACL. Será solicitado que você verifique as configurações para concluir a criação da nova lista.

  • Repita os três passos anteriores e conceda acesso a sys_glide_object para as quatro operações do ServiceNow, especificando Field class [sys_glide_object] no campo Name. Atribua a mesma função personalizada criada anteriormente.

Se você criar um registro ACL para cada atividade do conector em cada uma das duas tabelas, terá criado oito novos registros ao concluir. É possível classificar a tabela de Access Controls pela data de Updated e esses novos registros aparecerão no topo.

Atribuir funções ao usuário que se autentica

Atribua a função personalizada e duas funções adicionais do sistema ao usuário que se autentica.

  1. Atribua funções ao usuário que se autentica navegando até User Administration > Users e abrindo o usuário que se autentica (como jitterbit_harmony_agent) que você criou anteriormente.

  2. Na sua guia Roles, clique em Edit e clique duas vezes na função personalizada criada acima para adicioná-la às funções de Related Links do usuário que se autentica. Na mesma tela, também é necessário adicionar as duas funções personalize_dictionary e itil à lista Roles para habilitar o acesso às tabelas sys_dictionary e itil.

  3. Clique em Update para salvar a configuração do usuário que se autentica.

Próximas etapas

Após concluir as etapas descritas nesta página, é possível usar o nome de usuário e a senha do usuário que se autentica e o ID do cliente e o segredo da aplicação OAuth criada (se aplicável) na conexão do ServiceNow.