内容

• 公共类型
• 公共函数
• 重实现公共函数
• 公共槽
• 信号
• 静态公共成员
• 保护函数
• 静态保护成员
• 详细描述

QOAuth1 Class

The QOAuth1 class provides an implementation of the OAuth 1 Protocol . 更多...

头：	#include <QOAuth1>
qmake:	QT += networkauth
Since:	Qt 5.8
继承：	QAbstractOAuth

• 所有成员列表，包括继承成员
• 过时成员

公共类型

enum	SignatureMethod { Hmac_Sha1, Rsa_Sha1, PlainText }

公共函数

	QOAuth1 (QObject * parent = nullptr)
	QOAuth1 (QNetworkAccessManager * manager , QObject * parent = nullptr)
	QOAuth1 (const QString & clientIdentifier , const QString & clientSharedSecret , QNetworkAccessManager * manager , QObject * parent = nullptr)
QPair<QString, QString>	clientCredentials () const
QString	clientSharedSecret () const
void	setClientCredentials (const QPair<QString, QString> & clientCredentials )
void	setClientCredentials (const QString & clientIdentifier , const QString & clientSharedSecret )
void	setClientSharedSecret (const QString & clientSharedSecret )
void	setSignatureMethod (QOAuth1::SignatureMethod value )
void	setTemporaryCredentialsUrl (const QUrl & url )
void	setTokenCredentials (const QPair<QString, QString> & tokenCredentials )
void	setTokenCredentials (const QString & token , const QString & tokenSecret )
void	setTokenCredentialsUrl (const QUrl & url )
void	setTokenSecret (const QString & tokenSecret )
QOAuth1::SignatureMethod	signatureMethod () const
QUrl	temporaryCredentialsUrl () const
QPair<QString, QString>	tokenCredentials () const
QUrl	tokenCredentialsUrl () const
QString	tokenSecret () const

重实现公共函数

virtual QNetworkReply *	deleteResource (const QUrl & url , const QVariantMap & 参数 = QVariantMap()) override
virtual QNetworkReply *	get (const QUrl & url , const QVariantMap & 参数 = QVariantMap()) override
virtual QNetworkReply *	head (const QUrl & url , const QVariantMap & 参数 = QVariantMap()) override
virtual QNetworkReply *	post (const QUrl & url , const QVariantMap & 参数 = QVariantMap()) override
virtual QNetworkReply *	put (const QUrl & url , const QVariantMap & 参数 = QVariantMap()) override

• 21 公共函数继承自 QAbstractOAuth
• 31 公共函数继承自 QObject

公共槽

void	continueGrantWithVerifier (const QString & verifier )
virtual void	grant () override

• 1 公共槽继承自 QAbstractOAuth
• 1 公共槽继承自 QObject

信号

void	clientSharedSecretChanged (const QString & credential )
void	signatureMethodChanged (QOAuth1::SignatureMethod method )
void	temporaryCredentialsUrlChanged (const QUrl & url )
void	tokenCredentialsUrlChanged (const QUrl & url )
void	tokenSecretChanged (const QString & token )

• 11 signals inherited from QAbstractOAuth
• 2 信号继承自 QObject

静态公共成员

const QMetaObject

staticMetaObject

• 9 静态公共成员继承自 QObject

保护函数

QNetworkReply *	requestTemporaryCredentials (QNetworkAccessManager::Operation operation , const QUrl & url , const QVariantMap & 参数 = QVariantMap())
QNetworkReply *	requestTokenCredentials (QNetworkAccessManager::Operation operation , const QUrl & url , const QPair<QString, QString> & temporaryToken , const QVariantMap & 参数 = QVariantMap())
void	setup (QNetworkRequest * request , const QVariantMap & signingParameters , QNetworkAccessManager::Operation operation )

• 3 保护函数继承自 QAbstractOAuth
• 9 保护函数继承自 QObject

静态保护成员

QByteArray	generateAuthorizationHeader (const QVariantMap & oauthParams )
QByteArray	nonce ()

• 1 static protected member inherited from QAbstractOAuth

额外继承成员

• 6 特性继承自 QAbstractOAuth
• 1 特性继承自 QObject

详细描述

The QOAuth1 class provides an implementation of the OAuth 1 Protocol .

QOAuth1 provides a method for clients to access server resources on behalf of a resource owner (such as a different client or an end-user). It also provides a process for end-users to authorize third-party access to their server resources without sharing their credentials (typically, a username and password pair), using user-agent redirections.

QOAuth1 uses tokens to represent the authorization granted to the client by the resource owner. Typically, token credentials are issued by the server at the resource owner's request, after authenticating the resource owner's identity (usually using a username and password).

When making the temporary credentials request, the client authenticates using only the client credentials. When making the token request, the client authenticates using the client credentials as well as the temporary credentials. Once the client receives and stores the token credentials, it can proceed to access protected resources on behalf of the resource owner by making authenticated requests using the client credentials together with the token credentials received.

成员类型文档编制

enum QOAuth1:: SignatureMethod

Indicates the signature method to be used to sign requests.

常量	值	描述
QOAuth1::Hmac_Sha1	0	HMAC-SHA1 signature method.
QOAuth1::Rsa_Sha1	1	RSA-SHA1 signature method (not supported).
QOAuth1::PlainText	2	PLAINTEXT signature method.

成员函数文档编制

QOAuth1:: QOAuth1 ( QObject * parent = nullptr)

构造 QOAuth1 object with parent object parent .

QOAuth1:: QOAuth1 ( QNetworkAccessManager * manager , QObject * parent = nullptr)

构造 QOAuth1 object with parent object parent ，使用 manager to access the network.

QOAuth1:: QOAuth1 (const QString & clientIdentifier , const QString & clientSharedSecret , QNetworkAccessManager * manager , QObject * parent = nullptr)

构造 QOAuth1 object with parent object parent ，使用 manager to access the network. Also sets clientIdentifier and clientSharedSecret to sign the calls to the web server and identify the application.

QPair < QString , QString > QOAuth1:: clientCredentials () const

Returns the pair of QString used to identify the application and sign requests to the web server.

另请参阅 setClientCredentials ().

QString QOAuth1:: clientSharedSecret () const

Returns the current shared secret used to sign requests to the web server.

另请参阅 setClientSharedSecret () 和 clientCredentials ().

[signal] void QOAuth1:: clientSharedSecretChanged (const QString & credential )

[slot] void QOAuth1:: continueGrantWithVerifier (const QString & verifier )

Continues the Redirection-Based Authorization flow using verifier . Call this function when using an Out-of-band reply handler to supply the verifier provided by the web server.

[override virtual] QNetworkReply *QOAuth1:: deleteResource (const QUrl & url , const QVariantMap & 参数 = QVariantMap())

重实现自 QAbstractOAuth::deleteResource ().

Sends an authenticated DELETE request and returns a new QNetworkReply 。 url and 参数 are used to create the request.

另请参阅 : Hypertext Transfer Protocol -- HTTP/1.1: DELETE

[static protected] QByteArray QOAuth1:: generateAuthorizationHeader (const QVariantMap & oauthParams )

Generates an authorization header using oauthParams .

另请参阅 : The OAuth 1.0 Protocol: Authorization Header

[override virtual] QNetworkReply *QOAuth1:: get (const QUrl & url , const QVariantMap & 参数 = QVariantMap())

重实现自 QAbstractOAuth::get ().

Sends an authenticated GET request and returns a new QNetworkReply 。 url and 参数 are used to create the request.

另请参阅 : Hypertext Transfer Protocol -- HTTP/1.1: GET

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

重实现自 QAbstractOAuth::grant ().

Starts the Redirection-Based Authorization flow.

注意： For an out-of-band reply handler, a verifier string is received after the call to this function; pass that to continueGrantWithVerifier () to continue the grant process.

另请参阅 : The OAuth 1.0 Protocol: Redirection-Based Authorization

另请参阅 continueGrantWithVerifier ().

[override virtual] QNetworkReply *QOAuth1:: head (const QUrl & url , const QVariantMap & 参数 = QVariantMap())

重实现自 QAbstractOAuth::head ().

Sends an authenticated HEAD request and returns a new QNetworkReply 。 url and 参数 are used to create the request.

另请参阅 : Hypertext Transfer Protocol -- HTTP/1.1: HEAD

[static protected] QByteArray QOAuth1:: nonce ()

Generates a nonce.

另请参阅 : The OAuth 1.0 Protocol: Nonce and Timestamp

[override virtual] QNetworkReply *QOAuth1:: post (const QUrl & url , const QVariantMap & 参数 = QVariantMap())

重实现自 QAbstractOAuth::post ().

Sends an authenticated POST request and returns a new QNetworkReply 。 url and 参数 are used to create the request.

另请参阅 : Hypertext Transfer Protocol -- HTTP/1.1: POST

[override virtual] QNetworkReply *QOAuth1:: put (const QUrl & url , const QVariantMap & 参数 = QVariantMap())

重实现自 QAbstractOAuth::put ().

Sends an authenticated PUT request and returns a new QNetworkReply 。 url and 参数 are used to create the request.

另请参阅 : Hypertext Transfer Protocol -- HTTP/1.1: PUT

[protected] QNetworkReply *QOAuth1:: requestTemporaryCredentials ( QNetworkAccessManager::Operation operation , const QUrl & url , const QVariantMap & 参数 = QVariantMap())

Starts the a request for temporary credentials using the request method operation . The request URL is url 和 参数 shall encoded and sent during the request.

另请参阅 : The OAuth 1.0 Protocol: Temporary Credentials

[protected] QNetworkReply *QOAuth1:: requestTokenCredentials ( QNetworkAccessManager::Operation operation , const QUrl & url , const QPair < QString , QString > & temporaryToken , const QVariantMap & 参数 = QVariantMap())

Starts a request for token credentials using the request method operation . The request URL is url 和 参数 shall be encoded and sent during the request. The temporaryToken pair of string is used to identify and sign the request.

另请参阅 : The OAuth 1.0 Protocol: Token Credentials

void QOAuth1:: setClientCredentials (const QPair < QString , QString > & clientCredentials )

集 clientCredentials as the pair of QString used to identify the application and sign requests to the web server.

另请参阅 clientCredentials ().

void QOAuth1:: setClientCredentials (const QString & clientIdentifier , const QString & clientSharedSecret )

集 clientIdentifier and clientSharedSecret as the pair of QString used to identify the application and sign requests to the web server. clientIdentifier identifies the application and clientSharedSecret is used to sign requests.

另请参阅 clientCredentials ().

void QOAuth1:: setClientSharedSecret (const QString & clientSharedSecret )

集 clientSharedSecret as the string used to sign the requests to the web server.

另请参阅 clientSharedSecret () 和 setClientCredentials ().

void QOAuth1:: setSignatureMethod ( QOAuth1::SignatureMethod value )

集 value as the method used to sign requests to the web server.

另请参阅 signatureMethod ().

void QOAuth1:: setTemporaryCredentialsUrl (const QUrl & url )

集 url as the URL to request temporary credentials to start the authentication process.

另请参阅 temporaryCredentialsUrl ().

void QOAuth1:: setTokenCredentials (const QPair < QString , QString > & tokenCredentials )

集 tokenCredentials as the pair of QString used to identify and sign authenticated requests to the web server.

另请参阅 tokenCredentials ().

void QOAuth1:: setTokenCredentials (const QString & token , const QString & tokenSecret )

集 token and tokenSecret as the pair of QString used to identify and sign authenticated requests to the web server. Once the client receives and stores the token credentials, it can proceed to access protected resources on behalf of the resource owner by making authenticated requests using the client credentials together with the token credentials received.

另请参阅 tokenCredentials ().

void QOAuth1:: setTokenCredentialsUrl (const QUrl & url )

集 url as the URL to request the token credentials to continue the authentication process.

另请参阅 tokenCredentialsUrl ().

void QOAuth1:: setTokenSecret (const QString & tokenSecret )

集 tokenSecret as the current token secret used to sign authenticated calls to the web server.

另请参阅 tokenSecret () 和 setTokenCredentials ().

[protected] void QOAuth1:: setup ( QNetworkRequest * request , const QVariantMap & signingParameters , QNetworkAccessManager::Operation operation )

Signs the request 使用 signingParameters and operation .

QOAuth1::SignatureMethod QOAuth1:: signatureMethod () const

Returns the method used to sign the request to the web server.

另请参阅 setSignatureMethod ().

[signal] void QOAuth1:: signatureMethodChanged ( QOAuth1::SignatureMethod method )

QUrl QOAuth1:: temporaryCredentialsUrl () const

Returns the url used to request temporary credentials to start the authentication process.

另请参阅 setTemporaryCredentialsUrl ().

[signal] void QOAuth1:: temporaryCredentialsUrlChanged (const QUrl & url )

QPair < QString , QString > QOAuth1:: tokenCredentials () const

Returns the pair of QString used to identify and sign authenticated requests to the web server.

另请参阅 setTokenCredentials ().

QUrl QOAuth1:: tokenCredentialsUrl () const

Returns the url used to request token credentials to continue the authentication process.

另请参阅 setTokenCredentialsUrl ().

[signal] void QOAuth1:: tokenCredentialsUrlChanged (const QUrl & url )

QString QOAuth1:: tokenSecret () const

Returns the current token secret used to sign authenticated requests to the web server.

另请参阅 setTokenSecret () 和 tokenCredentials ().

[signal] void QOAuth1:: tokenSecretChanged (const QString & token )