QWebEngineWebAuthUxRequest Class
La clase QWebEngineWebAuthUxRequest encapsula los datos de una solicitud WebAuth UX. Más...
| Cabecera: | #include <QWebEngineWebAuthUxRequest> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
| qmake: | QT += webenginecore |
| Desde: | Qt 6.7 |
| En QML: | WebEngineWebAuthUxRequest |
| Hereda: | QObject |
Tipos Públicos
| 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 } |
Propiedades
|
Funciones públicas
| QWebEngineWebAuthPinRequest | pinRequest() const |
| QString | relyingPartyId() const |
| QWebEngineWebAuthUxRequest::RequestFailureReason | requestFailureReason() const |
| QWebEngineWebAuthUxRequest::WebAuthUxState | state() const |
| QStringList | userNames() const |
Ranuras públicas
| void | cancel() |
| void | retry() |
| void | setPin(const QString &pin) |
| void | setSelectedAccount(const QString &selectedAccount) |
Señales
| void | stateChanged(QWebEngineWebAuthUxRequest::WebAuthUxState state) |
Descripción detallada
Esta clase contiene la información y la API para WebAuth UX. WebAuth puede requerir la interacción del usuario durante el proceso de autenticación. Estas solicitudes son manejadas mostrando un diálogo a los usuarios. QtWebEngine actualmente soporta verificación de usuario, credenciales residentes, y mostrar solicitudes de falla UX.
QWebEngineWebAuthUxRequest modela una solicitud WebAuth UX a través de su ciclo de vida, comenzando con mostrar un diálogo UX, actualizando su contenido a través de cambios de estado, y finalmente cerrando el diálogo.
Las peticiones WebAuth UX se activan normalmente cuando el autenticador requiere la interacción del usuario. Es responsabilidad de QWebEnginePage notificar a la aplicación de las nuevas peticiones WebAuth UX, lo que hace emitiendo la señal webAuthUxRequested junto con una QWebEngineWebAuthUxRequest recién creada. La aplicación puede entonces examinar esta petición y mostrar un diálogo WebAuth UX.
El objeto QWebEngineWebAuthUxRequest emite periódicamente la señal stateChanged para notificar a los observadores potenciales los estados actuales de WebAuth UX. Los observadores actualizan el diálogo WebAuth en consecuencia.
Para obtener más información sobre cómo gestionar las solicitudes del autenticador del motor web, consulte Simple Browser.
Documentación de tipos de miembros
enum class QWebEngineWebAuthUxRequest::PinEntryError
Este enum describe los errores que pueden hacer que el autenticador solicite un PIN.
| Constante | Valor | Descripción |
|---|---|---|
QWebEngineWebAuthUxRequest::PinEntryError::NoError | 0 | No se ha producido ningún error. |
QWebEngineWebAuthUxRequest::PinEntryError::InternalUvLocked | 1 | La UV interna está bloqueada, por lo que volvemos al PIN. |
QWebEngineWebAuthUxRequest::PinEntryError::WrongPin | 2 | El PIN introducido por el usuario no coincide con el PIN del autenticador. |
QWebEngineWebAuthUxRequest::PinEntryError::TooShort | 3 | El nuevo PIN introducido por el usuario es demasiado corto. |
QWebEngineWebAuthUxRequest::PinEntryError::InvalidCharacters | 4 | El nuevo PIN introducido por el usuario contiene caracteres no válidos. |
QWebEngineWebAuthUxRequest::PinEntryError::SameAsCurrentPin | 5 | El nuevo PIN introducido por el usuario es el mismo que el PIN configurado actualmente. |
enum class QWebEngineWebAuthUxRequest::PinEntryReason
Este enum describe las razones que pueden hacer que el autenticador solicite un PIN.
| Constante | Valor | Descripción |
|---|---|---|
QWebEngineWebAuthUxRequest::PinEntryReason::Set | 0 | Se está configurando un nuevo PIN. |
QWebEngineWebAuthUxRequest::PinEntryReason::Change | 1 | El PIN existente debe cambiarse antes de utilizar este autenticador. |
QWebEngineWebAuthUxRequest::PinEntryReason::Challenge | 2 | Se está recopilando el PIN existente para probar la verificación del usuario. |
enum class QWebEngineWebAuthUxRequest::RequestFailureReason
Este enum describe el motivo del fallo de la solicitud WebAuth.
| Constante | Valor | Descripción |
|---|---|---|
QWebEngineWebAuthUxRequest::RequestFailureReason::Timeout | 0 | La sesión de autenticación ha expirado. |
QWebEngineWebAuthUxRequest::RequestFailureReason::KeyNotRegistered | 1 | La clave no está registrada en el autenticador. |
QWebEngineWebAuthUxRequest::RequestFailureReason::KeyAlreadyRegistered | 2 | La clave ya está registrada en el autenticador. Intente registrarse con otra clave o utilice otro autenticador. |
QWebEngineWebAuthUxRequest::RequestFailureReason::SoftPinBlock | 3 | El autenticador está bloqueado porque el usuario ha introducido varias veces una clave incorrecta. |
QWebEngineWebAuthUxRequest::RequestFailureReason::HardPinBlock | 4 | El autenticador está bloqueado porque el usuario ha introducido una clave incorrecta muchas veces y ha restablecido el PIN para volver a utilizar el autenticador específico. |
QWebEngineWebAuthUxRequest::RequestFailureReason::AuthenticatorRemovedDuringPinEntry | 5 | Se ha eliminado el autenticador durante la introducción del PIN. |
QWebEngineWebAuthUxRequest::RequestFailureReason::AuthenticatorMissingResidentKeys | 6 | El autenticador no admite claves residentes. |
QWebEngineWebAuthUxRequest::RequestFailureReason::AuthenticatorMissingUserVerification | 7 | El Authenticator no admite la verificación de usuario. |
QWebEngineWebAuthUxRequest::RequestFailureReason::AuthenticatorMissingLargeBlob | 8 | El autenticador no admite blobs grandes. |
QWebEngineWebAuthUxRequest::RequestFailureReason::NoCommonAlgorithms | 9 | No hay algoritmo común. |
QWebEngineWebAuthUxRequest::RequestFailureReason::StorageFull | 10 | No se ha podido crear la credencial residente porque el autenticador no tiene almacenamiento suficiente. |
QWebEngineWebAuthUxRequest::RequestFailureReason::UserConsentDenied | 11 | Consentimiento de usuario denegado. |
QWebEngineWebAuthUxRequest::RequestFailureReason::WinUserCancelled | 12 | El usuario hizo clic en Cancel en la interfaz de usuario nativa de Windows. |
enum class QWebEngineWebAuthUxRequest::WebAuthUxState
Este enum describe el estado de la solicitud WebAuth UX actual.
| Constante | Valor | Descripción |
|---|---|---|
QWebEngineWebAuthUxRequest::WebAuthUxState::NotStarted | 0 | La solicitud WebAuth UX aún no se ha iniciado. |
QWebEngineWebAuthUxRequest::WebAuthUxState::SelectAccount | 1 | El autenticador requiere detalles de credenciales residentes. La aplicación debe mostrar un cuadro de diálogo de detalles de la cuenta y el usuario debe seleccionar una cuenta para continuar. |
QWebEngineWebAuthUxRequest::WebAuthUxState::CollectPin | 2 | El autenticador requiere la verificación del usuario. La aplicación debe mostrar un cuadro de diálogo de solicitud de PIN. |
QWebEngineWebAuthUxRequest::WebAuthUxState::FinishTokenCollection | 3 | El autenticador requiere verificación de token/usuario (como tocar la clave FIDO) para completar el proceso. |
QWebEngineWebAuthUxRequest::WebAuthUxState::RequestFailed | 4 | Error en la solicitud de WebAuth. Mostrar detalles del error. |
QWebEngineWebAuthUxRequest::WebAuthUxState::Cancelled | 5 | Se cancela la solicitud de WebAuth. Cierre el cuadro de diálogo WebAuth. |
QWebEngineWebAuthUxRequest::WebAuthUxState::Completed | 6 | La solicitud WebAuth se ha completado. Cierra el diálogo WebAuth. |
Documentación de propiedades
[read-only] pinRequest : const QWebEngineWebAuthPinRequest
Esta propiedad contiene la información de la solicitud PIN de la petición WebAuth.
Se necesita cuando el estado actual de la solicitud WebAuth es CollectPin. WebAuth Dialog muestra un diálogo de solicitud de PIN. El usuario debe introducir un PIN e invocar setPin() para continuar.
Funciones de acceso:
| QWebEngineWebAuthPinRequest | pinRequest() const |
Véase también QWebEngineWebAuthPinRequest, CollectPin, y setPin().
[read-only] relyingPartyId : const QString
Esta propiedad contiene el identificador de la parte de confianza de la solicitud WebAuth.
Funciones de acceso:
| QString | relyingPartyId() const |
[read-only] requestFailureReason : const RequestFailureReason
Esta propiedad contiene el motivo del fallo de la solicitud WebAuth.
Funciones de acceso:
| QWebEngineWebAuthUxRequest::RequestFailureReason | requestFailureReason() const |
Véase también stateChanged() y QWebEngineWebAuthUxRequest::RequestFailureReason.
[read-only] state : WebAuthUxState
Esta propiedad contiene el estado UX actual de la solicitud WebAuth.
stateChanged() se emite cuando cambia el estado actual. Actualiza el diálogo WebAuth en respuesta a los cambios de estado.
Funciones de acceso:
| QWebEngineWebAuthUxRequest::WebAuthUxState | state() const |
Señal del notificador:
| void | stateChanged(QWebEngineWebAuthUxRequest::WebAuthUxState state) |
[read-only] userNames : const QStringList
Esta propiedad contiene los nombres de usuario disponibles para el soporte de credenciales residentes. Esto es necesario cuando el estado UX de la solicitud WebAuth actual es SelectAccount. El diálogo WebAuth muestra los nombres de usuario. El usuario debe seleccionar una cuenta para continuar.
Funciones de acceso:
| QStringList | userNames() const |
Véase también SelectAccount y setSelectedAccount().
Documentación de funciones miembro
[slot] void QWebEngineWebAuthUxRequest::cancel()
Cancela la solicitud WebAuth actual.
Véase también QWebEngineWebAuthUxRequest::Cancelled y stateChanged().
[slot] void QWebEngineWebAuthUxRequest::retry()
Reintenta la petición WebAuth actual.
Véase también stateChanged().
[slot] void QWebEngineWebAuthUxRequest::setPin(const QString &pin)
Envía la dirección pin al autenticador que solicita un PIN. Esto es necesario cuando el estado UX de la solicitud WebAuth actual es CollectPin. La solicitud WebAuth se bloquea hasta que el usuario responde con un PIN.
Véase también QWebEngineWebAuthPinRequest y CollectPin.
[slot] void QWebEngineWebAuthUxRequest::setSelectedAccount(const QString &selectedAccount)
Envía el nombre selectedAccount al autenticador. Esto es necesario cuando el estado UX de la solicitud WebAuth actual es SelectAccount. La solicitud WebAuth se bloquea hasta que el usuario selecciona una cuenta e invoca este método.
Véase también userNames y SelectAccount.
[signal] void QWebEngineWebAuthUxRequest::stateChanged(QWebEngineWebAuthUxRequest::WebAuthUxState state)
Esta señal se emite cada vez que cambia la WebAuth UX's state.
Nota: Señal notificadora para la propiedad state.
Véase también state y 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.
