WebEngineWebAuthUxRequest QML Type | Qt WebEngine 6.8.6 (original) (raw)
Encapsulates the data of a WebAuth UX request. More...
Properties
- pinRequest : QWebEngineWebAuthPinRequest
- relyingPartyId : string
- requestFailureReason : enumeration
- state : enumeration
- userNames : stringlist
Signals
- void stateChanged(WebAuthUxState state)
Methods
- void cancel()
- void retry()
- void setPin(const QString &pin)
- void setSelectedAccount(const QString &selectedAccount)
Detailed Description
Web engine's WebAuth UX requests are passed to the user in the WebEngineView::webAuthUxRequested() signal.
For more information about how to handle web engine authenticator requests, see the Nano Browser.
Property Documentation
pinRequest : QWebEngineWebAuthPinRequest [read-only]
relyingPartyId : string [read-only]
The WebAuth request's relying party id.
requestFailureReason : enumeration [read-only]
The WebAuth request's failure reason.
| Constant | Description |
|---|---|
| WebEngineWebAuthUxRequest.RequestFailureReason.Timeout | The authentication session has timed out. |
| WebEngineWebAuthUxRequest.RequestFailureReason.KeyNotRegistered | Key is not registered with the authenticator. |
| WebEngineWebAuthUxRequest.RequestFailureReason.KeyAlreadyRegistered | Key is already registered with the authenticator. Try to register with another key or use another authenticator. |
| WebEngineWebAuthUxRequest.RequestFailureReason.SoftPinBlock | The authenticator is blocked as the user entered the wrong key many times. |
| WebEngineWebAuthUxRequest.RequestFailureReason.HardPinBlock | The authenticator is blocked as the user entered the wrong key many times and reset the PIN to use the specific authenticator again. |
| WebEngineWebAuthUxRequest.RequestFailureReason.AuthenticatorRemovedDuringPinEntry | Authenticator removed during PIN entry. |
| WebEngineWebAuthUxRequest.RequestFailureReason.AuthenticatorMissingResidentKeys | Authenticator doesn't have resident key support. |
| WebEngineWebAuthUxRequest.RequestFailureReason.AuthenticatorMissingUserVerification | Authenticator doesn't have user verification support. |
| WebEngineWebAuthUxRequest.RequestFailureReason.AuthenticatorMissingLargeBlob | Authenticator doesn't have large blob support. |
| WebEngineWebAuthUxRequest.RequestFailureReason.NoCommonAlgorithms | No common algorithm. |
| WebEngineWebAuthUxRequest.RequestFailureReason.StorageFull | The resident credential could not be created because the authenticator has insufficient storage. |
| WebEngineWebAuthUxRequest.RequestFailureReason.UserConsentDenied | User consent denied. |
| WebEngineWebAuthUxRequest.RequestFailureReason.WinUserCancelled | The user clicked Cancel in the native windows UI. |
See also stateChanged().
state : enumeration [read-only]
The WebAuth request's current UX state.
| Constant | Description |
|---|---|
| WebEngineWebAuthUxRequest.WebAuthUxState.NotStarted | WebAuth UX request not started yet. |
| WebEngineWebAuthUxRequest.WebAuthUxState.SelectAccount | The authenticator requires resident credential details. The application needs to display an account details dialog, and the user needs to select an account to proceed. |
| WebEngineWebAuthUxRequest.WebAuthUxState.CollectPin | The authenticator requires user verification. The application needs to display a PIN request dialog. |
| WebEngineWebAuthUxRequest.WebAuthUxState.FinishTokenCollection | The authenticator requires token/user verification (like tap on the FIDO key) to complete the process. |
| WebEngineWebAuthUxRequest.WebAuthUxState.RequestFailed | WebAuth request failed. Display error details. |
| WebEngineWebAuthUxRequest.WebAuthUxState.Cancelled | WebAuth request is cancelled. Close the WebAuth dialog. |
| WebEngineWebAuthUxRequest.WebAuthUxState.Completed | WebAuth request is completed. Close the WebAuth dialog. |
userNames : stringlist [read-only]
Signal Documentation
void stateChanged(WebAuthUxState state)
Method Documentation
Retries the current WebAuth request.
See also stateChanged().
void setPin(const QString &pin)
Sends the pin to the authenticator that prompts for a PIN. This is needed when the current WebAuth request's UX state is WebEngineWebAuthUxRequest.WebAuthUxState.CollectPin. The WebAuth request is blocked until the user responds with a PIN.
See also QWebEngineWebAuthPinRequest and state.
void setSelectedAccount(const QString &selectedAccount)
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.