The custom secrets naming allows you to provide your own secret naming format without conforming to any Automation 360 encoding conventions.

You can create a mapping of the Control Room username with the secret names. To map the Control Room usernames with the secret names, you must import a .CSV template file which contains the username, secrets names mapping entries into the Control Room.

Note: Ensure that you have the view and manage settings permission to proceed with the procedure.

Prerequisites

As a first time user, you can download a .CSV template to upload from Administration > Settings > External key vault > Device auto login > View custom secrets mapping option even before you configure an external key vault. The View custom secrets mapping option also allows you to view all the mapped entries at a glance.

Procedure

To import the Custom Secrets Name Mapping Template.csv template for custom secrets mapping, follow these steps:

  1. Navigate to Administration > Settings > External key vault > Device auto login.
  2. Click Edit and select Manage custom secrets mapping.
  3. Download the Custom Secrets Name Mapping Template.csv template and add the username, secret name in the format specified.
    Note: In the Automation 360 On-Premises deployments with Active Directory, prefix the username with domain. Example: domain\username.
  4. Click Import .csv and browse to select the Custom Secrets Name Mapping Template.csv template file to map the Control Room usernames with the secret names.

    The import Import .csv template must follow the specified format. You cannot use the exported mapping entries Import .csv file to import new entries.

  5. Click Import and save. The custom secrets mapping table is populated with the updated entries.
    You can now perform the following actions, as necessary:
    • Search bar to search and sort by secret name.
    • Import .csv to add or update the entries.
    • Export to .csv to export the mapped entries into a .csv format.
    • Delete checked items to remove multiple entries.
    • Refresh to refresh the updated entries.
Review the information if you face any errors when uploading the .CSV template into the Control Room:
  • Only 100 records can be processed at a time. For additional records, you can repeat the import action multiple times.
  • Each username maps to a single secret name. If a matching username is found, the system will overwrite the existing entry. If there are duplicate records, the last processed entry will take priority.
  • Multiple users can be mapped to the same secret name.
  • The username and secret name fields are required. If either is missing, the entry is considered invalid.
  • The system checks if the username exists in the Control Room. If the specified username does not exist, the entry is considered invalid.
  • If the system fails to save the mapping, an exception is raised and no records will be processed.