auth0 / 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

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.

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.

lock-twitter.ios's Issues

Authentication cancelled when twitter app is installed without a session

[SLComposeViewController isAvailableForServiceType:SLServiceTypeTwitter] returns YES so we need a way to tell that there is no session in twitter app.

Also we need to define what to do, my first approach will be to tell the user to login there first

Lock-Twitter does not compile with the latest version (1.27) of Lock

AUTH0_DYNAMIC_LOGGER_METHODS was removed from Lock and did not from Lock-Twitter

PSPDFActionSheet does not work for iPad

Preconditions:

• I have 2 Twitter accounts on my iPad

I can not choose Twitter account from list of available Twitter accounts on my device because PSPDFActionSheet does not work for iPad. And that's why I can not login to Twitter with A0TwitterAuthenticator at all

Issue to build on Swift/iOS9/XCode7.1.1

I am having an issue to build the module successfully for iOS 9 in XCode 7.1.1 with Swift.

Could not find any extra steps in the repo readme, and neither at the Cocoapod documentation.
The Podfile i am using is attached.
What do you suggest? Regards

Podfile.txt

Issue while building Lock-Twitter as a Cocoa Touch Framework

When building the library as a Cocoa Touch Framework, it fails when linking the library to CocoaLumberjack. This is because CocoaLumberjack is not a declared dependency.

First time login error

I've found that when the app requests access to my Twitter accounts (via the standard UI), I then have to click login again to continue.

Use Swift module name "LockTwitter"

Authentication crashes when Twitter app is installed

Preconditions:

• I have installed Twitter app in my iPad
• Removed all Twitter accounts from my device settings

Then I launch my test app and try to login to Twitter with A0TwitterAuthenticator
My app crashes with log:

2016-07-29 20:36:21:608 AKAuth0TestApp[4684:1057695] Requesting access to iOS Twitter integration for Accounts
2016-07-29 20:36:21:700 AKAuth0TestApp[4684:1057827] Obtained 0 accounts from iOS Twitter integration
2016-07-29 20:36:21:700 AKAuth0TestApp[4684:1057827] Only one account found, no need for the user to pick one
2016-07-29 20:36:21:700 AKAuth0TestApp[4684:1057827] Starting reverse authentication with Twitter account @(null)...
2016-07-29 20:36:21.705 AKAuth0TestApp[4684:1057827] *** Assertion failure in +[TWAPIManager performReverseAuthForAccount:withHandler:], /Users/juliya/Akvelon/auth0/Auth0_iOS_Sample/Auth0/AKAuth0TestApp/Pods/TWReverseAuth/TWReverseAuth/TWAPIManager.m:89
2016-07-29 20:36:21.707 AKAuth0TestApp[4684:1057827] *** Terminating app due to uncaught exception 'NSInternalInconsistencyException', reason: 'Invalid parameter not satisfying: account'

This issue maybe relates to #6