LogoLogo
  • Overview
    • Overview
    • Integration Modes
    • Minimum Required Dataset
    • Customer Service Desk
  • Netacea Plugin Information
    • Accessing Your Integration Settings
    • Akamai
      • Akamai Plugin Logic
      • Monitoring Configuration
      • Installation and Configuration
        • Proxy Property Configuration
        • EdgeWorker Installation
        • Property Configuration
          • Optional Integration Configuration
    • Cloudflare
      • Cloudflare Plugin Logic
      • Monitoring Configuration
      • Installation and Configuration
        • Installation via Wrangler (CLI)
        • Installation via Cloudflare UI
    • CloudFront
      • CloudFront Plugin Logic
      • Monitoring Configuration
      • Installation and Configuration
    • Fastly
      • Fastly Plugin Logic
      • Monitoring Configuration
      • Installation and Configuration
        • Advanced Configuration
        • Deployment via Terraform
    • Fastly Magento
      • Fastly/Magento Plugin Logic
      • Monitoring Configuration
      • Installation and Configuration
        • Advanced Configuration
    • F5
      • F5 Plugin Logic
      • Monitoring Configuration
      • Installation and Configuration
    • Vercel
      • Vercel Plugin Logic
      • Monitoring Configuration
      • Installation and Configuration
    • API Direct Integration
      • How to Build a Netacea Plugin
  • Netacea Data Sync
    • Data Sync
    • Recommendations
  • Captcha
    • reCAPTCHA User Journey
    • hCaptcha User Journey
    • Custom reCAPTCHA Page Guide
    • Custom hCaptcha Page Guide
Powered by GitBook

Copyright Netacea 2023

On this page
  • Customising Integration Triggers
  • Update the Netacea Dictionary
  • Create & Customise the recv_configure.vcl
  • Update Log Shipping
  1. Netacea Plugin Information
  2. Fastly Magento
  3. Installation and Configuration

Advanced Configuration

In some cases, advanced configuration requirements may be discussed with the Netacea Solution Engineering team.

PreviousInstallation and ConfigurationNextF5

Last updated 1 year ago

Customising Integration Triggers

In some cases, there may be a requirement to customise which traffic triggers the Netacea integration within a single Fastly service traffic.

This could be for various reasons, including:

  • Multiple domains exist on the same Fastly service, and Netacea protect each domain with a separate set of Datastream models

  • Multiple domains exist on the same Fastly service, but Netacea only protect a subset of those domains

  • The Netacea Integration needs to be limited to trigger and protect a limited set of pathways

  • The Netacea Integration needs to based on certain criteria

To support customised triggers, follow the steps outlined below.

Do not complete this configuration without discussing the steps with the Netacea team

Update the Netacea Dictionary

Update the Netacea dictionary configured as part of the standard . The dictionary must be updated to include the variables and values normally set in the .

The Netacea module fields should be set to blank:

Create & Customise the recv_configure.vcl

Lastly, the recv_configure.vcl will need to be created to include the conditional statements that define how the Netacea integration triggers:

  • Cause the integration to trigger on a subset of requests made on the Fastly service.

  • Define which Datastream credentials are used when traffic triggers the integration on the Fastly Service.

Navigate to Stores → Configuration → Advanced → System → Full Page Cache → Fastly Configuration → Custom VCL Snippets and click "Create".

Selective trigger

The following example will cause the integration to trigger on login specific request pathways.

set req.http.x-netacea:edge_config_key_prefix = "";
declare local var.should_run_netacea BOOL;

set var.should_run_netacea = false;

# Must enable Netacea on the following paths if using captcha:
if (!var.should_run_netacea) {
  if (req.url.path ~ "^/AtaVerifyCaptcha|^\/Mitigations\/") {
    set var.should_run_netacea = true;
  }
}

if (!var.should_run_netacea) {
  if (req.url.path ~ "\/.*\/(login)\/") {
    set var.should_run_netacea = true;
  }
}

if (var.should_run_netacea) {
  call netacea_check_req;
}

Splitting trigger

The following example will cause the integration to use different Datastream credentials based on the request's associated domain.

declare local var.should_run_netacea BOOL;
set var.should_run_netacea = false;

# Must enable Netacea on the following paths if using captcha:
if (!var.should_run_netacea) {
  if (req.url.path ~ "^/AtaVerifyCaptcha|^\/Mitigations\/") {
    set var.should_run_netacea = true;
  }
}

#
if (!var.should_run_netacea) {
  if (req.http.host ~ "example.com") {
    set var.should_run_netacea = true;
    set req.http.x-netacea:edge_config_key_prefix = "dsA_";
  }
}

if (!var.should_run_netacea) {
  if (req.http.host ~ "example2.com") {
    set var.should_run_netacea = true;
    set req.http.x-netacea:edge_config_key_prefix = "dsB_";
  }
}

if (var.should_run_netacea) {
  call netacea_check_req;
}

Update Log Shipping

Lastly, you may need to update your Shipping configuration based on requirements defined by the Netacea Team.

behave differently
Installation and Configuration Guide
Netacea Module