Back to Qt.io
Contact Us Blog Download Qt

WebEngineWebAuthUxRequest QML Type

封装 WebAuth UX 请求的数据。更多

Import Statement: import QtWebEngine
Since: QtWebEngine 6.7
In C++: QWebEngineWebAuthUxRequest

属性

信号

方法

详细说明

WebEngine的 WebAuth UX 请求通过WebEngineView::webAuthUxRequested() 信号传递给用户。

有关如何处理网络引擎验证器请求的更多信息，请参阅Nano 浏览器。

属性文档

pinRequest : QWebEngineWebAuthPinRequest [read-only]

WebAuth 请求的 PIN 请求信息。

另请参阅 QWebEngineWebAuthPinRequest 。


relyingPartyId : string [read-only]

WebAuth 请求的依赖方 ID。


requestFailureReason : enumeration [read-only]

WebAuth 请求的失败原因。

常量说明
WebEngineWebAuthUxRequest.RequestFailureReason.Timeout身份验证会话超时。
WebEngineWebAuthUxRequest.RequestFailureReason.KeyNotRegistered密钥未在验证器上注册。
WebEngineWebAuthUxRequest.RequestFailureReason.KeyAlreadyRegistered密钥已在身份验证器上注册。尝试使用其他密钥注册或使用其他身份验证器。
WebEngineWebAuthUxRequest.RequestFailureReason.SoftPinBlock由于用户多次输入错误密钥，身份验证器被阻止。
WebEngineWebAuthUxRequest.RequestFailureReason.HardPinBlock由于用户多次输入错误密钥，认证器被阻止，请重置 PIN 码再次使用特定认证器。
WebEngineWebAuthUxRequest.RequestFailureReason.AuthenticatorRemovedDuringPinEntry验证器在输入密码时被移除。
WebEngineWebAuthUxRequest.RequestFailureReason.AuthenticatorMissingResidentKeys身份验证器不支持常驻密钥。
WebEngineWebAuthUxRequest.RequestFailureReason.AuthenticatorMissingUserVerification身份验证器不支持用户验证。
WebEngineWebAuthUxRequest.RequestFailureReason.AuthenticatorMissingLargeBlob身份验证器不支持大 Blob。
WebEngineWebAuthUxRequest.RequestFailureReason.NoCommonAlgorithms无通用算法。
WebEngineWebAuthUxRequest.RequestFailureReason.StorageFull由于身份验证器存储空间不足，无法创建常驻凭证。
WebEngineWebAuthUxRequest.RequestFailureReason.UserConsentDenied拒绝用户同意。
WebEngineWebAuthUxRequest.RequestFailureReason.WinUserCancelled用户在本地 Windows UI 中点击了Cancel 。

另请参阅 stateChanged().


state : enumeration [read-only]

WebAuth 请求的当前用户体验状态。

常量说明
WebEngineWebAuthUxRequest.WebAuthUxState.NotStartedWebAuth 用户体验请求尚未启动。
WebEngineWebAuthUxRequest.WebAuthUxState.SelectAccount身份验证器需要常驻凭据详细信息。应用程序需要显示账户详细信息对话框，用户需要选择一个账户才能继续。
WebEngineWebAuthUxRequest.WebAuthUxState.CollectPin身份验证器需要用户验证。应用程序需要显示 PIN 请求对话框。
WebEngineWebAuthUxRequest.WebAuthUxState.FinishTokenCollection身份验证器需要令牌/用户验证（如点击 FIDO 密钥）才能完成流程。
WebEngineWebAuthUxRequest.WebAuthUxState.RequestFailedWebAuth 请求失败。显示错误详情。
WebEngineWebAuthUxRequest.WebAuthUxState.CancelledWebAuth 请求已取消。关闭 WebAuth 对话框。
WebEngineWebAuthUxRequest.WebAuthUxState.CompletedWebAuth 请求已完成。关闭 WebAuth 对话框。

userNames : stringlist [read-only]

支持常驻凭证的可用用户名。

当前 WebAuth 请求的用户体验状态为WebEngineWebAuthUxRequest.WebAuthUxState.SelectAccount 时需要使用此功能。WebAuth 对话框会显示用户名。用户需要选择一个账户才能继续。

另请参阅 state,setSelectedAccount() 和QWebEngineWebAuthUxRequest::userNames 。


信号文档

void stateChanged(WebAuthUxState state)

每当 WebAuth UX 的state 发生变化时，就会发出该信号。

注： 相应的处理程序是onStateChanged 。

另请参阅 state 和QWebEngineWebAuthUxRequest::WebAuthUxState 。


方法文档

void cancel()

取消当前 WebAuth 请求。

另请参阅 QWebEngineWebAuthUxRequest::Cancelled 和WebEngineWebAuthUxRequest::stateChanged()。


void retry()

重试当前 WebAuth 请求。

另请参阅 stateChanged( )。


void setPin(const QString &pin)

向验证器发送pin ，提示输入 PIN 码。当当前 WebAuth 请求的用户体验状态为WebEngineWebAuthUxRequest.WebAuthUxState.CollectPin，则需要执行此操作。在用户回复 PIN 之前，WebAuth 请求将被阻止。

另请参阅 QWebEngineWebAuthPinRequest 和state 。


void setSelectedAccount(const QString &selectedAccount)

向验证器发送selectedAccount 名称。当当前 WebAuth 请求的用户体验状态为WebEngineWebAuthUxRequest.WebAuthUxState.SelectAccount 时，就需要这样做。在用户选择账户并调用此方法之前，WebAuth 请求将被阻止。

另请参阅 WebEngineWebAuthUxRequest::userNames 和state 。


© 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.