For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to page URLs.
Skip to content

Users

How a Master Administrator creates PSD and API users on Ledger Enterprise, issues API credentials, tracks registrations, and suspends or revokes access.

Role: Master Administrators.

Users lists everybody in the Workspace. It has two tabs: Users and PSD registrations.

The list carries each user's name, type, role, status, creation date and identifier. Search it by name, ID or device ID. Filter it by status, role or type.

The Status filter offers Active and Revoked only. Suspended users appear under Active.

Operators can be organized into groups, which Rules use in place of individual names. See Groups.

The two user types

PSD is short for Personal Security Device: the credential that identifies a user and signs their approvals.

Type
How they work
What they need

PSD user

Signs in and approves through the interface, on a Ledger device

A registration link, and the device's ID

API user

Works entirely through the API, signing with its own key

An externally generated public key

Both types take a role, Operator or Administrator.

In the interface, a name has at most 19 characters, in ASCII only. The API accepts up to 45 characters. Each name must be unique in the Workspace.

Important: Administrator creation is paused while a Confirmation Threshold change is in flight. Operator creation stays available. See Workspace settings.

Creating a PSD user

You need the invited person's device ID first: the 16 hexadecimal characters that the Ledger Vault app shows. The form shows it in groups of four, for example 0123-A123-B123-C123. Ask them for it before you start.

  1. Select Create user, then PSD user.

  2. Enter the name and the device ID.

  3. Select the role.

  4. Create user.

The form rejects a device ID already used by an active user or an ongoing registration.

You then get a registration link. Send it to the invited user.

The invitation takes effect at once. It is not a Request. The user is created only when the activation Request is approved. See Tracking registrations.

Registering as an invited user

The invited user completes registration from the link, with their Ledger device. See Registering as a new user.

If the device shows Device paired with another workspace, the invited user reinstalls the Ledger Vault app on the device, then selects Retry. If the message stays, contact support. See Your device and the Workspace partition.

Note: In a Workspace with single sign-on (SSO), a PSD user also pairs the Ledger device with their SSO identity at the first sign-in. See Single sign-on (SSO).

Tracking registrations

The PSD registrations tab follows an invitation from creation to activation.

Status
What it means

Invitation created

The link exists. The user has not started registration

Pending registration

The user started registration and has not finished it

Pending Administrator activation

Registration is complete. A Master Administrator must select Review

Pending Administrator approval

The activation Request is waiting for approval

From a registration you can select Copy registration link, Review or Delete.

Review is available only in Pending Administrator activation. It creates a Request to create the user, and Master Administrators approve it. While that Request is pending, Copy registration link and Delete are unavailable.

When the activation Request is approved, the registration leaves this tab. The user then appears in the Users tab.

When registrations are in Pending Administrator activation, Users in the navigation shows a red count of them. The PSD registrations tab shows the same count.

Delete asks for confirmation, then deletes the invitation. The copied link stops working, and the person cannot complete registration from it.

Creating an API user

  1. Select Create user, then API user.

  2. Enter the name.

  3. Paste the public key. It must be an uncompressed secp256r1 key: 04 followed by 128 hex characters.

  4. Select the role.

  5. Select Review, and confirm on your device.

The form rejects a public key already used by an active user.

Creating an API user is a Request. Master Administrators approve it.

The approved Request does not issue an API key ID or secret. Until a Master Administrator issues them, the API user cannot authenticate. See Issuing the first API credentials. For how API users authenticate and approve, see API users.

Note: A new API Administrator has no permissions. It gets permissions only from the API Administrator rules in Workspace settings. A Master Administrator configures these Rules.

Issuing the first API credentials

A Master Administrator issues an API user's first API key ID and API key secret with Refresh credentials. Do this after the creation Request is approved.

  1. In Users, find the API user. Its status is Active.

  2. In the row menu, select Refresh credentials. The same button is also on the user's page.

  3. In Refresh API credentials?, select Refresh credentials.

  4. Copy the API key ID and the API key secret.

  5. Close the dialog.

Warning: The dialog clears the credentials when it closes. The platform does not show them again. If they are lost, refresh again. A refresh issues a new pair and stops the old pair immediately.

Issuing credentials is not a Request. It needs no approval and no Ledger device. The platform logs each refresh.

The user page

Select a user in the Users tab to open their page. To share it, select Copy link to user in the row menu.

The page shows:

  • Role, Status and Created. For a revoked user, it also shows Revoked, with the date.

  • Ledger device information. It gives the Type. For a PSD user, it gives the Identifier, which is the device ID, with a copy action, and the Model. The copy action gives the device ID with no hyphens. For an API user, it gives the Public key, with a copy action.

  • History: the timeline of the Request that created the user.

  • Governance, for Operators only. Accounts lists the Accounts where the user takes part in a quorum, directly or through a group. Groups lists the user's groups, up to 8. In each part, View all opens the full list, filtered on this user.

The page header carries the actions available for the user: Refresh credentials for an API user, Revoke user permanently, and Suspend user or Restore access. Your own page shows no actions. The page of a suspended user shows the Temporary access lock banner.

Managing an existing user

Action
What it does

Suspend

Blocks access immediately. Reversible. Not available for a PSD Administrator

Restore access

Lifts a suspension

Revoke

Ends access permanently

Refresh credentials

Issues a new API key ID and secret, for an active API user who is not suspended

Add to Portfolios

Adds an Operator to Portfolios, or removes it from them. See Portfolios

A user's status is Active, Suspended or Revoked.

Suspending

Access is blocked immediately. The user loses the platform, any pending Requests, and any Account information. You can restore it at any time.

You cannot suspend a PSD Administrator. To remove one, revoke them.

Revoking

Revocation is permanent and it is a Request, so it needs approval.

You cannot revoke yourself. You cannot revoke a Master Administrator if the Master Administrators left would no longer outnumber the Confirmation Threshold. In the interface, Revoke is then unavailable. On the user's page, its tooltip gives the reason. While a revocation Request is pending, Revoke is unavailable for that user.

For most users, access is blocked immediately and the revocation is finalized when the Request is fully approved. In the interface, Revoke suspends the user first, then creates the revocation Request.

Important: An Administrator who is a PSD user keeps access while their revocation is being approved. They can still use the platform and see pending Requests. They cannot approve or reject their own revocation.

What a revocation removes

When the revocation Request is fully approved, the platform:

  • removes the user from every group and every Portfolio;

  • removes the user from every step of every Rule, including Creator steps and the API Administrator rules;

  • stops counting the user's approval at the current step of a pending Request. That step needs another approval.

The revocation Request also blocks two kinds of Requests. These are the Requests that the user created and that are not yet approved, and the Requests that the user approved at an earlier step. This happens when the revocation Request is created, and again when it is fully approved. Requests that already execute or have ended do not change. See Blocked.

When the platform refuses a revocation

The platform refuses to create the revocation when a Rule step would have fewer members than its quorum without the user. The step can list users, or hold a group that the user is in. A user who is the only member of a step with a quorum of 1 is in this case. This applies in the interface and over the API.

The platform does not check the steps of a single-asset Policy on a deprecated network, because Accounts on that network accept no new operation. It still checks the Rules that an Account holds on its own.

To find the steps, open the user's page. For an Operator, Governance lists the Accounts and the groups where the user takes part.

To revoke the user:

  1. In the Policy, the Account or the API Administrator rules that hold the step, lower the quorum or add a member.

  2. For a step that holds a group, you can add a member to the group instead.

  3. Wait until that Request is approved.

  4. Revoke the user again.

In the interface, the suspension happens before the platform checks the steps. A refused revocation therefore leaves the user suspended. A PSD Administrator is the exception, because the interface does not suspend one. To lift the suspension, select Restore access.

The platform checks the steps again before it applies an approved revocation. If a change since the creation leaves a step too small, the revocation does not complete.

Refreshing API credentials

This issues a new API key ID and API key secret. It is also how an API user gets its first pair. See Issuing the first API credentials.

Warning: The existing credentials stop working immediately. The new secret is shown once, and is cleared when the dialog closes. Copy it before you close.

Last updated