Use this documentation to help integrate Janrain social login and registration with your native Android or iOS mobile applications. This is an SDK with libraries and tools designed to help you build such applications. If you want to create a mobile version of your web applications, you need to refer to the Embed UI in a Webview section for the respective platform.
The Janrain User Management Platform (JUMP) includes the Engage and Capture widgets. Engage enables Social Sign-in, and Capture provides User Registration so you can gather information about your users. Federate is another component of JUMP that allows you to make a group of related websites work together. Our documentation often refers to Engage and Capture as separate widgets or applications, but they work together.
This page provides an overview of the Janrain Mobile Libraries, and how to use them.
Janrain Engage — part of the Janrain User Management Platform (JUMP) — is a user authentication service for the web. Engage unifies the interface to different social sign-in providers (such as Facebook and Google) and presents a unified, simplified interface which allows developers to add social sign-in to their websites easily.
Janrain provides two mobile libraries — JUMP for iOS and JUMP for Android — that bring the advantages of the Engage service to native-mobile applications. With these libraries, developers can authenticate their users on multiple providers and share their activities through Janrain’s unified API.
Along with the Engage mobile library, developers should implement their own server authentication endpoint or use Capture as their back end to manage user sessions within their mobile application.
The following components are involved in social sign-in and sharing for Engage:
* Look at the sample applications for more ideas.
During sign-in, the JUMP mobile libraries open a dialog presenting the end user with a list of providers for which the application is configured. The user chooses a provider, and then the libraries take him or her to an embedded web browser displaying the social provider’s sign-in page. Once the user signs in, the JUMP mobile libraries process the results and pass them back to your application and close the dialog. The libraries then post an Engage auth_info token to your application’s server (or to Capture) to complete the authentication.
Important: Engage authenticates users, but does not manage user sessions.
The JUMP mobile libraries provide screens, using native user interface elements, for sharing on the user’s social networks. Your users can share messages, and links (as well as Facebook activities) to Facebook, Yahoo!, Twitter, Myspace, and LinkedIn, as well as sharing through SMS or email.
Note: The JUMP mobile libraries’ native sharing User Experience (UX) supports only broadcast sharing at this time. Sharing with specific contacts only is not supported yet.
Janrain Capture — part of the Janrain User Management Platform (JUMP) — is a user management service for the web. It provides a customizable user data-store with a rich set of features including:
Janrain has provided Capture support in the JUMP for iOS library, which brings the advantages of Capture to the iOS device. With this library, developers can authenticate their users on multiple providers and manage the user’s record through Janrain’s unified API.
The following components are the main actors involved in Capture mobile integration:
* A sample comes with the library.
The JUMP for iOS library “wraps” the Engage mobile library module when integrating Capture into your mobile application. Instead of independently configuring and connecting the Engage and Capture modules, the Engage wrapper in the Capture module configures both Engage and Capture and connects them automatically.
The JUMP for iOS library creates a user model, in Objective-C, from your Capture schema. The user model stores the full Capture record on the device and includes methods to easily push local changes to your Capture server.
This section describes the user flow and its features.
The JUMP mobile libraries give your application the ability to authenticate users through their existing social identity provider accounts — Google, Facebook, Twitter, and so on. When you are ready to authenticate a user, the libraries present a modal dialog displaying a list of the providers that are configured in your Engage application. The user can select their desired provider and sign in through the provider’s web interface.
The screenshots below show the sign-in process on the iPhone:
The screenshots below show the sign-in process on Android:
Additionally, the JUMP mobile libraries include native social sharing screens, giving your users the ability to share their activities on their social networks. You can compose an activity, and when you are ready, the library presents a modal dialog that allows your users to add their comments and share the activity. In addition to sharing through the user’s social network, they can share by email and SMS.
Figure 3 below shows social sharing on the iPhone:
For an example application demonstrating how you can share an activity with the JUMP for iOS library, see the Janrain Quick Publish* app, available for free in the iTunes AppStore.
Here are links to our documentation to get you started.
The screenshots below show social sharing on Android:
JUMP can run on iPad and Android tablets as well.
The Engage for iOS SDK also works, as is, on the iPad and with universal apps. No changes to your code are required. The library dynamically detects the device and presents its dialogs in modal views optimized for the iPad.
Figure 5 below show sign-in and social sharing on the iPad.
Here is a link to our documentation about prerequisites.
Since release 2.0, the Engage for Android library has included support for Android tablets. Tablet screens are supported automatically with the use of modal dialogs, and the sharing interface is embeddable as an Android fragment.
The JUMP for iOS library provides Capture user management to your iOS application, giving you the ability to authenticate your users on social providers and interact with the user’s record and session locally and remotely.
Janrain sign-in, sharing, and other applications all have flow, that is, user screens, presented to the end-user in a particular order.
Here are links to our documentation to get you started.
* If your Capture instance does not require information such as an email address, this scenario does not occur.