The Asset Administrator or a partition's delegated administrator defines the SSH key sync group for an SSH key pair. The new key is generated for the sync group and configured for each of the synced accounts on the target host. All accounts in the SSH key sync group synchronize so the same key can be used to log into all systems.

An SSH key sync group is used to control validation and reset across all associated accounts. The same SSH key is used for one or more accounts associated with the same or different assets. For example, synchronized SSH keys can be used for accounts that support clusters or systems that sync between development, test, and production.

An account can belong to only one SSH key sync group. Multiple SSH key sync groups can be added to a profile.

The profile change schedule is applied to the SSH key sync group. The SSH key sync group controls the tasks to change the SSH keys for the accounts in the sync group. If synchronization fails for an individual account in the SSH key sync group, the account is retried multiple times and, if failing after that, the sync task halts and is rescheduled. The administrator must correct the cause of the failure for the sync task to continue.

If an account is associated with a profile with a daily check schedule and also associated with an SSH key sync group, a mismatch on the daily check will trigger a task to set the SSH key to the current SSH key.

Navigate to Asset Management > Profiles > View SSH Key Profile Components > SSH Key Sync Groups.

Table 59: SSH Key Sync Groups properties
Setting Description
Enabled

If Enable is selected, the sync runs with the profile change schedule. Use the following toolbar buttons to enable or disable:

  • Enable

  • Disable

Status

The Status displays if all SSH key pairs are in sync with the SSH key sync group. The Status is if any SSH key for any account within the sync group does not synchronize.

Name

The name of the SSH key sync group

Partition

The partition that uses the rule

Profile

The profile that uses the rule

Accounts

The number of accounts to synchronize with the SSH key sync group

Next Sync Date

The date the SSH key sync group's SSH key pair will be synchronized across all accounts

Description

Information about the rule

Use the following toolbar buttons to manage SSH key sync groups.

NOTE: Changes made from the SSH Key Sync Groups pane are reflected in the SSH key sync groups in the profile. See Creating a password profile.

Table 60: SSH Key Sync Groups: Toolbar
Option Description
Add

Add an SSH key sync group. For more information, see Adding SSH key sync groups.

Delete

Permanently remove the selected SSH key sync group.

View Details Modify the selected SSH key sync group rule.

Change Sync Group SSH Keys

Change the SSH key for the selected SSH key sync group. All accounts in the SSH key sync group synchronize with the new SSH key.

Refresh

Update the list of SSH key sync groups.

Search

To locate a value in this list, enter the character string to be used to search for a match. For more information, see Search box.