QOAuth1Signature Class

Implements OAuth 1 signature methods. 更多...

头: #include <QOAuth1Signature>
qmake: QT += networkauth
Since: Qt 5.8

公共类型

enum HttpRequestMethod { Head, Get, Put, Post, ..., Unknown }

公共函数

QOAuth1Signature (const QUrl & url = QUrl(), QOAuth1Signature::HttpRequestMethod method = HttpRequestMethod::Post, const QVariantMap & 参数 = QVariantMap())
QOAuth1Signature (const QUrl & url , const QString & clientSharedKey , const QString & tokenSecret , QOAuth1Signature::HttpRequestMethod method = HttpRequestMethod::Post, const QVariantMap & 参数 = QVariantMap())
QOAuth1Signature (const QOAuth1Signature & other )
QOAuth1Signature (QOAuth1Signature && other )
~QOAuth1Signature ()
void addRequestBody (const QUrlQuery & body )
QString clientSharedKey () const
QByteArray hmacSha1 () const
QOAuth1Signature::HttpRequestMethod httpRequestMethod () const
void insert (const QString & key , const QVariant & value )
QList<QString> keys () const
QVariantMap 参数 () const
QByteArray plainText () const
QByteArray rsaSha1 () const
void setClientSharedKey (const QString & secret )
void setHttpRequestMethod (QOAuth1Signature::HttpRequestMethod method )
void setParameters (const QVariantMap & 参数 )
void setTokenSecret (const QString & secret )
void setUrl (const QUrl & url )
void swap (QOAuth1Signature & other )
QVariant take (const QString & key )
QString tokenSecret () const
QUrl url () const
QVariant value (const QString & key , const QVariant & defaultValue = QVariant()) const
QOAuth1Signature & operator= (const QOAuth1Signature & other )
QOAuth1Signature & operator= (QOAuth1Signature && other )

静态公共成员

QByteArray plainText (const QString & clientSharedKey , const QString & tokenSecret )

详细描述

Implements OAuth 1 signature methods.

OAuth-authenticated requests can have two sets of credentials: those passed via the "oauth_consumer_key" parameter and those in the "oauth_token" parameter. In order for the server to verify the authenticity of the request and prevent unauthorized access, the client needs to prove that it is the rightful owner of the credentials. This is accomplished using the shared-secret (or RSA key) part of each set of credentials.

OAuth specifies three methods for the client to establish its rightful ownership of the credentials: "HMAC-SHA1", "RSA-SHA1", and "PLAINTEXT". Each generates a "signature" with which the request is "signed"; the first two use a digest of the data signed in generating this, though the last does not. The "RSA-SHA1" method is not supported here; it would use an RSA key rather than the shared-secret associated with the client credentials.

成员类型文档编制

enum QOAuth1Signature:: HttpRequestMethod

Indicates the HTTP request method.

常量 描述
QOAuth1Signature::Head 1 HEAD method.
QOAuth1Signature::Get 2 GET method.
QOAuth1Signature::Put 3 PUT method.
QOAuth1Signature::Post 4 POST method.
QOAuth1Signature::Delete 5 DELETE method.
QOAuth1Signature::Custom 6 Identifies a custom method.
QOAuth1Signature::Unknown 0 Method not set.

成员函数文档编制

QOAuth1Signature:: QOAuth1Signature (const QUrl & url = QUrl(), QOAuth1Signature::HttpRequestMethod method = HttpRequestMethod::Post, const QVariantMap & 参数 = QVariantMap())

创建 QOAuth1Signature 使用

  • url as the target address
  • method as the HTTP method used to send the request
  • and the given user 参数 to augment the request.

QOAuth1Signature:: QOAuth1Signature (const QUrl & url , const QString & clientSharedKey , const QString & tokenSecret , QOAuth1Signature::HttpRequestMethod method = HttpRequestMethod::Post, const QVariantMap & 参数 = QVariantMap())

创建 QOAuth1Signature 使用

  • url as the target address
  • clientSharedKey as the user token used to verify the signature
  • tokenSecret as the negotiated token used to verify the signature
  • method as the HTTP method used to send the request
  • and the given user 参数 to augment the request.

QOAuth1Signature:: QOAuth1Signature (const QOAuth1Signature & other )

创建副本为 other .

QOAuth1Signature:: QOAuth1Signature ( QOAuth1Signature && other )

移动构造 QOAuth1Signature instance, taking over the private data other was using.

QOAuth1Signature:: ~QOAuth1Signature ()

销毁 QOAuth1Signature .

void QOAuth1Signature:: addRequestBody (const QUrlQuery & body )

Adds the request body to the signature. When a POST request body contains arguments they should be included in the signed data.

QString QOAuth1Signature:: clientSharedKey () const

Returns the user secret used to generate the signature.

另请参阅 setClientSharedKey ().

QByteArray QOAuth1Signature:: hmacSha1 () const

Generates the HMAC-SHA1 signature using the client shared secret and, where available, token secret.

QOAuth1Signature::HttpRequestMethod QOAuth1Signature:: httpRequestMethod () const

Returns the request method.

另请参阅 setHttpRequestMethod ().

void QOAuth1Signature:: insert (const QString & key , const QVariant & value )

Inserts a new pair key , value into the signature. When a POST request body contains arguments they should be included in the signed data.

QList < QString > QOAuth1Signature:: keys () const

Retrieves the list of keys of parameters included in the signed data.

QVariantMap QOAuth1Signature:: 参数 () const

Returns the parameters.

另请参阅 setParameters ().

QByteArray QOAuth1Signature:: plainText () const

Generates the PLAINTEXT signature.

[static] QByteArray QOAuth1Signature:: plainText (const QString & clientSharedKey , const QString & tokenSecret )

Generates a PLAINTEXT signature from the client secret clientSharedKey and the token secret tokenSecret .

QByteArray QOAuth1Signature:: rsaSha1 () const

Generates the RSA-SHA1 signature.

注意: Currently this method is not supported.

void QOAuth1Signature:: setClientSharedKey (const QString & secret )

secret as the user secret used to generate the signature.

另请参阅 clientSharedKey ().

void QOAuth1Signature:: setHttpRequestMethod ( QOAuth1Signature::HttpRequestMethod method )

Sets the request method .

另请参阅 httpRequestMethod ().

void QOAuth1Signature:: setParameters (const QVariantMap & 参数 )

设置 参数 .

另请参阅 参数 ().

void QOAuth1Signature:: setTokenSecret (const QString & secret )

secret as the negotiated secret used to generate the signature.

另请参阅 tokenSecret ().

void QOAuth1Signature:: setUrl (const QUrl & url )

Sets the URL to url .

另请参阅 url ().

void QOAuth1Signature:: swap ( QOAuth1Signature & other )

Swaps signature other with this signature. This operation is very fast and never fails.

QVariant QOAuth1Signature:: take (const QString & key )

移除 key and any associated value from the signed data.

QString QOAuth1Signature:: tokenSecret () const

Returns the negotiated secret used to generate the signature.

另请参阅 setTokenSecret ().

QUrl QOAuth1Signature:: url () const

Returns the URL.

另请参阅 setUrl ().

QVariant QOAuth1Signature:: value (const QString & key , const QVariant & defaultValue = QVariant()) const

Returns the value associated with key , if present in the signed data, otherwise defaultValue .

QOAuth1Signature &QOAuth1Signature:: operator= (const QOAuth1Signature & other )

拷贝赋值运算符。

QOAuth1Signature &QOAuth1Signature:: operator= ( QOAuth1Signature && other )

移动赋值运算符。