nicosabena / lock-twitter.ios

Lock for iOS add-on to use Twitter iOS integration

Lock-Twitter

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-Twitter helps you integrate native Login with Twitter and Lock

Usage

Requierements

iOS 9+

Install

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

pod "Lock-Twitter", "~> 2.0"

Usage

Twitter authentication use Reverse Auth to obtain a valid access_token that can be sent to Auth0 Server and validate the user.

First create a new instance of A0TwitterAuthenticator

NSString *twitterApiKey = ...
A0TwitterAuthenticator *twitter = [A0TwitterAuthenticator newAuthenticationWithConsumerKey:twitterApiKey];

let twitterApiKey = ... //Remember to obfuscate your api key
let twitter = A0TwitterAuthenticator.newAuthentication(withConsumerKey: twitterApiKey)

and register it with your instance of A0Lock if native integration is available

A0Lock *lock = ... //Get your instance of A0Lock
if ([A0TwitterAuthenticator canUseNativeTwitterAuthentication]) {
    [lock registerAuthenticators:@[twitter]];
}

let lock = ... //Get your instance of A0Lock
if A0TwitterAuthenticator.canUseNativeTwitterAuthentication() {
    lock.registerAuthenticators([twitter])
}

Localization

For the case when there are more than one twitter account, Lock-Twitter will let the user choose one use an action sheet. Here are the keys you need to add to your Localizable.strings file

• com.auth0.lock.integration.twitter.choose-account.title: Title when choosing from multiple accounts
• com.auth0.lock.integration.twitter.choose-account.cancel: Cancel button title of the action sheet

Also when there are no accounts, Lock-Twitter will show an alert with an error that can be customizable with the following keys:

• com.auth0.lock.integration.twitter.choose-account.no-account.title: Title when no twitter account is found in the iOS device
• com.auth0.lock.integration.twitter.choose-account.no-account.message: Messsage when no twitter account is found in the iOS device

##API

###A0TwitterAuthenticator

####A0TwitterAuthenticator#canUseNativeTwitterAuthentication:

+ (BOOL)canUseNativeTwitterAuthentication;

Checks if it twitter native integration is available in the device.

BOOL canUse = [A0TwitterAuthenticator canUseNativeTwitterAuthentication];

let canUse = A0TwitterAuthenticator.canUseNativeTwitterAuthentication()

####A0TwitterAuthenticator#newAuthenticatorWithConsumerKey:

+ (A0TwitterAuthenticator *)newAuthenticatorWithConsumerKey:(NSString *)key;

Create a new 'A0TwitterAuthenticator' using a Twitter API key for the default twitter connection name.

A0TwitterAuthenticator *twitter = [A0TwitterAuthenticator newAuthenticatorWithConsumerKey:@"KEY"];

let twitter = A0TwitterAuthenticator.newAuthenticator(withConsumerKey: "KEY")

####A0TwitterAuthenticator#newAuthenticatorWithConnectionName:consumerKey:

+ (A0TwitterAuthenticator *)newAuthenticatorWithConnectionName:(NSString *)connectionName consumerKey:(NSString *)consumerKey;

Create a new 'A0TwitterAuthenticator' using a Twitter API key and a connection name.

A0TwitterAuthenticator *twitter = [A0TwitterAuthenticator newAuthenticatorWithConnectionName:@"my-twitter" consumerKey:@"KEY"];

let twitter = A0TwitterAuthenticator.newAuthenticator(withConnectionName: "my-twitter", consumerKey: "KEY")

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-Twitter is available under the MIT license. See the LICENSE file for more info.