Foglight Agent Manager 7.3.0 - Foglight Agent Manager Guide

Managing lockboxes

A lockbox can be password-protected, and contains a collection of credential keys used for encryption and decryption. A lockbox can encrypt one or more credentials. All lockboxes, except the System lockbox, are password-protected.

You can create, edit, and manage lockboxes, change their passwords, and release them to credential clients (such as the Agent Manager) using the Manage Lockboxes dashboard in the Management Server browser interface.

Releasing lockboxes to the Agent Manager

Each lockbox in the Management Server contains a set of credentials and keys for their encryption and decryption. Credentials are released to the Agent Manager unencrypted. When a lockbox is released to the Agent Manager, the Agent Manager passes the credential information to its agents. The agents use this information to establish connection with target resources.

When you start the Agent Manager without having first released a lockbox to it from the Management Server, the following message appears in the startup log:

INFO The Credential Manager has not been assigned any lockboxes. Lockboxes are used to decrypt credentials received as a result of an Agent Credential Query. Without any lockbox assignments, credentials received within a credential query result-set will be discarded. You can grant lockboxes to this Agent Manager through the Credential Administrator on the Server.

The lockbox you release to the Agent Manager must contain the credentials necessary for the agents to access the monitored resources.


	CAUTION: Any agents that have access to an Agent Manager with a released lockbox can potentially query and obtain credential information stored within that lockbox.

To release a lockbox to the Agent Manager:

On the navigation panel, click Dashboards > Administration > Credentials > Manage Lockboxes.

On the Manage Lockboxes dashboard, in the row containing the lockbox that you want to release, click

the Release to Credential Clients icon.

In the Release Lockbox to Credential Clients dialog box, type the lockbox password (if one exists) and select one or more credential clients (that is, Agent Managers) for lockbox release.

Figure 2. Release Lockbox to Credential Clients dialog box


	IMPORTANT: The System lockbox that is included by default with the Management Server is not password-protected. Its contents are accessible to all clients in your system.

Click Release.

The Release Lockbox to Credential Clients dialog box closes, indicating success.

Optional—ensure the Credential Clients column is populated.

Using the breadcrumb trail, return to the main Credentials dashboard, and navigate to the View Clients dashboard.

On the View Clients dashboard, ensure that the Show lockboxes currently assigned to each client check box is selected.


	NOTE: This functionality consumes server resources. It can be significant depending on the size of your client list.

The view refreshes, with the Assigned Lockboxes column populated.

Return to the main Credentials dashboard.

Navigate to the Manage Lockboxes dashboard.

On the Manage Lockboxes dashboard, observe the Credential Clients column of the newly released lockbox entry. The column lists the credential clients to which the lockbox is assigned.

When the lockbox is released to the Agent Manager, any credentials that are later added to the same lockbox are also accessible to the Agent Manager and its monitored agents.