QWebEngineWebAuthUxRequest Class
La classe QWebEngineWebAuthUxRequest encapsule les données d'une requête WebAuth UX. Plus d'informations...
| En-tête : | #include <QWebEngineWebAuthUxRequest> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
| qmake : | QT += webenginecore |
| Depuis : | Qt 6.7 |
| Dans QML : | WebEngineWebAuthUxRequest |
| Hérites : | QObject |
Types publics
| enum class | PinEntryError { NoError, InternalUvLocked, WrongPin, TooShort, InvalidCharacters, SameAsCurrentPin } |
| enum class | PinEntryReason { Set, Change, Challenge } |
| enum class | RequestFailureReason { Timeout, KeyNotRegistered, KeyAlreadyRegistered, SoftPinBlock, HardPinBlock, …, WinUserCancelled } |
| enum class | WebAuthUxState { NotStarted, SelectAccount, CollectPin, FinishTokenCollection, RequestFailed, …, Completed } |
Propriétés
|
Fonctions publiques
| QWebEngineWebAuthPinRequest | pinRequest() const |
| QString | relyingPartyId() const |
| QWebEngineWebAuthUxRequest::RequestFailureReason | requestFailureReason() const |
| QWebEngineWebAuthUxRequest::WebAuthUxState | state() const |
| QStringList | userNames() const |
Emplacements publics
| void | cancel() |
| void | retry() |
| void | setPin(const QString &pin) |
| void | setSelectedAccount(const QString &selectedAccount) |
Signaux
| void | stateChanged(QWebEngineWebAuthUxRequest::WebAuthUxState state) |
Description détaillée
Cette classe contient les informations et l'API pour l'interface utilisateur de WebAuth. WebAuth peut nécessiter une interaction avec l'utilisateur au cours du processus d'authentification. Ces demandes sont traitées en affichant une boîte de dialogue aux utilisateurs. QtWebEngine prend actuellement en charge la vérification de l'utilisateur, les informations d'identification des résidents et les demandes d'affichage de l'échec de la requête UX.
QWebEngineWebAuthUxRequest modélise une demande UX WebAuth tout au long de son cycle de vie, en commençant par l'affichage d'une boîte de dialogue UX, la mise à jour de son contenu par des changements d'état, et enfin la fermeture de la boîte de dialogue.
Les demandes UX de WebAuth sont normalement déclenchées lorsque l'authentificateur requiert une interaction avec l'utilisateur. Il est de la responsabilité de QWebEnginePage de notifier l'application des nouvelles demandes WebAuth UX, ce qu'il fait en émettant le signal webAuthUxRequested avec une QWebEngineWebAuthUxRequest nouvellement créée. L'application peut alors examiner cette demande et afficher une boîte de dialogue WebAuth UX.
L'objet QWebEngineWebAuthUxRequest émet périodiquement le signal stateChanged pour informer les observateurs potentiels de l'état actuel de l'interface utilisateur WebAuth. Les observateurs mettent à jour la boîte de dialogue WebAuth en conséquence.
Pour plus d'informations sur la manière de gérer les demandes d'authentification du moteur Web, voir le navigateur simple.
Documentation sur les types de membres
enum class QWebEngineWebAuthUxRequest::PinEntryError
Cette énumération décrit les erreurs qui peuvent amener l'authentificateur à demander un code PIN.
| Constante | Valeur | Description de l'erreur |
|---|---|---|
QWebEngineWebAuthUxRequest::PinEntryError::NoError | 0 | Aucune erreur ne s'est produite. |
QWebEngineWebAuthUxRequest::PinEntryError::InternalUvLocked | 1 | L'UV interne est verrouillé, nous revenons donc au code PIN. |
QWebEngineWebAuthUxRequest::PinEntryError::WrongPin | 2 | Le code PIN saisi par l'utilisateur ne correspond pas au code PIN de l'authentificateur. |
QWebEngineWebAuthUxRequest::PinEntryError::TooShort | 3 | Le nouveau code PIN saisi par l'utilisateur est trop court. |
QWebEngineWebAuthUxRequest::PinEntryError::InvalidCharacters | 4 | Le nouveau code PIN saisi par l'utilisateur contient des caractères non valides. |
QWebEngineWebAuthUxRequest::PinEntryError::SameAsCurrentPin | 5 | Le nouveau code PIN saisi par l'utilisateur est identique au code PIN actuellement défini. |
enum class QWebEngineWebAuthUxRequest::PinEntryReason
Cette énumération décrit les raisons qui peuvent inciter l'authentificateur à demander un code PIN.
| Constante | Valeur | Description du motif |
|---|---|---|
QWebEngineWebAuthUxRequest::PinEntryReason::Set | 0 | Un nouveau code PIN est en cours de définition. |
QWebEngineWebAuthUxRequest::PinEntryReason::Change | 1 | Le code PIN existant doit être modifié avant d'utiliser cet authentificateur. |
QWebEngineWebAuthUxRequest::PinEntryReason::Challenge | 2 | Le code PIN existant est collecté pour prouver la vérification de l'utilisateur. |
enum class QWebEngineWebAuthUxRequest::RequestFailureReason
Cette énumération décrit la raison de l'échec de la requête WebAuth.
| Constante | Valeur | Description de l'échec |
|---|---|---|
QWebEngineWebAuthUxRequest::RequestFailureReason::Timeout | 0 | La session d'authentification a expiré. |
QWebEngineWebAuthUxRequest::RequestFailureReason::KeyNotRegistered | 1 | La clé n'est pas enregistrée auprès de l'authentificateur. |
QWebEngineWebAuthUxRequest::RequestFailureReason::KeyAlreadyRegistered | 2 | La clé est déjà enregistrée auprès de l'authentificateur. Essayez de vous enregistrer avec une autre clé ou d'utiliser un autre authentificateur. |
QWebEngineWebAuthUxRequest::RequestFailureReason::SoftPinBlock | 3 | L'authentificateur est bloqué car l'utilisateur a saisi plusieurs fois une clé erronée. |
QWebEngineWebAuthUxRequest::RequestFailureReason::HardPinBlock | 4 | L'authentificateur est bloqué car l'utilisateur a saisi une clé erronée à plusieurs reprises et a réinitialisé le code PIN pour utiliser à nouveau l'authentificateur en question. |
QWebEngineWebAuthUxRequest::RequestFailureReason::AuthenticatorRemovedDuringPinEntry | 5 | L'authentificateur a été retiré pendant la saisie du code PIN. |
QWebEngineWebAuthUxRequest::RequestFailureReason::AuthenticatorMissingResidentKeys | 6 | L'authentificateur ne prend pas en charge les clés résidentes. |
QWebEngineWebAuthUxRequest::RequestFailureReason::AuthenticatorMissingUserVerification | 7 | L'authentificateur n'a pas de support pour la vérification de l'utilisateur. |
QWebEngineWebAuthUxRequest::RequestFailureReason::AuthenticatorMissingLargeBlob | 8 | L'authentificateur ne prend pas en charge les gros blocs. |
QWebEngineWebAuthUxRequest::RequestFailureReason::NoCommonAlgorithms | 9 | Pas d'algorithme commun. |
QWebEngineWebAuthUxRequest::RequestFailureReason::StorageFull | 10 | Le justificatif résident n'a pas pu être créé car l'authentificateur ne dispose pas d'un espace de stockage suffisant. |
QWebEngineWebAuthUxRequest::RequestFailureReason::UserConsentDenied | 11 | Consentement de l'utilisateur refusé. |
QWebEngineWebAuthUxRequest::RequestFailureReason::WinUserCancelled | 12 | L'utilisateur a cliqué sur Cancel dans l'interface utilisateur native de Windows. |
enum class QWebEngineWebAuthUxRequest::WebAuthUxState
Cette énumération décrit l'état de la requête WebAuth UX en cours.
| Constante | Valeur | Description |
|---|---|---|
QWebEngineWebAuthUxRequest::WebAuthUxState::NotStarted | 0 | La demande WebAuth UX n'a pas encore commencé. |
QWebEngineWebAuthUxRequest::WebAuthUxState::SelectAccount | 1 | L'authentificateur a besoin des informations d'identification des résidents. L'application doit afficher une boîte de dialogue sur les détails du compte et l'utilisateur doit sélectionner un compte pour continuer. |
QWebEngineWebAuthUxRequest::WebAuthUxState::CollectPin | 2 | L'authentificateur requiert une vérification de l'utilisateur. L'application doit afficher une boîte de dialogue de demande de code PIN. |
QWebEngineWebAuthUxRequest::WebAuthUxState::FinishTokenCollection | 3 | L'authentificateur nécessite une vérification du jeton/de l'utilisateur (comme une tape sur la clé FIDO) pour terminer le processus. |
QWebEngineWebAuthUxRequest::WebAuthUxState::RequestFailed | 4 | La demande de WebAuth a échoué. Afficher les détails de l'erreur. |
QWebEngineWebAuthUxRequest::WebAuthUxState::Cancelled | 5 | La demande de WebAuth est annulée. Fermez la boîte de dialogue WebAuth. |
QWebEngineWebAuthUxRequest::WebAuthUxState::Completed | 6 | La demande de WebAuth est terminée. Fermer la boîte de dialogue WebAuth. |
Documentation sur les propriétés
[read-only] pinRequest : const QWebEngineWebAuthPinRequest
Cette propriété contient les informations relatives à la demande de code PIN de la requête WebAuth.
Elle est nécessaire lorsque l'état actuel de la demande de WebAuth est CollectPin. Le dialogue WebAuth affiche une boîte de dialogue de demande de code PIN. L'utilisateur doit saisir un code PIN et invoquer setPin() pour continuer.
Fonctions d'accès :
| QWebEngineWebAuthPinRequest | pinRequest() const |
Voir également QWebEngineWebAuthPinRequest, CollectPin, et setPin().
[read-only] relyingPartyId : const QString
Cette propriété contient l'identifiant de la partie se fiant à la requête WebAuth.
Fonctions d'accès :
| QString | relyingPartyId() const |
[read-only] requestFailureReason : const RequestFailureReason
Cette propriété contient la raison de l'échec de la requête WebAuth.
Fonctions d'accès :
| QWebEngineWebAuthUxRequest::RequestFailureReason | requestFailureReason() const |
Voir aussi stateChanged() et QWebEngineWebAuthUxRequest::RequestFailureReason.
[read-only] state : WebAuthUxState
Cette propriété contient l'état actuel de l'interface utilisateur de la requête WebAuth.
stateChanged() est émis lorsque l'état actuel change. La boîte de dialogue WebAuth est mise à jour en fonction des changements d'état.
Fonctions d'accès :
| QWebEngineWebAuthUxRequest::WebAuthUxState | state() const |
Signal Notificateur :
| void | stateChanged(QWebEngineWebAuthUxRequest::WebAuthUxState state) |
[read-only] userNames : const QStringList
Cette propriété contient les noms d'utilisateurs disponibles pour le support des informations d'identification résidentes. Cette propriété est nécessaire lorsque l'état UX de la requête WebAuth en cours est SelectAccount. La boîte de dialogue WebAuth affiche les noms d'utilisateur. L'utilisateur doit sélectionner un compte pour continuer.
Fonctions d'accès :
| QStringList | userNames() const |
Voir également SelectAccount et setSelectedAccount().
Documentation sur les fonctions membres
[slot] void QWebEngineWebAuthUxRequest::cancel()
Annule la requête WebAuth en cours.
Voir aussi QWebEngineWebAuthUxRequest::Cancelled et stateChanged().
[slot] void QWebEngineWebAuthUxRequest::retry()
Réessaie la requête WebAuth en cours.
Voir aussi stateChanged().
[slot] void QWebEngineWebAuthUxRequest::setPin(const QString &pin)
Envoie l'adresse pin à l'authentificateur qui demande un code PIN. Cela est nécessaire lorsque l'état UX de la demande WebAuth en cours est CollectPin. La demande WebAuth est bloquée jusqu'à ce que l'utilisateur réponde avec un code PIN.
Voir également QWebEngineWebAuthPinRequest et CollectPin.
[slot] void QWebEngineWebAuthUxRequest::setSelectedAccount(const QString &selectedAccount)
Envoie le nom selectedAccount à l'authentificateur. Cette méthode est nécessaire lorsque l'état UX de la demande WebAuth en cours est SelectAccount. La requête WebAuth est bloquée jusqu'à ce que l'utilisateur sélectionne un compte et invoque cette méthode.
Voir également userNames et SelectAccount.
[signal] void QWebEngineWebAuthUxRequest::stateChanged(QWebEngineWebAuthUxRequest::WebAuthUxState state)
Ce signal est émis chaque fois que l'UX WebAuth state change.
Note : Signal de notification pour la propriété state.
Voir également state et WebAuthUxState.
© 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.
