# API-direkteintegrasjon

Netacea er et skybasert system som analyserer all besøksaktivitet til et nettbasert system og identifiserer ondsinnede besøkende.

For å gjøre det mulig for selskaper å bruke Netacea til å gi sanntids, inline-beskyttelse for sine nettsystemer, har Netacea utviklet en plugin-arkitektur som kan implementeres i alle større teknologier.

Denne plugin-arkitekturen håndterer interaksjon med Netacea-API-ene og behandling av svar for å gi effektiv beskyttelse med lav latens mot oppdagede trusler.

Netacea har bygget en rekke plugins for store CDN-er, lastbalanserere og nettplattformer, men gjør det også mulig for kunder å bygge sin egen plugin ved behov.

## Interaksjon med Netacea-API-er

Å opprette en Netacea-plugin innebærer interaksjon med to Netacea-API-er:

* **Monitor Ingest API** – For innsamling av besøksdata.
  * Alternativt kan innsamlingslogger sendes til et innsamlingspunkt levert av Netacea.
* **Protector API** – For å få tilgang til Netaceas evaluering av den nåværende besøkende og hvilken handling som bør utføres.

API-endepunkter for Netacea-API-ene varierer etter kunde. Dine spesifikke API-endepunkter vil bli kommunisert, sammen med dine spesifikke API-nøkler som en del av onboarding-prosessen.

API-nøkkelen skal inkluderes med hver forespørsel til enhver Netacea-API som en header-verdi med nøkkelen "X-Netacea-API-Key".

Alle API-kall som gjøres uten en API-nøkkel eller med en ugyldig API-nøkkel vil bli avvist.

## Oversikt over plugin-prosessen

Plugin-prosessen utfører to distinkte elementer:

1. N/ Monitor: Overføring av besøksrelaterte data til Netacea Detection Engine for analyse.
   * Denne prosessen utføres asynkront i responsfasen av forespørselsbehandlingen.
   * Data kan også leveres i batch – enten til en Kinesis-strøm eller til en S3-bøtte.
2. N/ Protector: Forespørsel til Netacea Protector API for å avgjøre om noen tiltak bør iverksettes for denne besøkende.
   * Denne prosessen utføres synkront i forespørselsfasen (resultatet spores mot en besøkende for å minimere latens og antall API-kall som gjøres).

Diagrammet nedenfor viser prosessen som ligger til grunn for en plugin.

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