GAuth

KO | EN

gitlite — search

#python #javascript #mysql #docker #java #deep-learning #nodejs #vue #vuejs #api #html #express

★ 12 Open GitHub ↗

Make authentication with Google Services easier.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![Twitter](https://img.shields.io/badge/twitter-@iamfabiomilano-blue.svg?style=flat)](http://twitter.com/iamfabiomilano)
[![Carthage Compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)
[![CocoaPods Compatible](https://img.shields.io/cocoapods/v/GAuth.svg)](https://img.shields.io/cocoapods/v/GAuth.svg)
[![Platform](https://img.shields.io/cocoapods/p/GAuth.svg?style=flat)](http://cocoadocs.org/docsets/GAuth)

# GAuth

GAuth is small framework that makes authentication to Google Services easier by properly implementing the OAuth authentication flow described in [Google's Developers website](https://developers.google.com/identity/protocols/OAuth2InstalledApp).

GAuth is not about to provide yet another Swift OAuth client but to easily integrate authentication to Google Services for the OAuth client already used in your project.

# Cloning the repo 
To give `GAuth` a shot follow this steps:

1. Clone the repo.
2. Open the terminal and move to the `GAuth` folder.
3. To setup all required dependencies run `make setup`.
4. Open the `GAuth.xcworkspace`, build and run.

# Installation

Add via [CocoaPods](https://cocoapods.org/) by adding this to your Podfile:

```
pod 'GAuth'
```

If using [Carthage](https://github.com/Carthage/Carthage), add following line into your Cartfile:

```
github "fabiomassimo/GAuth"
```

# How to use it

Integrate GAuth by making your OAuthClient ([OAuthSwift](https://github.com/OAuthSwift/OAuthSwift), [SwiftyOAuth](https://github.com/delba/SwiftyOAuth)) conform to `GoogleAuthenticatorOAuthClient`.

Finally authorize your device via the `GoogleAuthenticatorClient` by passing the proper OAuth client.

See the example project (using [OAuthSwift](https://github.com/OAuthSwift/OAuthSwift) to see how it works in details.

# Support for Limited Input Device Applications

GAuth cares to support all platforms therefore it also implements the [Device Authentication Flow](https://tools.ietf.org/html/draft-ietf-oauth-v2-01#section-3.5.3) for devices that can not support the standard authorization flows (i.e. tvOS which does not include WebKit framework).

# Roadmap

- [x] Include code example
- [ ] Add more Google Service Scope.
- [ ] Add Travis CI/Circle CI to the repo
- [ ] Add support for Swift 3

# Credits

GAuth's primary author is Fabio Milano, iOS Engineer at [Touchwonders](http://www.touchwonders.com).

GAuth was inspired from the need of having a simple framework that could support all type of platforms and easily integrate with an existing OAuth client.

# License

GAuth is available under the MIT license. See the LICENSE file for more info.

GAuth

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README