Pré-requisitos do ServiceNow¶

Introdução¶

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

• Crie um endpoint da API OAuth e recupere seu ID e segredo do cliente

• Criar um usuário de autenticação e definir permissões

Crie um Endpoint de API OAuth e Recupere Seu ID e Segredo do Cliente¶

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:

1. Faça login no Portal do desenvolvedor ServiceNow e clique em Iniciar criação para sua instância do ServiceNow.

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

   

3. Na página Registros de Aplicativos, 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 Harmony.

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

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

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

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

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

Crie um Usuário de Autenticação e Defina Permissões¶

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

Siga esses passos:

1. Eleve sua papel: você precisará ter temporariamente a papel elevada security_admin para concluir as outras etapas nestas seções.

2. Crie uma papel personalizada para o usuário autenticador: o usuário autenticador exigirá uma papel personalizada com permissões específicas.

3. Crie 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 separados da Lista de Controle de Acesso usando a papel personalizada são necessários para cada atividade do Jitterbit ServiceNow.

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

Eleve Seu Papel¶

Você precisará ter temporariamente a papel elevada security_admin para concluir as outras etapas nestas seções.

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

   

2. Selecione security_admin e clique em Atualizar.

Crie uma Papel Personalizada para o Usuário Autenticador¶

O usuário autenticador requer uma papel personalizada com permissões específicas.

1. Clique no menu Todos e navegue até Administração de usuários > Funções.

2. Crie uma nova papel personalizada que será usada pelo usuário autenticador em nome do agente Harmony clicando em Novo.

3. Preencha o formulário:

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

     Nota

     O nome de uma papel não pode ser alterado depois que a papel for criada.

   • Aplicativo: Deixe como padrão Global.

   • Requer assinatura: Deixe como padrão Não especificado.

   • Privilégio elevado: Deixe como padrão desmarcado.

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

4. Clique em Enviar para criar a nova papel.

Crie um Usuário de Autenticação¶

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 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 autenticador em nome do agente Harmony 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. Copie e salve a senha, pois ela será exigida pela conexão ServiceNow.

Crie Listas de Controle de Acesso para as Atividades¶

Dois registros separados da Lista de Controle de Acesso usando a papel personalizada são necessários para cada atividade do Jitterbit ServiceNow. Siga estas etapas para cada atividade:

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

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

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

   • Tipo: Selecione gravar no menu.

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

     Atividade do conector Jitterbit ServiceNow	Operação ServiceNow
     Atividade de criação do ServiceNow	criar
     Atividade de consulta do ServiceNow	ler
     Atividade de atualização do ServiceNow	escrever
     Excluir atividade do ServiceNow	apagar

     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 Table [sys_db_object] no menu. Deixe o segundo menu definido como --None--.

   • Requer papel: Em Função, clique duas vezes em Inserir uma nova linha e insira a papel personalizada criada anteriormente (como jitterbit_harmony_agent). Clique na marca de seleção verde para adicionar a papel à ACL.

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

5. Repita as três etapas anteriores e conceda acesso ao sys_glide_object para as quatro operações do ServiceNow especificando Field class [sys_glide_object] no campo Name. Atribua a mesma papel personalizada criada anteriormente como acima.

Se você criar uma ACL para cada atividade do conector e cada uma das duas tabelas, terá criado oito novos registros quando concluído. Você pode classificar a tabela de Controles de acesso pela data de Atualização e esses novos registros aparecerão no topo.

Atribuir Funções ao Usuário Autenticador¶

Atribua a papel personalizada e duas funções de sistema adicionais ao usuário autenticador.

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

2. Na aba Funções, clique em Editar e clique duas vezes na papel personalizada criada acima para adicioná-la às funções Links relacionados do usuário autenticador. Na mesma tela, você também deve adicionar as duas funções personalize_dictionary e itil à lista Roles para permitir o acesso às tabelas sys_dictionary e itil.

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

Resumo¶

Com todas essas etapas concluídas, você pode usar o usuário autenticador como nome de usuário e sua senha com o ID do cliente e segredo do aplicativo OAuth criado na conexão ServiceNow.