Additional Fields for SSH Keys and SSL Certificates

Use Additional Fields in PAM360 to attach any extra information about keys and certificates stored in the repository.

There are four types of fields to create: Character, Numeric, Date and Email. Once an additional field is created, the default value assigned to it will be applied to all entries in SSH Keys and Certificates tabs and will be visible to all users. Therefore, it is ideal to use additional fields for assigning common attributes such as organization name, or email address. Also, the Column Chooser icon helps you organize columns and additional fields in SSH Keys and Certificates tab views, and in Reports and Dashboard tab views.

Below are the operations you can perform on additional fields and the column chooser:

1. Creating an Additional Field
2. Displaying an Additional Field
3. Editing an Additional Field
4. Resetting an Additional Field
5. How to Show/Hide Fields Using the Column Chooser?

1. Creating an Additional Field

Follow the below steps to create additional fields that will apply to both keys and certificates tabs.

1. Navigate to Admin >> SSH/SSL Config >> Additional Fields.
2. Create a new additional field for any of the below mentioned field types:
   1. Character: To store text inputs
   2. Numeric: To store numerical inputs
   3. Date: To store date and time inputs
   4. Email: To store relevant email addresses
   5. Dropdown: To store multiple values in the same field and to use the values diversely for various certificates.
3. Add the Field Name, Default Value, Description. Select SSH Keys or Certificates tab to add the additional field to either of the tabs. To add the field to both tabs, select Both and click Save.
4. To view the newly created additional field under the SSH Keys or the Certificates tab, click the column chooser icon () from the top bar.


Note: Certificate Expiry Notification emails are sent to the email addresses specified in additional fields of the type Email. These notification emails will be customized according to the format configured for notifications under Admin >> SSH/SSL Config >> Notification Settings and Admin >> SSH/SSL Config >> Schedules.

2. Displaying an Additional Field

When you create an additional field of the type Character/Numeric/Date/Email/Dropdown, the field is added to both SSH keys and Certificates tabs immediately. Follow the below steps to display an additional field:

1. Navigate to SSH Keys or Certificates tab.
2. Click the column chooser icon () from the top bar.
3. In the column chooser pop-up, select the checkbox beside the additional field you added and click Save. Now, the additional field and the default value added during its creation will be displayed among the other fields. The same field value will be applied to all entries in the Keys and Certificate repository but the value can be edited and customized using the Edit option for individual certificates.

3. Editing an Additional Field

Once a default value for the additional field is added, the same value will be applied to all the certificate and key entries in the Certificates and SSH Keys tabs respectively. To change the field value for a particular certificate, follow the below steps:

1. Navigate to the SSH Keys or Certificates tab.
2. Select a particular certificate and click Edit from the More dropdown in the top bar.
3. In the Edit Certificate window, edit the value from the text field or select the value from the dropdown and click Save. This value will be updated for the selected certificate alone.
4. To edit additional fields in bulk for a number of keys/certificates at a time, select all required keys or certificates and click More >> Edit. In the Edit window, edit the values from the text field or select the value from the dropdown. The same values will be added for all the selected keys/certificates.
5. To edit additional fields for certificate groups, go to Certificates >> Certificate Group. Select the required groups and click Update Additional Fields.
6. In the Update SSL Group Additional Fields pop-up that opens, edit the values form the text field or select the value from the dropdown. The same values will be added for all the selected keys/certificates present in the selected group.

4. Resetting an Additional Field

Follow the below steps to reset the additional fields and remove any previously added ones:

1. Navigate to Admin >> SSH/SSL Config >> Additional Fields.
2. Click the Reset option available at the bottom of the page. In the pop-up that opens, confirm the reset by clicking OK. This process will delete the additional fields from both the SSH Keys and SSL Certificates tab.
3. To delete only selected additional fields, remove the field name, default value and description manually and click Save.

5. How to Show/Hide Fields using the Column Chooser?

Using the Column Chooser icon (), organize the columns and choose to show or hide both the default and additional fields as per your requirement. The Column Chooser icon helps declutter the columns in the following tabs: SSH Keys, Certificates, Reports and Dashboard.

In the Reports tab, the Column Chooser is available for selected reports, namely the following:

1. SSL Certificates Report
2. SHA1 Certificate Report
3. Let's Encrypt Certificates Report
4. SSL Vulnerability Report
5. PrivateKey Report
6. Certificate Renewal

In the Dashboard tab, the Column Chooser is available for the following views in the Keys Dashboard: SSH Keys and SSL Certificates.

Follow the below steps to show or hide any column from the tab view:

1. Click the Column Chooser icon to display all the available column names.
2. Unselect the checkboxes beside the column names that you want to hide from the tab view. You can choose to hide even the default columns in this way.
3. Apart from the show/hide option, you can change the sort order of the columns. To do so, simply click the column and drag and drop where required.
4. All the additional fields created for SSH Keys and SSL Certificates will also be listed under Admin >> Settings >> Privacy Settings, along with the default column values. Select the checkboxes beside the column/field names to hide or mask the corresponding data from the exported reports.