Keyring Screen

Reference guide for the TrueNAS Connect Keyring screen interface elements and operations.
Tags:

  3 minute read  

The TrueNAS Connect Keyring screen displays TrueNAS systems and their encrypted key storage status, and allows users to reset the keyring.

Header Controls

Back to Dashboard

The arrow_back_iosbutton in the upper-left area of the screen returns to the main TrueNAS Connect dashboard.

Reset Button

Reset opens the Reset Keyring confirmation dialog.

Keyring Table

The keyring table displays all TrueNAS systems with stored encrypted keys containing the following columns:

TrueNAS Column

The TrueNAS column displays the host name or identifier of connected TrueNAS systems. The system name shows as it appears in TrueNAS Connect (e.g., my-system).

Key Column

The Key column displays the storage status of the encrypted key. Stored indicates the encrypted TrueNAS key is successfully saved in the keyring database. A blank cell indicates no key is stored for the system.

Connected Column

The Connected column displays the current connection status to the TrueNAS system. True indicates TrueNAS Connect can successfully authenticate with the stored key. False indicates authentication fails or the system is unreachable.

Reset Keyring Dialog

The Reset Keyring dialog shows a reset warning about keyring reset consequences.

Resetting the keyring permanently removes encryption keys from the database, and users must manually authenticate each TrueNAS server after reset.

Ok proceeds with keyring reset and removes all encrypted keys from the database. Cancel closes the reset dialog without resetting the key and returns to the Keyring screen.

Create Keyring Passphrase Dialog

The Create Keyring button opens the Create Keyring Passphrase dialog for setting up encrypted API key storage.

The dialog explains that the keyring provides quick authentication for TrueNAS servers by creating and encrypting API keys client-side using a passphrase. TrueNAS user credentials are not stored by TrueNAS Connect.

The dialog recommends using a passphrase different from your TrueNAS user password.

Name

Specifies the identifier for the keyring. Enter the keyring name.

Passphrase

Sets the encryption passphrase for the keyring. Enter the passphrase.

Confirm

Confirms the encryption passphrase. Re-enter the passphrase.

Cancel closes the dialog without creating a keyring. Returns to the Keyring screen with no changes.
Ok creates the keyring with the specified name and passphrase. The button remains disabled until all required fields are completed and passphrases match.

Unlock Keyring Dialog

The Unlock Keyring dialog shows when you sign into TrueNAS Connect if you created a keyring to authenticate your registered (added) system.

Passphrase

Passphrase entered unlocks a system added to or covered by the keyring. Adding a keyring creates an API key between the TrueNAS server and TrueNAS Connect. To view the API key, log into the TrueNAS server as an administrator and go to the User API Key screen.

OK submits the passphrase to the system for authentication. A correctly entered passphrase unlocks all systems associated with the authentication keyring. Cancel closes the dialog without submitting the passphrase.