Skip to main content

​
O que esta integração fornece

O Netskope pode fornecer atividades normalizadas de web, nuvem, autenticação, proteção de dados e ameaças. Entre os exemplos analisados, estão:
  • web.ai.visited — site de IA visitado
  • data.bulk.uploaded — upload de dados em massa
  • geo.impossible — viagem impossível entre logins
A conexão atual usa a REST API v2; uma variante REST legada pode aparecer para clientes existentes. Consulte como os dados de integração se tornam Sinais.

​
O que o Living Security precisa

Acesso necessário aos endpoints: Função necessária: Tenant Admin ou equivalente, com acesso a Configurações → Tools
Esta integração exige um token de API v2, não um token v1. Os tokens v1 usam autenticação por parâmetro de consulta e não funcionam com o endpoint da API v2.

​
Pré-requisitos

  • É necessário ter acesso de Tenant Admin no Netskope para gerenciar tokens da REST API.

​
Parte A — No Netskope

O administrador do Netskope da sua organização realiza estas etapas.
1

Acesse o gerenciamento de tokens da REST API v2

  1. Faça login no console de administração do Netskope em https://<tenant>.goskope.com.
  2. Na navegação à esquerda, clique em Configurações.
  3. Em Tools, selecione REST API v2.
2

Crie um novo token

  1. Clique em New Token.
  2. Informe um nome descritivo (por exemplo, Living Security Platform).
  3. Em acesso aos endpoints, habilite o acesso a:
Conceda acesso a ambos os endpoints. Eles alimentam dois fluxos distintos — alerts e events — e um token restrito a apenas um deles ainda se conecta com êxito. O fluxo associado ao endpoint ausente, então, não retorna nada, sem nenhum erro que indique o motivo.
Esses dois são os únicos endpoints que o Living Security exige. Não conceder nada além deles segue o princípio do menor privilégio.
  1. Clique em Salvar (ou em Generate Token).
3

Copie e salve o seu token

Copie o token imediatamente e armazene-o em local seguro.
O Netskope exibe o valor do token apenas uma vez, no momento da criação. Se você sair da página sem copiá-lo, será necessário excluir o token e criar um novo.
4

Configure a lista de IPs permitidos (se aplicável)

Se o seu tenant do Netskope tiver a lista de IPs permitidos habilitada, você deve adicionar os intervalos de IP de saída do Living Security.
  1. No console de administração do Netskope, acesse Configurações → Administração → IP Allowlist.
  2. Se a lista de IPs permitidos estiver habilitada, adicione cada endereço IP de saída do Living Security à lista Custom IP.
Se a lista de IPs permitidos estiver habilitada, a caixa de diálogo de conexão será concluída com êxito, mas as sincronizações de dados falharão com 401 Unauthorized até que os IPs corretos sejam adicionados.
5

Identifique o subdomínio do seu tenant

O subdomínio do seu tenant é o prefixo da URL do console de administração do Netskope.Se a URL do seu console for https://acme.goskope.com, o seu subdomínio será acme.Informe somente o subdomínio simples — sem https://, sem .goskope.com e sem barra final.
A caixa de diálogo de conexão aceita vários formatos de entrada (subdomínio simples, nome de host completo ou URL completa) e os normaliza automaticamente. No entanto, recomenda-se informar o subdomínio simples.

​
Parte B — Na Living Security Platform

O responsável pelo programa realiza esta etapa, ou o administrador do sistema, caso seja usada a configuração delegada.
Agora você está conectado ao Netskope (v2 API).

​
Solução de problemas

Causas comuns:
  1. Token revogado ou expirado — gere um novo token
  2. Uso de um token v1 — os tokens v1 autenticam por parâmetro de consulta e não funcionam com os endpoints v2. Gere um novo token v2 em Configurações → Tools → REST API v2
  3. Lista de IPs permitidos bloqueando as solicitações — se o seu tenant tiver a lista de IPs permitidos habilitada, verifique se os quatro endereços IP de saída do Living Security estão na lista
O token foi criado sem acesso a /api/v2/events/data/alert ou a /api/v2/events/data/page. As permissões de endpoint do token não podem ser alteradas após a criação — crie um novo token com acesso de leitura a ambos e reconecte.
O token não tem um dos dois endpoints necessários. Um token restrito apenas a /api/v2/events/data/alert ou apenas a /api/v2/events/data/page ainda se conecta, e o fluxo associado ao endpoint ausente permanece vazio, sem nenhum aviso.As permissões de endpoint não podem ser alteradas após a criação do token — gere um novo token com acesso de leitura a ambos e reconecte.
Se a lista de IPs permitidos estiver habilitada, os endereços IP de saída do Living Security podem ter mudado. Consulte Configuring Integration Egress IP Addresses e atualize a lista Custom IP de acordo.
Os tokens v1 e v2 usam mecanismos de autenticação diferentes:
  • v1: parâmetro de consulta (token=...)
  • v2: cabeçalho (Netskope-Api-Token: ...)
O Living Security usa a autenticação v2. Gere um novo token em Configurações → Tools → REST API v2 (não na página do token v1 legado).