# API-direktintegration

Netacea är ett molnbaserat system som analyserar all besöksaktivitet på ett webbaserat system och identifierar skadliga besökare.

För att möjliggöra för företag att använda Netacea för realtidsskydd inline för sina webbsystem har Netacea skapat en plugin-arkitektur som kan implementeras i alla större teknologier.

Denna plugin-arkitektur hanterar interaktion med Netacea:s API:er och bearbetning av svar för att tillhandahålla effektiv mitigering med låg latens mot identifierade hot.

Netacea har byggt ett antal plugins för stora CDN:er, lastbalanserare och webbplattformar, men möjliggör även för kunder att bygga sina egna plugins vid behov.

## Interaktion med Netacea:s API:er

Att skapa en Netacea-plugin innebär interaktion med två Netacea-API:er:

* **Monitor Ingest API** – För insamling av besöksdata.
  * Alternativt kan ingestloggar skickas till en ingestpunkt som tillhandahålls av Netacea.
* **Protector API** – För att få tillgång till Netacea:s bedömning av den aktuella besökaren och vilken åtgärd som bör vidtas.

API-ändpunkter för Netacea:s API:er varierar per kund. Dina specifika API-ändpunkter kommer att meddelas tillsammans med dina specifika API-nycklar som en del av onboarding-processen.

API-nyckeln ska inkluderas med varje begäran till alla Netacea-API:er som ett headervärde med nyckeln "X-Netacea-API-Key".

Alla API-anrop som görs utan API-nyckel eller med en ogiltig API-nyckel kommer att avvisas.

## Översikt av plugin-processen

Plugin-processen utför två distinkta element:

1. N/ Monitor: Överföring av besöksrelaterad data till Netacea Detection Engine för analys.
   * Denna process utförs asynkront i svarsfasen av begärandebearbetningen.
   * Data kan även tillhandahållas i batch – antingen till en Kinesis-ström eller till en S3-bucket.
2. N/ Protector: Förfrågan till Netacea Protector API för att avgöra om några mittigeringsåtgärder ska tillämpas på denna besökare.
   * Denna process utförs synkront i begärandefasen (resultatet spåras mot en besökare för att minimera latens och antalet API-anrop som görs).

Diagrammet nedan visar processen som ligger till grund för en plugin.

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