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,[](constQUrl用户代码 QString用户代码, constQUrl&completeVerificationUrl) {if(completeVerificationUrl.isValid()) {// 如果授权服务器提供了一个完整的 URL // 该 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().

启动设备授权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()。