# Installasjon og konfigurasjon ### Forutsetninger For å kunne integrere med Netacea, må du sørge for at du har: 1. Fastly versjon 1.2.131 eller høyere. 2. Tilgang til de relevante API-nøklene og loggforsendelsesendepunktene i [Netacea portal](https://docs.netacea.com/no/netacea-plugininformasjon/accessing-your-integration-settings). 3. [Monitoring ](https://docs.netacea.com/no/netacea-plugininformasjon/fastly/monitoring-configuration)er konfigurert. Kunder må også opprette en support-sak hos Fastly for å aktivere POST i miljøet sitt. Vi må sikre at det er 2 pragmas aktivert på Fastly-kontoen din som ikke er aktivert som standard. Påkrevde Pragmas: ``` Pragma optional_param fix_unsent_body_drain true; Pragma optional_param no_body_if_bereq_is_get_or_head true; ``` For å aktivere Pragmas, opprett en support-sak hos [Fastly Support](https://support.fastly.com). ### Implementeringstrinn * Logg inn på Fastly-webgrensesnittet. * Fra hjemmesiden velger du den aktuelle tjenesten. Du kan bruke søkefeltet for å søke etter ID, navn eller domene. * Klikk på knappen Rediger konfigurasjon og velg deretter alternativet for å klone den aktive versjonen. Domener-siden vises. Alle konfigurasjonsendringer nedenfor vil bli gjort på den nylig klonede versjonen. {% hint style="info" %} Noter deg den aktive versjonen i tilfelle du trenger å rulle tilbake senere. {% endhint %} ### Vert For å tillate Netacea VCL å gjøre kall til Protector API, må 2 nye verter konfigureres med Netacea sine detaljer, som skal kalles i [VCL-snutter](#vcl-snippets). * Klikk på Origins-lenken. Origins-siden vises. * Klikk på "Create a Host"-knappen. Vert-feltet vises. Fyll inn en ny vert med følgende URL og klikk "Add": ``` mitigations-lbr.netacea.net ```

Rediger den nye verten ved å klikke på blyantikonet og endre navnet til: ``` MitSvc ```

I Override host-feltet skriver du inn samme URL som den opprinnelige verten.

Gjenta prosessen, fyll inn den nye verten med følgende URL og klikk "Add": ``` assets.ntcacdn.net ``` Rediger den nye verten ved å klikke på blyantikonet og endre navnet til: ``` CaptchaAssets ```

### VCL-snutter For at Netacea skal kunne utløses og tilby beskyttelse, må løsningen legges til Fastly-miljøet i form av en tilpasset VCL. Netacea VCL er delt inn i 7 nøkkelsnutter: INIT, DELIVER, RECV, ERROR, RECV\_CONFIGURE, PASS og MISS. Hver av disse må legges til i VCL Snippets-konfigurasjonen i Fastly. {% hint style="info" %} Netacea vil levere VCL separat. {% endhint %} **INIT:** * Naviger til VCL snippets i Fastly. * Klikk på "Create snippet"-knappen. * Gi snutten et passende navn, som Netacea\_INIT * Sett typen til "init"

* Lim inn INIT-koden i VCL * På linje 4 - 24 finner du et sett med felter som er unike for hver distribusjon å definere, sett integration\_type til passende modus.

**Påkrevde felter**

Felt	Verdi
integration_type	fastly
integration_version	<Integrasjonsversjon>
integration_mode	BYPASS - Deaktiverer Netacea-integrasjonen fullstendig INGEST - Passiv modus for å la Netacea samle inn og analysere trafikk MITIGATE - Aktiv modus som vil mitigere basert på Netacea sin Intent Analytics® INJECT - Aktiv modus for kunder som ønsker å motta Netacea-analyse i sin backend og bestemme hvilke tiltak som skal iverksettes.
api_key	Levert av Netacea portal
secret_key	Levert av Netacea portal
encryption_key	Levert av Netacea portal
cookie_name	Et passende navn for mitigation-informasjonskapselen din. For ekstra sikkerhet, ikke inkluder Netacea eller Mitigation i dette navnet.
captcha_cookie_name	Et passende navn for Captcha-sporingsinformasjonskapselen din. For ekstra sikkerhet, ikke inkluder Netacea eller Mitigation i dette navnet.
ignore_list	Kommaseparert liste over undermapper hvor mitigation ikke skal brukes. Du kan sette opp til 5 undermapper her. Alle ressurser under slike mapper vil bli ignorert av integrasjonen. Legg til `/media/,/static/` som standard for å sikre full integrasjonsdekning uten å utløse på medieinnhold.

**Valgfrie felter - Kan settes til blank med mindre annet er avtalt med Netacea-teamet**

Felt	Verdi
real_ip_header_name	Lar brukere tilpasse hvilket header som brukes for forespørselens IP. La stå blank som standard for å bruke Fastly-standard `client.IP`-feltet.
use_relative_path_captcha_assets	Hvis satt til `true`, sikrer det at Captcha serveres uten referanser til Netacea CDN. Ellers vil den bygge inn full URL til Netacea CDN i Captcha HTML. La stå blank som standard for å bruke HTML på hele nettstedet.
captcha_path	Lar brukere opprette et endepunkt som alltid serverer Captcha HTML. Nyttig ved implementering av captcha-utfordring for mobilapper. La stå blank som standard for å bruke /ATAverify-banen.
captcha_header	Tilpasset header som indikerer om responsen er en Captcha-side. Må være i formatet `name={{header name}}&value={{header value}}.`
enable_captcha_content_negotiation	Håndterer formatet på Captcha-siden. Når satt til `true` er det mulig for integrasjonen å returnere Captcha-siden i form av JSON. La stå blank som standard for å bruke HTML på hele nettstedet.

Under avanserte alternativer, sett prioritet til 45.

**RECV**: * Klikk på "Create snippet"-knappen * Gi snutten et passende navn, som Netacea\_RECV * Sett typen til "within subroutine" og "recv (vcl\_recv)" * Lim inn RECV-koden i VCL * Sett prioritet til 45 **DELIVER** * Klikk på "Create snippet"-knappen * Gi snutten et passende navn, som Netacea\_DELIVER * Sett typen til "within subroutine" og "deliver (vcl\_deliver)" * Lim inn DELIVER-koden i VCL * Sett prioritet til 45 **ERROR:** * Klikk på "Create snippet"-knappen * Gi snutten et passende navn, som Netacea\_ERROR * Sett typen til "within subroutine" og "error (vcl\_error)" * Lim inn ERROR-koden i VCL * Sett prioritet til 45 **RECV\_CONFIGURE:** * Klikk på "Create snippet"-knappen * Gi snutten et passende navn, som Netacea\_RECV\_CONFIGURE * Sett typen til "within subroutine" og "recv (vcl\_recv)" * Lim inn RECV\_CONFIGURE-koden i VCL * Sett prioritet til 46 PASS: * Klikk på "Create snippet"-knappen * Gi snutten et passende navn, som Netacea\_PASS * Sett typen til "within subroutine" og "pass (