Skip to content

Latest commit

 

History

History
126 lines (96 loc) · 4.01 KB

README.md

File metadata and controls

126 lines (96 loc) · 4.01 KB
Raw

OhMyAuth

CI Status Version Carthage Compatible License Platform

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 SafariWebView it 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.userUPN

And 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.