Pré-requisitos para o conector ServiceNow v2 no Jitterbit Studio

Introdução

Para configurar uma conexão ServiceNow v2 e usar suas atividades, é necessário ter um usuário autenticador com permissões específicas associadas à sua instância ServiceNow. Se usar autenticação OAuth 2.0, também será necessário um endpoint de API OAuth e seu ID do cliente e segredo do cliente.

Requisitos de autenticação básica

• Criar um usuário autenticador e definir permissões

Requisitos de autenticação OAuth 2.0

• Criar um usuário autenticador e definir permissões

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

Criar um usuário autenticador e definir permissões

Esta seção descreve como criar um usuário autenticador e definir as permissões necessárias para uso com o conector ServiceNow v2. Esta etapa é obrigatória para autenticação básica e OAuth 2.0. O conector requer essas permissões para recuperar metadados do ServiceNow quando uma atividade é configurada.

Siga estas etapas:

1. Elevar sua função: A função elevada security_admin é temporariamente necessária para concluir as outras etapas desta seção.

2. Criar uma função personalizada para o usuário autenticador: Uma função personalizada com permissões específicas é necessária para o usuário autenticador.

3. Criar um usuário autenticador: As credenciais do usuário autenticador são inseridas na conexão ServiceNow v2 durante a configuração do conector.

4. Criar listas de controle de acesso para as atividades: Dois registros de Lista de Controle de Acesso (ACL) separados usando a função personalizada são necessários para cada atividade ServiceNow v2 funcionar conforme pretendido.

5. Atribuir funções ao usuário autenticador: A função personalizada e duas funções de sistema adicionais devem ser atribuídas ao usuário autenticador.

Elevar sua função

A função elevada security_admin é temporariamente necessária para concluir as outras etapas desta seção. Siga estas etapas para obter a função elevada:

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.

2. Selecione security_admin e clique em Update.

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

Uma função personalizada com permissões específicas é necessária para o usuário autenticador. Siga estas etapas para criar a função personalizada:

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

2. Crie uma nova função personalizada que o usuário autenticador usará em nome do agente Jitterbit clicando em New.

3. Preencha o formulário com as seguintes informações:

   • Name: Digite 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 a criação da função.

   • Application: Deixe como padrão Global.

   • Requires Subscription: Deixe como padrão Unspecified.

   • Elevated privilege: Deixe como padrão desmarcado.

   • Description: Digite 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

As credenciais do usuário autenticador são inseridas na conexão ServiceNow v2 durante a configuração do conector. Recomenda-se criar um usuário separado com um nome apropriado em vez de usar um usuário existente. Siga estas etapas para criar o usuário autenticador:

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.

Criar listas de controle de acesso para as atividades

Dois registros de Lista de Controle de Acesso (ACL) separados usando a função personalizada são necessários para cada atividade ServiceNow v2 funcionar conforme pretendido. Siga estas etapas para configurar ambas as ACLs com os registros corretos:

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

2. Crie um novo registro de ACL clicando em New.

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

   • Type: Selecione record no menu.

   • Operation: Selecione a operação ServiceNow apropriada no menu. A operação read é o tipo de operação mínimo necessário para fazer uma conexão ServiceNow v2. Estas são as operações ServiceNow necessárias para cada atividade ServiceNow v2:

     Atividade do conector ServiceNow v2	Operação ServiceNow
     Query	read
     Create	create
     Update	write
     Delete	delete

     Nota

     Se a operação ServiceNow apropriada para uma atividade não estiver configurada na instância 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.

4. Clique em Submit para criar a nova ACL. Você será solicitado a verificar as configurações para concluir a criação da nova lista.

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

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

Atribuir funções ao usuário autenticador

A função personalizada e duas funções de sistema adicionais devem ser atribuídas ao usuário autenticador. Siga estas etapas para atribuir as funções:

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

2. Na aba Roles, clique em Edit e clique duas vezes na função personalizada criada acima para adicioná-la às funções Related Links do usuário autenticador. Na mesma tela, você também deve 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 autenticador.

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

Se estiver usando autenticação OAuth 2.0, siga estas etapas para criar um endpoint de API OAuth e recuperar seu ID do cliente e segredo do cliente para uso na conexão ServiceNow v2:

1. Faça login no 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.

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 v2.

   • 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 v2.

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

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

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

Próximas etapas

Após concluir as etapas descritas nesta página, você pode usar o nome de usuário do usuário autenticador com sua senha e o ID do cliente e o segredo do aplicativo OAuth criado (se aplicável) na conexão ServiceNow v2.