Windows Apache Module Install

  Last updated 2024-09-09

IMPORTANT

This guide only applies to Next-Gen WAF customers with access to the Next-Gen WAF control panel. If you have access to the Next-Gen WAF product in the Fastly control panel, you can only deploy the Next-Gen WAF with the Edge WAF deployment method.

Requirements

  • Windows 10, Windows Server 2016, or higher (64-bit)
  • Apache 2.4 (64-bit)
  • Verify you have installed the Next-Gen WAF Windows Agent. This will ensure the appropriate folder structure is in place on your file system.

Installation

  1. Download the Apache module from:

    https://dl.signalsciences.net/sigsci-module-apache/sigsci-module-apache_latest.zip

  2. Extract the Next-Gen WAF Apache Module from the .zip archive to your Apache modules directory, replacing PATH-TO-APACHE with the path to your Apache installation:

    $ unzip sigsci-module-apache_latest.zip
    $ copy mod_sigsci.so PATH-TO-APACHE\modules\

  3. Add the following line to your Apache configuration file (httpd.conf) after the Dynamic Shared Object (DSO) Support section to enable the Next-Gen WAF Apache module:

    LoadModule signalsciences_module modules/mod_sigsci.so

  4. Determine SigSciAgentPort and SigSciAgentHost values. These module configuration values must reflect either:

    • The rpc-address value from the agent configuration (if used).
    • The default port of the agent's RPC listener (737)

    For example, if no rpc-address is being set within the agent configuration, update SigSciAgentPort to 737:

    SigSciAgentPort 737

    If the agent has an rpc-address value configured of 192.231.203.132:9000, then configure the module to reflect it:

    SigSciAgentPort 9000
    SigSciAgentHost 192.231.203.132

    These properties can be changed globally, or per VirtualHost if necessary. See the Module Configuration guide for further information.

  5. Test to confirm the configuration is correct, replacing MY-SERVICE-NAME with the name of your service:

    $ httpd.exe -n "MY-SERVICE-NAME" -t

  6. Start the Apache service as normal, for example:

    $ net start Apache2.4

    Or restart the Apache service with the following example command, replacing MY-SERVICE-NAME with the name of your service:

    $ httpd.exe -k restart -n "MY-SERVICE-NAME"

Next Steps

Verify the agent and module installation and explore module options.

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.

Fastly
© Fastly 2024