QAbstractOAuth2 Class

QAbstractOAuth2 클래스는 OAuth 2 인증 메서드의 모든 구현의 기반입니다. 더 보기...

헤더: #include <QAbstractOAuth2>
CMake: find_package(Qt6 REQUIRED COMPONENTS NetworkAuth)
target_link_libraries(mytarget PRIVATE Qt6::NetworkAuth)
qmake: QT += networkauth
상속합니다: QAbstractOAuth
상속 대상:

QOAuth2AuthorizationCodeFlow

속성

공용 함수

QAbstractOAuth2(QObject *parent = nullptr)
QAbstractOAuth2(QNetworkAccessManager *manager, QObject *parent = nullptr)
virtual ~QAbstractOAuth2()
QString clientIdentifierSharedKey() const
virtual QUrl createAuthenticatedUrl(const QUrl &url, const QVariantMap &parameters = QVariantMap())
QDateTime expirationAt() const
(until 6.11) virtual QNetworkReply *post(const QUrl &url, QHttpMultiPart *multiPart)
(until 6.11) virtual QNetworkReply *post(const QUrl &url, const QByteArray &data)
(until 6.11) virtual QNetworkReply *put(const QUrl &url, QHttpMultiPart *multiPart)
(until 6.11) virtual QNetworkReply *put(const QUrl &url, const QByteArray &data)
QString refreshToken() const
QString responseType() const
QString scope() const
void setClientIdentifierSharedKey(const QString &clientIdentifierSharedKey)
void setRefreshToken(const QString &refreshToken)
void setScope(const QString &scope)
(since 6.5) void setSslConfiguration(const QSslConfiguration &configuration)
void setState(const QString &state)
void setUserAgent(const QString &userAgent)
(since 6.5) QSslConfiguration sslConfiguration() const
QString state() const
QString userAgent() const

재구현된 공용 함수

(until 6.11) virtual QNetworkReply *deleteResource(const QUrl &url, const QVariantMap &parameters = QVariantMap()) override
(until 6.11) virtual QNetworkReply *get(const QUrl &url, const QVariantMap &parameters = QVariantMap()) override
(until 6.11) virtual QNetworkReply *head(const QUrl &url, const QVariantMap &parameters = QVariantMap()) override
(until 6.11) virtual QNetworkReply *post(const QUrl &url, const QVariantMap &parameters = QVariantMap()) override
virtual void prepareRequest(QNetworkRequest *request, const QByteArray &verb, const QByteArray &body = QByteArray()) override
(until 6.11) virtual QNetworkReply *put(const QUrl &url, const QVariantMap &parameters = QVariantMap()) override

신호

void authorizationCallbackReceived(const QVariantMap &data)
void clientIdentifierSharedKeyChanged(const QString &clientIdentifierSharedKey)
void error(const QString &error, const QString &errorDescription, const QUrl &uri)
void expirationAtChanged(const QDateTime &expiration)
void refreshTokenChanged(const QString &refreshToken)
void scopeChanged(const QString &scope)
(since 6.5) void sslConfigurationChanged(const QSslConfiguration &configuration)
void stateChanged(const QString &state)
void userAgentChanged(const QString &userAgent)

상세 설명

이 클래스는 OAuth 2 인증 클래스의 기본 인터페이스를 정의합니다. 이 클래스를 상속하면 다양한 웹 서비스에 대해 OAuth 2 표준을 사용하여 사용자 지정 인증 메서드를 만들 수 있습니다.

OAuth 2의 작동 방식에 대한 설명은 여기에서 확인할 수 있습니다: OAuth 2.0 인증 프레임워크

속성 문서

clientIdentifierSharedKey : QString

이 속성에는 서버에서 토큰을 요청하기 위해 인증이 필요한 경우 비밀번호로 사용되는 클라이언트 공유 키가 저장됩니다.

액세스 기능:

QString clientIdentifierSharedKey() const
void setClientIdentifierSharedKey(const QString &clientIdentifierSharedKey)

알림 신호:

void clientIdentifierSharedKeyChanged(const QString &clientIdentifierSharedKey)

[read-only] expiration : const QDateTime

이 속성은 현재 액세스 토큰의 만료 시간을 보유합니다. 유효하지 않은 값은 권한 부여 서버가 유효한 만료 시간을 제공하지 않았음을 의미합니다.

액세스 기능:

QDateTime expirationAt() const

알림 신호:

void expirationAtChanged(const QDateTime &expiration)

QDateTime::isValid()도 참조하세요 .

scope : QString

이 속성은 클라이언트가 요청한 권한을 정의하는 원하는 범위를 보유합니다.

범위 값은 권한 서버에서 부여한 범위 값으로 업데이트됩니다. 범위가 비어 있는 응답의 경우 요청된 범위가 부여된 것으로 간주되어 변경되지 않습니다.

액세스 기능:

QString scope() const
void setScope(const QString &scope)

알림 신호:

void scopeChanged(const QString &scope)

state : QString

이 속성은 인증 중에 서버로 전송된 문자열을 보관합니다. 이 상태는 콜백이 수신될 때 요청을 식별하고 유효성을 검사하는 데 사용됩니다.

액세스 함수:

QString state() const
void setState(const QString &state)

알림 신호:

void stateChanged(const QString &state)

userAgent : QString

이 속성은 네트워크 요청을 생성하는 데 사용되는 User-Agent 헤더를 보유합니다.

기본값은 "QtOAuth/1.0(+https://www.qt.io)"입니다.

액세스 함수:

QString userAgent() const
void setUserAgent(const QString &userAgent)

알림 신호:

void userAgentChanged(const QString &userAgent)

멤버 함수 문서

[explicit] QAbstractOAuth2::QAbstractOAuth2(QObject *parent = nullptr)

parent 을 부모로 사용하여 QAbstractOAuth2 객체를 구축합니다.

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

parent 을 부모로 사용하고 manager 을 네트워크 액세스 관리자로 설정하여 QAbstractOAuth2 개체를 구성합니다.

[virtual noexcept] QAbstractOAuth2::~QAbstractOAuth2()

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

[signal] void QAbstractOAuth2::authorizationCallbackReceived(const QVariantMap &data)

응답 서버가 서버로부터 권한 부여 콜백을 수신할 때 발생하는 신호: data 서버로부터 받은 값을 포함합니다.

[virtual invokable] QUrl QAbstractOAuth2::createAuthenticatedUrl(const QUrl &url, const QVariantMap &parameters = QVariantMap())

반환된 URL은 url 을 기반으로 하며, 지정된 parameters 및 액세스 토큰과 결합됩니다.

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.

[override virtual invokable, until 6.11] QNetworkReply *QAbstractOAuth2::deleteResource(const QUrl &url, const QVariantMap &parameters = QVariantMap())

이 기능은 버전 6.11에서 더 이상 사용되지 않을 예정입니다.

재구현합니다: QAbstractOAuth::deleteResource(const QUrl &url, const QVariantMap &parameters).

대신 QtNetwork 클래스를 직접 사용하세요. HTTP 메서드 대안을 참조하세요.

인증된 DELETE 요청을 전송하고 새 QNetworkReply 을 반환합니다. urlparameters 은 요청을 생성하는 데 사용됩니다.

참조하세요: 하이퍼텍스트 전송 프로토콜 - HTTP/1.1: DELETE

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.

[signal] void QAbstractOAuth2::error(const QString &error, const QString &errorDescription, const QUrl &uri)

서버가 RFC 6749 오류 응답에 정의된 오류와 함께 권한 부여 요청에 응답할 때 발생하는 신호입니다.

error 는 오류의 이름이고 errorDescription 는 오류를 설명하며 uri 는 오류에 대한 자세한 정보가 포함된 선택적 URI입니다.

QAbstractOAuth::requestFailed()도 참조하세요 .

[override virtual invokable, until 6.11] QNetworkReply *QAbstractOAuth2::get(const QUrl &url, const QVariantMap &parameters = QVariantMap())

이 기능은 버전 6.11에서 더 이상 사용되지 않을 예정입니다.

재구현합니다: QAbstractOAuth::get(const QUrl &url, const QVariantMap &parameters).

대신 QtNetwork 클래스를 직접 사용하세요. HTTP 메서드 대체를 참조하세요.

인증된 GET 요청을 전송하고 새 QNetworkReply 을 반환합니다. urlparameters 은 요청을 생성하는 데 사용됩니다.

또한 참조하세요: 하이퍼텍스트 전송 프로토콜 - HTTP/1.1: GET

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.

이 기능은 버전 6.11에서 더 이상 사용되지 않을 예정입니다.

재구현합니다: QAbstractOAuth::head(const QUrl &url, const QVariantMap &parameters).

대신 QtNetwork 클래스를 직접 사용하세요. HTTP 메서드 대안을 참조하세요.

인증된 HEAD 요청을 전송하고 새로운 QNetworkReply 을 반환합니다. urlparameters 은 요청을 생성하는 데 사용됩니다.

또한 참조하세요: 하이퍼텍스트 전송 프로토콜 - HTTP/1.1: HEAD

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.

[override virtual invokable, until 6.11] QNetworkReply *QAbstractOAuth2::post(const QUrl &url, const QVariantMap &parameters = QVariantMap())

이 기능은 버전 6.11에서 더 이상 사용되지 않을 예정입니다.

재구현합니다: QAbstractOAuth::post(const QUrl &url, const QVariantMap &parameters).

대신 QtNetwork 클래스를 직접 사용하세요. HTTP 메서드 대안을 참조하세요.

인증된 POST 요청을 전송하고 새 QNetworkReply 을 반환합니다. urlparameters 은 요청을 생성하는 데 사용됩니다.

또한 참조하세요: 하이퍼텍스트 전송 프로토콜 - HTTP/1.1: POST

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.

[virtual invokable, until 6.11] QNetworkReply *QAbstractOAuth2::post(const QUrl &url, QHttpMultiPart *multiPart)

이 함수는 버전 6.11에서 더 이상 사용되지 않을 예정입니다.

대신 QtNetwork 클래스를 직접 사용하세요. HTTP 메서드 대안을 참조하세요.

이 함수는 오버로드된 함수입니다.

인증된 POST 요청을 전송하고 새 QNetworkReply 을 반환합니다. urlmultiPart 은 요청을 생성하는 데 사용됩니다.

{하이퍼텍스트 전송 프로토콜 - HTTP/1.1: POST}

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.

post(), QHttpMultiPart, https://tools.ietf.org/html/rfc2616#section-9.6도 참조하세요 .

[virtual invokable, until 6.11] QNetworkReply *QAbstractOAuth2::post(const QUrl &url, const QByteArray &data)

이 함수는 버전 6.11에서 더 이상 사용되지 않을 예정입니다.

대신 QtNetwork 클래스를 직접 사용하세요. HTTP 메서드 대안을 참조하세요.

이 함수는 오버로드된 함수입니다.

인증된 POST 요청을 전송하고 새 QNetworkReply 을 반환합니다. urldata 은 요청을 생성하는 데 사용됩니다.

{하이퍼텍스트 전송 프로토콜 - HTTP/1.1: POST}

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하십시오.

post() 및 https://tools.ietf.org/html/rfc2616#section-9.6 을참조하세요 .

[override virtual] void QAbstractOAuth2::prepareRequest(QNetworkRequest *request, const QByteArray &verb, const QByteArray &body = QByteArray())

재구현합니다: QAbstractOAuth::prepareRequest(QNetworkRequest *request, const QByteArray &verb, const QByteArray &body).

[override virtual invokable, until 6.11] QNetworkReply *QAbstractOAuth2::put(const QUrl &url, const QVariantMap &parameters = QVariantMap())

이 기능은 버전 6.11에서 더 이상 사용되지 않을 예정입니다.

재구현합니다: QAbstractOAuth::put(const QUrl &url, const QVariantMap &parameters).

대신 QtNetwork 클래스를 직접 사용하세요. HTTP 메서드 대안을 참조하세요.

인증된 PUT 요청을 전송하고 새 QNetworkReply 을 반환합니다. urlparameters 은 요청을 생성하는 데 사용됩니다.

또한 참조하세요: 하이퍼텍스트 전송 프로토콜 - HTTP/1.1: PUT

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.

[virtual invokable, until 6.11] QNetworkReply *QAbstractOAuth2::put(const QUrl &url, QHttpMultiPart *multiPart)

이 함수는 버전 6.11에서 더 이상 사용되지 않을 예정입니다.

대신 QtNetwork 클래스를 직접 사용하세요. HTTP 메서드 대안을 참조하세요.

이 함수는 오버로드된 함수입니다.

인증된 PUT 요청을 전송하고 새 QNetworkReply 을 반환합니다. urlmultiPart 은 요청을 생성하는 데 사용됩니다.

{하이퍼텍스트 전송 프로토콜 - HTTP/1.1: PUT}

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.

put(), QHttpMultiPart, https://tools.ietf.org/html/rfc2616#section-9.6도 참조하세요 .

[virtual invokable, until 6.11] QNetworkReply *QAbstractOAuth2::put(const QUrl &url, const QByteArray &data)

이 함수는 버전 6.11에서 더 이상 사용되지 않을 예정입니다.

대신 QtNetwork 클래스를 직접 사용하세요. HTTP 메서드 대안을 참조하세요.

이 함수는 오버로드된 함수입니다.

인증된 PUT 요청을 전송하고 새 QNetworkReply 을 반환합니다. urldata 은 요청을 생성하는 데 사용됩니다.

{하이퍼텍스트 전송 프로토콜 - HTTP/1.1: PUT}

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하십시오.

put() 및 https://tools.ietf.org/html/rfc2616#section-9.6 을참조하세요 .

QString QAbstractOAuth2::refreshToken() const

현재 새로고침 토큰을 가져옵니다.

새로 고침 토큰은 일반적으로 액세스 토큰보다 수명이 길기 때문에 나중에 사용할 수 있도록 저장해 두는 것이 좋습니다.

현재 새로 고침 토큰을 반환하거나 사용 가능한 새로 고침 토큰이 없는 경우 빈 문자열을 반환합니다.

참고: refreshToken 속성에 대한 게터 함수입니다.

setRefreshToken()도 참조하세요 .

QString QAbstractOAuth2::responseType() const

사용된 응답 유형을 반환합니다.

void QAbstractOAuth2::setRefreshToken(const QString &refreshToken)

새 새로 고침 토큰 refreshToken 을 사용하도록 설정합니다.

사용자 지정 새로 고침 토큰을 사용하여 이 메서드를 통해 액세스 토큰을 새로 고친 다음 QOAuth2AuthorizationCodeFlow::refreshAccessToken()를 통해 액세스 토큰을 새로 고칠 수 있습니다.

참고: 속성에 대한 설정자 함수 refreshToken.

refreshToken()도 참조하세요 .

[since 6.5] void QAbstractOAuth2::setSslConfiguration(const QSslConfiguration &configuration)

클라이언트와 권한 부여 서버 간에 상호 TLS 연결을 설정할 때 사용할 TLS configuration 를 설정합니다.

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

sslConfiguration() 및 sslConfigurationChanged()도 참조하십시오 .

[since 6.5] QSslConfiguration QAbstractOAuth2::sslConfiguration() const

클라이언트와 권한 부여 서버 간에 상호 TLS 연결을 설정할 때 사용할 TLS 구성을 반환합니다.

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

setSslConfiguration() 및 sslConfigurationChanged()도 참조하십시오 .

[signal, since 6.5] void QAbstractOAuth2::sslConfigurationChanged(const QSslConfiguration &configuration)

이 신호는 TLS 구성이 변경되었을 때 전송됩니다. configuration 매개변수에는 새 TLS 구성이 포함됩니다.

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

sslConfiguration() 및 setSslConfiguration()도 참조하세요 .

© 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.