Pular para o conteúdo principal
Última atualização em

ServiceNow

info

Visualização

Lakewatch está em Pré-visualização privada. Para solicitar acesso, entre em contato com a equipe da sua account Databricks.

Exporte alertas do Lakewatch para ServiceNow. Quando um alerta é criado, o Lakewatch cria um registro de Incidente no ServiceNow através da API de Tabela e o atualiza à medida que o alerta muda. Para saber como a exportação se comporta entre os destinos, consulte Destinos de alertas.

A exportação para o ServiceNow é unidirecional, do Lakewatch para o ServiceNow. O Lakewatch grava na API de Tabela do ServiceNow, autenticando com um aplicativo OAuth que você registro no ServiceNow.

Como o registro é criado e atualizado​

  • Na criação de alerta : o Lakewatch cria um registro de incidente na sua instância do ServiceNow através da Table API.
  • Na alteração : à medida que o título, a descrição ou o estado do alerta mudam, o Lakewatch atualiza o mesmo registro.

O Lakewatch define o ID de correlação do registro como o ID do alerta do Lakewatch para que você possa rastrear um registro até seu alerta, e o Lakewatch atualiza o mesmo registro em vez de criar um duplicado.

Pré-requisitos​

Configurar o ServiceNow​

No ServiceNow, registre um aplicativo OAuth que o Lakewatch usa para criar e atualizar registros de Incidentes. Estes são os passos básicos. Para obter o procedimento exato, consulte a documentação do ServiceNow OAuth.

  1. No ServiceNow, vá para System OAuth > Application Registry e selecione Create an OAuth API endpoint for external clients . Você pode criar um novo aplicativo ou reutilizar um existente.
  2. Defina o Tipo de Cliente como Integração como Serviço , defina a Restrição de Escopo como Escopo amplo e defina o Usuário do Aplicativo OAuth .
  3. Conceda à conta de usuário do aplicativo OAuth a função incident_manager para que ele possa criar e atualizar registros de Incidentes.

Observe o ID da instância, o ID do cliente OAuth e o segredo do cliente.

Armazene o segredo do cliente como um segredo do Unity Catalog​

O Lakewatch lê o segredo do cliente OAuth de um segredo do Unity Catalog, um item protegível com um nome de três níveis no formato catalog.schema.secret, cada vez que exporta um alerta. O Lakewatch armazena apenas o nome do segredo, não o seu valor.

Você pode criar esse segredo com antecedência ou criá-lo embutido durante a configuração da exportação do ServiceNow com o botão Criar segredo . De qualquer forma, criar um segredo requer USE CATALOG no catálogo e a propriedade do esquema ou CREATE SECRET e USE SCHEMA no esquema. Para ver os passos, consulte Criar um segredo.

Permissões necessárias​

Para configurar a exportação do ServiceNow, você precisa do seguinte:

  • READ SECRET no segredo do Unity Catalog que contém o segredo do cliente, ou em seu esquema ou catálogo pai. O Lakewatch verifica se você pode ler o segredo quando salva a configuração. Para concedê-la, consulte Gerenciar permissões em segredos.
  • Permissão para editar a configuração de exportação de alertas nas configurações do workspace.

No momento da exportação, o Lakewatch lê o segredo do cliente como seu service principal. Como o Lakewatch lê o segredo pelo nome sempre que exporta, a rotação do segredo não precisa de toque: atualize o segredo do Unity Catalog e o Lakewatch usará o novo valor na próxima exportação, sem alterações na configuração de exportação.

Configurar exportação do ServiceNow​

Configure um destino ServiceNow para alertas na seção de configurações de Alertas .

  1. Na barra lateral do Lakewatch, vá para Configurações e abra Alertas .
  2. Localize a configuração Exportar em Alertas .
  3. Defina o destino de exportação para ServiceNow .
  4. Para Workspace , mantenha o workspace atual, a menos que o destino esteja atrás da rede de um workspace específico, como um endpoint PrivateLink ou um serviço com restrição de região. A rede deste workspace entrega a exportação.
  5. Em ID da instância , insira seu ID de instância do ServiceNow. Insira apenas o rótulo do host, não a URL completa: para uma instância em https://acme.service-now.com, insira acme.
  6. Em ID do cliente , insira o ID do cliente OAuth do aplicativo que você registrou no ServiceNow.
  7. Defina Segredo do cliente como o segredo do Unity Catalog que contém o segredo do cliente OAuth. Digite ou cole seu nome de três níveis (catalog.schema.secret), clique em Selecionar segredo para escolher um segredo existente ou clique em Criar segredo para criar um a partir do segredo do cliente sem sair da página. Depois de salvar, o campo de segredo torna-se somente leitura; para atualizá-lo, altere o segredo no Unity Catalog.
  8. Salve suas alterações.

Para obter a referência completa das configurações de alerta, consulte Configurar configurações.

Solução de problemas​

  • Os registros não foram criados no ServiceNow : o Usuário do Aplicativo OAuth não pode criar registros de Incidentes, ou o ID da instância está errado. Confirme se o Usuário do Aplicativo tem a função incident_manager e se o ID da instância é apenas o rótulo do host (por exemplo, acme).
  • A configuração não é salva : você não tem permissão para ler o segredo do Unity Catalog ou o nome do segredo não está na forma catalog.schema.secret. Confirme seu acesso ao segredo e ao nome do segredo.
  • Falha na autenticação : o ID do cliente ou o segredo do cliente está incorreto, ou o aplicativo OAuth não tem permissão. Confirme o ID do cliente, o valor do segredo e o acesso do aplicativo no ServiceNow.
  • Você girou o segredo do cliente : atualize o segredo do Unity Catalog com o novo valor. Nenhuma alteração na configuração de exportação é necessária.
Nesta página