WebEngineWebAuthUxRequest QML Type
WebAuth UX 요청의 데이터를 캡슐화합니다. 더 보기...
| Import Statement: | import QtWebEngine |
| Since: | QtWebEngine 6.7 |
| In C++: | QWebEngineWebAuthUxRequest |
속성
- pinRequest : QWebEngineWebAuthPinRequest
- relyingPartyId : string
- requestFailureReason : enumeration
- state : enumeration
- userNames : stringlist
신호
- void stateChanged(WebAuthUxState state)
방법
- void cancel()
- void retry()
- void setPin(const QString &pin)
- void setSelectedAccount(const QString &selectedAccount)
상세 설명
웹 엔진의 WebAuth UX 요청은 WebEngineView::webAuthUxRequested() 신호로 사용자에게 전달됩니다.
웹 엔진 인증 요청을 처리하는 방법에 대한 자세한 내용은 나노 브라우저를 참조하세요.
속성 문서
pinRequest : QWebEngineWebAuthPinRequest |
WebAuth 요청의 PIN 요청 정보입니다.
QWebEngineWebAuthPinRequest 를참조하세요 .
relyingPartyId : string |
WebAuth 요청의 신뢰 당사자 ID.
requestFailureReason : enumeration |
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 | 인증서에 큰 블롭이 지원되지 않습니다. |
WebEngineWebAuthUxRequest.RequestFailureReason.NoCommonAlgorithms | 일반적인 알고리즘이 없습니다. |
WebEngineWebAuthUxRequest.RequestFailureReason.StorageFull | 인증자의 저장 공간이 부족하여 상주 자격 증명을 만들 수 없습니다. |
WebEngineWebAuthUxRequest.RequestFailureReason.UserConsentDenied | 사용자 동의가 거부되었습니다. |
WebEngineWebAuthUxRequest.RequestFailureReason.WinUserCancelled | 사용자가 기본 Windows UI에서 Cancel 을 클릭했습니다. |
stateChanged()도 참조하세요 .
state : enumeration |
WebAuth 요청의 현재 UX 상태입니다.
| 상수 | 설명 |
|---|---|
WebEngineWebAuthUxRequest.WebAuthUxState.NotStarted | WebAuth UX 요청이 아직 시작되지 않았습니다. |
WebEngineWebAuthUxRequest.WebAuthUxState.SelectAccount | 인증자에게 상주 자격 증명 세부 정보가 필요합니다. 애플리케이션에 계정 세부 정보 대화 상자가 표시되어야 하며 사용자는 계속 진행하려면 계정을 선택해야 합니다. |
WebEngineWebAuthUxRequest.WebAuthUxState.CollectPin | 인증자에 사용자 인증이 필요합니다. 애플리케이션에 PIN 요청 대화 상자가 표시되어야 합니다. |
WebEngineWebAuthUxRequest.WebAuthUxState.FinishTokenCollection | 인증자가 프로세스를 완료하려면 토큰/사용자 인증(예: FIDO 키 탭)이 필요합니다. |
WebEngineWebAuthUxRequest.WebAuthUxState.RequestFailed | WebAuth 요청에 실패했습니다. 오류 세부 정보를 표시합니다. |
WebEngineWebAuthUxRequest.WebAuthUxState.Cancelled | WebAuth 요청이 취소되었습니다. WebAuth 대화 상자를 닫습니다. |
WebEngineWebAuthUxRequest.WebAuthUxState.Completed | WebAuth 요청이 완료되었습니다. WebAuth 대화 상자를 닫습니다. |
userNames : stringlist |
상주 자격 증명에 사용 가능한 사용자 이름 지원.
현재 WebAuth 요청의 UX 상태가 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 요청의 UX 상태가 WebEngineWebAuthUxRequest.WebAuthUxState.CollectPin인 경우에 필요합니다. 사용자가 PIN으로 응답할 때까지 WebAuth 요청이 차단됩니다.
QWebEngineWebAuthPinRequest 및 state 을참조하세요 .
void setSelectedAccount(const QString &selectedAccount) |
selectedAccount 이름을 인증자에게 보냅니다. 현재 WebAuth 요청의 UX 상태가 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.
