HypervisorUserSummaryDto
A Hypervisor MFA User as listed and fetched. Carries no secret material, ever. canonicalUsername is the server-computed name the Agent matches an SSH login against; it is unique case-insensitively.
{
"id": 0,
"username": "string",
"canonicalUsername": "string",
"displayName": "string",
"email": "string",
"identitySource": "string",
"realm": "string",
"provisioningSource": "string",
"enrollmentStatus": "string",
"enabled": false,
"secretVersion": 0,
"enrolledAt": "string",
"createdAt": "string",
"updatedAt": "string"
}
Identifier of the Hypervisor MFA User, assigned when the record is created
The name as entered by the administrator
The name the Agent matches an SSH login against: the entered name for SHARED_ROOT_PRINCIPAL and LOCAL, and for ACTIVE_DIRECTORY always lowercase in the form the user logs in with (user@domain, domain, backslash and user, or domain, slash and user)
Optional display name of at most 128 characters without control characters; null when none was set
Optional email address of at most 254 characters; null when none was set
SHARED_ROOT_PRINCIPAL: OS login is root and the person types a Console username at the second prompt. LOCAL: a named local account. ACTIVE_DIRECTORY: an AD account; a realm is required.
SHARED_ROOT_PRINCIPAL: The canonical name is the name as entered (case kept, 1 to 64 letters, digits, dot, underscore or hyphen); a realm is refused, and the bare name root is refusedLOCAL: The canonical name is the name as entered (case kept, 1 to 64 letters, digits, dot, underscore or hyphen); a realm is refused, and the bare name root is refusedACTIVE_DIRECTORY: A realm is required; the canonical name is lowercase, as user@domain when the realm contains a dot and as domain, backslash and user otherwise, or in the qualified form that was entered
Present exactly when identitySource is ACTIVE_DIRECTORY
How a Hypervisor MFA User record was created.
MANUAL: Created by the create operationCSV_IMPORT: Created by the CSV import
PENDING: no secret issued. ENROLLED: a secret is issued. REVOKED: every secret version is destroyed.
PENDING: The initial status; also set again when cancelling the first enrollment; only a PENDING user can be enrolledENROLLED: An enrollment was issued by enroll or re-enroll; also restored when cancelling a re-enroll returns to the previous enrollmentREVOKED: The revoke operation was applied; also set when cancelling a re-enroll finds no previous enrollment to restore
Whether the user is enabled; a new user starts enabled and the update operation changes it
Current secret version; 0 while PENDING
Time the current MFA enrollment was issued by enroll or re-enroll; null while no enrollment has been issued, and again after the first enrollment is cancelled
Time the user record was created
Time the user record was last changed