# Suora API-integrointi

Netacea on pilvipohjainen järjestelmä, joka analysoi kaiken verkkojärjestelmän kävijätoiminnan ja tunnistaa haitalliset kävijät.

Jotta yritykset voivat käyttää Netaeceaa reaaliaikaisen, linjakohtaisen suojauksen tarjoamiseen verkkojärjestelmilleen, Netacea on luonut lisäosaarkkitehtuurin, joka voidaan toteuttaa kaikissa tärkeimmissä teknologioissa.

Tämä lisäosaarkkitehtuuri hoitaa vuorovaikutuksen Netaecea-rajapintojen kanssa ja vastausten käsittelyn tarjoten tehokkaan, matalan viiveen torjunnan havaittuja uhkia vastaan.

Netacea on rakentanut joukon lisäosia tärkeimmille CDN-palveluille, kuormantasaimille ja verkkoalustoille, mutta mahdollistaa myös asiakkaiden oman lisäosan rakentamisen tarvittaessa.

## Vuorovaikutus Netacea-rajapintojen kanssa

Netacea-lisäosan luominen edellyttää vuorovaikutusta kahden Netacea-rajapinnan kanssa:

* **Monitor Ingest API** – Kävijätietojen keräämiseen.
  * Vaihtoehtoisesti tiedonkeruulokit voidaan toimittaa Netaecean tarjoamaan tiedonkeruupisteeseen.
* **Protector API** – Netaeceän arvion saamiseksi nykyisestä kävijästä ja tarvittavista toimenpiteistä.

Netacea-rajapintojen päätepisteet vaihtelevat asiakkaittain. Omat päätepisteesi ilmoitetaan yhdessä API-avaintesi kanssa käyttöönottoprosessin aikana.

API-avain tulee sisällyttää jokaiseen Netaeca-rajapintapyyntöön otsikkoarvona avaimella "X-Netacea-API-Key".

Kaikki API-kutsut, jotka tehdään ilman API-avainta tai virheellisellä API-avaimella, hylätään.

## Lisäosaprosessin yleiskatsaus

Lisäosaprosessi suorittaa kaksi erillistä toimintoa:

1. N/ Monitor: Kävijään liittyvien tietojen välittäminen Netacea Detection Enginelle analysoitavaksi.
   * Tämä prosessi suoritetaan asynkronisesti pyynnön käsittelyn vastausvaiheessa.
   * Tiedot voidaan myös toimittaa eräajona – joko Kinesis-streamiin tai S3-ämpäriin.
2. N/ Protector: Netaeca Protector API:n kysely sen määrittämiseksi, pitäisikö tälle kävijälle soveltaa torjuntatoimenpiteitä.
   * Tämä prosessi suoritetaan synkronisesti pyyntövaiheessa (tulos seurataan kävijäkohtaisesti viiveen minimoimiseksi ja API-kutsujen määrän vähentämiseksi).

Alla oleva kaavio näyttää lisäosan taustalla olevan prosessin.

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