Asset credential management

Introduction to credential management and credential sets

Credential Administration tool permission

To access the Credential Management page

The Asset Credential Management page

To create, edit or remove a credential

To configure the columns and edit the filter

To manage credentials via RESTful API

When migrating from an older version of Entuity to Entuity v19.0

Introduction to credential management and credential sets:

The Asset Credential Management page provides a central location from which you can manage, create and edit shared credential sets for multiple processes. Each credential set is uniquely identified by name and credential type. Shared credential sets can be bulk-applied to multiple assets.

Credentials are used in the following areas:

• Managed Assets.
• Discovered Assets.
• Auto Discovery.
• Configuration Monitoring tasks.
• Geographical Map - Google API key.
• User Defined REST Polling (Entuity v20.0 upwards)

Note, you can also create local, device-specific credentials when adding manually adding an individual asset to your network. Please see this article for further help and information on adding assets to your network.

Credential Administration tool permission:

In order to access credential management, users will need the Credential Administration tool permission. Please see this article for further help and information on tool permissions.  The Credential Administration tool permission enables the following functionality:

• access to the Credential Management page.
• permission to create and edit credentials.
• ability to turn on and off the visibility of hidden passwords via the  icon.

Without the Credential Administration tool permission:

• users will not have access to the Credential Management page.
• users can still view credentials (e.g. via Asset Management page, Geographical Map page, Configuration Management page), but will not be able to create or edit new credentials. All fields will be read-only.
• users will not be able to decrypt hidden passwords.

To access the Asset Credential Management page:

1. From the Main Menu, click Administration.
2. Click Asset Credential Management. This will open the Asset Credential Management page.

The Asset Credential Management page:

The Asset Credential Management page displays a table containing credentials and their details. The table columns (which are configurable via the Overflow Menu) are as follows:

• Identity - numerical ID of the credential.
• Name - credential name. 
• Description - credential description.
• Type - credential type.
• Usage - where the credentials are in use.

Note, this page does not list the local, device-specific credentials that can be created on an individual basis when manually adding an asset. Please see the section below (When migrating from an older version of Entuity to Entuity v19.0) for more information on this.

To create, edit or remove a credential:

Please see this article for further help and information on creating, editing and removing credentials.

To configure the columns and edit the filter:

You can configure the table columns and edit the filter from the options in the Overflow Menu.

Please see this article for further help and information on configuring, filtering and exporting tables in Entuity.

To manage credentials via RESTful API:

Please see this article for help and information on retrieving, creating, editing and removing credentials via RESTful API.

When migrating from an older version of Entuity to Entuity v19.0:

When migrating from an older version of Entuity to Entuity v19.0, device-specific local credentials will be converted to a custom credential set, allowing you to continue setting device-specific credentials.

This custom credential set will not show on the Asset Credential Management page nor in any list of shared credential sets. Instead, you can access the device-specific local credential when you go to modify the asset, and navigate to the Asset Credentials section. Please see this section for further help and information on modifying assets. 

Note: upon upgrade, SNMPv3 community strings will not be populated in the Community String field, but will continue to work in the background. You will need to re-enter the community string if you wish to see it via the decrypt option.