# API direkte integration

Netacea er et cloud-baseret system, der analyserer al besøgsaktivitet på et webbaseret system og identificerer ondsindede besøgende.

For at gøre det muligt for virksomheder at bruge Netacea til at levere realtidsbeskyttelse, in-line, til deres websystemer, har Netacea skabt en plugin-arkitektur, der kan implementeres i alle større teknologier.

Denne plugin-arkitektur håndterer interaktion med Netacea API'erne og behandling af svar for at levere effektiv beskyttelse med lav latenstid mod opdagede trusler.

Netacea har udviklet en række plugins til større CDN'er, load balancers og webplatforme, men giver også kunderne mulighed for at bygge deres eget plugin, hvis det er nødvendigt.

## Interaktion med Netacea API'er

Oprettelse af et Netacea plugin involverer interaktion med to Netacea API'er:

* **Monitor Ingest API** – Til indsamling af besøgsdata.
  * Alternativt kan ingest-logfiler sendes til et ingest-punkt leveret af Netacea.
* **Protector API** – For at få adgang til Netaceas vurdering af den aktuelle besøgende, og hvilken handling der skal foretages.

API-endpoints for Netacea API'erne varierer efter kunde. Dine specifikke API-endpoints vil blive kommunikeret sammen med dine specifikke API-nøgler som en del af onboarding-processen.

API-nøglen skal inkluderes med hver forespørgsel til enhver Netacea API som en header-værdi med nøglen "X-Netacea-API-Key".

Alle API-kald foretaget uden en API-nøgle eller med en ugyldig API-nøgle vil blive afvist.

## Oversigt over plugin-processen

Plugin-processen udfører to distinkte elementer:

1. N/ Monitor: Overførsel af besøgsrelaterede data til Netacea Detection Engine til analyse.
   * Denne proces udføres asynkront i svarfasen af forespørgselsbehandlingen.
   * Data kan også leveres i batch – enten til en Kinesis-stream eller til en S3-bucket.
2. N/ Protector: Forespørgsel til Netacea Protector API for at afgøre, om der skal anvendes beskyttelsesforanstaltninger på denne besøgende.
   * Denne proces udføres synkront i forespørgselsfasen (resultatet spores mod en besøgende for at minimere latenstid og antallet af API-kald, der foretages).

Diagrammet nedenfor viser processen, der ligger til grund for et plugin.

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