WEBAUTHN_AUTHENTICATOR_GET_ASSERTION_OPTIONS structure (webauthn.h)

A structure that contains the data needed to get an assertion.

Syntax

typedef struct _WEBAUTHN_AUTHENTICATOR_GET_ASSERTION_OPTIONS {
  DWORD                                dwVersion;
  DWORD                                dwTimeoutMilliseconds;
  WEBAUTHN_CREDENTIALS                 CredentialList;
  WEBAUTHN_EXTENSIONS                  Extensions;
  DWORD                                dwAuthenticatorAttachment;
  DWORD                                dwUserVerificationRequirement;
  DWORD                                dwFlags;
  PCWSTR                               pwszU2fAppId;
  BOOL                                 *pbU2fAppId;
  GUID                                 *pCancellationId;
  PWEBAUTHN_CREDENTIAL_LIST            pAllowCredentialList;
  DWORD                                dwCredLargeBlobOperation;
  DWORD                                cbCredLargeBlob;
  PBYTE                                pbCredLargeBlob;
  PWEBAUTHN_HMAC_SECRET_SALT_VALUES    pHmacSecretSaltValues;
  BOOL                                 bBrowserInPrivateMode;
  PCTAPCBOR_HYBRID_STORAGE_LINKED_DATA pLinkedDevice;
  BOOL                                 bAutoFill;
  DWORD                                cbJsonExt;
  PBYTE                                pbJsonExt;
} WEBAUTHN_AUTHENTICATOR_GET_ASSERTION_OPTIONS, *PWEBAUTHN_AUTHENTICATOR_GET_ASSERTION_OPTIONS;

Members

dwVersion

The version of this structure.

dwTimeoutMilliseconds

Time that the operation is expected to complete within. This is used as guidance and can be overridden by the platform.

CredentialList

The list of allowed credentials to be used in the assertion.

Extensions

A CBOR map from extension identifiers to their authenticator extension inputs, created by the client based on the extensions requested by the Relying Party. These are optional extensions to parse when performing the operation.

dwAuthenticatorAttachment

The attachment for the assertion. Optional platform vs cross-platform authenticators.

dwUserVerificationRequirement

The effective user verification requirement.

dwFlags

The flags for the assertion.

pwszU2fAppId

Optional identifier for the U2F AppId. Converted to UTF8 before being hashed. Not lower-cased.

pbU2fAppId

If this is non-NULL, then, set to TRUE if the pwszU2fAppid was used instead of PCWSTR pwszRpId.

pCancellationId

Optional cancellation Id. See WebAuthNGetCancellationId for more information.

pAllowCredentialList

An optional list of public key credential descriptors describing credentials acceptable to the Relying Party (possibly filtered by the client), if any. If present, CredentialList will be ignored.

dwCredLargeBlobOperation

The large blob operation.

cbCredLargeBlob

Size of pbCredLargeBlob.

pbCredLargeBlob

A pointer to the large credential blob.

pHmacSecretSaltValues

PRF values which will be converted into HMAC-SECRET values according to the WebAuthN Spec.

bBrowserInPrivateMode

Indicates whether the client is using in-private mode in the browser. An optional parameter that defaults to FALSE.

pLinkedDevice

bAutoFill

cbJsonExt

pbJsonExt

Requirements

Requirement Value
Header webauthn.h

See also

WebAuthNAuthenticatorGetAssertion

WEBAUTHN_HMAC_SECRET_SALT_VALUES