QOAuth2DeviceAuthorizationFlow Class

m_deviceFlow.setAuthorizationUrl(QUrl(authorizationUrl));
m_deviceFlow.setTokenUrl(QUrl(accessTokenUrl));
m_deviceFlow.setRequestedScopeTokens({scope});
m_deviceFlow.setClientIdentifier(clientIdentifier);
// The need for a client secret depends on the authorization server
m_deviceFlow.setClientIdentifierSharedKey(clientSecret);

connect(&m_deviceFlow, &QOAuth2DeviceAuthorizationFlow::authorizeWithUserCode, this,
    [](const QUrl&verificationUrl, const QString&userCode, const QUrl&completeVerificationUrl) {
        if (completeVerificationUrl.isValid()) {
            // 인증 서버가  URL 매개변수의 일부로 필요한 데이터가 이미 포함된
            //  완성된 URL 을  제공한 경우 ,
            // 해당 URL을 사용할 수 있습니다
            qDebug() << "Complete verification uri:" << completeVerificationUrl;
        } else {
            // 인증 서버에서 확인용 URL만 제공된 경우, 해당 URL을 사용
            qDebug() << "Verification uri and usercode:" << verificationUrl << userCode;
        }
    }
);

connect(&m_deviceFlow, &QAbstractOAuth::requestFailed, this, [](QAbstractOAuth::Error error) {
    Q_UNUSED(error);
    // Handle error
});

connect(&m_deviceFlow, &QAbstractOAuth2::serverReportedErrorOccurred, this,
    [](const QString &error, const QString &errorDescription, const QUrl &uri) {
        // Check server reported error details if needed
        Q_UNUSED(error);
        Q_UNUSED(errorDescription);
        Q_UNUSED(uri);
    }
);

connect(&m_deviceFlow, &QAbstractOAuth::granted, this, [this](){
    // Here we use QNetworkRequestFactory to store the access token
    m_api.setBearerToken(m_deviceFlow.token().toLatin1());
});
m_deviceFlow.grant();

멤버 함수 설명서

QOAuth2DeviceAuthorizationFlow::QOAuth2DeviceAuthorizationFlow()

QOAuth2DeviceAuthorizationFlow 객체를 생성합니다.

[explicit] QOAuth2DeviceAuthorizationFlow::QOAuth2DeviceAuthorizationFlow(QObject *parent)

parent 를 상위 객체로 하는 QOAuth2DeviceAuthorizationFlow 객체를 생성합니다.

[explicit] QOAuth2DeviceAuthorizationFlow::QOAuth2DeviceAuthorizationFlow(QNetworkAccessManager *manager, QObject *parent = nullptr)

parent 를 부모로 사용하여 QOAuth2DeviceAuthorizationFlow 객체를 생성하고, manager 를 네트워크 액세스 관리자로 설정합니다.

[override virtual noexcept] QOAuth2DeviceAuthorizationFlow::~QOAuth2DeviceAuthorizationFlow()

QOAuth2DeviceAuthorizationFlow 인스턴스를 삭제합니다.

[signal] void QOAuth2DeviceAuthorizationFlow::authorizeWithUserCode(const QUrl &verificationUrl, const QString &userCode, const QUrl &completeVerificationUrl)

이 신호는 사용자가 인증 절차를 완료해야 할 때 전송됩니다.

인증 서버에서 completeVerificationUrl 을 제공한 경우, 사용자는 해당 URL로 이동할 수 있습니다. 이 URL에는 필요한 userCode 및 기타 필요한 매개변수가 포함되어 있습니다.

또는 사용자가 verificationUrl 로 이동하여 userCode 를 수동으로 입력해야 합니다.

Device Flow Usage도 참조하십시오 .

[override virtual slot] void QOAuth2DeviceAuthorizationFlow::grant()

QAbstractOAuth::grant()를 재구현합니다.

Device Grant RFC에 설명된 대로 인증 흐름을 시작합니다.

이 흐름은 다음 단계로 구성됩니다:

• 인증 서버에 대한 인증 요청
• 사용자가 액세스를 승인함(자세한 내용은 authorizeWithUserCode() 참조)
• 사용자가 승인을 수락하거나 거부할 때까지(또는 코드가 만료될 때까지) 인증 서버를 주기적으로 확인
• 애플리케이션에 결과 알림 ( granted() 및 QAbstractOAuth::requestFailed() 참조)

이 흐름은 인증 단계에서 토큰 확인 단계로 자동으로 진행됩니다.

이 함수를 호출하면 이전의 모든 인증 데이터가 재설정됩니다.

authorizeWithUserCode(), granted(), QAbstractOAuth::requestFailed(), polling, startTokenPolling(), stopTokenPolling() 및 Device Flow Usage도 참조하십시오 .

[protected slot, since 6.9] void QOAuth2DeviceAuthorizationFlow::refreshTokensImplementation()

이 함수는 토큰 갱신 요청을 전송합니다.

갱신 요청이 성공적으로 시작되면 상태는 ` QAbstractOAuth::Status::RefreshingToken`로 설정되며, 그렇지 않은 경우 ` requestFailed()` 신호가 발생하고 상태는 변경되지 않습니다. ` isPolling `가 ` true`인 동안에는 토큰을 갱신할 수 없습니다.

토큰 갱신 프로세스가 이미 진행 중인 경우 이 함수는 아무런 효과도 없습니다.

토큰 갱신이 실패하고 액세스 토큰이 존재하는 경우, 상태는 QAbstractOAuth::Status::Granted 로 설정되며, 액세스 토큰이 존재하지 않는 경우 QAbstractOAuth::Status::NotAuthenticated 로 설정됩니다.

이 함수는 Qt 6.9에서 도입되었습니다.

QAbstractOAuth::requestFailed() 및 QAbstractOAuth2::refreshTokens()도 참조하십시오 .

[slot] bool QOAuth2DeviceAuthorizationFlow::startTokenPolling()

토큰 폴링을 시작합니다. 시작이 성공한 경우(또는 이미 활성화된 경우)에는 ` true `를 반환하고, 그렇지 않은 경우 ` false `를 반환합니다.

일반적인 사용 사례에서는 이 함수를 호출할 필요가 없습니다. grant() 호출의 결과로 인증 요청이 완료되면 폴링이 자동으로 시작됩니다.

이 함수는 전체 인증 흐름을 다시 시작하지 않고도, 잠시 후 토큰 폴링을 재개(재시도)해야 하는 경우에 유용할 수 있습니다. 예를 들어, 일시적인 네트워크 연결 끊김이 발생한 경우입니다.

폴링 간격은 인증 서버에 의해 정의되며, 일반적으로 5초입니다. 첫 번째 간격이 경과하면 첫 번째 폴링 요청이 전송됩니다.

polling, stopTokenPolling(), Device Flow Usage도 참조하십시오 .

[slot] void QOAuth2DeviceAuthorizationFlow::stopTokenPolling()

토큰 폴링을 중지합니다. 처리되지 않은 폴링 요청이 있는 경우, 해당 요청은 아무런 알림 없이 무시됩니다.

polling 및 startTokenPolling()도 참조하십시오 .