# Intégration directe via API

Netacea est un système cloud qui analyse l'ensemble de l'activité des visiteurs d'un système web et identifie les visiteurs malveillants.

Pour permettre aux entreprises d'utiliser Netacea afin de fournir une protection en temps réel et en ligne pour leurs systèmes web, Netacea a créé une architecture de plugins pouvant être implémentée dans toutes les technologies majeures.

Cette architecture de plugins gère l'interaction avec les API Netacea et le traitement des réponses pour fournir une atténuation efficace et à faible latence contre les menaces détectées.

Netacea a développé une gamme de plugins pour les principaux CDN, équilibreurs de charge et plateformes web, mais permet également aux clients de créer leur propre plugin si nécessaire.

## Interaction avec les API Netacea

La création d'un plugin Netacea implique une interaction avec deux API Netacea :

* **API Monitor Ingest** – Pour la capture des données des visiteurs.
  * Alternativement, les journaux d'ingestion peuvent être transmis à un point d'ingestion fourni par Netacea.
* **API Protector** – Pour accéder à l'évaluation Netacea du visiteur actuel et à l'action à entreprendre.

Les points de terminaison des API Netacea varient selon le client. Vos points de terminaison API spécifiques vous seront communiqués, ainsi que vos clés API spécifiques, dans le cadre du processus d'intégration.

La clé API doit être incluse dans chaque requête vers toute API Netacea en tant que valeur d'en-tête avec la clé « X-Netacea-API-Key ».

Tout appel API effectué sans clé API ou avec une clé API invalide sera rejeté.

## Vue d'ensemble du processus du plugin

Le processus du plugin comprend deux éléments distincts :

1. N/ Monitor : Transmission des données relatives au visiteur au moteur de détection Netacea pour analyse.
   * Ce processus est effectué de manière asynchrone dans la phase de réponse du traitement des requêtes.
   * Les données peuvent également être fournies par lots – soit vers un flux Kinesis, soit vers un bucket S3.
2. N/ Protector : Interrogation de l'API Netacea Protector pour déterminer si des mesures d'atténuation doivent être appliquées à ce visiteur.
   * Ce processus est effectué de manière synchrone dans la phase de requête (le résultat est suivi par visiteur pour minimiser la latence et le nombre d'appels API effectués).

Le schéma ci-dessous illustre le processus sous-jacent à un plugin.

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