implicity v0.0.1

Implicity

WORK IN PROGRESS.

Implicity is the API backend for Simplicity, an iOS framework for easy mobile authentication via external providers.

With Implicity, any redirect-based login flow is turned into an "Implicit" style OAuth grant, hence the name "Implicity". This means that you can use any redirect-based login flow with your iOS app.

While Implicity is designed to work with Simplicity, you can also use it with Android and frontend web apps.

Why Use Implicity?

To get an access token for a user, some redirect-based login providers (for instance, LinkedIn) will not redirect a user back to a mobile app. To successfully get an access token, you need to complete the server-side OAuth flow, which Implicity performs for you. Some login providers require server-side secrets to make an API call to get an access token. Again, Implicity will handle that for you.

Also, Implicity seamlessly works with Simplicity, meaning that you can use one library to do login for many different login providers.

Logging in with Simplicity + Implicity is as easy as:

let apiURL = NSURL("https://yourserver.io/")!
let implicity = Implicity(url: apiURL, appId: "12345")

Simplicity.login(implicity.provider(.Google)) { (accessToken, error) in
  // Handle access token here
}

Stormpath

Simplicity is maintained by Stormpath, an API service for authentication, authorization, and user management. If you're building a backend API for your app, consider using Stormpath to help you implement a secure REST API. Read our tutorial on how to build a REST API for your mobile apps using Node.js.