# Integração Direta via API

A Netacea é um sistema baseado em nuvem que analisa toda a atividade de visitantes em um sistema web e identifica visitantes maliciosos.

Para permitir que as empresas utilizem a Netacea para fornecer proteção em tempo real e em linha para seus sistemas web, a Netacea criou uma arquitetura de plugins que pode ser implementada em todas as principais tecnologias.

Essa arquitetura de plugins gerencia a interação com as APIs da Netacea e o processamento de respostas para fornecer mitigação eficaz e de baixa latência contra as ameaças detectadas.

A Netacea desenvolveu uma variedade de plugins para os principais CDNs, balanceadores de carga e plataformas web, mas também permite que os clientes desenvolvam seus próprios plugins, se necessário.

## Interagindo com as APIs da Netacea

A criação de um plugin da Netacea envolve a interação com duas APIs da Netacea:

* **API de Ingestão do Monitor** – Para captura de dados de visitantes.
  * Alternativamente, os logs de ingestão podem ser enviados para um ponto de ingestão fornecido pela Netacea.
* **API do Protector** – Para acessar a avaliação da Netacea sobre o visitante atual e qual ação deve ser tomada.

Os endpoints de API das APIs da Netacea variam conforme o cliente. Seus endpoints de API específicos serão comunicados, juntamente com suas chaves de API específicas, como parte do processo de onboarding.

A chave de API deve ser incluída em cada solicitação a qualquer API da Netacea como um valor de cabeçalho com a chave "X-Netacea-API-Key".

Quaisquer chamadas de API feitas sem uma chave de API ou com uma chave de API inválida serão rejeitadas.

## Visão Geral do Processo do Plugin

O processo do plugin executa dois elementos distintos:

1. N/ Monitor: Passagem dos dados relacionados ao visitante para o Motor de Detecção da Netacea para análise.
   * Este processo é realizado de forma assíncrona na fase de resposta do processamento da solicitação.
   * Os dados também podem ser fornecidos em lote – seja para um stream Kinesis ou para um bucket S3.
2. N/ Protector: Consulta à API do Protector da Netacea para determinar se alguma mitigação deve ser aplicada a este visitante.
   * Este processo é realizado de forma síncrona na fase de solicitação (o resultado é rastreado em relação a um visitante para minimizar a latência e a quantidade de chamadas de API sendo feitas).

O diagrama abaixo mostra o processo que fundamenta um plugin.

<figure><img src="https://3103183613-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ0VONni9fqVKgqwRyueW%2Fuploads%2Fgit-blob-15d8be61baa7f012f5142b44f77da232083b6152%2FGitbook_diagrams_API%20.jpg?alt=media" alt=""><figcaption></figcaption></figure>
