Configurar uma instância do ServiceNow para CDC

Visualizar

Este recurso está sujeito aos Termos das Soluções 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.

É possível usar o Datastream para replicar dados de uma instância do ServiceNow para um destino compatível, como o BigQuery ou o Cloud Storage. Antes de criar um perfil de conexão, configure um usuário de integração dedicado, configure a autenticação básica ou OAuth 2.0 e inclua os endereços IP do Datastream na lista de permissões, se necessário.

Antes de começar

Antes de configurar o ServiceNow para uso com o Datastream, verifique se você tem:

• Uma instância ativa do ServiceNow, por exemplo, company.service-now.com.
• Privilégios de administrador na instância do ServiceNow para criar usuários, atribuir papéis e gerenciar o registro de aplicativos OAuth.
• Conhecimento da versão da instância do ServiceNow.

Configurar um usuário de integração

No ServiceNow, é possível criar um novo usuário ou ajustar as configurações de uma conta para permitir o acesso do Datastream. Por motivos de segurança e auditoria, recomendamos que você crie um usuário de integração dedicado.

1. No ServiceNow, acesse User Administration > Users.
2. Para criar um novo usuário, clique em Novo. Para editar um usuário, pesquise o ID do usuário na lista e clique nele para abrir o registro.

3. Configure os detalhes do usuário:

   • Insira um nome exclusivo no campo ID do usuário, por exemplo, datastream_integration. Você define o identificador de usuário apenas para novos usuários.
   • Se você selecionar a autenticação OAuth para o conector, recomendamos que insira valores nos campos Nome e Sobrenome para identificar melhor o registro do usuário.

   • Configuração de identidade: com base na versão da plataforma ServiceNow:

     • Xanadu e versões mais recentes: selecione Máquina no menu suspenso Tipo de identidade. Isso ativa automaticamente a opção Somente acesso ao serviço da Web.
     • Pré-Xanadu: marque a caixa de seleção Somente acesso ao serviço da Web.

4. Salve o registro:

   • Para novos usuários, clique em Enviar.
   • Para usuários atuais, clique em Atualizar.

5. Se você criou um novo usuário, reabra o registro. Encontre o usuário na lista e clique no ID do usuário para acessar as opções de registro.

6. Defina uma senha:

   1. Clique em Definir senha no cabeçalho do formulário.
   2. Digite uma senha forte e clique em Salvar senha.
   3. Se você usar a autenticação básica para o conector, anote a senha, porque ela é necessária ao configurar o perfil de conexão.

7. Atribuir permissões. É necessário conceder ao usuário de integração acesso de leitura a todas as tabelas que você quer replicar. Além disso, o conector requer permissões de leitura explícitas para as tabelas de metadados do sistema sys_db_object, sys_table_rotation e sys_dictionary.

Devido à natureza granular dos papéis do ServiceNow e do sistema de lista de controle de acesso (ACL), a configuração específica necessária para conceder essas permissões é específica do cliente.

• Recomendamos atribuir o papel snc_read_only ao usuário, porque isso garante que a sessão dele seja estritamente limitada ao acesso somente leitura em toda a plataforma.
• A função de administrador concede acesso total a todas as tabelas na instância. Se as políticas de segurança permitirem, atribuir o papel de administrador é o método mais simples para garantir acesso total ao conector.

Opcional: configurar as credenciais do cliente OAuth 2.0

O OAuth 2.0 é o método de autenticação mais seguro e recomendado para usar o conector do ServiceNow com o Datastream. Ele usa um ID do cliente e uma chave secreta do cliente em vez de uma senha permanente.

1. Ative o plug-in do OAuth 2.0 para sua instância. Para mais informações, consulte a documentação do ServiceNow.
2. Verifique se a propriedade do sistema com.snc.platform.security.oauth.is.active está definida como true. Para mais informações, consulte a documentação do ServiceNow.
3. Verifique se a propriedade do sistema glide.oauth.inbound.client.credential.grant_type.enabled está definida como true. Para mais informações, consulte a documentação do ServiceNow.

4. Defina a configuração de entrada do OAuth. Dependendo dos requisitos de segurança da instância, selecione um dos seguintes escopos de configuração do OAuth:

   • Escopo amplo: ao usar o OAuth de escopo amplo, o portador do token herda os papéis de usuário e as listas de controle de acesso (ACLs) associados.
   • Escopo de autenticação granular da API REST: esse tipo de configuração do OAuth restringe a APIs REST e métodos específicos permitidos pelo escopo, além de papéis de usuário e ACLs associados.

5. Crie o registro de integração do OAuth. Para mais informações, consulte a documentação do ServiceNow:

   • Para a versão da plataforma Zurich e mais recentes
   • Para versões da plataforma anteriores à Zurich

6. Depois de criar o registro de integração do OAuth, a configuração depende da versão da plataforma e do escopo do OAuth:

   • Configuração de escopo amplo:

     • Zurique e versões mais recentes:na seção Escopo de autenticação do registro de integração, verifique se não há entradas nos campos Escopo de autenticação ou Limitar autorização às seguintes APIs e se a caixa de seleção Permitir acesso apenas às APIs no escopo selecionado não está marcada.
     • Pré-Zurique:no menu suspenso Restrição de escopo, selecione Escopo amplo e deixe a lista Escopos de autenticação vazia.

   • Configuração granular com escopo de autenticação da API REST: se quiser, use escopos de autenticação para limitar ainda mais o portador do token a APIs REST e métodos específicos permitidos pelo escopo. O conector do Datastream só requer acesso GET à API Table. Dependendo da versão da plataforma, siga as etapas abaixo:

     • Zurique e versões mais recentes: na seção Escopo de autenticação do registro de integração, selecione um escopo de autorização e limite o acesso dele à API Table.

       Observação: se você criar o escopo de autorização ao editar o registro de integração, o escopo terá acesso a todos os métodos da API Table por padrão. Para limitar ainda mais o acesso apenas ao método GET, é preciso editar manualmente o registro recém-criado acessando System Web Services > API Auth Scopes > REST API Auth Scope.

     • Pré-Zurique:

       1. Restrinja o acesso à API Table para o escopo de autorização selecionado. Para mais informações, consulte a documentação do ServiceNow.
       2. Adicione o escopo na seção Escopos de autenticação.
       3. Selecione Escopo seguro na caixa Restrição de escopo.

Opcional: configurar o controle de acesso de endereços IP

Se a instância do ServiceNow usar o controle de acesso de endereço IP, será necessário incluir explicitamente os endereços IP do Datastream na lista de permissões.

As etapas a seguir só serão necessárias se você tiver uma regra de controle de acesso de endereço IP DENY que abranja os endereços IP do Datastream. Por padrão, não há restrições de IP no acesso à instância.

1. No ServiceNow, acesse Segurança do sistema > Controle de acesso de endereços IP.
2. Clique em Novo.
3. No formulário de criação de registro, aplique as seguintes configurações:
   1. No menu suspenso Tipo, selecione Permitir.
   2. No menu suspenso Direção, selecione Entrada.
   3. Nos campos Início do intervalo e Fim do intervalo, insira o endereço IP específico ou o intervalo de endereços da lista de endereços IP do Datastream.
   4. Verifique se a caixa de seleção Ativo está marcada.
4. Clique em Enviar.
5. Repita as etapas anteriores para cada endereço IP na lista de endereços do Datastream.

A seguir

• Saiba mais sobre a origem do ServiceNow.