Lock for iOS add-on to use Google SignIn iOS SDK
Clone or download
cocojoe Merge pull request #19 from nicosabena/patch-1
Added deprecation notice
Latest commit 58d8826 Aug 11, 2017
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
LockGoogle.xcodeproj Update Pods Jan 9, 2017
LockGoogle.xcworkspace Standalone project for LockGoogle.framework Aug 15, 2015
LockGoogle Release 3.0.0 Jan 23, 2017
LockGoogleApp Release 3.0.0 Jan 23, 2017
LockGoogleTests Release 3.0.0 Jan 23, 2017
.gitignore Create project for lib May 18, 2015
.travis.yml Silence pod update Jan 9, 2017
CHANGELOG.md Release 3.0.0 Jan 23, 2017
LICENSE Update LICENSE Jan 27, 2016
Lock-Google.podspec Update Pods Jan 9, 2017
Podfile Update Pods Jan 9, 2017
Podfile.lock Update Pods Jan 9, 2017
README.md Added deprecation notice Aug 9, 2017

README.md

Lock-Google

Build Status Version License Platform

Auth0 is an authentication broker that supports social identity providers as well as enterprise identity providers such as Active Directory, LDAP, Google Apps and Salesforce.

Lock-Google helps you integrate native login with Google iOS SDK and Lock

Deprecation notice

This package relies on a token endpoint that is now considered deprecated. If your Auth0 client was created after Jun 8th 2017 you won't be able to use this package. This repository is left for reference purposes.

We recommend using browser-based flows to authenticate users. You can do that using the auth0.swift package, as explained in this document.

Requirements

iOS 7+

Install

The Lock-Google is available through CocoaPods. To install it, simply add the following line to your Podfile:

CocoaPods

pod "Lock-Google", "~> 3.0"

Swift & Frameworks

If you are using CocoaPods with the uses_frameworks! flag in your Podfile, adding Lock-Google might make CocoaPods fail because Google SignIn library is distributed as a static lib. A workaround for this case is to add the following files to your project:

And Google SignIn library to your project or to your Podfile like this:

pod 'Google/SignIn', '~> 3.0'

Before you start using Lock-Google

In order to use Google APIs you'll need to register your iOS application in Google Developer Console and get your clientId. We recommend follwing this wizard instead and download the file GoogleServices-Info.plist that is generated at the end.

Add that file to your application's target and the last step is to register two custom URL for your application.

The first URL should have a scheme equal to your application Bundle Identifier, the other one should be your Google clientId reversed, so if your clientID is CLIENTID.apps.googleusercontent.com the scheme will be com.googleusercontent.apps.CLIENTID

This last value can be found in GoogleServices-Info.plist under the key REVERSED_CLIENT_ID For more information please check Google's documentation

Auth0 Connection with multiple Google clientIDs (Web & Mobile)

If you also have a Web Application, and a Google clientID & secret for it configured in Auth0, you need to whitelist the Google clientID of your mobile application in your Auth0 connection. With your Mobile clientID from Google, go to Social Connections, select Google and add the clientID to the field named Allowed Mobile Client IDs

Usage

Just create a new instance of A0GoogleAuthenticator

A0GoogleAuthenticator *google = [A0GoogleAuthenticator newAuthenticator];
let google = A0GoogleAuthenticator.newAuthenticator()

and register it with your instance of A0Lock

A0Lock *lock = //Get your A0Lock instance
[lock registerAuthenticators:@[google]];
let lock:A0Lock = //Get your A0Lock instance
lock.registerAuthenticators([google])

A good place to create and register A0GoogleAuthenticator is the AppDelegate.

###Specify scopes

A0GoogleAuthenticator *google = [A0GoogleAuthenticator newAuthenticatorWithScopes:@[@"scope1", @"scope2"]];
let google = A0GoogleAuthenticator.newAuthenticatorWithScopes(["scope1", "scope2"])

###Custom Google connection

A0GoogleAuthenticator *google = [A0GoogleAuthenticator newAuthenticatorForConnectionName:@"my-google-connection"];
let google = A0GoogleAuthenticator.newAuthenticatorForConnectionName("my-google-connection")

Please check CocoaDocs for more information about LockGoogle API.

Issue Reporting

If you have found a bug or if you have a feature request, please report them at this repository issues section. Please do not report security vulnerabilities on the public GitHub issue tracker. The Responsible Disclosure Program details the procedure for disclosing security issues.

What is Auth0?

Auth0 helps you to:

  • Add authentication with multiple authentication sources, either social like Google, Facebook, Microsoft Account, LinkedIn, GitHub, Twitter, Box, Salesforce, amont others, or enterprise identity systems like Windows Azure AD, Google Apps, Active Directory, ADFS or any SAML Identity Provider.
  • Add authentication through more traditional username/password databases.
  • Add support for linking different user accounts with the same user.
  • Support for generating signed Json Web Tokens to call your APIs and flow the user identity securely.
  • Analytics of how, when and where users are logging in.
  • Pull data from other sources and add it to the user profile, through JavaScript rules.

Create a free account in Auth0

  1. Go to Auth0 and click Sign Up.
  2. Use Google, GitHub or Microsoft Account to login.

Author

Auth0

License

Lock-Google is available under the MIT license. See the LICENSE file for more info.