Installing the agent on Windows
Last updated 2022-12-05
The Signal Sciences agent is a small process that provides the interface between your web server and our analysis platform. An inbound web request is passed to the agent, the agent then decides whether the requests should be permitted to continue or whether we should take action.
Install and configure the Signal Sciences Agent package
To install and configure the Signal Sciences agent on Windows, complete the following steps:
Create an empty agent configuration file at
C:\Program Files\Signal Sciences\Agent\agent.conf
.- If you need to specify a custom location for the
agent.conf
file, set the absolute file path with the system environment variableSIGSCI_CONFIG
. - If you are deploying the agent in reverse proxy mode, see the Reverse Proxy Mode configuration page for details on required configuration options.
- If you need to specify a custom location for the
Configure the agent by inputting the Agent Access Key and Agent Secret Key into the agent configuration file at
C:\Program Files\Signal Sciences\Agent\agent.conf
.Log in to the Signal Sciences console.
From the Sites menu, select a site if you have more than one site.
Click Agents in the navigation bar. The agents page appears.
Click View agent keys. The agent keys window appears.
Copy the Agent Access Key and Agent Secret Key.
Enter the Agent Access Key and Agent Secret Key into
C:\Program Files\Signal Sciences\Agent\agent.conf
.accesskeyid = "AGENTACCESSKEYHERE"secretaccesskey = "AGENTSECRETACCESSKEYHERE"
Download the latest Signal Sciences Windows Agent
.msi
from https://dl.signalsciences.net/?prefix=sigsci-agent/.Run the
.msi
to install the Agent automatically with no prompts. It will install the executable inC:\Program Files\Signal Sciences\Agent
, add a service entry for the Agent, and start the service if the agent configuration file is present with validaccesskeyid
andsecretaccesskey
settings.The installed service name is
sigsci-agent
and can be controlled with PowerShell cmdlets:1Start-Service sigsci-agent2Restart-Service sigsci-agent3Stop-Service sigsci-agentAlternatively, you can download the latest Signal Sciences Windows Agent as a
.zip
file, which contains the agent binary. You can run this from any location you prefer. However, to install the agent in this way, you will need to configure the Service entry and start the service manually.
Example services.msc
screenshot:
Next steps
Explore our module options and install the Signal Sciences module.
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.