CloudRadial CSA: Data Agent Security Key

Agent installation offers the ability to create a unique security key that is required at installation and at agent check-in to validate that the information is coming from a trusted source. Generating and enabling a security key will add the security key to all Windows installers and Mac install scripts. If the Security Key is enabled, then all existing agents will need to be rebuilt and redeployed.

• Generate a unique Security Key during installation
• Validate agents with the key during installation and check-in
• Locate the key in the Windows registry
• Rebuild requirements when enabling the key

Understanding Security Keys

The Security Key serves as a validation mechanism for your Data Agent installations. When enabled, this key gets embedded into all Windows installers and Mac install scripts to ensure secure communication between agents and your CloudRadial environment.

One thing to note is that even though the agent gets rebuilt and the rebuild says it's completed in the portal, the agent file at the download link is cached so it may take 10-15 minutes after completing before downloaded files actually have the Security Key. Also, if the key is correctly included in the agent then you should be able to find that same key in the registry after installation.

The key is stored in the Windows registry at:

HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Azurative\CloudRadial\Agent

Setting Up Security Keys

To configure a Security Key for your Data Agent:

1. Navigate to Partner > Clients
2. Select the Agents tab
3. Check the box for Enforce security key on agent check-in?
4. Check the box and click OK
   

Security Key Components

• Unique Security Key: A security key can be created during installation
• Validation: This key is required at installation and agent check-in
• Purpose: Ensures that the information is coming from a trusted source
• Rebuild Requirement: Existing agents must be rebuilt and redeployed if the key is enabled

Important Notes

When enabling a Security Key on an environment with existing agents:

1. All existing agents will display as offline until rebuilt
2. You must download new installer packages with the embedded key
3. Deploy the new packages to replace existing agents
4. Allow up to 15 minutes for the cache to clear after rebuilding agents

If you are still having trouble, we're here to help! Submit a ticket here for assistance, and don't forget to check our status page to ensure there are no outages in your area.