Configuração do ServiceNow

Acesso antecipado:os recursos de pesquisa e ações federadas estão em Acesso antecipado. Esse recurso está sujeito aos "Termos das ofertas pré-GA" na seção Termos gerais de serviço dos Termos específicos de serviço. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Nesta página, descrevemos como configurar uma configuração de terceiros antes de criar o repositório de dados do ServiceNow.

Sites do ServiceNow

O ServiceNow oferece dois sites principais:

1. Site para desenvolvedores:

   • Configura a base de conhecimento, cria fluxos de trabalho e desenvolve aplicativos personalizados.
   • URL: https://developer.servicenow.com.
   • Faça login usando 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.

   • Gerencia usuários, grupos e tarefas de administração do sistema.
   • URL: o URL da sua instância do ServiceNow.
   • Faça login usando suas credenciais de administrador.

Observação: para a configuração a seguir, use o site principal do ServiceNow para configurar o OAuth e as permissões.

Criar conta do ServiceNow

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

1. Acesse developer.servicenow.com e clique em "Fazer login".

2. Selecione Novo usuário? Receba um ID do ServiceNow.

3. Insira as informações necessárias e clique em Inscrever-se. Use seu e-mail e verifique-o usando o link de confirmação enviado para sua caixa de entrada.

Para criar uma instância de desenvolvedor pessoal (PDI, na sigla em inglês):

1. Faça login no site para desenvolvedores usando as credenciais da sua conta e aceite os termos.
2. Clique em Solicitar instância. Após o provisionamento, uma caixa de diálogo de confirmação vai aparecer com a mensagem "Sua instância está pronta!".
3. Salve o URL da instância exibida, um nome de usuário de administrador e uma senha.
4. Para acessar seu novo ambiente, clique no botão Começar a criar no cabeçalho do site para desenvolvedores. Isso abre sua instância em uma nova guia.

Observação: ao fazer login inicial com privilégios administrativos totais, acesse "Administração de usuários" > "Usuários" para mudar a senha de administrador padrão por segurança.

Instância de desenvolvedor

Receber credenciais de autenticação

Para criar um endpoint OAuth e receber as credenciais de autenticação, faça o seguinte:

1. Faça login na instância do PDI ServiceNow usando as credenciais de administrador obtidas na seção Criar conta do ServiceNow.

2. Acesse Todos > OAuth do sistema > Registro de aplicativos.

3. Na página Registros de aplicativos, clique em Novo.

4. Na página Aplicativo OAuth, clique em Criar um endpoint de API OAuth para clientes externos.

5. Na página Novo registro, insira os seguintes campos obrigatórios:

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

6. Clique em Enviar para criar a credencial.

7. Depois do envio, clique no nome para ver o ID do cliente.

8. O secret é mascarado. Clique no ícone de bloqueio ao lado dele para revelar e conferir o chave secreta do cliente.

9. Salve o ID do cliente e a chave secreta do cliente para uso posterior.

Configurar função de administrador

Para elevar seu próprio papel a security_admin, faça o seguinte:

1. Faça login na conta do ServiceNow.

2. Clique no ícone do seu perfil e selecione Promover função.

3. Selecione security_admin e clique em Atualizar. O papel security_admin ajuda a criar papéis e gerenciar usuários.

Para conceder a função security_admin a outro usuário:

1. Selecione Todos e, em seguida, Usuários em Administração de usuários.

2. Localize e selecione o usuário para quem você precisa elevar a função.

3. Na guia Funções, clique em Editar.

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

   Observação: o usuário com a função security_admin precisa clicar no ícone do perfil e selecionar Promover função para usar.

Configurar permissões e funções do usuário

Para criar um repositório de dados do ServiceNow no Gemini Enterprise, conceda as funções e permissões adequadas aos usuários.

Confira abaixo as opções para definir funções e permissões de usuário nas suas instâncias do ServiceNow:

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

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

• Usar uma função de administrador

Para mais informações sobre visibilidade e controle de acesso, consulte Visibilidade de incidentes e controle de acesso.

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

Crie um papel personalizado com o conjunto mínimo de permissões.

Observação: esse procedimento oferece o acesso mais seguro e restrito à entidade incidente. Os usuários só podem encontrar incidentes com os quais estão diretamente associados. Para mais informações, consulte Visibilidade de incidentes e controle de acesso.

1. Acesse Tudo > Administração de usuários > Funções.

2. Clique em Novo.

3. Insira um nome e clique em Enviar.

4. Acesse Segurança do sistema > Controle de acesso (ACL).

5. Clique em Nova para criar uma regra de ACL.

6. Repita as duas etapas a seguir até conceder acesso a todas as tabelas necessárias.

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

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

Acesso obrigatório à tabela

O conector precisa de acesso a essas tabelas para que cada entidade seja executada.

Nome da tabela	Descrição
incidente	Mostrar incidentes nos resultados da pesquisa.
sc_cat_item	Mostrar itens do catálogo nos resultados da pesquisa.
sc_cat_item_user_criteria_mtom	Mostre os usuários que podem acessar itens do catálogo com base nos critérios de usuário.
sc_cat_item_user_criteria_no_mtom	Mostra os usuários que não podem acessar itens do catálogo com base em critérios de usuário.
sc_cat_item_user_mtom	Mostrar quais usuários podem acessar itens do catálogo.
sc_cat_item_user_no_mtom	Mostrar usuários que não podem acessar itens do catálogo.
kb_knowledge	A lista de artigos de conhecimento que podem ser mostrados nos resultados da pesquisa.
kb_knowledge_base	A lista de bases de conhecimento que podem ser mostradas nos resultados da pesquisa.
kb_uc_can_contribute_mtom	Mostrar quem pode contribuir para bases de conhecimento com base nos critérios do usuário.
kb_uc_can_read_mtom	Mostrar quem pode ler bases de conhecimento com base nos critérios do usuário.
kb_uc_cannot_read_mtom	Mostre quem não consegue ler bases de conhecimento com base nos critérios do usuário.
sys_user_role	Lista de funções que podem ser atribuídas aos usuários.
sys_user_has_role	Lista de funções mapeadas para os usuários.
sys_user_group	Lista de segmentos de grupo de usuários.
sys_user_grmember	Lista de participantes do grupo.
sys_user	Lista de todos os usuários.
core_company	Lista de todos os atributos da empresa.
cmn_location	Lista de todos os atributos de local.
cmn_department	Lista de todos os atributos de departamento.
user_criteria	Lista de registros de critérios do usuário.
sp_portal	Vincular o URI do portal nos resultados da pesquisa.
m2m_sp_portal_knowledge_base	URI do portal de links para artigos de conhecimento nos resultados da pesquisa.
m2m_sp_portal_catalog	URI do portal de links para itens do catálogo nos resultados da pesquisa.

Conceder e verificar o acesso à ACL

O conector exige acesso de ACL aos campos de item do catálogo da tabela sc_cat_item.

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

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

   

   Digite `sc_cat_item.*`

2. Verifique se as ACLs foram atualizadas.

3. Acesse sys_security_acl_role_list.do na barra de pesquisa.

4. Defina Papel como o papel que você quer verificar.

   

   Selecione o papel a ser verificado

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

Usar uma função personalizada com administradores de entidades

Usar a função de administrador pode não ser adequado para equipes ou organizações que querem evitar a atribuição de permissões muito poderosas. Essa opção fornece um papel com três permissões específicas que concedem o acesso necessário.

1. Acesse Todos > Segurança do sistema > Usuários e grupos > Funções.

2. Selecione Novo e insira um nome.

3. Clique em Enviar.

4. Encontre o papel criada na lista.

5. Navegue até Contém papéis > Editar.

6. Adicione os seguintes papéis ao papel recém-criado e clique em Salvar.

   • catalog_admin
   • knowledge_admin
   • incident_manager

   

   Adicione papéis e clique no botão "Salvar"

7. Confirme as funções atualizadas.

   

   Confirmar papéis

Usar um papel de administrador

Você pode usar uma função de administrador para extrair dados. Use a função de administrador padrão configurada com a instância ou crie um novo usuário com uma função de administrador fazendo o seguinte:

1. Acesse Todos > Administração de usuários > Usuários.

2. Crie um usuário.

3. Ative a opção Somente acesso ao serviço da Web. Ao selecionar Acesso somente ao serviço da Web, você cria um usuário não interativo.

   • Os usuários interativos podem fazer login na interface do ServiceNow e no portal de serviços usando credenciais padrão ou SSO, com acesso total às páginas da UI e aos endpoints da API.
   • Os usuários não interativos têm acesso restrito UI e só podem autorizar conexões programáticas de API para integração de serviço a serviço.

4. Depois de criar o usuário, selecione-o na lista.

5. Clique em Funções > Editar.

6. Adicionar Administrador.

7. Clique em Salvar para adicionar uma lista de papéis ao usuário.

8. Clique em Definir senha, gere automaticamente e salve.

Conceder um papel a um usuário

1. Acesse Todos > Administração de usuários > Usuários.

2. Encontre ou crie um novo usuário.

3. Se nenhum usuário estiver disponível, acesse Segurança do sistema > Usuários e grupos > Usuários.

4. Clique em Novo.

5. Crie uma conta de serviço na tabela de usuários. Clique em Acesso somente ao serviço da Web.

6. Role a tela até Funções.

7. Clique em Editar.

8. Conceda e atribua o papel criado ao usuário. Com base no tipo de papel que você criou na etapa anterior, selecione o adequado e atribua ao usuário. Clique em Salvar.

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

10. Consiga o nome de usuário e a senha do usuário e clique em Definir senha.

11. Gere uma senha automaticamente e guarde-a para uso posterior.

Visibilidade de incidentes e controle de acesso

Para aumentar a segurança e evitar a exposição não intencional de dados, o conector do ServiceNow usa um controle de acesso restritivo para a entidade incident. Isso garante que os usuários finais só possam ver os incidentes com que estão diretamente associados.

Como parte dessa abordagem restritiva, o conector não respeita permissões amplas e baseadas em função para visibilidade de incidentes. As funções padrão do ServiceNow, como itil e sn_incident_read, que podem conceder a um usuário visibilidade de todos os incidentes na interface do ServiceNow, não concedem o mesmo nível de acesso no Gemini Enterprise.

Os usuários com qualquer uma das seguintes funções têm visibilidade global de incidentes e podem ver todos os incidentes:

• admin
• incident_manager
• change_manager

Todos os outros usuários só podem ver um incidente se o abriram, reabriram, resolveram ou fecharam. Eles também podem ver um incidente se:

• No grupo de atribuições do incidente.
• Um autor da chamada associado ao incidente.
• Um cessionário.
• Em uma lista de interesses.
• Em uma lista de observações de trabalho.
• Em uma lista de atribuídos adicionais.

Esse comportamento impede que um usuário do Gemini Enterprise encontre um incidente a que não tem acesso. Devido às restrições adicionais em comparação com as permissões mais amplas do ServiceNow, esse comportamento pode impedir que um usuário encontre um incidente no Gemini Enterprise a que tem acesso no ServiceNow.