|
| 1 | +// AFOAuth2SessionManager.h |
1 | 2 | // |
2 | | -// AFOAuth2SessionManager.h |
3 | | -// AFOAuth2Manager |
| 3 | +// Copyright (c) 2012-2014 AFNetworking (http://afnetworking.com) |
4 | 4 | // |
5 | | -// Created by Kevin Harwood on 10/28/15. |
6 | | -// Copyright © 2015 Alamofire. All rights reserved. |
| 5 | +// Permission is hereby granted, free of charge, to any person obtaining a copy |
| 6 | +// of this software and associated documentation files (the "Software"), to deal |
| 7 | +// in the Software without restriction, including without limitation the rights |
| 8 | +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell |
| 9 | +// copies of the Software, and to permit persons to whom the Software is |
| 10 | +// furnished to do so, subject to the following conditions: |
7 | 11 | // |
| 12 | +// The above copyright notice and this permission notice shall be included in |
| 13 | +// all copies or substantial portions of the Software. |
| 14 | +// |
| 15 | +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
| 16 | +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
| 17 | +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE |
| 18 | +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
| 19 | +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, |
| 20 | +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN |
| 21 | +// THE SOFTWARE |
8 | 22 |
|
9 | 23 | #import <UIKit/UIKit.h> |
| 24 | +@class AFOAuthCredential; |
10 | 25 | @import AFNetworking; |
11 | 26 |
|
| 27 | +NS_ASSUME_NONNULL_BEGIN |
| 28 | + |
12 | 29 | @interface AFOAuth2SessionManager : AFHTTPSessionManager |
13 | 30 |
|
| 31 | +///------------------------------------------ |
| 32 | +/// @name Accessing OAuth 2 Client Properties |
| 33 | +///------------------------------------------ |
| 34 | + |
| 35 | +/** |
| 36 | + The service provider identifier used to store and retrieve OAuth credentials by `AFOAuthCredential`. Equivalent to the hostname of the client `baseURL`. |
| 37 | + */ |
| 38 | +@property (readonly, nonatomic, copy) NSString *serviceProviderIdentifier; |
| 39 | + |
| 40 | +/** |
| 41 | + The client identifier issued by the authorization server, uniquely representing the registration information provided by the client. |
| 42 | + */ |
| 43 | +@property (readonly, nonatomic, copy) NSString *clientID; |
| 44 | + |
| 45 | +/** |
| 46 | + Whether to encode client credentials in a Base64-encoded HTTP `Authorization` header, as opposed to the request body. Defaults to `YES`. |
| 47 | + */ |
| 48 | +@property (nonatomic, assign) BOOL useHTTPBasicAuthentication; |
| 49 | + |
| 50 | +///------------------------------------------------ |
| 51 | +/// @name Creating and Initializing OAuth 2 Managers |
| 52 | +///------------------------------------------------ |
| 53 | + |
| 54 | +/** |
| 55 | + Creates and initializes an `AFOAuth2SessionManager` object with the specified base URL, client identifier, and secret. |
| 56 | +
|
| 57 | + @param url The base URL for the HTTP client. This argument must not be `nil`. |
| 58 | + @param clientID The client identifier issued by the authorization server, uniquely representing the registration information provided by the client. This argument must not be `nil`. |
| 59 | + @param secret The client secret. |
| 60 | +
|
| 61 | + @return The newly-initialized OAuth 2 manager |
| 62 | + */ |
| 63 | ++ (instancetype)managerWithBaseURL:(NSURL *)url |
| 64 | + clientID:(NSString *)clientID |
| 65 | + secret:(NSString *)secret; |
| 66 | + |
| 67 | ++ (instancetype)managerWithBaseURL:(NSURL *)url |
| 68 | + sessionConfiguration:(nullable NSURLSessionConfiguration *)configuration |
| 69 | + clientID:(NSString *)clientID |
| 70 | + secret:(NSString *)secret; |
| 71 | + |
| 72 | +/** |
| 73 | + Initializes an `AFOAuth2SessionManager` object with the specified base URL, client identifier, and secret. The communication to to the server will use HTTP basic auth by default (use `-(id)initWithBaseURL:clientID:secret:withBasicAuth:` to change this). |
| 74 | +
|
| 75 | + @param url The base URL for the HTTP manager. This argument must not be `nil`. |
| 76 | + @param clientID The client identifier issued by the authorization server, uniquely representing the registration information provided by the client. This argument must not be `nil`. |
| 77 | + @param secret The client secret. |
| 78 | +
|
| 79 | + @return The newly-initialized OAuth 2 client |
| 80 | + */ |
| 81 | +- (id)initWithBaseURL:(NSURL *)url |
| 82 | + clientID:(NSString *)clientID |
| 83 | + secret:(NSString *)secret; |
| 84 | + |
| 85 | +- (id)initWithBaseURL:(NSURL *)url |
| 86 | + sessionConfiguration:(nullable NSURLSessionConfiguration *)configuration |
| 87 | + clientID:(NSString *)clientID |
| 88 | + secret:(NSString *)secret; |
| 89 | + |
| 90 | +///--------------------- |
| 91 | +/// @name Authenticating |
| 92 | +///--------------------- |
| 93 | + |
| 94 | +/** |
| 95 | + Creates and enqueues an `NSURLSessionTask` to authenticate against the server using a specified username and password, with a designated scope. |
| 96 | +
|
| 97 | + @param URLString The URL string used to create the request URL. |
| 98 | + @param username The username used for authentication |
| 99 | + @param password The password used for authentication |
| 100 | + @param scope The authorization scope |
| 101 | + @param success A block object to be executed when the request operation finishes successfully. This block has no return value and takes a single argument: the OAuth credential returned by the server. |
| 102 | + @param failure A block object to be executed when the request operation finishes unsuccessfully, or that finishes successfully, but encountered an error while parsing the response data. This block has no return value and takes a single argument: the error returned from the server. |
| 103 | + */ |
| 104 | +- (NSURLSessionTask *)authenticateUsingOAuthWithURLString:(NSString *)URLString |
| 105 | + username:(NSString *)username |
| 106 | + password:(NSString *)password |
| 107 | + scope:(NSString *)scope |
| 108 | + success:(void (^)(AFOAuthCredential *credential))success |
| 109 | + failure:(void (^)(NSError *error))failure; |
| 110 | + |
| 111 | +/** |
| 112 | + Creates and enqueues an `NSURLSessionTask` to authenticate against the server with a designated scope. |
| 113 | +
|
| 114 | + @param URLString The URL string used to create the request URL. |
| 115 | + @param scope The authorization scope |
| 116 | + @param success A block object to be executed when the request operation finishes successfully. This block has no return value and takes a single argument: the OAuth credential returned by the server. |
| 117 | + @param failure A block object to be executed when the request operation finishes unsuccessfully, or that finishes successfully, but encountered an error while parsing the response data. This block has no return value and takes a single argument: the error returned from the server. |
| 118 | + */ |
| 119 | +- (NSURLSessionTask *)authenticateUsingOAuthWithURLString:(NSString *)URLString |
| 120 | + scope:(NSString *)scope |
| 121 | + success:(void (^)(AFOAuthCredential *credential))success |
| 122 | + failure:(void (^)(NSError *error))failure; |
| 123 | + |
| 124 | +/** |
| 125 | + Creates and enqueues an `NSURLSessionTask` to authenticate against the server with the specified parameters. |
| 126 | +
|
| 127 | + @param URLString The URL string used to create the request URL. |
| 128 | + @param parameters The parameters to be encoded and set in the request HTTP body. |
| 129 | + @param success A block object to be executed when the request operation finishes successfully. This block has no return value and takes a single argument: the OAuth credential returned by the server. |
| 130 | + @param failure A block object to be executed when the request operation finishes unsuccessfully, or that finishes successfully, but encountered an error while parsing the response data. This block has no return value and takes a single argument: the error returned from the server. |
| 131 | + */ |
| 132 | +- (NSURLSessionTask *)authenticateUsingOAuthWithURLString:(NSString *)URLString |
| 133 | + parameters:(NSDictionary *)parameters |
| 134 | + success:(void (^)(AFOAuthCredential *credential))success |
| 135 | + failure:(void (^)(NSError *error))failure; |
| 136 | + |
14 | 137 | @end |
| 138 | + |
| 139 | +NS_ASSUME_NONNULL_END |
0 commit comments