About module-agent deployment

The core deployment method includes both module-agent and agent-only deployment options. With a module-agent deployment, you're responsible for managing your Next-Gen WAF deployment in your hosting environment.

The module-agent topology includes both the Next-Gen WAF module and the Next-Gen WAF agent components. The module listens for incoming requests and passes them to the agent for a decision. The agent decides whether the request should be permitted to continue, blocked, rate limited, or tagged with signals. After receiving a decision from the agent, the module then blocks, allows, or rate limits requests in accordance with that decision.

To set up a module-agent deployment, complete the following steps:

  1. Install the agent.
  2. Install the module.
  3. Verify the installation.

Installing the module

After installing the Next-Gen WAF agent, install the variation of the Next-Gen WAF module that is appropriate for your hosting environment. The module can exist as a plugin to your web server or as a language or framework specific implementation.

Web server module options

Web server module variations are installed to extend the request handling logic and communicate with the agent for subsequent advice. The web server module options are as follows:

Language and framework specific module (RASP) options

The language and framework specific module variations are installed at the application layer. The language and framework specific module options are as follows:

Open source module options

Our open source modules follow either a Fastly-service or self-service model.

  • Fastly-service model: modules that Fastly updates and provides technical support for.
  • self-service model: modules that have a public-only development workflow and that Fastly will not update or provide technical support for.
ModuleFastly-service modelSelf-service modelLicense
Golang moduleMIT
PHP moduleMIT
Python moduleMIT

Per the MIT license included in the repositories for our open source modules, you may use our open source modules without restriction.

Verifying your installation

After installing the agent and module, verify your installation:

  1. Log in to the Next-Gen WAF control panel.
  2. From the Sites menu, select a site if you have more than one site.
  3. Click Agents in the navigation bar near the top of the screen.
  4. Check the module version under Module to confirm the correct version is listed.

Until there has been at least one request since the agent and module were installed, the module information won't be listed. Once there is traffic the module information will be populated.

Was this guide helpful?

Do not use this form to send sensitive information. If you need assistance, contact support. This form is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.