Enterprise Manager logoEM: Security > Public/Private Keys

Description

In BBj 19.20 and higher, the Public/Private Keys is utilized for BBj security and authentication purposes. Each row lists a user along with an associated key pair identifier and description. Filtering options allow refined search based on the Public Key ID using logical conditions. The Use Filter checkbox enables/disables filter application, while the Refresh Rate dropdown controls how frequently the table auto-updates. The section supports key pair creation, deletion, and management for secure authentication workflow.

Location

Enterprise Manager logoEM NavigatorSecurityPublic/Private Keys

Toolbar

Button Function
Adds a new entry and opens new application.
refresh button Refreshes the displayed list of applications and their status.
Removes/deletes selected application(s) or files from the system.

Public/Private Keys: More Options Dropdown

The More Options dropdown in the Public/Private Keys panel enables advanced filtering and refresh control. The Refresh Rate dropdown defines how often the key list refreshes, ranging from Manual to timed intervals such as 3 to 15 seconds. Enabling Use Filter activates dynamic query rows that support compound logic (AND, OR) and filtering by key field Public Key ID, comparison operator (equals), and value. Multiple filters can be used to refine the displayed key list.

Settings Description
Refresh Rate Sets the automatic refresh interval for the data table. Selecting a time value (3, 5, 10, or 15 seconds) updates the data at the specified interval. Selecting Manual disables auto-refresh, requiring the user to manually reload the data.
Use Filter
  • When unchecked, disables all associated filter inputs, rendering the fields non-editable and preventing filter execution, regardless of any configured criteria.

  • When checked, enables the filter controls, allowing users to define one or more filtering conditions by selecting a field (Public Key ID), a comparison operator (equals, contains, less than, and regex etc.), and a corresponding input value. The filtering logic may be expanded with compound conditions using logical operators such as AND or OR.

Public Key ID

Specifies the filter column used to narrow results in the Public/Private Keys table. Options include User, Description, and Public Key ID, corresponding to the table's column headers. Selecting one of these options sets the filtering focus for the associated condition row. It functions in conjunction with the comparison operator and value fields to create precise filtering criteria when the Use Filter checkbox is enabled.

Comparison Dropdown

Conditional operator(s) used to evaluate the selected column against the input value in the filtering row. Options include equals, greater than, less than, contains, and regex. Used together with the field selector and value input to build precise filter expressions when the Use Filter checkbox is enabled.

Settings Description
equals Matches records where the selected column’s value is exactly the same as the input value.
greater than Matches records where the selected column’s value exceeds the specified input value.
less than Matches records where the selected column’s value is lower than the specified input value.
contains Matches records where the selected column’s value includes the specified sequence of characters.
regex Filters records using a regular expression pattern, enabling advanced, rule-based text matching in the selected column.
Filter Value Field Defines the user-specified target value that must match the selected filter column and comparison condition when the filter is applied.
Logical Operator Dropdown

Defines the logical relationship between multiple filter conditions in the filter panel, available options: None, AND, and OR.

Settings Description
None Selects no option for the control, leaving the related feature inactive and applying no additional behavior.
AND Applies logical conjunction to the active filters so a token record appears only when all selected conditions are true.
OR Applies logical disjunction to the active filters so a token record is returned when any selected condition is true.

Public/ Private Keys Column List

The Public/Private Keys table lists active key pairs and includes three columns; User, which identifies the account associated with the key pair; Description, which provides a user-defined label for the key; and Public Key ID, which shows the unique identifier assigned to the public key.

Column Description
User Identifies the authenticated BBjServices user account associated with the listed public/private key pair in the table.
Description Identifies the user-defined label or explanatory text associated with a given public/private key pair, typically indicating its purpose or context of usage within the system.
Public Key ID Identifies the unique Base64-encoded public key string associated with a stored key pair entry, used for BBj authentication and encryption purposes.

Create Public/Private Key Pair

Accessed by clicking the button in the Public/Private Keys section, this panel enables the creation of a new cryptographic key pair by specifying a target username(admin or guest), optional description, and private key, either manually entered or automatically generated. Includes an option to append the username to the key file name, which must be removed before the key can be used. Once generated, the private key is presented in JSON format and can be downloaded securely. The Done button finalizes and exits the creation process once all required fields are validated.

Settings Description
Username Specifies the target system user for whom the public/private key pair is being created, selected from a predefined dropdown list(guest or admin) of existing usernames.
Description Defines a brief, user-assigned label for the key pair to aid identification within the Public/Private Keys table and during download operations.
Append User To Filename
  • When unchecked, the username is omitted from the filename, allowing immediate use without modification.

  • When checked, appends the selected username to the generated private key filename, which must be manually removed before the key can be used.

Private Key Accepts a generated or user-provided JSON-formatted private key object containing privateKeyEncoded and publicKeyId fields, used for BBj application authentication and key-based access control.
Generate Key Pair Generates a new public/private key pair for the selected user using the provided parameters, populating the private key field with the encoded key and enabling the option to download it.
Download Private Key Initiates the download of the generated private key in JSON format, which contains both the encoded private key and associated public key ID. This action becomes enabled only after a valid key pair has been created and the private key field is filled.
Done Finalizes and exits the Create Public/Private Key Pair dialog after a key pair is generated and all necessary fields are completed.

See Also

BBjAdminBase

Authentication Tokens

Settings