Class Oauth
Oauth 1 authentication strategy for Cake\Network\Http\Client
This object does not handle getting Oauth access tokens from the service provider. It only handles make client requests after you have obtained the Oauth tokens.
Generally not directly constructed, but instead used by Cake\Network\Http\Client when $options['auth']['type'] is 'oauth'
Method Summary
-
_buildAuth() protected
Builds the Oauth Authorization header value.
-
_encode() protected
URL Encodes a value based on rules of rfc3986
-
_hmacSha1() protected
Use HMAC-SHA1 signing.
-
_normalizedParams() protected
Sorts and normalizes request data and oauthValues
-
_normalizedUrl() protected
Builds a normalized URL
-
_plaintext() protected
Plaintext signing
-
authentication() public
Add headers for Oauth authorization.
-
baseString() public
Generate the Oauth basestring
Method Detail
_buildAuth() ¶ protected
_buildAuth(array $data): stringBuilds the Oauth Authorization header value.
Parameters
-
array$data The oauth_* values to build
Returns
string_encode() ¶ protected
_encode(string $value): stringURL Encodes a value based on rules of rfc3986
Parameters
-
string$value Value to encode.
Returns
string_hmacSha1() ¶ protected
_hmacSha1(Cake\Network\Http\Request $request, array $credentials): stringUse HMAC-SHA1 signing.
This method is suitable for plain HTTP or HTTPS.
Parameters
-
Cake\Network\Http\Request$request The request object.
-
array$credentials Authentication credentials.
Returns
string_normalizedParams() ¶ protected
_normalizedParams(Cake\Network\Http\Request $request, array $oauthValues): stringSorts and normalizes request data and oauthValues
Section 9.1.1 of Oauth spec.
- URL encode keys + values.
- Sort keys & values by byte value.
Parameters
-
Cake\Network\Http\Request$request The request object.
-
array$oauthValues Oauth values.
Returns
stringsorted and normalized values
_normalizedUrl() ¶ protected
_normalizedUrl(string $url): stringBuilds a normalized URL
Section 9.1.2. of the Oauth spec
Parameters
-
string$url URL
Returns
stringNormalized URL
Throws
Cake\Core\Exception\ExceptionOn invalid URLs
_plaintext() ¶ protected
_plaintext(Cake\Network\Http\Request $request, array $credentials): stringPlaintext signing
This method is not suitable for plain HTTP. You should only ever use PLAINTEXT when dealing with SSL services.
Parameters
-
Cake\Network\Http\Request$request The request object.
-
array$credentials Authentication credentials.
Returns
stringAuthorization header.
authentication() ¶ public
authentication(Cake\Network\Http\Request $request, array $credentials): voidAdd headers for Oauth authorization.
Parameters
-
Cake\Network\Http\Request$request The request object.
-
array$credentials Authentication credentials.
Returns
voidThrows
Cake\Core\Exception\ExceptionOn invalid signature types.
baseString() ¶ public
baseString(Cake\Network\Http\Request $request, array $oauthValues): stringGenerate the Oauth basestring
- Querystring, request data and oauth_* parameters are combined.
- Values are sorted by name and then value.
- Request values are concatenated and urlencoded.
- The request URL (without querystring) is normalized.
- The HTTP method, URL and request parameters are concatenated and returned.
Parameters
-
Cake\Network\Http\Request$request The request object.
-
array$oauthValues Oauth values.
Returns
string