Skip to main content

TwoFactorSecret

Description

TOTP-based 2FA secret linked to a Principal. Store securely encrypted.

Properties

NameTypeDescriptionNotes
principalPrincipal[optional]
secretKeyStringTOTP secret key (Base32 encoded, encrypted at rest)
algorithmAlgorithmEnumTOTP algorithm (HmacSHA1, HmacSHA256, HmacSHA512)
digitsIntegerNumber of digits in the TOTP code
periodIntegerTime period in seconds for TOTP rotation
qrCodeUrlStringQR code URL for provisioning authenticator apps[optional] [readonly]
backupCodesList<String>List of backup codes (10 single-use codes for account recovery)[optional]
enabledBooleanWhether 2FA is actively enforced for this Principal[optional]
lastUsedAtOffsetDateTimeLast time a code was successfully verified[optional] [readonly]
verifiedAtOffsetDateTimeWhen the Principal confirmed possession of the authenticator[optional] [readonly]
idUUIDUnique identifier for object in the system[optional] [readonly]
ownerIdUUIDUUID of owner of the object in the system[optional] [readonly]
createdDateOffsetDateTimeDate of object creation[optional] [readonly]
keyHashStringData, including hash of the key(s) used to encrypt this record.[optional] [readonly]
lastAccessedByIdUUIDLast user to access object[optional] [readonly]
lastAccessedDateOffsetDateTimeTimestamp of last access of object[optional] [readonly]
lastModifiedByIdUUIDUnique identifier for user who last modifed the object in the system[optional] [readonly]
lastModifiedDateOffsetDateTimeDate of last object modification[optional] [readonly]
trashedBooleanIndicates if the object is trashed (soft deleted)[optional]

Enum: AlgorithmEnum

NameValue
HMACSHA1"HmacSHA1"
HMACSHA256"HmacSHA256"
HMACSHA512"HmacSHA512"

Implemented Interfaces

  • Serializable

Generated Version Details

~value
GENERATOR VERSIONcom.valkyrlabs:ValkyrAI API 1.0.2-SNAPSHOT
API ARTIFACTcom.valkyrlabs.valkyrai-api.jar
GENERATOR VERSIONorg.openapitools.openapi-generator:7.5.0
GENERATOR CLASSorg.openapitools.codegen.languages.SpringCodegen
GENERATED DATE2026-04-02T00:49:23.764634-07:00[America/Los_Angeles]