Skip to content

🔐 Simple OAuth2 library with a support of multiple services.

License

Notifications You must be signed in to change notification settings

hyperoslo/OhMyAuth

Folders and files

NameName
Last commit message
Last commit date

Latest commit

4f2e812 · Sep 27, 2018
Oct 17, 2016
Aug 21, 2018
Feb 5, 2016
Nov 9, 2017
Aug 21, 2018
Oct 31, 2016
Feb 3, 2016
Oct 30, 2017
Jun 19, 2017
Feb 5, 2016
Oct 30, 2017
Oct 30, 2017
Feb 3, 2016
Oct 30, 2017
Sep 27, 2018
Oct 30, 2017

Repository files navigation

OhMyAuth

⚠️ DEPRECATED, NO LONGER MAINTAINED

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, ios@hyper.no

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, ios@hyper.no

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.