Configuração do ServiceNow

Pré-visualização pública: as funcionalidades de pesquisa e ações federadas estão em pré-visualização pública. Esta funcionalidade está sujeita aos "Termos de ofertas de pré-disponibilidade geral" na secção de Termos de Utilização Gerais dos Termos Específicos do Serviço. As funcionalidades pré-GA estão disponíveis "tal como estão" e podem ter apoio técnico limitado. Para mais informações, consulte as descrições das fases de lançamento.

Esta página descreve como configurar uma configuração de terceiros antes de criar o arquivo de dados do ServiceNow.

Sites do ServiceNow

O ServiceNow oferece dois sites principais:

1. Site do programador:

   • Configura a base de conhecimentos, configura fluxos de trabalho e desenvolve aplicações personalizadas.
   • URL: https://developer.servicenow.com.
   • Inicie sessão com o seu ID do ServiceNow.

2. Site principal do ServiceNow [site do ServiceNow para _Personal Developer Instance (PDI)]: o site da sua instância do ServiceNow.

   • Faz a gestão de utilizadores, grupos e tarefas de administração do sistema.
   • URL: o URL da sua instância do ServiceNow.
   • Inicie sessão com as suas credenciais de administrador.

Nota: para a configuração seguinte, use o site principal do ServiceNow para a configuração no OAuth e nas autorizações.

Crie uma conta do ServiceNow

Para criar uma conta do ServiceNow no site para programadores e criar uma instância de PDI, faça o seguinte:

1. Aceda a developer.servicenow.com e clique em Iniciar sessão.

2. Selecione Novo utilizador? Obtenha um ID do ServiceNow.

3. Introduza as informações necessárias e clique em Inscrever-se. Use o seu email e valide-o através do link de confirmação enviado para a sua caixa de entrada.

Para criar uma instância de programador pessoal (PDI):

1. Inicie sessão no site para programadores com as credenciais da sua conta e aceite os termos.
2. Clique em Pedir instância. Após o aprovisionamento, é apresentada uma caixa de diálogo de confirmação com a seguinte mensagem: "A sua instância está pronta!".
3. Guarde o URL da instância apresentado, um nome de utilizador de administrador e uma palavra-passe.
4. Para aceder ao seu novo ambiente, clique no botão Começar a criar no cabeçalho do site para programadores. Esta ação abre a sua instância num novo separador.

Nota: após o início de sessão inicial com privilégios administrativos completos, aceda a Administração de utilizadores > Utilizadores para alterar a palavra-passe de administrador predefinida por motivos de segurança.

Instância do programador

Obtenha credenciais de autenticação

Para criar um ponto final do OAuth e obter as credenciais de autenticação, faça o seguinte:

1. Inicie sessão na instância do PDI ServiceNow com as credenciais de administrador que obteve na secção Crie uma conta do ServiceNow.

2. Navegue para Tudo > OAuth do sistema > Registo de aplicações.

3. Na página Registos de aplicações, clique em Novo.

4. Na página Aplicação OAuth, clique em Criar um ponto final da API OAuth para clientes externos.

5. Na página Novo registo, introduza os seguintes campos obrigatórios:

   1. Nome: introduza um nome exclusivo.
   2. URL de redirecionamento: introduza o URL de redirecionamento: https://vertexaisearch.cloud.google.com/console/oauth/servicenow_oauth.html

6. Clique em Enviar para criar a credencial.

7. Após o envio, clique no nome para ver o ID de cliente.

8. O segredo está oculto. Clique no ícone de cadeado junto ao mesmo para desmascarar e ver o segredo do cliente.

9. Guarde o ID de cliente e o segredo do cliente para utilização posterior.

Configure a função de administrador

Para elevar a sua própria função para security_admin, faça o seguinte:

1. Inicie sessão na conta do ServiceNow.

2. Clique no ícone do seu perfil e, de seguida, selecione Elevar função.

3. Selecione security_admin e, de seguida, clique em Atualizar. A função security_admin ajuda a criar funções e gerir utilizadores.

Para conceder a função security_admin a outro utilizador:

1. Selecione Tudo e, de seguida, Utilizadores em Administração de utilizadores.

2. Localize e selecione o utilizador para o qual tem de elevar a função.

3. No separador Funções, clique em Editar.

4. Selecione a função security_admin em Coleção e adicione-a à Lista de funções.

   Nota: o utilizador com a função security_admin tem de clicar no ícone do perfil e selecionar Elevar função para a usar.

Configure funções e autorizações de utilizadores

Para criar um repositório de dados do ServiceNow no Gemini Enterprise, tem de conceder as funções e as autorizações adequadas aos utilizadores.

Seguem-se as opções para definir funções e autorizações de utilizadores para as suas instâncias do ServiceNow:

• Crie uma função personalizada com regras de ACL (recomendado)

• Use uma função personalizada com administradores de entidades

• Use uma função de administrador

Para mais informações sobre a visibilidade e o controlo de acesso, consulte o artigo Visibilidade e controlo de acesso a incidentes

Crie uma função personalizada com regras de LCA (recomendado)

Crie uma função personalizada com o conjunto mínimo de autorizações.

Nota: este procedimento oferece o acesso mais seguro e restritivo à entidade incidente. Os utilizadores só podem encontrar incidentes aos quais estão diretamente associados. Para mais informações, consulte o artigo Visibilidade de incidentes e controlo de acesso.

1. Aceda a Tudo > Administração de utilizadores > Funções.

2. Clique em Novo.

3. Introduza um nome e clique em Enviar.

4. Aceda a Segurança do sistema > Controlo de acesso (ACL).

5. Clique em Nova para criar uma nova regra de LCA.

6. Repita os dois passos seguintes até conceder acesso a todas as tabelas necessárias.

   1. Use sys_user_role como exemplo para ver como é concedido o acesso à tabela.

   2. Clique em Enviar e selecione a função.

Acesso à tabela necessário

O conetor precisa de acesso a estas tabelas para que cada entidade seja executada.

Nome da tabela	Descrição
incidente	Mostrar incidentes nos resultados da pesquisa.
sc_cat_item	Mostrar artigos do catálogo nos resultados da pesquisa.
sc_cat_item_user_criteria_mtom	Mostrar utilizadores que podem aceder a itens do catálogo com base em critérios do utilizador.
sc_cat_item_user_criteria_no_mtom	Mostrar utilizadores que não podem aceder a itens do catálogo com base nos critérios do utilizador.
sc_cat_item_user_mtom	Mostrar que utilizadores podem aceder aos itens do catálogo.
sc_cat_item_user_no_mtom	Mostrar utilizadores que não conseguem aceder a itens do catálogo.
kb_knowledge	A lista de artigos de conhecimentos que podem ser apresentados nos resultados da pesquisa.
kb_knowledge_base	A lista de bases de conhecimentos que podem ser apresentadas nos resultados da pesquisa.
kb_uc_can_contribute_mtom	Mostrar quem pode contribuir para as bases de conhecimentos com base nos critérios do utilizador.
kb_uc_can_read_mtom	Mostrar quem pode ler as bases de conhecimentos com base nos critérios do utilizador.
kb_uc_cannot_read_mtom	Mostrar quem não pode ler as bases de conhecimentos com base nos critérios do utilizador.
sys_user_role	Lista de funções que podem ser atribuídas aos utilizadores.
sys_user_has_role	Lista de funções mapeadas para os utilizadores.
sys_user_group	Lista de segmentos de grupos de utilizadores.
sys_user_grmember	Lista de membros do grupo para grupos.
sys_user	Lista de todos os utilizadores.
core_company	Lista de todos os atributos da empresa.
cmn_location	Lista de todos os atributos de localização.
cmn_department	Lista de todos os atributos do departamento.
user_criteria	Lista de registos de critérios do utilizador.
sp_portal	URI do portal de links nos resultados da pesquisa.
m2m_sp_portal_knowledge_base	URI do portal de links para artigos de conhecimentos nos resultados da pesquisa.
m2m_sp_portal_catalog	URI do portal de links para itens do catálogo nos resultados da pesquisa.

Conceda e valide o acesso à LCA

O conetor requer acesso ACL aos campos do item do catálogo da tabela sc_cat_item.

Para conceder e validar o acesso, faça o seguinte:

1. Conceda acesso explícito criando uma nova regra de ACL e introduzindo manualmente sc_cat_item.* no campo Nome do formulário.

   

   Introduza `sc_cat_item.*`

2. Verifique se as ACLs estão atualizadas.

3. Aceda a sys_security_acl_role_list.do na barra de pesquisa.

4. Defina Role para a função que quer validar.

   

   Selecione a função a validar

5. Verifique se as ACLs necessárias estão atribuídas à função.

Use uma função personalizada com administradores de entidades

A utilização da função de administrador pode não ser adequada para equipas ou organizações que pretendam evitar a atribuição de autorizações excessivamente poderosas. Esta opção oferece uma função com três autorizações específicas que concedem o acesso necessário.

1. Aceda a Tudo > Segurança do sistema > Utilizadores e grupos > Funções.

2. Selecione Novo e introduza um nome.

3. Clique em Enviar.

4. Encontre a função criada na lista.

5. Navegue para Contém funções > Editar.

6. Adicione as seguintes funções à função recém-criada e, de seguida, clique em Guardar.

   • catalog_admin
   • knowledge_admin
   • incident_manager

   

   Adicione funções e clique no botão Guardar

7. Confirme as funções atualizadas.

   

   Confirme as funções

Use uma função de administrador

Pode usar uma função de administrador para extrair dados. Use a função de administrador predefinida configurada com a instância ou crie um novo utilizador com uma função de administrador fazendo o seguinte:

1. Aceda a Tudo > Administração de utilizadores > Utilizadores.

2. Crie um novo utilizador.

3. Ative a opção Apenas acesso ao serviço Web. Quando seleciona a opção Acesso apenas ao serviço Web, cria um utilizador não interativo.

   • Os utilizadores interativos podem iniciar sessão na IU e no portal de serviços do ServiceNow através de credenciais padrão ou SSO, com acesso total às páginas da IU e aos pontos finais da API.
   • Os utilizadores não interativos têm acesso restrito à IU e estão limitados à autorização de ligações de API programáticas para integração de serviço a serviço.

4. Após a criação do utilizador, selecione-o na lista de utilizadores.

5. Clique em Funções > Editar.

6. Adicione Administrador.

7. Clique em Guardar para adicionar uma lista de funções ao utilizador.

8. Clique em Definir palavra-passe, gere-a automaticamente e guarde-a.

Conceda uma função a um utilizador

1. Aceda a Tudo > Administração de utilizadores > Utilizadores.

2. Encontre ou crie um novo utilizador.

3. Se não estiver disponível nenhum utilizador, aceda a Segurança do sistema > Utilizadores e grupos > Utilizadores.

4. Clique em Novo.

5. Crie uma nova conta de serviço na tabela de utilizadores. Certifique-se de que clica em Acesso apenas ao serviço Web.

6. Desloque a página até Funções.

7. Clique em Edit.

8. Conceda a função que criou e atribua-a ao utilizador. Com base no tipo de função que criou no passo anterior, selecione a adequada e atribua-a ao utilizador. Clique em Guardar.

9. Veja a função personalizada com a ACL.

10. Obtenha o nome de utilizador e a palavra-passe do utilizador e clique em Definir palavra-passe.

11. Gerar automaticamente uma palavra-passe e guardá-la para utilização posterior.

Visibilidade de incidentes e controlo de acesso

Para melhorar a segurança e evitar a exposição não intencional de dados, o conetor do ServiceNow usa um controlo de acesso restritivo para a entidade incidente. Isto garante que os utilizadores finais só podem ver incidentes aos quais estão diretamente associados.

Como parte desta abordagem restritiva, o conector não respeita as autorizações amplas baseadas em funções para a visibilidade de incidentes. As funções padrão do ServiceNow, como itil e sn_incident_read, que podem conceder a um utilizador visibilidade sobre todos os incidentes na IU do ServiceNow, não concedem o mesmo nível de acesso no Gemini Enterprise.

Os utilizadores com qualquer uma das seguintes funções têm visibilidade global dos incidentes e podem ver todos os incidentes:

• admin
• incident_manager
• change_manager

Todos os outros utilizadores só podem ver um incidente se o tiverem aberto, reaberto, resolvido ou fechado. Também podem ver um incidente se:

• No grupo de atribuição do incidente.
• Uma pessoa que ligou associada ao incidente.
• Um destinatário.
• Numa lista de visualização.
• Numa lista de notas profissionais.
• Numa lista de responsáveis adicional.

Este comportamento impede que um utilizador do Gemini Enterprise encontre um incidente ao qual não tem acesso. Devido às restrições adicionais em comparação com as autorizações mais amplas do ServiceNow, este comportamento pode, ocasionalmente, impedir que um utilizador encontre um incidente no Gemini Enterprise ao qual tem acesso no ServiceNow.