Register Standalone Java-based Agent
  • 26 Mar 2021
  • 1 Minute to read
  • Dark
    Light
  • PDF

Register Standalone Java-based Agent

  • Dark
    Light
  • PDF

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 3aa9761eaa3e11eab337413711fcb341
User-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?