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()) { // Si el servidor de autorización ha proporcionado una URL completa // que ya contiene los datos necesarios como parte de los parámetros de la URL, // puede optar por utilizarla.            qDebug() << "Complete verification uri:" << completeVerificationUrl;
        } else { // El servidor de autorización sólo ha proporcionado la URL de verificación; utilícela            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();

Documentación de las funciones miembro

QOAuth2DeviceAuthorizationFlow::QOAuth2DeviceAuthorizationFlow()

Construye un objeto QOAuth2DeviceAuthorizationFlow.

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

Construye un objeto QOAuth2DeviceAuthorizationFlow con el objeto padre parent.

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

Construye un objeto QOAuth2DeviceAuthorizationFlow usando parent como padre y establece manager como gestor de acceso a la red.

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

Destruye la instancia QOAuth2DeviceAuthorizationFlow.

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

Esta señal se emite cuando el usuario debe completar la autorización.

Si el servidor de autorización ha proporcionado completeVerificationUrl, el usuario puede navegar a esa URL. La URL contiene el userCode necesario y cualquier otro parámetro necesario.

Alternativamente, el usuario necesita navegar a verificationUrl e introducir userCode manualmente.

Véase también Device Flow Usage.

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

Reimplementa: QAbstractOAuth::grant().

Inicia el flujo de autorización como se describe en Device Grant RFC.

El flujo consta de los siguientes pasos:

• Solicitud de autorización al servidor de autorización
• Autorización del acceso por parte del usuario, véase authorizeWithUserCode()
• Sondeo del servidor de autorización hasta que el usuario haya aceptado o rechazado la autorización (o expiren los códigos)
• Indicación del resultado a la aplicación (véase granted() y QAbstractOAuth::requestFailed())

El flujo pasa automáticamente de la autorización al sondeo de tokens.

La llamada a esta función restablecerá los datos de autorización anteriores.

Véase también authorizeWithUserCode(), granted(), QAbstractOAuth::requestFailed(), polling, startTokenPolling(), stopTokenPolling(), y Device Flow Usage.

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

Esta función envía una solicitud de actualización de token.

Si la solicitud de actualización se inició correctamente, el estado se establece en QAbstractOAuth::Status::RefreshingToken; de lo contrario, se emite la señal requestFailed() y el estado no cambia. Los tokens no pueden ser refrescados mientras isPolling es true.

Esta función no tiene ningún efecto si el proceso de actualización del testigo ya está en curso.

Si la actualización del token falla y existe un token de acceso, el estado se establece en QAbstractOAuth::Status::Granted, y en QAbstractOAuth::Status::NotAuthenticated si no existe un token de acceso.

Esta función se introdujo en Qt 6.9.

Véase también QAbstractOAuth::requestFailed() y QAbstractOAuth2::refreshTokens().

[slot] bool QOAuth2DeviceAuthorizationFlow::startTokenPolling()

Inicia el sondeo de tokens. Devuelve true si el inicio tuvo éxito (o ya estaba activo), y false en caso contrario.

Llamar a esta función no es necesario en un caso de uso típico. Una vez completada la solicitud de autorización, como resultado de la llamada a grant(), el sondeo se inicia automáticamente.

Esta función puede ser útil en casos en los que sea necesario reanudar (reintentar) el sondeo de tokens un poco más tarde, sin reiniciar todo el flujo de autorización. Por ejemplo, en caso de pérdida transitoria de la conectividad de red.

El intervalo de sondeo lo define el servidor de autorización y suele ser de 5 segundos. La primera solicitud de sondeo se envía una vez transcurrido el primer intervalo.

Véase también polling, stopTokenPolling(), y Device Flow Usage.

[slot] void QOAuth2DeviceAuthorizationFlow::stopTokenPolling()

Detiene el sondeo de tokens. Las posibles peticiones de sondeo pendientes se descartan silenciosamente.

Véase también polling y startTokenPolling().