Skip to main content
Version: 11.1.0

FIDO2 MDS Server (UI)

Prerequisites

Accessing the MDS Server Page

  1. Click Settings in the left navigation pane
  2. Select the FIDO2 MDS Server tab

The page displays two tabs: FIDO2 Metadata Statements and Management.

FIDO2 Metadata Statements Tab

This tab provides a searchable, filterable table of all metadata entries known to your HYPR deployment — both FIDO Alliance-sourced and manually uploaded.

A status banner at the top shows when the MDS was last successfully synced from the FIDO Alliance.

Table Columns

ColumnDescription
IconAuthenticator icon (falls back to HYPR logo if unavailable)
AuthenticatorFriendly name and AAGUID
StatusFIDO certification level (e.g., FIDO_CERTIFIED, FIDO_CERTIFIED_L1)
UVMUser verification methods (e.g., fingerprint, passcode, presence)
TransportsSupported transports (e.g., USB, NFC, BLE, internal, hybrid)
ActionsView JSON button to inspect the full metadata statement

Additional columns can be toggled via the Columns button:

ColumnDescription
AttachmentAuthenticator attachment type (internal, external, etc.)
Key ProtectionKey protection mechanism (hardware, software, TEE, secure element)
AlgorithmsSupported cryptographic algorithms

Search and Filters

FilterTypeDescription
SearchFree textSearches against AAGUID and authenticator name
EnabledDropdownFilter by enabled or disabled status
StatusDropdownFilter by FIDO certification level
User VerificationMulti-selectFilter by user verification methods (OR match)
TransportsMulti-selectFilter by supported transport protocols

Click More Filters to access additional filters:

FilterValues
Attachmentinternal, external, wired, wireless, NFC, Bluetooth
Key Protectionhardware, software, TEE, secure element, remote handle
Algorithmssecp256r1, ed25519, RSA PKCS v1.5, RSA PSS, and others

Click Reset to clear all active filters.

Viewing Metadata Details

Click View JSON on any row to open a modal with the full metadata statement.

The modal displays:

  • The authenticator's AAGUID (copyable)
  • A Copy JSON button for the complete metadata statement
  • Pretty-printed JSON of all metadata fields

Management Tab

The Management tab allows administrators to upload custom metadata statements and manage manually added entries.

Uploading Custom Metadata

Two methods are available:

Upload JSON File

  1. Click Upload JSON File
  2. Select a .json file containing a valid FIDO2 MetadataStatement (max 1 MB)
  3. The entry appears in the table upon successful upload

Paste JSON

  1. Click Paste JSON
  2. Paste a valid MetadataStatement JSON into the text area (max 1 MB)
  3. Click Submit
caution

Uploaded metadata must conform to the FIDO2 MetadataStatement schema. Invalid JSON or missing required fields will be rejected.

Managing Manual Entries

The table displays all manually uploaded entries with the following columns:

ColumnDescription
AAGUIDThe authenticator's unique identifier
DescriptionFriendly name from the metadata statement
CreatedUpload timestamp
ActionsDelete button with confirmation prompt
info

Only manually uploaded entries appear in this tab. Entries synced from the FIDO Alliance MDS cannot be deleted from the UI — they are managed automatically by the MDS sync process.

Permissions Required

Admin role required. The following permission scopes apply:

ActionRequired Permission
View metadata table and entriesRP_APP_CONFIG_VIEW or RP_APP_CONFIG_MODIFY
Upload or delete manual entriesRP_APP_CONFIG_MODIFY