# implicity

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

Latest version **0.0.1** (published 2016-06-09) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install implicity
pnpm add implicity
yarn add implicity
bun add implicity
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.0.1 |
| Published | 2016-06-09 |
| First published | 2016-06-09 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 2 |
| Author | Edward Jiang |
| Maintainers | edjiang |

## Links

- npm: https://www.npmjs.com/package/implicity
- Repository: https://github.com/SimplicityMobile/Implicity
- Homepage: https://github.com/SimplicityMobile/Implicity#readme
- Issues: https://github.com/SimplicityMobile/Implicity/issues
- npm.io page: https://npm.io/package/implicity

## Recent versions

- 0.0.1 (latest) — 2016-06-09

## README

# 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: 

```Swift
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](https://stormpath.com), 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](https://stormpath.com/blog/tutorial-build-rest-api-mobile-apps-using-node-js).

##

---
_Source: https://npm.io/package/implicity · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._