Installation via Wrangler (CLI)
This section describes how configure and deploy the Netacea integration via the Wrangler.
Last updated
This section describes how configure and deploy the Netacea integration via the Wrangler.
Last updated
Copyright Netacea 2023
To successfully integrate using Netacea, please ensure you have:
Installed Wrangler V2, Node.js (version 16.13.0 or higher) and Git on you machine.
An active Cloudflare account with access to the Cloudflare Dashboard.
A “Paid” Cloudflare subscription, in order to avoid any issues with worker request-limits etc.
Access to the Cloudflare Workers product.
The detailed GitHub instructions to pull the code, configure and deploy the Netacea Cloudflare plugin can be found here.
Open Windows Command-Prompt/PowerShell and navigate to a directory where you can save the Netacea code.
Within that directory execute the following command
This will use wrangler to create (generate) a new local worker bundle by pulling the latest Netacea GitHub code.
You can verify this by visiting the above directory and seeing the worker with the following format:
Open the src directory and edit the NetaceaConfig.json file to match the below:
Replace the values with the details that Netacea has provided you and save the file.
The attribute mitigationType is used to determine the mode of the integration. This can be one of three values:
"INGEST" - This integration mode is monitoring only, meaning that no mitigation actions will be executed. This is recommended during POCs.
"MITIGATE" - This is the "normal" integration mode, meaning that the Netacea solution will monitor and actively mitigate requests.
"INJECT" - This mode is used in custom solutions in which the mitigation action by Netacea will only be a recommendation using HTTP headers added to the request.
The last three configuration variables are used to increase security by concealing Netacea's default cookie names and values from public view.
Navigate to the worker's root directory and edit the wrangler.toml file:
Replace the values with the appropriate details.
The Account ID can be found on your Cloudflare Dashboard.
The Route refers to the path that the worker should be applied to, e.g. "www.example.com/*" and can be edited after deployment.
Once ready, save the file.
Within the worker root directory, execute the following two commands to ensure all the necessary node modules are installed/updated
Execute the following command:
This might prompt you to login to Cloudflare via your browser and allow access to wrangler. If so, login and allow access.
You can use the above command to re-deploy the same worker in order to update it (e.g. changing the configuration properties). The last deployment will become active by default.
Login to Cloudflare, open the dashboard and select "Workers Routes" from the menu. You should be able to see the newly deployed worker, associated with the route from the wrangler.toml file.
You can make changes to the worker, route, environment and more by clicking Edit, without the need to re-deploy the worker via wrangler.
Deployments of each worker can be seen by clicking on the environment (e.g. production) and selecting the Deployment's tab:
For each worker, you can see various metrics, the associated routes and have the option to roll-back to a previous deployment.
