Remote Agents

The Remote Agent is a lightweight agent installed at the end customer site which connects the customer environment to the Siemplify platform.
The Agent enables the analyst to run actions, playbooks and connectors on remote customer sites directly from Siemplify.
In order for Siemplify to connect with the Agent, it pushes information to the Publisher which is a Proxy Server which usually resides in the Cloud. The Publisher has the information pulled from it by the Agent.

The following steps need to be taken in the correct order to set up the Remote Agent.

1. Deploy the Publisher. For full information refer to Siemplify Agent and Publisher Guide
2. Pair the Publisher. In order to see this information, refer to the Publisher screen.
3. Create and Deploy New Agent. See below.
4. Set up Integration. Refer to Marketplace.
5. Set up Connectors. Refer to Marketplace.
   

To create a new agent:

1. In Settings > Advanced > Remote Agents, click the plus icon on the top right of the screen.
2. Fill out the relevant information: Name, Environment, Publisher and check Is Enabled.
3. A unique identifier is generated automatically for each customer.
4. A download link to install the Agent on the remote site will be created for each customer.
5. Click Save.
   
6. Click Send Now in the main screen for the platform to send the defined user the link for them to install the Agent.
   

Possible Agent Status Options:
Waiting for Agent: Only displays if it is a new agent and it is enabled. Status means it’s waiting for the agent to be installed and perform initial communication with Siemplify.
Live: There is full communication from Agent to Publisher or from Siemplify to Publisher in last X minutes (where X is taken from Publisher pairing configuration)
Error: There was a problem with the communication from Agent to Publisher or from Siemplify to Publisher in last X minutes (where X is taken from Publisher pairing configuration)
Disabled: Will display if the agent is disabled
Stopped: Will display if the agent was stopped

Disable an Agent

To disable an agent:

1. Navigate to Settings > Advanced > Remote Agents.
2. Click Edit on the required agent.
3. Deselect the Enabled checkbox.
4. Click Save.
   Note that disabling an agent will stop any assigned integrations and connectors from running.
   

Stop an Agent

*Once you stop an agent, you cannot restart it.

To stop an agent:

1. Navigate to Settings > Advanced > Remote Agents.
2. Click Edit on the required agent.
3. Click the red Stop Agent button.
4. Click Save.