Register Standalone Java-based Agent
  • 18 Oct 2020
  • 1 Minute To Read
  • Print
  • Share
  • Dark
    Light

Register Standalone Java-based Agent

  • Print
  • Share
  • Dark
    Light

Java-based SecureCircle Agents, such as the Network Filter/Mimefilter agent, must be registered on the SecureCircle Server in order to interact with protected data. The following steps describe the process to register the Java-based SecureCircle Agent.

Steps

  1. Create an email-based invitation for managing one or more standalone appliances.
  2. Retrieve the Invitation ID from the Description tab the in Circles → 'Circle Name' → Users → 'New User Name' menu.
Example

The Invitation ID is 016ef62ccb5111eaadaadb78e480491e
invitationID.png

  1. Register the Java-based Network Filter Agent on the machine using registerer.jar (e.g., registerer-1.0.3-jar-with-dependencies.jar)

Command syntax

java -jar <registerer.jar> -cname $(hostname) -hwd 1D6A7492-487D-4B13-B18E-E4CE4E197B00 -inv <invitationId> -out mimefilter.properties -server <server FQDN>

Example

java -jar registerer-1.0.3-jar-with-dependencies.jar -cname $(hostname) -hwd 1D6A7492-487D-4B13-B18E-E4CE4E197B00 -inv 016ef62ccb5111eaadaadb78e480491e -out mimefilter.properties -server example.securecircle.local -ver 1.0.6

Note: the above command creates a file named mimefilter.properties in the current working directory. This file must be placed in the working directory of the network filter OR in /etc/sc-java-agent/mimefilter.properties. For example: sudo mkdir -p /etc/sc-java-agent/ && sudo cp mimefilter.properties /etc/sc-java-agent/

  1. Confirm the new device in the Devices menu.

After completing the above steps, the device is registered and is authorized to interact with data in the Circles to which the user was invited. The same user may subsequently be added to other Circles to allow the device to interact with data in those Circles.

Was This Article Helpful?