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

Introdução

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

Requisitos básicos de autenticação:

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

Requisitos de autenticação OAuth 2.0:

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

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

Criar um usuário autenticado e definir permissões

Esta seção descreve como criar um usuário autenticado e definir as permissões necessárias para uso com o conector ServiceNow v2 (Beta). O conector requer essas permissões para recuperar metadados do ServiceNow quando uma atividade é configurada.

Siga estas etapas:

1. Elevar seu papel: O papel elevado security_admin é temporariamente necessário para concluir as outras etapas nesta seção.

2. Criar um papel personalizado para o usuário autenticado: Um papel personalizado com permissões específicas é necessário para o usuário autenticado.

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

4. Criar listas de controle de acesso para as atividades: Dois registros separados de Lista de Controle de Acesso (ACL) usando o papel personalizado são necessários para que cada atividade do ServiceNow v2 (Beta) funcione conforme o esperado.

5. Atribuir papéis ao usuário autenticador: O papel personalizado e dois papéis de sistema adicionais devem ser atribuídos ao usuário autenticador.

Elevar seu papel

O papel elevado security_admin é temporariamente necessário para completar os outros passos nesta seção. Siga estas etapas para obter o papel elevado:

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

2. Selecione security_admin e clique em Atualizar.

Criar um papel personalizado para o usuário autenticador

Um papel personalizado com permissões específicas é necessário para o usuário autenticador. Siga estas etapas para criar o papel personalizado:

1. Clique no menu Todos e navegue até Administração de Usuários > Papéis.

2. Crie um novo papel personalizado que o usuário autenticador usará em nome do agente Jitterbit clicando em Novo.

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

   • Nome: Insira um nome apropriado para o papel, como jitterbit_harmony_agent.

     Nota

     O nome de um papel não pode ser alterado uma vez que o papel é criado.

   • Aplicativo: Deixe como o padrão Global.

   • Requer Assinatura: Deixe como o padrão Não Especificado.

   • Privilégio Elevado: Deixe como o padrão não selecionado.

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

4. Clique em Enviar para criar o novo papel.

Criar um usuário autenticador

As credenciais do usuário autenticado são inseridas na conexão ServiceNow v2 (Beta) 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 autenticado:

1. Clique no menu Todos e navegue até Segurança do Sistema > Usuários e Grupos > Usuários.

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

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

4. Defina uma senha para o novo usuário clicando em Definir Senha e seguindo as instruções na tela resultante.

Criar listas de controle de acesso para as atividades

São necessários dois registros de Lista de Controle de Acesso (ACL) separados usando o papel personalizado para que cada atividade do ServiceNow v2 (Beta) funcione conforme o esperado. Siga estas etapas para configurar ambas as ACLs com os registros corretos:

1. Clique no menu Todos e navegue até Segurança do Sistema > Controle de Acesso.

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

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

   • Tipo: Selecione registro no menu.

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

     Atividade do conector ServiceNow v2 (Beta)	Operação do ServiceNow
     Consulta	leitura
     Criar	criar
     Atualizar	escrever
     Excluir	excluir

     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.

   • Nome: Para conceder acesso ao sys_db_object, insira sys_db_object e selecione Tabela [sys_db_object] no menu. Deixe o segundo menu definido como --Nenhum--.

   • Requer papel: Em Papel, clique duas vezes em Inserir uma nova linha e, em seguida, insira o papel personalizado criado anteriormente (como jitterbit_harmony_agent). Clique na marca de verificação verde para adicionar o papel ao ACL.

4. Clique em Enviar para criar o novo 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 do ServiceNow, especificando Classe de campo [sys_glide_object] no campo Nome. Atribua o mesmo papel personalizado criado anteriormente.

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

Atribuir papéis ao usuário autenticado

O papel personalizado e dois papéis de sistema adicionais devem ser atribuídos ao usuário autenticado. Siga estas etapas para atribuir os papéis:

1. Atribua papéis ao usuário autenticado navegando até Administração de Usuários > Usuários e abrindo o usuário autenticado (como jitterbit_harmony_agent) que você criou anteriormente.

2. Na aba Papéis, clique em Editar e clique duas vezes no papel personalizado criado acima para adicioná-lo aos papéis de Links Relacionados do usuário autenticado. Na mesma tela, você também deve adicionar os dois papéis personalize_dictionary e itil à lista de Papéis para habilitar o acesso às tabelas sys_dictionary e itil.

3. Clique em Atualizar para salvar a configuração para o usuário autenticado.

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

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

1. Faça login no Portal do Desenvolvedor ServiceNow e clique em Começar a Construir para sua instância ServiceNow.

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

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

4. Clique em Criar um endpoint de API OAuth para clientes externos.

5. Insira estes detalhes para seu aplicativo:

   • Nome: Insira um nome exclusivo para o aplicativo, como Agente Jitterbit.

   • ID do Cliente: Copie este valor. Este será o ID do Cliente na conexão ServiceNow v2 (Beta).

   • Segredo do Cliente: Insira um valor ou deixe em branco para que o ServiceNow gere um valor. Este será o segredo do cliente na conexão ServiceNow v2 (Beta).

   • Ativo: Certifique-se de que Ativo esteja selecionado.

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

7. Se você deixou o Segredo do Cliente 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 autenticado com sua senha e o ID do cliente e segredo da aplicação OAuth criada (se aplicável) na conexão ServiceNow v2 (Beta).