QWebEngineWebAuthUxRequest Class
QWebEngineWebAuthUxRequest 클래스는 WebAuth UX 요청의 데이터를 캡슐화합니다. 더 보기...
| 헤더: | #include <QWebEngineWebAuthUxRequest> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
| qmake: | QT += webenginecore |
| 이후: | Qt 6.7 |
| QML에서: | WebEngineWebAuthUxRequest |
| 상속합니다: | QObject |
공용형
| 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 } |
속성
|
공용 기능
| QWebEngineWebAuthPinRequest | pinRequest() const |
| QString | relyingPartyId() const |
| QWebEngineWebAuthUxRequest::RequestFailureReason | requestFailureReason() const |
| QWebEngineWebAuthUxRequest::WebAuthUxState | state() const |
| QStringList | userNames() const |
공용 슬롯
| void | cancel() |
| void | retry() |
| void | setPin(const QString &pin) |
| void | setSelectedAccount(const QString &selectedAccount) |
신호
| void | stateChanged(QWebEngineWebAuthUxRequest::WebAuthUxState state) |
상세 설명
이 클래스에는 WebAuth UX에 대한 정보와 API가 포함되어 있습니다. WebAuth는 인증 프로세스 중에 사용자 상호작용을 요구할 수 있습니다. 이러한 요청은 사용자에게 대화 상자를 표시하여 처리됩니다. QtWebEngine 현재 사용자 인증, 상주 자격 증명, 요청 실패 표시 UX 요청을 지원합니다.
QWebEngineWebAuthUxRequest는 UX 대화 상자 표시부터 시작하여 상태 변경을 통해 내용을 업데이트하고 마지막으로 대화 상자를 닫는 등 수명 주기 전반에 걸쳐 WebAuth UX 요청을 모델링합니다.
WebAuth UX 요청은 일반적으로 인증자가 사용자 상호 작용을 필요로 할 때 트리거됩니다. QWebEnginePage 은 애플리케이션에 새 WebAuth UX 요청을 알리는 역할을 하며, 새로 생성된 QWebEngineWebAuthUxRequest와 함께 webAuthUxRequested 신호를 전송하여 이를 수행합니다. 그러면 애플리케이션은 이 요청을 검사하고 WebAuth UX 대화 상자를 표시할 수 있습니다.
QWebEngineWebAuthUxRequest 객체는 주기적으로 stateChanged 신호를 전송하여 잠재적 관찰자에게 현재 WebAuth UX 상태를 알립니다. 관찰자는 그에 따라 WebAuth 대화 상자를 업데이트합니다.
웹 엔진 인증자 요청을 처리하는 방법에 대한 자세한 내용은 간편 브라우저를 참조하세요.
멤버 유형 문서
enum class QWebEngineWebAuthUxRequest::PinEntryError
이 열거형은 인증자에게 PIN을 요청할 수 있는 오류를 설명합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QWebEngineWebAuthUxRequest::PinEntryError::NoError | 0 | 오류가 발생하지 않았습니다. |
QWebEngineWebAuthUxRequest::PinEntryError::InternalUvLocked | 1 | 내부 UV가 잠겼으므로 PIN으로 돌아갑니다. |
QWebEngineWebAuthUxRequest::PinEntryError::WrongPin | 2 | 사용자가 입력한 PIN이 인증자 PIN과 일치하지 않습니다. |
QWebEngineWebAuthUxRequest::PinEntryError::TooShort | 3 | 사용자가 입력한 새 PIN이 너무 짧습니다. |
QWebEngineWebAuthUxRequest::PinEntryError::InvalidCharacters | 4 | 사용자가 입력한 새 비밀번호에 잘못된 문자가 포함되어 있습니다. |
QWebEngineWebAuthUxRequest::PinEntryError::SameAsCurrentPin | 5 | 사용자가 입력한 새 PIN이 현재 설정된 PIN과 동일합니다. |
enum class QWebEngineWebAuthUxRequest::PinEntryReason
이 열거형은 인증자가 PIN을 요청할 수 있는 이유를 설명합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QWebEngineWebAuthUxRequest::PinEntryReason::Set | 0 | 새 PIN을 설정 중입니다. |
QWebEngineWebAuthUxRequest::PinEntryReason::Change | 1 | 이 인증기를 사용하기 전에 기존 PIN을 변경해야 합니다. |
QWebEngineWebAuthUxRequest::PinEntryReason::Challenge | 2 | 사용자 인증을 증명하기 위해 기존 PIN을 수집 중입니다. |
enum class QWebEngineWebAuthUxRequest::RequestFailureReason
이 열거형은 WebAuth 요청 실패의 이유를 설명합니다.
| Constant | 값 | 설명 |
|---|---|---|
QWebEngineWebAuthUxRequest::RequestFailureReason::Timeout | 0 | 인증 세션 시간이 초과되었습니다. |
QWebEngineWebAuthUxRequest::RequestFailureReason::KeyNotRegistered | 1 | 인증자에 키가 등록되지 않았습니다. |
QWebEngineWebAuthUxRequest::RequestFailureReason::KeyAlreadyRegistered | 2 | 키가 이미 인증자에 등록되어 있습니다. 다른 키로 등록하거나 다른 인증자를 사용해 보세요. |
QWebEngineWebAuthUxRequest::RequestFailureReason::SoftPinBlock | 3 | 사용자가 잘못된 키를 여러 번 입력하여 인증서가 차단되었습니다. |
QWebEngineWebAuthUxRequest::RequestFailureReason::HardPinBlock | 4 | 사용자가 잘못된 키를 여러 번 입력하여 인증서가 차단되었으며 특정 인증서를 다시 사용하려면 PIN을 재설정하세요. |
QWebEngineWebAuthUxRequest::RequestFailureReason::AuthenticatorRemovedDuringPinEntry | 5 | 비밀번호 입력 중에 인증서가 제거되었습니다. |
QWebEngineWebAuthUxRequest::RequestFailureReason::AuthenticatorMissingResidentKeys | 6 | 인증서에 주민 키가 지원되지 않습니다. |
QWebEngineWebAuthUxRequest::RequestFailureReason::AuthenticatorMissingUserVerification | 7 | 인증서에 사용자 인증이 지원되지 않습니다. |
QWebEngineWebAuthUxRequest::RequestFailureReason::AuthenticatorMissingLargeBlob | 8 | 인증서에 큰 블롭이 지원되지 않습니다. |
QWebEngineWebAuthUxRequest::RequestFailureReason::NoCommonAlgorithms | 9 | 일반적인 알고리즘이 없습니다. |
QWebEngineWebAuthUxRequest::RequestFailureReason::StorageFull | 10 | 인증자의 저장 공간이 부족하여 상주 자격 증명을 만들 수 없습니다. |
QWebEngineWebAuthUxRequest::RequestFailureReason::UserConsentDenied | 11 | 사용자 동의가 거부되었습니다. |
QWebEngineWebAuthUxRequest::RequestFailureReason::WinUserCancelled | 12 | 사용자가 기본 Windows UI에서 Cancel 을 클릭했습니다. |
enum class QWebEngineWebAuthUxRequest::WebAuthUxState
이 열거형은 현재 WebAuth UX 요청의 상태를 설명합니다.
| Constant | 값 | 설명 |
|---|---|---|
QWebEngineWebAuthUxRequest::WebAuthUxState::NotStarted | 0 | WebAuth UX 요청이 아직 시작되지 않았습니다. |
QWebEngineWebAuthUxRequest::WebAuthUxState::SelectAccount | 1 | 인증자는 상주 자격 증명 세부 정보가 필요합니다. 애플리케이션에 계정 세부 정보 대화 상자가 표시되어야 하며 사용자는 계속하려면 계정을 선택해야 합니다. |
QWebEngineWebAuthUxRequest::WebAuthUxState::CollectPin | 2 | 인증자에 사용자 인증이 필요합니다. 애플리케이션에 PIN 요청 대화 상자가 표시되어야 합니다. |
QWebEngineWebAuthUxRequest::WebAuthUxState::FinishTokenCollection | 3 | 인증자가 프로세스를 완료하려면 토큰/사용자 인증(예: FIDO 키 탭)이 필요합니다. |
QWebEngineWebAuthUxRequest::WebAuthUxState::RequestFailed | 4 | WebAuth 요청에 실패했습니다. 오류 세부 정보를 표시합니다. |
QWebEngineWebAuthUxRequest::WebAuthUxState::Cancelled | 5 | WebAuth 요청이 취소되었습니다. WebAuth 대화 상자를 닫습니다. |
QWebEngineWebAuthUxRequest::WebAuthUxState::Completed | 6 | WebAuth 요청이 완료되었습니다. WebAuth 대화 상자를 닫습니다. |
속성 문서
[read-only] pinRequest : const QWebEngineWebAuthPinRequest
이 속성은 WebAuth 요청의 PIN 요청 정보를 보유합니다.
현재 WebAuth 요청 상태가 CollectPin 일 때 필요합니다. WebAuth 대화 상자에 PIN 요청 대화 상자가 표시됩니다. 계속하려면 사용자가 PIN을 입력하고 setPin()를 호출해야 합니다.
기능에 접근합니다:
| QWebEngineWebAuthPinRequest | pinRequest() const |
QWebEngineWebAuthPinRequest, CollectPin, setPin()도 참조하세요 .
[read-only] relyingPartyId : const QString
이 프로퍼티에는 WebAuth 요청의 신뢰 당사자 ID가 저장됩니다.
액세스 함수:
| QString | relyingPartyId() const |
[read-only] requestFailureReason : const RequestFailureReason
이 속성에는 WebAuth 요청의 실패 이유가 저장됩니다.
액세스 함수:
| QWebEngineWebAuthUxRequest::RequestFailureReason | requestFailureReason() const |
stateChanged() 및 QWebEngineWebAuthUxRequest::RequestFailureReason 을참조하세요 .
[read-only] state : const WebAuthUxState
이 프로퍼티는 WebAuth 요청의 현재 UX 상태를 보유합니다.
stateChanged()는 현재 상태가 변경될 때 발생합니다. 상태 변경에 대한 응답으로 WebAuth 대화 상자를 업데이트합니다.
액세스 함수:
| QWebEngineWebAuthUxRequest::WebAuthUxState | state() const |
알림 신호:
| void | stateChanged(QWebEngineWebAuthUxRequest::WebAuthUxState state) |
[read-only] userNames : const QStringList
이 속성은 상주 자격 증명 지원에 사용할 수 있는 사용자 이름을 보유합니다. 이 속성은 현재 WebAuth 요청의 UX 상태가 SelectAccount 일 때 필요합니다. WebAuth 대화 상자에 사용자 이름이 표시됩니다. 계속하려면 사용자가 계정을 선택해야 합니다.
기능에 접근합니다:
| QStringList | userNames() const |
SelectAccount 및 setSelectedAccount()도 참조하세요 .
회원 함수 문서
[slot] void QWebEngineWebAuthUxRequest::cancel()
현재 WebAuth 요청을 취소합니다.
QWebEngineWebAuthUxRequest::Cancelled 및 stateChanged()도 참조하세요 .
[slot] void QWebEngineWebAuthUxRequest::retry()
현재 WebAuth 요청을 다시 시도합니다.
stateChanged()도 참조하세요 .
[slot] void QWebEngineWebAuthUxRequest::setPin(const QString &pin)
PIN을 입력하라는 메시지가 표시되는 인증자에게 pin 을 전송합니다. 현재 WebAuth 요청의 UX 상태가 CollectPin 일 때 필요합니다. 사용자가 PIN으로 응답할 때까지 WebAuth 요청이 차단됩니다.
QWebEngineWebAuthPinRequest 및 CollectPin 을참조하세요 .
[slot] void QWebEngineWebAuthUxRequest::setSelectedAccount(const QString &selectedAccount)
인증자에게 selectedAccount 이름을 보냅니다. 이 메서드는 현재 WebAuth 요청의 UX 상태가 SelectAccount 일 때 필요합니다. 사용자가 계정을 선택하고 이 메서드를 호출할 때까지 WebAuth 요청은 차단됩니다.
userNames 및 SelectAccount 을참조하세요 .
[signal] void QWebEngineWebAuthUxRequest::stateChanged(QWebEngineWebAuthUxRequest::WebAuthUxState state)
이 신호는 WebAuth UX의 state 가 변경될 때마다 발신됩니다.
참고: 속성에 대한 알림 신호 state.
state 및 WebAuthUxState도 참조하세요 .
© 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.
