Installing the agent on Windows

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:

1. 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 variable SIGSCI_CONFIG.
   • If you are deploying the agent in reverse proxy mode, see the Reverse Proxy Mode configuration page for details on required configuration options.

2. 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.

   1. Log in to the Signal Sciences console.

   2. From the Sites menu, select a site if you have more than one site.

   3. Click Agents in the navigation bar. The agents page appears.

   4. Click View agent keys. The agent keys window appears.

      

   5. Copy the Agent Access Key and Agent Secret Key.

      

   6. Enter the Agent Access Key and Agent Secret Key into C:\Program Files\Signal Sciences\Agent\agent.conf.

      accesskeyid = "AGENTACCESSKEYHERE"
      secretaccesskey = "AGENTSECRETACCESSKEYHERE"

3. Download the latest Signal Sciences Windows Agent .msi from https://dl.signalsciences.net/?prefix=sigsci-agent/.

4. Run the .msi to install the Agent automatically with no prompts. It will install the executable in C:\Program Files\Signal Sciences\Agent, add a service entry for the Agent, and start the service if the agent configuration file is present with valid accesskeyid and secretaccesskey settings.

   The installed service name is sigsci-agent and can be controlled with PowerShell cmdlets:

   1Start-Service sigsci-agent
   2Restart-Service sigsci-agent
   3Stop-Service sigsci-agent

   Alternatively, 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.