OhMyAuth
Description
Simple OAuth2 library with a support of multiple services.
Usage
- Setup:
let config = AuthConfig(
clientId: "client-id",
accessTokenUrl: NSURL(string: "access-token-url")!,
accessGrantType: "authorization_code",
authorizeURL: NSURL(string: "authorise-url")!,
changeUserURL: NSURL(string: "change-user-url")!,
redirectURI: "yourapp://auth")
config.extraAccessTokenParameters = ["resource": "resource"]
config.extraRefreshTokenParameters = ["resource": "resource"]
let service = AuthService(name: "service", config: config)
AuthContainer.addService(service)- Safari app will be opened by default for authorization, if it's iOS9 and you'd
like to use
SFSafariViewController, there is a ready-to-use class for you:
// SFSafariViewController will be presented on top of provided controller
service.config.webView = SafariWebView(viewController: viewController)- Show a login web page:
AuthContainer.serviceNamed("service")?.authorize()- Handle response. If you use
SafariWebViewit will be dismissed automagically:
func application(app: UIApplication, openURL url: NSURL, options: [String : AnyObject]) -> Bool {
AuthContainer.serviceNamed("service")?.accessToken(URL: url) { accessToken, error in
if let accessToken = accessToken where error == nil {
// User is logged in!!!
}
}
}- Get an access token to include it in the each request. If token is about to expire it will be refreshed automagically, so you always get an active token is the completion closure:
AuthContainer.serviceNamed("service")?.accessToken(completion)- If you need to change user and have a separate URL for that:
AuthContainer.serviceNamed("service")?.changeUser()- If you don't have authorisation by code, but by username and password, there is a flow:
let config = AuthConfig(
clientId: "client-id",
accessTokenUrl: NSURL(string: "access-token-url")!,
accessGrantType: "password")
let service = AuthService(name: "service", config: config)
AuthContainer.addService(service)
let parameters = ["username": "weirdo", "password": "123456"]
service.accessToken(parameters: parameters) { accessToken, error in
// Ready!
}- If you need to get your tokens, expiry date, username, user UPN:
let accessToken = AuthContainer.serviceNamed("service")?.locker.accessToken
let userUPN = AuthContainer.serviceNamed("service")?.locker.userUPNAnd yeah, you could add as many auth services as you want if you have some crazy setup in the app. Just register a new one with a different name:
let service = AuthService(name: "another-service", config: config)Author
Hyper Interaktiv AS, [email protected]
Installation
OhMyAuth is available through CocoaPods. To install it, simply add the following line to your Podfile:
pod 'OhMyAuth'OhMyAuth is also available through Carthage. To install just write into your Cartfile:
github "hyperoslo/OhMyAuth"Author
Hyper Interaktiv AS, [email protected]
Contributing
We would love you to contribute to OhMyAuth, check the CONTRIBUTING file for more info.
License
OhMyAuth is available under the MIT license. See the LICENSE file for more info.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent