このページでは

WebEngineWebAuthUxRequest QML Type

WebAuth UX リクエストのデータをカプセル化します。詳細...

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

プロパティ

信号

方法

詳しい説明

WebEngineの WebAuth UX リクエストは、WebEngineView::webAuthUxRequested() シグナルでユーザに渡されます。

ウェブエンジン認証リクエストの処理方法の詳細については、Nano Browser を参照してください。

プロパティの説明

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.AuthenticatorRemovedDuringPinEntryPIN 入力中に認証器が削除された。
WebEngineWebAuthUxRequest.RequestFailureReason.AuthenticatorMissingResidentKeysオーセンティケータが常駐キーをサポートしていない。
WebEngineWebAuthUxRequest.RequestFailureReason.AuthenticatorMissingUserVerificationオーセンティケータがユーザー検証をサポートしていない。
WebEngineWebAuthUxRequest.RequestFailureReason.AuthenticatorMissingLargeBlobAuthenticator がラージ・ブロブをサポートしていない。
WebEngineWebAuthUxRequest.RequestFailureReason.NoCommonAlgorithms共通のアルゴリズムがありません。
WebEngineWebAuthUxRequest.RequestFailureReason.StorageFull認証子のストレージが不足しているため、常駐クレデンシャルを作成できませんでした。
WebEngineWebAuthUxRequest.RequestFailureReason.UserConsentDeniedユーザの同意が拒否されました。
WebEngineWebAuthUxRequest.RequestFailureReason.WinUserCancelledユーザーがネイティブのウィンドウズ UI でCancel をクリックしました。

stateChanged()も参照してください

state : enumeration [read-only]

WebAuth リクエストの現在の UX 状態。

定数説明
WebEngineWebAuthUxRequest.WebAuthUxState.NotStartedWebAuth UX リクエストはまだ開始されていません。
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 リクエストの UX ステートがWebEngineWebAuthUxRequest.WebAuthUxState.SelectAccount の場合に必要です。WebAuth ダイアログはユーザー名を表示します。続行するには、ユーザーがアカウントを選択する必要があります。

statesetSelectedAccount()、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 リクエストの UX ステートがWebEngineWebAuthUxRequest.WebAuthUxState.CollectPin の場合に必要です。WebAuth リクエストは、ユーザーが PIN で応答するまでブロックされます。

QWebEngineWebAuthPinRequest およびstateも参照してください

void setSelectedAccount(const QString &selectedAccount)

selectedAccount 名を認証者に送信する。これは、現在の WebAuth リクエストの UX ステートがWebEngineWebAuthUxRequest.WebAuthUxState.SelectAccount の場合に必要です。WebAuth リクエストは、ユーザーがアカウントを選択してこのメソッドを呼び出すまでブロックされます。

WebEngineWebAuthUxRequest::userNames およびstateも参照してください

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