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, incluem-se:
  • 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 utiliza 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 Settings → Tools
Esta integração requer um token de API v2, não um token v1. Os tokens v1 usam autenticação por parâmetro de consulta e não funcionarão 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 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 Settings.
  3. Em Tools, selecione REST API v2.
2

Crie um novo token

  1. Clique em New Token.
  2. Insira 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 qualquer erro que indique o motivo.
Estes dois são os únicos endpoints de que o Living Security necessita. Não conceder nada além deles está de acordo com o princípio do menor privilégio.
  1. Clique em Save (ou Generate Token).
3

Copie e salve o token

Copie o token imediatamente e armazene-o com segurança.
O Netskope exibe o valor do token somente 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 permissões de IP (se aplicável)

Se o seu tenant do Netskope tiver a lista de permissões de IP habilitada, é necessário adicionar os intervalos de IP de saída do Living Security.
  1. No console de administração do Netskope, acesse Settings → Administration → IP Allowlist.
  2. Se a lista de permissões de IP estiver habilitada, adicione cada endereço IP de saída do Living Security à lista Custom IP.
Se a lista de permissões de IP 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 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.Insira somente o subdomínio simples — sem https://, sem .goskope.com e sem barra final.
A caixa de diálogo de conexão aceita diversos formatos de entrada (subdomínio simples, nome de host completo ou URL completa) e os normaliza automaticamente. No entanto, recomenda-se inserir o subdomínio simples.

​
Parte B — Na Living Security Platform

O responsável pelo programa realiza esta etapa, ou o administrador do sistema, caso a configuração seja 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 Settings → Tools → REST API v2
  3. Lista de permissões de IP bloqueando as solicitações — se o seu tenant tiver a lista de permissões de IP habilitada, verifique se os quatro endereços IP de saída do Living Security estão na lista de permissões
O token foi criado sem acesso a /api/v2/events/data/alert ou /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 possui 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, em seguida, reconecte.
Se a lista de permissões de IP estiver habilitada, os endereços IP de saída do Living Security podem ter sido alterados. Consulte Configuração dos endereços IP de saída da integração e atualize a lista Custom IP para refletir as alterações.
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 utiliza a autenticação v2. Gere um novo token em Settings → Tools → REST API v2 (não na página legada de tokens v1).