Social Login Overview

Social login enables users to register on your web site by using an account created with a third-party identity provider (IDP). For example, instead of creating a new site-specific user name and password just for your site, users can register by using an existing Facebook or Twitter account.

You can use the Engage Dashboard to configure the identity providers users can employ to register or to log on to your site. Because setup requirements for identity providers differ we have put together configuration guides for each Janrain-compatible IDP. Links to these configuration guides are shown in the table below. In addition, the table also:

  • Lists the identity provider’s string specifier. This value is required when using the Social APIs to manage social login.

  • Indicates whether you need to create an app in order to configure the provider for social logon.

  • Specifies whether you can choose which user data is returned by an identity provider.

In the table you will also see a handful of providers with the entry N/A in each column. These are identity providers that no longer offer social login but are still shown in the Engage Dashboard. Other providers are marked by asterisks. For information on these providers, contact your Janrain representative.

Following are the identity providers available in the Engage Dashboard, as well as links to their respective configuration guides:

Provider String Specifier App Required Return Data Customizable
Amazon amazon Yes Yes
AOL aol Yes
Blogger blogger
Disqus disqus Yes
DocCheck doccheck *** ***
Doximity doximity
Facebook facebook Yes Yes
Flickr flickr
Fimnet fimnet *** ***
Foursquare foursquare Yes
Google+ googleplus Yes Yes
Instagram instagram Yes Yes
LinkedIn linkedin Yes Yes
LiveJournal livejournal
MediKey medikey *** ***
Medy medy *** ***
Microsoft Account microsoftaccount Yes Yes
Mixi mixi Yes Yes
Odnoklassniki odnoklassniki Yes Yes
OneKey onekey *** ***
OpenID openid
PayPal paypal_openidconnect *** ***
QQ qq Yes
Renren renren Yes
Salesforce salesforce Yes
Sina Weibo sina weibo Yes
SoundCloud soundcloud Yes Yes
Tencent Weibo N/A N/A N/A
Tumblr tumblr Yes
Twitter twitter Yes
VK vk Yes Yes
WeChat wechat Yes
WordPress N/A N/A N/A
Xing xing Yes
Yahoo! yahoo Yes

Amazon Social Login Configuration Guide

Amazon is both the largest Internet retailer in the world and the world’s No. 1 provider of cloud computing services.

Before You Begin

To use Amazon for social login you must:

  1. Obtain an Amazon developer account from https://sellercentral.amazon.com.
  2. Do one of the following:
    • Open a previously-created Amazon application and copy the client ID and client secret.
    • Create a new application and copy the client ID and client secret.

  3. Use the Janrain Engage Dashboard and the Amazon client ID and client secret to configure Amazon as a social login provider.

In This Configuration Guide

Creating an Amazon Application

This section walks you through the process of creating an Amazon application for social login. If you already have an application, see the Using an Existing Amazon Application for Social Login section of this documentation.

To create an Amazon application, complete the following procedure:

  1. Log on to the Amazon Applications Center (https://sellercentral.amazon.com).
  2. From the Applications page, click Register new application:

    Creating an Amazon App
  3. On the Register Your Application page, enter:

    • The name of your application in the Name field.
    • A brief description of your application in the Description field.

  4. Click Save:

    Creating an Amazon App
  5. Expand the Web Settings section:

    Creating an Amazon App
  6. In the Web Settings section, copy and save the Client ID. You can copy the ID to a text editor, then close the text editor after you have configured Janrain social login.

  7. Click Show Secret.

  8. In the Client Secret dialog box, click Select All and then copy the client secret to the clipboard. You can copy this information to a text editor, then close the text editor after you have configured Janrain social login:

    Creating an Amazon App
  9. Enter your Amazon callback URL in the Allowed Returns URLs field and then click Save. If you are using a standard Janrain domain, your redirect URL will look similar to this: https://greg-stemp.rpxnow.com/amazon/callback:

    Creating an Amazon App
  10. Log off from the Amazon Applications center.

Use an Existing Amazon Application

If you already have a social login application, complete the following steps to retrieve the application’s client ID and client secret:

  1. Log on to the Amazon Applications center https://sellercentral.amazon.com.
  2. From the Applications page, click the name of the app you want to use for social login:

    Use an Existing Amazon App
  3. From the home page for your application, in the Web Settings section, copy the Client ID. You can copy this information to a text editor, then close the text editor after you have configured Janrain social login:

    Use an Existing Amazon App
  4. Click Show Secret.

  5. In the Client Secret dialog box, click Select All and then copy the client secret to the clipboard. You can copy this information to a text editor, then close the text editor after you have configured Janrain social login:

    Use an Existing Amazon App
  6. Log off from the Amazon Applications center.

Configure Amazon as a Social Login Provider

To configure Amazon as a social login provider, make sure you have your Amazon client ID and client secret, and then complete the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. From the list of Providers, click Amazon.
  6. In the Amazon dialog box, click Next until you reach the screen requesting the client ID and client secret:

    The Configure Amazon Dialog Box
  7. Paste your Amazon client ID in the Client ID field, paste your Amazon client secret in the Client Secret field, and then click Save. Amazon appears in your social login widget.

  8. When you are finished, select Save and Publish and then click Publish. It might take as long as one hour before Amazon appears as a social login option for your web site.

Testing Amazon Social Login

To test Amazon social login, complete the following procedure:

  1. Do one of the following:

    • If you have just published your widget settings, click the Test your widget link that appears after the widget has been saved.
    • If you previously published your widget settings then, from the Engage Dashboard Sign-in page, click Launch a test widget.

  2. From the Test page, click the Amazon icon:

    Testing Amazon Logins
  3. In the Amazon.com Sign In window, logon using a valid Amazon account:

    Testing Amazon Logins
  4. If login succeeds, information returned from the Amazon profile is displayed in the API response preview field:

    Amazon API Response Preview

The returned profile information will vary depending on:

  • The Amazon account used in the test.
  • The profile information you requested for Amazon.

You can verify Amazon profile fields by completing the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click Amazon.

  3. Profile information returned from Amazon is displayed onscreen. For example:

    Amazon Basic Profile

Fields not marked with an Off or an Ask label are automatically returned when a user logs on using an Amazon account.

For fields that are marked with a label, click Off to request that the information be returned. The Off label will change to Ask, meaning that, at logon time, the user will be asked whether he or she gives permission for that data to be returned:

Amazon Permission Required Fields

For example, if you ask for a user’s address during logon, he or she will see the following message before they log on:

Testing Amazon Logins

The user can either click Okay to forward all the requested information, or can click Cancel to terminate logon.

On the Configure Providers page, click Ask to turn off the information request.

See Also

Assigning a Different Amazon Application for Social Login

If you want to use a different Amazon application or if you need to change your existing application, you must update the Amazon provider configuration settings. To do that, complete the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. On the Configure Providers page, click Amazon.

  3. Click the green Configured button to display the Amazon is currently enabled dialog box:

    The Modify Amazon Dialog Box
  4. To change the Amazon configuration, click Modify these settings.

  5. In the Amazon dialog box, change the Client ID and/or Client Secret as needed, and then click Save:

    The Configure Amazon Dialog Box

Although you can modify your Amazon settings, you cannot delete these settings. If you delete the settings and try to save your changes, you’ll see the error message Please enter your Consumer Key and Secret exactly as Amazon shows them.

This means that you cannot “unconfigure” the provider: once configured, the Amazon icon will always be shown as green (i.e., configured) in the Janrain Dashboard.

Removing Amazon as a Social Login Provider

If you no longer want to use Amazon for social login, you can remove Amazon as a social login provider by completing the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. In the widget, click the X in the upper right corner of the Amazon icon.
  6. Scroll to the bottom of the page, select Save and Publish, and then click Publish. Amazon no longer appears in the sign-on widget.

Note. You must always have at least one social login provider in the widget. If you delete all the providers and then click Publish, you’ll see the error message Couldn’t save configuration: No providers.


AOL Social Login Configuration Guide

AOL (formerly America Online) is a US-based web services provider. Approximately 4.5 million people have AOL Mail accounts.

Before You Begin

To use AOL for social login you must:

  • Use the Janrain Dashboard to enable AOL as a social login provider. No additional configuration is required.

In This Configuration Guide

Configuring AOL as a Social Login Provider

To configure AOL as a social login provider, complete the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. From the list of Providers, click AOL. AOL appears in your social login widget.
  6. When you are finished, select Save and Publish and then click Publish. It might take as long as one hour before AOL appears as a social login option on your web site.

See Also

Testing AOL Social Login

To test AOL social login, complete the following procedure:

  1. Do one of the following:

    • If you have just published your widget settings, click the Test your widget link that appears after the widget has been saved.
    • If you previously published your widget settings then, from the Engage Dashboard Sign-in page, click Launch a test widget.

  2. From the Test page, click the AOL icon:

    Testing AOL Logins
  3. In the Sign In window, logon to AOL using a valid AOL account:

    Testing AOL Logins
  4. If login succeeds, information returned from the AOL profile is displayed in the API response preview field:

    AOL API Response Preview

The returned profile information will vary depending on:

  • The AOL account used in the test.
  • The profile information you requested for AOL.

You can verify your AOL profile fields by completing the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click AOL.

  3. Profile information returned from AOL is displayed onscreen. For example:

    AOL Basic Profile

Fields not marked with an Off or an Ask label are automatically returned when a user logs on using an AOL account.

For fields that are marked with a label, click Off to request that the information be returned. The Off label will change to Ask, meaning that, at logon time, the user will be asked whether he or she gives permission for that data to be returned:

AOL Permission Required Fields

For example, if you ask for a user’s email address during logon, he or she will see the following message before they log on:


Testing AOL Logins

The user can either click Continue to forward all the requested information, or can click Cancel to terminate logon.

On the Configure Providers page, click Ask to turn off the information request.

See Also

Removing AOL as a Social Login Provider

If you no longer want to use AOL for social login, you can remove AOL as a social login provider by completing the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. In the widget, click the X in the upper right corner of the AOL icon.
  6. Scroll to the bottom of the page, select Save and Publish, and then click Publish. AOL no longer appears in the sign-on widget.

Note. You must always have at least one social login provider in the widget. If you delete all the providers and then click Publish, you’ll see the error message Couldn’t save configuration: No providers.


Blogger Social Login Configuration Guide

Blogger is a blog-publishing website owned by Google. Over 700,000 web sites use Blogger.

Before You Begin

To use Blogger for social login you must:

  • Use the Janrain Dashboard to configure Blogger as a social login provider. No additional configuration is required.

In This Configuration Guide

Configuring Blogger as a Social Login Provider

To configure Blogger as a social login provider, complete the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. From the list of Providers, click Blogger. Blogger appears in your social login widget.
  6. When you are finished, select Save and Publish and then click Publish. It might take as long as one hour before Blogger appears as a social login option on your web site.

See Also

Testing Blogger Social Login

To test Blogger social login, complete the following procedure:

  1. Do one of the following:

    • If you have just published your widget settings, click the Test your widget link that appears after the widget has been saved.
    • If you previously published your widget settings then, from the Engage Dashboard Sign-in page, click Launch a test widget.

  2. From the Test page, click the Blogger icon:

    Testing Blogger Logins
  3. In the Blogger Sign-In window, logon using a valid Blogger account:

    Testing Blogger Logins
  4. If login succeeds, information returned from the Blogger profile is displayed in the API response preview field:

    Blogger API Response Preview

The returned profile information will vary depending on the Blogger account used in the test.

You can verify Blogger profile fields by completing the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click Blogger.

  3. Profile information returned from Blogger is displayed onscreen. For example:

    Blogger Basic Profile

See Also

Removing Blogger as a Social Login Provider

If you no longer want to use Blogger for social login, you can remove Blogger as a social login provider by completing the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. In the widget, click the X in the upper right corner of the Blogger icon.
  6. Scroll to the bottom of the page, select Save and Publish, and then click Publish. Blogger no longer appears in the sign-on widget.

Note. You must always have at least one social login provider in the widget. If you delete all the providers and then click Publish, you’ll see the error message Couldn’t save configuration: No providers.


Disqus

Disqus is a blog comment hosting service used by 3.5 million websites. Blog comment hosting services maintain comments posted by users in response to blogs and other online posts.

Before You Begin

To use Disqus for social login you must:

  1. Obtain a Disqus developer account from https://disqus.com/api.
  2. Do one of the following:
    • Open a previously-created Disqus application, and copy the API key and API secret.
    • Create a new application and copy the API key and API secret.

  3. Use the Janrain Engage Dashboard and the Disqus API key and API secret to configure Disqus as a social login provider.

In This Configuration Guide

Creating a Disqus Application

This section walks you through the process of creating a Disqus application for social login. If you already have an application, see the Using an Existing Disqus Application for Social Login portion of this documentation.

To configure a Disqus application, complete the following procedure:

  1. Log on to the Disqus API Resources site (https://disqus.com/api).
  2. From the API Resources page, click Get started with the Disqus API by registering an application:

    Creating a Disqus App
  3. On the Register Application page, enter:

    • The display name of your application in the Label field.
    • A brief description of your application in the Description field.
    • The URL for your application in the Website field.

    Creating a Disqus App
  4. Scroll to the bottom of the page, fill in the Recaptcha text, and then click Register my application:

    Creating a Disqus App
  5. From the Application Details page for your new app, on the Settings tab, scroll down to the Domains field and enter your application domains, one domain per line. One of your domains must be the application website minus the HTTP or HTTPS protocol (for example, greg-stemp.rpxnow.com):

    Creating a Disqus App
  6. In the Authentication section, click Default Access and then click Read and Write:

  7. Enter the Disqus redirect URL for your application in the Callback URL field. If you are using a standard Janrain domain, your redirect URL will look similar to this: https://greg-stemp.rpxnow.com/disqus/callback:

    Creating a Disqus App
  8. Enter the name of your organization in the Organization field and then click Save Changes:

    Creating a Disqus App
  9. On the Application Details page, click Details.

  10. On the Details tab, scroll down to the OAuth Settings section and then copy and save the API Key and API Secret. You can copy this information to a text editor, then close the text editor after you have configured Janrain social login:

    Creating a Disqus App
  11. Log off from the Disqus Applications center.

Using an Existing Disqus Application for Social Login

If you already have an Disqus application that can be used for social login, complete the following steps to retrieve the application’s secret key and public key:

  1. Log on to the Disqus API Resources site (https://disqus.com/api).

  2. From the API Resources page, click Applications:

    Use an Existing Disqus App
  3. From the Applications tab, locate the application you want to use to configure social login and then copy the Secret Key and Public Key. You can copy this information to a text editor, then close the text editor after you have configured Janrain social login:

    Use an Existing Disqus App

  4. Log off from the Disqus API Resources center.

Configuring Disqus as a Social Login Provider

To configure Disqus as a social login provider, make sure you have your Disqus API key and API secret, and then complete the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. From the list of Providers, click Disqus.
  6. In the Disqus dialog box, click Next until you reach the screen requesting the API key and API secret:

    The Configure Disqus Dialog Box
  7. Paste your Disqus API key in the API Key field, paste your Disqus API secret in the API Secret field, and then click Save. Disqus appears in your social login widget.

  8. When you are finished, select Save and Publish and then click Publish. It might take as long as one hour before Disqus appears as a social login option on your web site.

See Also

Testing Disqus Social Login

To test Disqus social login, complete the following procedure:

  1. Do one of the following:

    • If you have just published your widget settings, click the Test your widget link that appears after the widget has been saved.
    • If you previously published your widget settings then, from the Engage Dashboard Sign-in page, click Launch a test widget.

  2. From the Test page, click the Disqus icon:

    Testing Disqus Logins
  3. In the Disqus – Authorize an application window, logon using a valid Disqus account:

    Testing Disqus Logins
  4. If login succeeds, information returned from the Disqus profile is displayed in the API response preview field:

    Disqus API Response Preview

The returned profile information will vary depending on the Disqus account used in the test.

See Also

Assigning a Different Disqus App for Social Login

If you want to use a different Disqus app or if you need to change your existing app (perhaps because you have a new API secret) you must update the Disqus provider configuration settings. To do that, complete the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click Disqus.

  3. Click the green Configured button to display the Disqus is currently enabled dialog box:

    The Modify Disqus Dialog Box
  4. To change the Disqus configuration, click Modify these settings.

  5. In the Disqus dialog box, change the API Key and/or API Secret as needed, and then click Save:

    The Configure Disqus Dialog Box

Although you can modify your Disqus settings, you cannot delete those settings. If you delete the settings and then save your changes, you’ll see the error message Please enter your Consumer Key and Secret exactly as Disqus shows them.

This means that you cannot “unconfigure” the provider: once configured, the Disqus icon will always be shown as green (i.e., configured) in the Janrain Dashboard.

Removing Disqus as a Social Login Provider

You can remove Disqus as a social login provider by completing the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. In the widget, click the X in the upper right corner of the Disqus icon.
  6. Scroll to the bottom of the page, select Save and Publish, and then click Publish. Disqus no longer appears in the sign-on widget.

Note. you must always have at least one social login provider in the widget. If you delete all the providers and then click Publish, you’ll see the error message Couldn’t save configuration: No providers.


DocCheck

With more than 1,200,000 registered members, DocCheck is the largest community of health care professionals in Europe.

If you are interested in using DocCheck as a social login provider, please contact your Janrain representative.


Doximity

Doximity is an online community for health care professionals. More than 70% of US doctors belong to the Doximity community.

If you are interested in using Doximity as a social login provider, please contact your Janrain representative.


Facebook Social Login Configuration Guide

Facebook is the world’s largest social media network, with more than 2 billion active users each month.

Before You Begin

To use Facebook for social login you must:

  1. Obtain a Facebook developer account from https://developers.facebook.com.
  2. Do one of the following:
    • Open a previously-created Facebook app, and copy the app ID and app secret.
    • Create a new app and copy the app ID and app secret.

  3. Use the Janrain Dashboard and the Facebook app ID and app secret to configure Facebook as a social login provider.

In This Configuration Guide

Creating a Facebook App for Social Login

This section walks you through the process of creating a Facebook app for social login. If you already have an app, see the Using an Existing Facebook App for Social Login section of this documentation.

To configure a Facebook app for social login, complete the following procedure:

  1. Log on to Facebook for Developers.
  2. From the Facebook for Developers home page, click My Apps and then click Add a New App:

    Adding a New Facebook App
  3. In the Create a New App ID dialog box, enter the name of your new app in the Display Name field, enter your email address in the Contact Email field, and then click Create App ID:

    Creating a New Facebook App ID
  4. In the Security Check dialog box, type the Captcha text in the Enter the text you see above field and then click Submit:

    Completing the Facebook Security Check
  5. On the home page for your new app, expand Settings and then click Basic:

    Configuring Basic Facebook Settings
  6. From the Settings page, copy and save the application ID shown in the App ID box:

    Copying the Facebook App ID
  7. Click the Show button located next to the App Secret field:

    Showing the Facebook App Secret
  8. In the Please Re-enter Your Password dialog box, in the Password field, enter your password for the Facebook for Developers site:

    Re-entering your Facebook Password
  9. Copy and save the application secret shown in the App Secret box:

    Copying the Facebook App Secret
  10. Click + Add Platform:

    Adding a Facebook Platform
  11. In the Select Platform dialog box, click Website:

    Selecting the Website Platform
  12. In the Website section, type the URL for your website in the Site URL field, and then click Save Changes:

    Entering Your Web Site URL
  13. After the changes have been saved, then, in the navigation pane, click Advanced:

    Facebook Advanced Settings
  14. On the Advanced Settings page, select Allow API Access to App Settings and then click Save Changes:

    Enabling API Access
  15. In the navigation pane, click Dashboard to return to the home page for your app. From your app’s home page, click the Facebook Login product:

    Selecting the Facebook Login Product
  16. In the Use Quickstart dialog box, click Web:

    Selecting the Web Quickstart
  17. On the Quickstart page, in the Tell Us about Your Website, section type the URL for your web site in the Site URL field, click Save, and then click Continue:

    Entering Your Web Site URL
  18. In the navigation pane, expand Facebook Login and then click Settings:

    The Facebook Login Settings Page
  19. In the Client OAuth Settings section, verify that the following settings are set to Yes:

    • Client OAuth Login
    • Web OAuth Login
    • Use Strict Mode for Redirect URIs

    For example:

    Enabling Strict Mode
  20. In the Valid OAuth redirect URIs field, type the redirect URI for your website and then press ENTER:

    Entering Tour Web Site Redirect URL
  21. Your redirect URI will typically have the format https://engage-app-name.rpxnow.com/facebook/callback. For example, if your Engage app has the name greg-stemp, your redirect URI would be https://greg-stemp.rpxnow.com/facebook/callback. If you have questions about your redirect URI, contact your Janrain representative.

  22. If you have more than one redirect URI, type each URI in the Valid Oauth redirect URIs field. You can enter additional URIs by clicking in the Valid Oauth redirect URIs field, typing a URI, and then pressing ENTER. URIs can be removed from the list by clicking the Delete button (X) at the end of the URI:

    Removing a Redirect URL
  23. To verify that you have entered a valid URI, retype the URI in the Redirect URI to Check field and then click Check URI. You should see a message verifying that you have entered a publicly-accessible URI:

    Validating a Redirect URL
  24. Click Save Changes and then log off from the Facebook for Developers site.

Using an Existing Facebook App for Social Login

If you already have a Facebook app that can be used for social login, complete the following steps to retrieve the application’s app ID and app Secret:

  1. Log on to the Facebook for Developers site (https://developers.facebook.com).
  2. From the Facebook for Developers home page, click My Apps and then click the name of the app you want to use for social login:

    Use an Existing Facebook App
  3. On the home page for your app, click Show to display your app secret:

    Use an Existing Facebook App
  4. Copy the App ID and APP Secret, and then log off of Facebook for Developers.

Configuring Facebook as a Social Login Provider

To configure Facebook as a social login provider, make sure you have your Facebook app ID and app secret, and then complete the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. From the list of Providers, click Facebook.
  6. In the Facebook dialog box, click Next until you reach the screen requesting the App ID and App secret:

    The Configure Facebook Dialog Box
  7. Paste your Facebook app ID in the App ID field, paste your Facebook app secret in the App Secret field, and then click Save. Facebook appears in your social login widget.

  8. When you are finished, select Save and Publish and then click Publish. It might take as long as one hour before Facebook appears as a social login option on your web site.

See Also

Testing Facebook Social Login

To test Facebook social login, complete the following procedure:

  1. Do one of the following:

    • If you have just published your widget settings, click the Test your widget link that appears after the widget has been saved.
    • If you previously published your widget settings then, from the Engage Dashboard Sign-in page, click Launch a test widget.

  2. From the Test page, click the Facebook icon:

    Testing Facebook Logins
  3. In the Facebook window, logon using a valid Facebook account:

    Testing Facebook Logins
  4. If the Facebook logon succeeds, information returned from the Facebook profile is displayed in the API response preview field:

    Facebook API Response Preview

The returned profile information will vary depending on:

  • The Facebook account used in the test.
  • The profile information you requested for Facebook.

You can verify Facebook profile fields by completing the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click Facebook. Profile information returned from Facebook is displayed onscreen. For example:

    Facebook Basic Profile

Fields not marked with an Off or an Ask label are automatically returned when a user logs on using a Facebook account.

For fields that are marked with a label, click Off to request that the information be returned. The Off label will change to Ask, meaning that, at logon time, the user will be asked if they give permission for that data to be returned:

Facebook Permission Required Fields

For example, if you ask for a user’s email address during logon, he or she will see the following message before they log on:

Testing Facebook Logins

The user can either click Continue to forward all the requested information, or can click Review the info you provide and select which fields (if any) will be forwarded during logon.

On the Configure Providers page, click Ask to turn off the information request.

See Also

Assigning a Different Facebook App for Social Login

If you want to use a different Facebook app or if you need to need to change your existing app, you must update your Facebook provider configuration settings. To do that, complete the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click Facebook.

  3. Click the green Configured button to display the Facebook is currently enabled dialog box:

    The Modify Facebook Dialog Box
  4. To change the Facebook configuration, click Modify these settings.

  5. In the Facebook dialog box, change the App ID and/or App Secret as needed, and then click Save:

    The Configure Facebook Dialog Box

Although you can modify your Facebook settings, you cannot delete those settings. If you delete the settings and then try to save your changes, you’ll see the error message Please enter your Consumer Key and Secret exactly as Facebook shows them.

This means that you cannot “unconfigure” the provider: once configured, the Facebook icon will always be shown as green (i.e., configured) in the Janrain Dashboard.

Removing Facebook as a Social Login Provider

If you no longer want to use Facebook for social login, you can remove Facebook as a social login provider by completing the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. In the widget, click the X in the upper right corner of the Facebook icon.
  6. Scroll to the bottom of the page, select Save and Publish, and then click Publish. Facebook no longer appears in the sign-on widget.

Note. You must always have at least one social login provider in the widget. If you delete all the providers and then click Publish, you’ll see the error message Couldn’t save configuration: No providers.


Fimnet

Fimnet (short for Finnish Medical Network) is an online community composed of members from organizations such as the Finnish Medical Association, the Association of Finnish Pharmacies, the Finnish Dental Association, and the Finnish Veterinary Association.

If you are interested in using Fimnet as a social login provider, please contact your Janrain representative.


Flickr Social Login Configuration Guide

Flickr is a website and web service that hosts images and video, and has approximately 92 million registered users.

Before You Begin

To use Flickr for social login you must:

  • Use the Janrain Dashboard to configure Flickr as a social login provider. No additional configuration is required.

In This Configuration Guide

Configuring Flickr as a Social Login Provider

To configure Flickr as a social login provider, complete the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. From the list of Providers, click Flickr. Flickr appears in your social login widget.
  6. When you are finished, select Save and Publish and then click Publish. It might take as long as one hour before Flickr appears as a social login option on your web site.

Testing Flickr Social Login

To test Flickr social login, complete the following procedure:

  1. Do one of the following:

    • If you have just published your widget settings, click the Test your widget link that appears after the widget has been saved.
    • If you previously published your widget settings then, from the Engage Dashboard Sign-in page, click Launch a test widget.

  2. From the Test page, click the Flickr icon:

    Testing Flickr Logins
  3. In the Yahoo! window, logon using a valid Flickr account:

    Testing Flickr Logins
  4. If login succeeds, information returned from the Flickr profile is displayed in the API response preview field:

    Flickr API Response Preview

The returned profile information will vary depending on:

  • The Flickr account used in the test.
  • The profile information you requested for Flickr.

You can verify Flickr profile fields by completing the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click Flickr.

  3. Profile information returned from Flickr is displayed onscreen. For example:

    Flickr Basic Profile

Fields not marked with an Off or an Ask label are automatically returned when a user logs on using a Flickr account.

For fields that are marked with a label, click Off to request that the information be returned. The Off label will change to Ask, meaning that, at logon time, the user will be asked whether he or she gives permission for that data to be returned:

Flickr Permission Required Fields

On the Configure Providers page, click Ask to turn off the information request.

See Also

Removing Flicker as a Social Login Provider

If you no longer want to use Flickr for social login, you can remove Flickr as a social login provider by completing the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. In the widget, click the X in the upper right corner of the Flickr icon.
  6. Scroll to the bottom of the page, select Save and Publish, and then click Publish. Flickr no longer appears in the sign-on widget.

Note. You must always have at least one social login provider in the widget. If you delete all the providers and then click Publish, you’ll see the error message Couldn’t save configuration: No providers.


Foursquare Social Login Configuration Guide

Foursquare is a search-and-discovery app used by more than 50 million people each month.

Before You Begin

To use Foursquare for social login you must:

  1. Obtain a Foursquare developer account from https://foursquare.com/developer/apps.
  2. Do one of the following:
    • Open a previously-created Foursquare app, and copy the client ID and client secret.
    • Create a new Foursquare app and copy the client ID and client secret.

  3. Use the Janrain Engage Dashboard and the Foursquare client ID and client secret to configure Foursquare as a social login provider.

In This Configuration Guide

Creating a Foursquare App

This section walks you through the process of creating a Foursquare app for social login. If you already have an app, see the Using an Existing Foursquare App for Social Login section of this documentation.

To create a Foursquare account, complete the following procedure:

  1. Log on to the Foursquare Developers site (https://foursquare.com/developers/apps).
  2. From the home page, under the My Apps label, click Create a new app:

    Creating a Foursquare App
  3. On the New Developer app page, enter:

    • The name of your app in the Get started integrating Foursquare into your app or website field.
    • The URL of your website in the Application URL field.
    • Your Foursquare callback URL in the Redirect URI(s) field. If you are using a standard Janrain domain, your redirect URL will look similar to this: https://greg-stemp.rpxnow.com/ foursquare/callback.

    Creating a Foursquare App
  4. Scroll down to the bottom of the page and click the Recaptcha field.

  5. After the message I’m not a robot appears in the Recaptcha field, click Create App and Verify:

    Creating a Foursquare App
  6. From the My Apps page, click More about this app:

    Creating a Foursquare App
  7. From the home page for your app, copy the Client_ID and Client_Secret. You can copy this information to a text editor, then close the text editor after you have configured Janrain social login:

    Creating a Foursquare App
  8. Log off from the Foursquare Developers site.

Using an Existing Foursquare App for Social Login

If you already have a Foursquare app that can be used for social login, complete the following steps to retrieve the application’s client ID and client secret:

  1. Log on to the Foursquare Developers center (https://foursquare.com/developers/apps).
  2. From the My Apps page, locate the app you want to use for configuring social login and then click More about this app:

    Use an Existing Foursquare App
  3. From the home page for your app, copy the Client_ID and Client_Secret. You can copy this information to a text editor, then close the text editor after you have configured Janrain social login:

    Use an Existing Foursquare App
  4. Log off from the Foursquare Developers center.

Configuring Foursquare as a Social Login Provider

To configure Foursquare as a social login provider, make sure you have your Foursquare client ID and client secret, and then complete the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. From the list of Providers, click Foursquare.
  6. In the Foursquare dialog box, click Next until you reach the screen requesting the client ID and client secret:

    The Configure Foursquare Dialog Box
  7. Paste your Foursquare client ID in the Client ID field, paste your Foursquare client secret in the Client Secret field, and then click Save. Foursquare appears in your social login widget.

  8. When you are finished, select Save and Publish and then click Publish. It might take as long as one hour before Foursquare appears as a social login option on your web site.

See Also

Testing Foursquare Social Login

To test Foursquare social login, complete the following procedure:

  1. Do one of the following:

    • If you have just published your widget settings, click the Test your widget link that appears after the widget has been saved.
    • If you previously published your widget settings then, from the Engage Dashboard Sign-in page, click Launch a test widget.

  2. From the Test page, click the Foursquare icon:

    Testing Foursquare Logins
  3. In the Foursquare window, logon using a valid Foursquare account:

    Testing Foursquare Logins
  4. If login succeeds, information returned from the Foursquare profile is displayed in the API response preview field:

    Foursquare API Response Preview

The returned profile information will vary depending on the Foursquare account used in the test.

You can verify Foursquare profile fields by completing the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click Foursquare.

  3. Profile information returned from Foursquare is displayed onscreen. For example:

    Foursquare Basic Profile

See Also

Assigning a Different Foursquare App for Social Login

If you want to use a different Foursquare app or if you need to change your existing app, you must update the Foursquare provider configuration settings. To do that, complete the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click Foursquare.

  3. Click the green Configured button to display the Foursquare is currently enabled dialog box:

    The Modify Foursquare Dialog Box
  4. To change the Foursquare configuration, click Modify these settings.

  5. In the Foursquare dialog box, change the Client ID and/or Client Secret as needed, and then click Save:

    The Configure Foursquare Dialog Box

Although you can modify your Foursquare settings, you cannot delete those settings. If you delete the settings and then try to save your changes, you’ll see the error message Please enter your Consumer Key and Secret exactly as Foursquare shows them.

This means that you cannot “unconfigure” the provider: once configured, the Foursquare icon will always be shown as green (i.e., configured) in the Janrain Dashboard.

Removing Foursquare as a Social Login Provider

If you no longer want to use Foursquare for social login, you can remove Foursquare as a social login provider by completing the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers**.
  5. In the widget, click the X in the upper right corner of the Foursquare icon.
  6. Scroll to the bottom of the page, select Save and Publish, and then click Publish. Foursquare no longer appears in the sign-on widget.

Note. You must always have at least one social login provider in the widget. If you delete all the providers and then click Publish, you’ll see the error message Couldn’t save configuration: No providers.


Google+ Social Login Configuration Guide

Google+ is a social networking site operated by the people who bring you the Google search engine.

Before You Begin

To use Google+ for social login you must:

  1. Obtain a Google developer account from https://console.cloud.google.com.
  2. Do one of the following:
    • Open a previously-created Google app, and copy the app ID and app secret.
    • Create a new Google app and copy the client ID and client secret.

  3. Use the Janrain Dashboard and the Google+ client ID and client secret to configure Google+ as a social login provider.

In This Configuration Guide

Creating a Google+ App for Social Login

This section walks you through the process of creating a Google+ app for social login. If you already have an app, see the Using an Existing Google+ App for Social Login section of this documentation.

To create a Google+ app, complete the following procedure:

  1. Log on to the Google Cloud Platform Developers site (https://console.cloud.google.com).
  2. From your Cloud Platform Dashboard, click Go to APIs overview:

    Creating a Google App
  3. On the Dashboard page, click Enable APIs and Services:

    Creating a Google App
  4. On the API Library page, scroll down and then click Google+ API:

    Creating a Google App
  5. On the Google+ API page, click Enable:

    Creating a Google App
  6. From the Google+ API page, click Create credentials:

    Creating a Google App
  7. On the Credentials page:

    • Click Which API are you using and then select Google+ API.
    • Click Where will you be calling the API from and then select Web browser (Javascript).
    • Under the label What data will you be using, select User data.
    • Click What credentials do I need.

    Creating a Google App
  8. On the Add credentials to your project page:

    • Enter the URL of your website in the Authorized JavaScript origins field.
    • Enter your Google redirect URL in the Authorized redirect URIs field. If you are using a standard Janrain domain, your redirect URL will look similar to this: https://greg-stemp.rpxnow.com/google/callback.
    • Click Create Client Id.

    Creating a Google App
  9. After the Add credentials to your project page updates:

    • Enter your email address in the Email address field.
    • Enter the display name of your app in the Product name shown to users field.
    • Click Continue.

    Creating a Google App
  10. Click Download to download credentialing information for your app:

    Creating a Google App

    The credentialing information downloaded from Google will look similar to this:

    Creating a Google App
  11. Copy and save the client_id (493091232151-4ks8jnplmho6pjigo9o3kjedft8v31jn.apps.googleusercontent.com) and the client_secret (KrED9ZUGXsKEWN0GOZUNOOIx). You can copy this information to a text editor, then close the text editor after you have configured Janrain social login.

  12. Click Done.

  13. Verify that credentials for your application have been created, and then log off of the Google Cloud Platform:

    Creating a Google App

Using an Existing Google App for Social Login

If you already have a Google app that can be used for social login, complete the following steps to retrieve the application’s client ID and client secret:

  1. Log on to the Google Cloud Platform (https://console.cloud.google.com).
  2. From your Google Cloud Platform dashboard, click Go to APIS overview:

    Use an Existing Google App
  3. From the APIs & services page, click Credentials:

    Use an Existing Google App
  4. From the Credentials page, click the Name of your OAuth 2.0 client:

    Use an Existing Google App
  5. From the Client ID for Web application page, copy the Client ID and Client secret, and then log off from the Google Cloud Platform:

    Use an Existing Google App

Configuring Google+ as a Social Login Provider

To configure Google+ as a social login provider, make sure you have your Google+ client ID and client secret, then complete the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. From the list of Providers, click Google+.
  6. In the Google+ dialog box, click Next until you reach the screen requesting the client ID and client secret:

    The Configure Google Dialog Box
  7. Paste your Google+ client ID in the Client ID field, paste your Google+ client secret in the Client Secret field, and then click Save. Google+ appears in your social login widget.

  8. When you are finished, select Save and Publish and then click Publish. It might take as long as one hour before Google+ appears as a social login option on your web site.

Testing Google+ Social Login

To test Google+ social login, complete the following procedure:

  1. Do one of the following:

    • If you have just published your widget settings, click the Test your widget link that appears after the widget has been saved.
    • If you previously published your widget settings then, from the Engage Dashboard Sign-in page, click Launch a test widget.

  2. From the Test page, click the Google+ icon:

    Testing Google Logins
  3. In the Sign in – Google Accounts window, logon using a valid Google+ account:

    Testing Google Logins
  4. If login succeeds, information returned from the Google+ profile is displayed in the API response preview field:

    Google API Response Preview

The returned profile information will vary depending on:

  • The Google+ account used in the test.
  • The profile information you requested for Google+.

You can verify Google+ profile fields by completing the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click Google+.

  3. Profile information returned from Google+ is displayed onscreen. For example:

    Google Basic Profile

Fields not marked with an Off or an Ask label are automatically returned when a user logs on using a Google+ account.

For fields that are marked with a label, click Off to request that the information be returned. The Off label will change to Ask, meaning that, at logon time, the user will be asked whether they give permission for that data to be returned:

Google Permission Required Fields

For example, if you ask for a user’s email address during logon, he or she will see the following message before they log on:

Testing Google Logins

The user can either click Allow to forward all the requested information, or can click Cancel to terminate logon.

On the Configure Providers page, click Ask to turn off the information request.

See Also

Assigning a Different Google+ App for Social Login

If you want to use a different Google+ app or if you need to change your existing app, you must update the Google+ provider configuration settings. To do that, complete the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click Google+.

  3. Click the green Configured button to display the Google+ is currently enabled dialog box:

    The Modify Google Dialog Box
  4. To change the Google+ configuration, click Modify these settings.

  5. In the Google+ dialog box, change the Client ID and/or Client Secret as needed, and then click Save:

    The Configure Google Dialog Bo

Although you can modify your Google+ settings, you cannot delete those settings. If you delete the settings and then try to save your changes, you’ll see the error message Please enter your Consumer Key and Secret exactly as Google+ shows them.

This means that you cannot “unconfigure” the provider: once configured, the Google+ icon will always be shown as green (i.e., configured) in the Janrain Dashboard.

Removing Google+ as a Social Login Provider

If you no longer want to use Google+ for social login, you can remove Google+ as a social login provider by completing the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. In the widget, click the X in the upper right corner of the Google+ icon.
  6. Scroll to the bottom of the page, select Save and Publish, and then click Publish. Google+ no longer appears in the sign-on widget.

Note. You must always have at least one social login provider in the widget. If you delete all the providers and then click Publish, you’ll see the error message Couldn’t save configuration: No providers.


Instagram Social Login Configuration Guide

Instagram is a photo- and video-sharing services that has approximately 800 million users divided between Instagram Direct and Instagram Stories.

Before You Begin

To use Instagram for social login you must:

  1. Obtain an Instagram developer account from https://instagram.com/developer/register.
  2. Do one of the following:
    • Open a previously-created Instagram client, and copy the client ID and client secret.
    • Create a new Instagram client, and copy the client ID and client secret.

  3. Use the Janrain Engage Dashboard and the Instagram client ID and client secret to configure Instagram as a social login provider.

In This Configuration Guide

Creating an Instagram Client

This section walks you through the process of creating an Instagram client for social login. If you already have a client, see the Using an Existing Instagram Client for Social Login section of this documentation.

To configure an Instagram client, complete the following procedure:

  1. Log on to the Instagram Developers site (https://www.instagram.com/developer/register/).
  2. On the Developers Signup page, enter:
    • The URL of your website in the Your website field.
    • Your contact phone number in the Phone Number field.
    • A brief description of your app in the What do you want to build with the API field.

  3. Select I accept the API Terms of Use and Brand Guidelines and then click Sign up:

    Creating an Instagram App
  4. On the Hello Developers page, click Register Your Application.

  5. On the Manage Clients page, click Register a New Client:

    Creating an Instagram App
  6. On the Register New Client ID page, enter:

    • The name of your application in the Application Name field.
    • A brief description of your application in the Description field.
    • The name of your company in the Company Name field.
    • The URL of your website in the Website URL field.
    • Your Instagram callback URL in the Valid redirect URIs field. If you are using a standard Janrain domain, your redirect URL will look similar to this: https://greg-stemp.rpxnow.com/instagram/callback.
    • Your email address in the Contact email field.

  7. Type the words shown in the Recaptcha section in the Type the words above field and then click Register:

    Creating an Instagram App
  8. On the Manage Clients page, click Manage:

    Creating an Instagram App
  9. Copy the Client ID and the Client Secret. You can copy this information to a text editor, then close the text editor after you have configured Janrain social login:

    Creating an Instagram App
  10. Log off from the Instagram Developers site.

Using an Existing Instagram Client for Social Login

If you already have an Instagram client that can be used for social login, complete the following steps to retrieve the client ID and client secret:

  1. Log on to the Instagram Developers site (https://www.instagram.com/developer).
  2. From the Developers site home page, click Manage Clients:

    Use an Existing Instagram App
  3. From the Manage Clients page, locate the app you want to use to configure social login, and then click Manage:

    Use an Existing Instagram App
  4. From the Manage Client page, copy the Client ID and Client Secret. You can copy this information to a text editor, then close the text editor after you have configured Janrain social login:

    Use an Existing Instagram App
  5. Log off from the Instagram Developers site.

Configuring Instagram as a Social Login Provider

To configure Instagram as a social login provider, make sure you have your Instagram client ID and client secret, and then complete the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. From the list of Providers, click Instagram.
  6. In the Instagram dialog box, click Next until you reach the screen requesting the client ID and client secret:

    The Configure Instagram Dialog Box
  7. Paste your Instagram client ID in the Client ID field, paste your Instagram client secret in the Client Secret field, and then click Save. Instagram appears in your social login widget.

  8. When you are finished, select Save and Publish and then click Publish. It might take as long as one hour before Instagram appears as a social login option on your web site.

See Also

Testing Instagram Social Login

To test Instagram social login, complete the following procedure:

  1. Do one of the following:

    • If you have just published your widget settings, click the Test your widget link that appears after the widget has been saved.
    • If you previously published your widget settings then, from the Engage Dashboard Sign-in page, click Launch a test widget.

  2. From the Test page, click the Instagram icon:

    Testing Instagram Logins
  3. In the Log in – Instagram window, logon using a valid Instagram account:

    Testing Instagram Logins
  4. If login succeeds, information returned from the Instagram profile is displayed in the API response preview field:

    Instagram API Response Preview

The returned profile information will vary depending on:

  • The Instagram account used in the test.
  • The profile information you requested for Instagram.

You can verify Instagram profile fields by completing the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click Instagram.

  3. Profile information returned from Instagram is displayed onscreen. For example:

    Instagram Basic Profile

Fields not marked with an Off or an Ask label are automatically returned when a user logs on using an Instagram account.

For fields that are marked with a label, click Off to request that the information be returned. The Off label will change to Ask, meaning that, at logon time, the user will be asked whether he or she gives permission for that data to be returned:

Instagram Permission Required Fields

For example, if you ask about commenting on photos, he or she will see the following message before they log on:

Testing Instagram Logins

The user can either click Authorize to agree to the request, or can click Cancel to terminate logon.

On the Configure Providers page, click Ask to turn off the information request.

See Also

Assigning a Different Instagram Client for Social Logon

If you want to use a different Instagram client or if you need to change your existing client, you must update the Instagram provider configuration settings. To do that, complete the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click Instagram.

  3. Click the green Configured button to display the Instagram is currently enabled dialog box:

    The Modify Instagram Dialog Box
  4. To change the Instagram configuration, click Modify these settings.

  5. In the Instagram dialog box, change the Client ID and/or Client Secret as needed, and then click Save:

    The Configure Instagram Dialog Box

Although you can modify your Instagram settings, you cannot delete those settings. If you delete the settings and then try to save your changes, you’ll see the error message Please enter your Consumer Key and Secret exactly as Instagram shows them.

This means that you cannot “unconfigure” the provider: once configured, the Instagram icon will always be shown as green (i.e., configured) in the Janrain Dashboard.

Removing Instagram as a Social Login Provider

If you no longer want to use Instagram for social login, you can remove Instagram as a social login provider by completing the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. In the widget, click the X in the upper right corner of the Instagram icon.
  6. Scroll to the bottom of the page, select Save and Publish, and then click Publish. Instagram no longer appears in the sign-on widget.

Note. you must always have at least one social login provider in the widget. If you delete all the providers and then click Publish, you’ll see the error message Couldn’t save configuration: No providers.


LinkedIn Social Login Configuration Guide

LinkedIn is a business- and career-oriented social networking site with over 500 million registered users.

Before You Begin

To use LinkedIn for social login you must:

  1. Obtain a LinkedIn developer account from https://www.linkedin.com/secure/developer.
  2. Do one of the following:
    • Open a previously-created LinkedIn application, and copy the client ID and client secret.
    • Create a new LinkedIn application and copy the client ID and client secret.

  3. Use the Janrain Engage Dashboard and the LinkedIn client ID and client secret to configure LinkedIn as a social login provider.

In This Configuration Guide

Creating a LinkedIn Application for Social Login

This section walks you through the process of creating a LinkedIn application for social login. If you have already have an application, see the Using an Existing LinkedIn Application for Social Login section of this documentation.

To create a LinkedIn application, complete the following procedure:

  1. Log on to the LinkedIn Developers site (https://www.linkedin.com/secure/developer).
  2. From the My Applications page, click Create Application:

    Creating a LinkedIn App
  3. On the Create a New Application page, enter:

    • The name of your company in the Company Name field.
    • The name of your application in the Name field.
    • A brief description of your application in the Description field.

  4. Click Select File to Upload to upload a logo for your new application (a logo is required). Using your operating system’s File Open dialog box, select the image file you want to use as your logo and then click Open.

  5. Click Application Use and select the intended use for your application:

    Creating a LinkedIn App
  6. Enter:

    • The URL for your website in the Website URL field.
    • Your contact email address in the Business Email field.
    • Your phone number in the Business Phone field.

    Creating a LinkedIn App
  7. Scroll to the bottom of the page, select I have read and agree to the LinkedIn API Terms of Use and then click Save:

    Creating a LinkedIn App
  8. On the home page for your new app, under Default Application Permissions, select r_basicprofile:

    Creating a LinkedIn App
  9. Enter your LinkedIn callback URL in the Authorized Redirect URLs field, click Add, and then click Update. If you are using a standard Janrain domain, your redirect URL will look similar to this: https://greg-stemp.rpxnow.com/linkedin/callback.

  10. Copy the Client ID and Client Secret. You can copy this information to a text editor, then close the text editor after you have configured Janrain social login.

  11. Log off from the LinkedIn Developers center.

Using an Existing LinkedIn Application for Social Login

If you already have a LinkedIn application that can be used for social login, complete the following steps to retrieve the application’s client ID and client secret:

  1. Log on to the LinkedIn Developers center (https://www.linkedin.com/secure/developer).
  2. From the My Applications page, click the name of the application you want to use to configure social login:

    Use an Existing LinkedIn App
  3. From the home page for your app, copy the Client ID and Client Secret, and then log off from the LinkedIn Developers center. You can copy this information to a text editor, then close the text editor after you have configured Janrain social login:

    Use an Existing LinkedIn App

Configuring LinkedIn as a Social Login Provider

To configure LinkedIn as a social login provider, make sure you have your LinkedIn client ID and client secret, and then complete the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. From the list of Providers, click LinkedIn.
  6. In the LinkedIn dialog field, click Next until you reach the screen requesting the LinkedIn API key and secret key:

    The Configure LinkedIn Dialog Box
  7. Paste your LinkedIn client ID in the API Key field, paste your LinkedIn client secret in the Secret Key field, and then click Save. LinkedIn appears in your social login widget.

  8. When you are finished, select Save and Publish and then click Publish. It might take as long as one hour before LinkedIn appears as a social login option on your web site.

See Also

Testing LinkedIn Social Login

To test LinkedIn social login, complete the following procedure:

  1. Do one of the following:

    • If you have just published your widget settings, click the Test your widget link that appears after the widget has been saved.
    • If you previously published your widget settings then, from the Engage Dashboard Sign-in page, click Launch a test widget.

  2. From the Test page, click the LinkedIn icon:

    Testing LinkedIn Logins
  3. In the Authorize | LinkedIn window, logon using a valid LinkedIn account:

    Testing LinkedIn Logins
  4. If login succeeds, information returned from the LinkedIn profile is displayed in the API response preview field:

    LinkedIn API Response Preview

The returned profile information will vary depending on:

  • The LinkedIn account used in the test.
  • The profile information you requested for LinkedIn.

You can verify LinkedIn profile fields by completing the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click LinkedIn.

  3. Profile information returned from LinkedIn is displayed onscreen. For example:

    LinkedIn Basic Profile

Fields not marked with an Off or an Ask label are automatically returned when a user logs on using a LinkedIn account.

For fields that are marked with a label, click Off to request that the information be returned. The Off label will change to Ask, meaning that, at logon time, the user will be asked whether he or she gives permission for that data to be returned:

LinkedIn Permission Required Fields

On the Configure Providers page, click Ask to turn off the information request.

See Also

Assigning a Different LinkedIn App for Social Login

If you want to use a different LinkedIn app or if you need to change your existing app, you must update the LinkedIn provider configuration settings. To do that, complete the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click LinkedIn.

  3. Click the green Configured button to display the LinkedIn is currently enabled dialog box:

    The Modify LinkedIn Dialog Box
  4. To change the LinkedIn configuration, click Modify these settings.

  5. In the LinkedIn dialog box, change the API Key and/or Secret Key as needed, and then click Save:

    The Configure LinkedIn Dialog Box

Although you can modify your LinkedIn settings, you cannot delete those settings. If you delete the settings and then try to save your changes, you’ll see the error message Please enter your Consumer Key and Secret exactly as LinkedIn shows them.

This means that you cannot “unconfigure” the provider: once configured, the LinkedIn icon will always be shown as green (i.e., configured) in the Janrain Dashboard.

Removing LinkedIn as a Social Login Provider

If you no longer want to use LinkedIn for social login, you can remove LinkedIn as a social login provider by completing the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. In the widget, click the X in the upper right corner of the LinkedIn icon.
  6. Scroll to the bottom of the page, select Save and Publish, and then click Publish. LinkedIn no longer appears in the sign-on widget.

Note. You must always have at least one social login provider in the widget. If you delete all the providers and then click Publish, you’ll see the error message Couldn’t save configuration: No providers.


LiveJournal Social Login Configuration Guide

LiveJournal is a Russian social media service that hosts user blogs, journals, and diaries. LiveJournal has around 15 million active users each month.

Before You Begin

To use LiveJournal for social login you must:

  • Use the Janrain Dashboard to configure LiveJournal as a social login provider. No additional configuration is required.

In This Configuration Guide

Configuring LiveJournal as a Social Login Provider

To configure LiveJournal as a social login provider, complete the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. From the list of Providers, click LiveJournal. LiveJournal appears in your social login widget.
  6. When you are finished, select Save and Publish and then click Publish. It might take as long as one hour before LiveJournal appears as a social login option on your web site.

See Also

Testing LiveJournal Social Login

To test LiveJournal social login, complete the following procedure:

  1. Do one of the following:

    • If you have just published your widget settings, click the Test your widget link that appears after the widget has been saved.
    • If you previously published your widget settings then, from the Engage Dashboard Sign-in page, click Launch a test widget.

  2. From the Test page, click the LiveJournal icon:

    Testing LiveJournal Logins
  3. In the LiveJournal Sign-In window, logon using a valid LiveJournal account:

    Testing LiveJournal Logins
  4. If login succeeds, information returned from the LiveJournal profile is displayed in the API response preview field:

    LiveJournal API Response Preview

The returned profile information will vary depending on the LiveJournal account used in the test.

You can verify LiveJournal profile fields by completing the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click LiveJournal.

  3. Profile information returned from LiveJournal is displayed onscreen. For example:

    LiveJournal Basic Profile

See Also

Removing LiveJournal as a Social Login Provider

If you no longer want to use LiveJournal for social login, you can remove LiveJournal as a social login provider by completing the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. In the widget, click the X in the upper right corner of the LiveJournal icon.
  6. Scroll to the bottom of the page, select Save and Publish, and then click Publish. LiveJournal no longer appears in the sign-on widget.

Note. You must always have at least one social login provider in the widget. If you delete all the providers and then click Publish, you’ll see the error message Couldn’t save configuration: No providers.


MediKey Social Login Configuration Guide

MediKey is a cloud-based system for storing and maintaining medical records and other personal documentation.

If you are interested in using Medikey as a social login provider, please contact your Janrain representative.


Medy Social Login Configuration Guide

Medy is an online pharmaceutical web site for healthcare professionals.

If you are interested in using Medy as a social login provider, please contact your Janrain representative.


Microsoft Account Social Login Configuration Guide

Microsoft Account” is another name for a Microsoft Live account. Live accounts are used to sign in for Microsoft services like Outlook/Hotmail and Xbox Live.

Before You Begin

To use Microsoft Account for social login you must:

  1. Obtain a Microsoft developer account from https://apps.dev.microsoft.com.
  2. Do one of the following:
    • Open a previously-created Microsoft app, and copy the app ID and client ID.
    • Create a new Microsoft app and copy the app ID and client ID.

  3. Use the Janrain Dashboard and the Microsoft app ID and client ID to configure Microsoft Account as a social login provider.

In This Configuration Guide

Creating a Microsoft Account App for Social Login

This section walks you through the process of creating an app that can be used to configure Microsoft Account social login. If you already have an app, see the Using an Existing Microsoft Account App for Social Login section of this documentation.

  1. Log on to the Microsoft Application Registration Portal (https://apps.dev.microsoft.com).
  2. From the Application Registration Portal home page, click Add an app:

    Creating a Microsoft App
  3. On the Register your application page:

    • Enter the name of your application in the Application Name field.
    • Enter your email address in the Contact Email field.
    • Leave Guided Setup unselected and then click Create.

    Creating a Microsoft App
  4. From the Registration page for your new application, copy and save the Application ID. You can copy this information to a text editor, then close the text editor after you have configured Janrain social login.

  5. Click Generate New Password:

    Creating a Microsoft App
  6. In the New password generated dialog box, copy and save your application password. (This is the only time you will be able to access the password.) You can copy this information to a text editor, then close the text editor after you have configured Janrain social login.

  7. When you are finished, click OK:

    Creating a Microsoft App
  8. Scroll down the page to the Platforms section, and then click Add Platform:

    Creating a Microsoft App
  9. In the Add Platform dialog box, click Web:

    Creating a Microsoft App
  10. In the Web section, enter your redirect URL in the Redirect URLs field. If you are using a standard Janrain domain, your redirect URL will look similar to this: https://greg-stemp.rpxnow.com/liveid/callback:

    Creating a Microsoft App
  11. Scroll down the page to the Profile section. Enter the URL of your website in the Home page URL field, click Save, and then log off of the Application Registration Portal:

    Creating a Microsoft App

Using an Existing Microsoft Account App for Social Login

If you already have a Microsoft Account app that can be used for social login, complete the following steps to retrieve the application ID and password:

  1. Log on to the Microsoft Application Registration Portal (https://apps.dev.microsoft.com)
  2. From the My applications page, click the name of the application that you want to use for configuring social logins:

    Use an Existing Microsoft App
  3. On the home page for your application, copy and save the Application ID. You can copy this information to a text editor, then close the text editor after you have configured Janrain social login.

  4. If you did not previously save your application password, click Generate New Password:

    Use an Existing Microsoft App
  5. In the New password generated dialog box, copy and save your application password. (This is the only time you will be able to access the password.) You can copy this information to a text editor, then close the text editor after you have configured Janrain social login.

  6. When you are done, click OK.

  7. If you no longer need your old password, click the Delete button next to that password. In the Confirm Delete dialog box, click OK:

    Use an Existing Microsoft App
  8. Scroll down to the bottom of the page, click Save, and then log off the Application Registration portal:

    Use an Existing Microsoft App

Testing Microsoft Account Social Login

To test Microsoft social login, complete the following procedure:

  1. Do one of the following:

    • If you have just published your widget settings, click the Test your widget link that appears after the widget has been saved.
    • If you previously published your widget settings then, from the Engage Dashboard Sign-in page, click Launch a test widget.

  2. From the Test page, click the Microsoft Account icon:

    Testing Microsoft Account Logins
  3. In the Sign in to your Microsoft account window, logon using a valid Microsoft account:

    Testing Microsoft Logins
  4. If login succeeds, information returned from the Microsoft profile is displayed in the API response preview field.

The returned profile information will vary depending on:

  • The Microsoft account used in the test.
  • The profile information you requested for Microsoft account.

You can verify Microsoft account profile fields by completing the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click Microsoft Account.

  3. Profile information returned from Microsoft accounts is displayed onscreen. For example:

    Microsoft Account Basic Profile

Fields not marked with an Off or an Ask label are automatically returned when a user logs on using a Microsoft account.

For fields that are marked with a label, click Off to request that the information be returned. The Off label will change to Ask, meaning that, at logon time, the user will be asked whether he or she gives permission for that data to be returned:


Microsoft Account Permission Required Fields

For example, if you ask for a user’s email address during logon, he or she will see the following message before they log on:

Testing Microsoft Logins

The user can either click Yes to forward all the requested information, or can click No to terminate logon.

On the Configure Providers page, click Ask to turn off the information request.

See Also

Assigning a Different Microsoft App for Social Login

If you want to use a different Microsoft app or if you need to change your existing app, you must update the Microsoft Account provider configuration settings. To do that, complete the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click Microsoft Account.

  3. Click the green Configured button to display the Microsoft Account is currently enabled dialog box:

    The Modify Microsoft Account Dialog Box
  4. To change the Microsoft account configuration, click Modify these settings.

  5. In the Microsoft Account dialog box, change the Client ID and/or Client Secret as needed, and then click Save:

    The Configure Microsoft Account Dialog Box

Although you can modify your Microsoft Account settings, you cannot delete those settings. If you delete the settings and then try to save your changes, you’ll see the error message Please enter your Consumer Key and Secret exactly as Microsoft Account shows them.

This means that you cannot “unconfigure” the provider: once configured, the Microsoft Account icon will always be shown as green (i.e., configured) in the Janrain Dashboard.

Removing Microsoft as a Social Login Provider

If you no longer want to use Microsoft accounts for social login, you can remove Microsoft as a social login provider by completing the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. In the widget, click the X in the upper right corner of the Microsoft Account icon.
  6. Scroll to the bottom of the page, select Save and Publish, and then click Publish. Microsoft Account no longer appears in the sign-on widget.

Note. You must always have at least one social login provider in the widget. If you delete all the providers and then click Publish, you’ll see the error message Couldn’t save configuration: No providers.


Mixi Social Login Configuration Guide

Mixi is a Japanese social networking service. Mixi has approximately 50 million active users each month.

Before You Begin

Although not detailed in this configuration guide, you can create a new Mixi app that enables users to log on to your web site by using their Mixi account. To create a Mixi developer account, you must have an email account with a Japanese mobile service provider:


Mixi Registration

If you have an email account with a Japanese mobile service provider, you can create an account on the Mixi Developer’s site (http://developer.mixi.co.jp).


Note. Web pages on the Mixi Developers site are written in Japanese. If you do not speak Japanese, you might want to use a web browser than can translate the Mixi web pages. For this configuration guide, we used Google Chrome and its Translate to English option.


In This Configuration Guide

Configuring Mixi as a Social Login Provider

To configure Mixi as a social login provider, make sure you have your Mixi key and secret, and then complete the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. From the list of Providers, click Mixi.
  6. In the Mixi dialog box, click Next until you reach the screen requesting the key and secret:

    The Configure Mixi Dialog Box
  7. Paste your Mixi key in the Key field, paste your Mixi secret in the Secret field, and then click Save. Mixi appears in your social login widget.

  8. When you are finished, select Save and Publish and then click Publish. It might take as long as one hour before Mixi appears as a social login option on your web site.

See Also

Testing Mixi Social Login

To test Mixi social login, complete the following procedure:

  1. Do one of the following:

    • If you have just published your widget settings, click the Test your widget link that appears after the widget has been saved.
    • If you previously published your widget settings then, from the Engage Dashboard Sign-in page, click Launch a test widget.

  2. From the Test page, click the Mixi icon:

    Testing Mixi Logins
  3. In the Social networking service window, log on using a valid Mixi account:

    Testing Mixi Logins
  4. If login succeeds, information returned from the Mixi profile is displayed in the API response preview field.

The returned profile information will vary depending on:

  • The Mixi account used in the test.
  • The profile information you requested for Mixi.

You can verify Mixi profile fields by completing the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click Mixi.

  3. Profile information returned from Mixi is displayed onscreen. For example:

    Mixi Basic Profile

Fields not marked with an Off or an Ask label are automatically returned when a user logs on using a Mixi account.

For fields that are marked with a label, click Off to request that the information be returned. The Off label will change to Ask, meaning that, at logon time, the user will be asked whether he or she gives permission for that data to be returned:

Mixi Permission Required Fields

From the Configure Providers page, click Ask to turn off the information request.

See Also

Assigning a Different Mixi App for Social Login

If you want to use a different Mixi app or if you need to change your existing app, you must update the Mixi provider configuration settings. To do that, complete the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click Mixi.

  3. Click the green Configured button to display the Mixi is currently enabled dialog box:

    The Modify Mixi Dialog Box
  4. To change the Mixi configuration, click Modify these settings.

  5. In the Mixi dialog box, change the Key and/or Secret as needed, and then click Save:

    The Configure Mixi Dialog Box

Although you can modify your Mixi settings, you cannot delete those settings. If you delete the settings and then try to save your changes, you’ll see the error message Please enter your Consumer Key and Secret exactly as Mixi shows them.

This means that you cannot “unconfigure” the provider: once configured, the Mixi icon will always be shown as green (i.e., configured) in the Janrain Dashboard.

Removing Mixi as a Social Login Provider

You can remove Mixi as a social login provider by completing the following procedure:

  1. Log on to your Janrain Dashboard ([https://dashboard.janrain.com(https://dashboard.janrain.com)).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. In the widget, click the X in the upper right corner of the Mixi icon.
  6. Scroll to the bottom of the page, select Save and Publish, and then click Publish. Mixi no longer appears in the sign-on widget.

Note. You must always have at least one social login provider in the widget. If you delete all the providers and then click Publish, you’ll see the error message Couldn’t save configuration: No providers.


Odnoklassniki Social Login Configuration Guide

Odnoklassniki is a social networking service popular in Russia. Approximately 200 million people have Odnoklassniki accounts.

Before You Begin

To use Odnoklassniki for social login you must:

  1. Obtain an Odnoklassniki developer account from https://www.odnosklassniki.ru/devaccess.
  2. Do one of the following:
    • From the email sent when you created an Odnoklassniki app, copy the application ID, public key, and secret key. (This information cannot be retrieved online.)
    • Create a new Odnoklassniki app and copy the application ID, public key, and secret key.

  3. Use the Janrain Dashboard to configure Odnoklassniki as a social login provider.

Note. Web pages on the Odnoklassniki Developers site are written in Russian. If you do not speak Russian, you might want to use a web browser than can translate the Odnoklassniki web pages. For this configuration guide, we used Google Chrome and its Translate to English option.


In This Configuration Guide

Creating an Odnoklassniki App

This section walks you through the process of creating an Odnoklassniki app for social login. If you already have an app, see the Using an Existing Odnosklassniki App for Social Login section of this documentation.

To configure an Odnosklassniki app, complete the following procedure:

  1. Log on to the Odnoklassniki Developers site (https://www.ok.ru/devaccess).
  2. On the Developer rights granting request page, select I have read and accept The Terms and Conditions of the Agreement, and then click Receive the developer rights:

    Creating an Odnoklassniki App
  3. After the page updates, click Follow the link:

    Creating an Odnoklassniki App
  4. On the My Uploads page, click Add App:

    Creating an Odnoklassniki App
  5. On the App Settings page, click Add Platform:

    Creating an Odnoklassniki App
  6. On the expanded App Settings page, enter:

    • The name of your app in the Title field.
    • A “nickname” for your app in the Shortname field. Note that you cannot use blank spaces in the short name.
    • A brief description of your app in the Description field.

    Creating an Odnoklassniki App
  7. Scroll down the page to the Link to avatars and icons section. Enter URLs to online images of the specified size (for example 128 pixels by 128 pixels). Odnoklassniki verifies the image size; if your images are not the correct size, you will not be able to proceed:

    Creating an Odnoklassniki App
  8. Scroll down the page and enter:

    • Your web site URL in the App link field.
    • Your Odnoklassniki redirect URL in the Callback link field. If you are using a standard Janrain domain, your redirect URL will look similar to this: https://greg-stemp.rpxnow.com/odnoklassniki/callback.

    Creating an Odnoklassniki App
  9. Scroll further down the page. Next to the App size label, select Full screen:

    Creating an Odnoklassniki App
  10. Click Save:

    Creating an Odnoklassniki App
  11. In the App has been added dialog box, click Close:

    Creating an Odnoklassniki App
  12. Log off from the Odnoklassniki developers site.

  13. Shortly after creating your app, you will receive an email listing your application ID, public key, and secret key:

    Creating an Odnoklassniki App
  14. In the preceding email, the Application ID is 1257192448; the public key is CBANDQOLEBABABABA; and the secret key is C365B5F1AD5289F5359BC61A. Be sure and save this email; you cannot go online and retrieve the application ID, public key, or secret key.

Configuring Odnoklassniki as a Social Login Provider

To configure Odnoklassniki as a social login provider, make sure you have your Odnoklassniki application ID, public key, and secret key, and then complete the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. From the list of Providers, click Odnoklassniki.
  6. In the Odnoklassniki dialog box, click Next until you reach the screen requesting the application ID, public key, and secret key:

    The Configure Odnoklassniki Dialog Box
  7. Paste your Odnoklassniki application ID in the Application ID field, paste your Odnoklassniki public key in the Public Key field, and then paste your Odnoklassniki secret key in the Secret Key field.

  8. Click Save. Odnoklassniki appears in your social login widget.

  9. When you are finished, select Save and Publish and then click Publish. It might take as long as one hour before Odnoklassniki appears as a social login option on your web site.

See Also

Testing Odnoklassniki Social Login

To test Odnoklassniki social login, complete the following procedure:

  1. Do one of the following:

    • If you have just published your widget settings, click the Test your widget link that appears after the widget has been saved.
    • If you previously published your widget settings then, from the Engage Dashboard Sign-in page, click Launch a test widget.

  2. From the Test page, click the Odnoklassniki icon:

    Testing Odnoklassniki Logins
  3. In the OK window, logon using a valid Odnoklassniki account:

    Testing Odnoklassniki Logins
  4. If login succeeds, information returned from the Odnoklassniki profile is displayed in the API response preview field:

    Odnoklassniki API Response Preview

The returned profile information will vary depending on:

  • The Odnoklassniki account used in the test.
  • The profile information you requested for Odnoklassniki.

You can verify Odnoklassniki profile fields by completing the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click Odnoklassniki.

  3. Profile information returned from Odnoklassniki is displayed onscreen. For example:

    Odnoklassniki Basic Profile

Fields not marked with an Off or an Ask label are automatically returned when a user logs on using an Odnoklassniki account.

For fields that are marked with a label, click Off to request that the information be returned. The Off label will change to Ask, meaning that, at logon time, the user will be asked whether he or she gives permission for that data to be returned:

Odnoklassniki Permission Required Fields

On the Configure Providers page, click Ask to turn off the information request.

See Also

Assigning a Different Odnoklassniki App for Social Login

If you want to use a different Odnoklassniki app or if you need to change your existing app, you must update the Odnoklassniki provider configuration settings. To do that, complete the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click Odnoklassniki.

  3. Click the green Configured button to display the Odnoklassniki is currently enabled dialog box:

    The Modify Odnoklassniki Dialog Box
  4. To change the Odnoklassniki configuration, click Modify these settings.

  5. In the Odnoklassniki dialog box, change the Application ID, Public Key, and/or Secret Key as needed, and then click Save:

    The Configure Odnoklassniki Dialog Box

Although you can modify your Odnoklassniki settings, you cannot delete those settings. If you delete the settings and then try to save your changes, you’ll see the error message Please enter your Consumer Key and Secret exactly as Odnoklassniki shows them.

This means that you cannot “unconfigure” the provider: once configured, the Odnoklassniki icon will always be shown as green (i.e., configured) in the Janrain Dashboard.

See Also

Removing Odnoklassniki as a Social Login Provider

If you no longer want to use Odnoklassniki for social login, you can remove Odnoklassniki as a social login provider by completing the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. In the widget, click the X in the upper right corner of the Odnoklassniki icon.
  6. Scroll to the bottom of the page, select Save and Publish, and then click Publish. Odnoklassniki no longer appears in the sign-on widget.

Note. You must always have at least one social login provider in the widget. If you delete all the providers and then click Publish, you’ll see the error message Couldn’t save configuration: No providers.


OneKey Social Login Configuration Guide

OneKey is a comprehensive database of healthcare professionals from over than 70 different countries.

If you are interested in using OneKey as a social login provider, please contact your Janrain representative.


OpenID Social Login Configuration Guide

OpenID is a standard authentication protocol managed by the OpenID Foundation. More than 500 million people have OpenID accounts.

Before You Begin

To use OpenID for social login you must:

  • Use the Janrain Dashboard to configure OpenID as a social login provider. No additional configuration is required.

In This Configuration Guide

Configuring OpenID as a Social Login Provider

To configure OpenID as a social login provider, complete the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. From the list of Providers, click OpenID. OpenID appears in your social login widget.
  6. When you are finished, select Save and Publish and then click Publish. It might take as long as one hour before OpenID appears as a social login option on your web site.

See Also

Testing OpenID Social Login

To test OpenID social login, complete the following procedure:

  1. Do one of the following:

    • If you have just published your widget settings, click the Test your widget link that appears after the widget has been saved.
    • If you previously published your widget settings then, from the Engage Dashboard Sign-in page, click Launch a test widget.

  2. From the Test page, click the OpenID icon:

    Testing OpenID Logins
  3. In the OpenID Sign-In window, logon using a valid OpenID account:

    Testing OpenID Logins
  4. If login succeeds, information returned from the OpenID profile is displayed in the API response preview field:

    OpenID API Response Preview

The returned profile information will vary depending on the OpenID account used in the test.

See Also

Removing OpenID as a Social Login Provider

If you no longer want to use OpenID for social login, you can remove OpenID as a social login provider by completing the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. In the widget, click the X in the upper right corner of the OpenID icon.
  6. Scroll to the bottom of the page, select Save and Publish, and then click Publish. OpenID no longer appears in the sign-on widget.

Note. You must always have at least one social login provider in the widget. If you delete all the providers and then click Publish, you’ll see the error message Couldn’t save configuration: No providers.


PayPal Social Login Configuration Guide

PayPal is a digital payment platform with more than 225 million active users.

If you are interested in using PayPal as a social login provider, please contact your Janrain representative.


QQ Social Login Configuration Guide

QQ (also known as Tencent QQ) is a Chinese instant messaging service that provides microblogging, social games, music, and group and voice chat software. There are approximately 900 million active QQ accounts.

Before You Begin

Although not detailed in this configuration guide, you can create a new QQ app that enables users to log on to your web site by using their QQ account. To create a QQ developer account, you must complete a registration process that includes such tasks as providing a copy of your business license:

QQ Registration

If you already have a QQ developer account, you can create a social login app from the QQ developer’s site (https://connect.qq.com).


Note. Web pages on the QQ Developers site are written in Chinese. If you do not speak Chinese, you might want to use a web browser than can translate the QQ web pages. For this configuration guide, we used Google Chrome and its Translate to English option.


In This Configuration Guide

Configuring QQ as a Social Login Provider

To configure QQ as a social login provider, make sure you have your QQ app ID and app key, and then complete the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. From the list of Providers, click QQ.
  6. In the QQ dialog box, click Next until you reach the screen requesting the app ID and app key:

    The Configure QQ Dialog Box
  7. Paste your QQ app ID in the App ID field, paste your QQ app key in the App Key field, and then click Save. QQ appears in your social login widget.

  8. When you are finished, select Save and Publish and then click Publish. It might take as long as one hour before QQ appears as a social login option on your web site.

See Also

Testing QQ Social Login

To test QQ social login, complete the following procedure:

  1. Do one of the following:

    • If you have just published your widget settings, click the Test your widget link that appears after the widget has been saved.
    • If you previously published your widget settings then, from the Engage Dashboard Sign-in page, click Launch a test widget.

  2. From the Test page, click the QQ icon:

    Testing QQ Logins
  3. In the QQ account security window, logon using a valid QQ account.

  4. If login succeeds, information returned from the QQ profile is displayed in the API response preview field.

The returned profile information will vary depending on the QQ account used in the test.

You can verify QQ profile fields by completing the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click QQ.

  3. Profile information returned from QQ is displayed onscreen. For example:

    QQ Basic Profile

See Also

Assigning a Different QQ App for Social Login

If you want to use a different QQ app or if you need to change your existing app, you must update the QQ provider configuration settings. To do that, complete the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click QQ.

  3. Click the green Configured button to display the QQ is currently enabled dialog box:

    The Modify QQ Dialog Box
  4. To change the QQ configuration, click Modify these settings.

  5. In the QQ dialog box, change the App ID and/or App Key as needed, and then click Save:

    The Configure QQ Dialog Box

Although you can modify your QQ settings, you cannot delete those settings. If you delete the settings and then try to save your changes, you’ll see the error message Please enter your Consumer Key and Secret exactly as QQ shows them.

This means that you cannot “unconfigure” the provider: once configured, the QQ icon will always be shown as green (i.e., configured) in the Janrain Dashboard.

Removing QQ as a Social Login Provider

You can remove QQ as a social login provider by completing the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. In the widget, click the X in the upper right corner of the QQ icon.
  6. Scroll to the bottom of the page, select Save and Publish, and then click Publish. QQ no longer appears in the sign-on widget.

Note. You must always have at least one social login provider in the widget. If you delete all the providers and then click Publish, you’ll see the error message Couldn’t save configuration: No providers.


Renren Social Login Configuration Guide

Renren is a Chinese social networking service used primarily by college students. Renren has approximately 31 million active users each month.

Before You Begin

Although not detailed in this configuration guide, you can create a Renren app that enables users to log on to your web site by using their Renren account. To create a Renren developer account, you must have a Chinese phone number:

Renren Registration

Although you can fill out the application forms on the Renren site, the required verification text message can only be sent to a Chinese phone number.

If you already have a Renren developer account, you can create a social login app from the Renren developer’s site (https://dev.renren.com/app).


Note. Web pages on the Renren Developers site are written in Chinese. If you do not speak Chinese, you might want to use a web browser than can translate the Renren web pages. For this configuration guide, we used Google Chrome and its Translate to English option.


In This Configuration Guide

Configuring Renren as a Social Login Provider

To configure Renren as a social login provider, make sure you have your Renren app key and app secret, and then complete the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. From the list of Providers, click Renren.
  6. In the Renren dialog box, click Next until you reach the screen requesting the app key and app secret:

    The Configure Renren Dialog Box
  7. Paste your Renren app key in the App Key field, paste your Renren app secret in the App Secret field, and then click Save. Renren appears in your social login widget.

  8. When you are finished, select Save and Publish and then click Publish. It might take as long as one hour before Renren appears as a social login option on your web site.

See Also

Testing Renren Social Login

To test Renren social login, complete the following procedure:

  1. Do one of the following:

    • If you have just published your widget settings, click the Test your widget link that appears after the widget has been saved.
    • If you previously published your widget settings then, from the Engage Dashboard Sign-in page, click Launch a test widget.

  2. From the Test page, click the Renren icon:

    Testing Renren Logins
  3. In the Connect with everyone window, logon using a valid Renren account:

    Testing Renren Logins
  4. If login succeeds, information returned from the Renren profile is displayed in the API response preview field.

The returned profile information will vary depending on the Renren account used in the test.

You can verify Renren profile fields by completing the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click Renren.

  3. Profile information returned from Renren is displayed onscreen. For example:

    Renren Basic Profile

See Also

Assigning a Different Renren App for Social Login

If you want to use a different Renren app or if you need to change your existing app, you must update the Renren provider configuration settings. To do that, complete the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click Renren.

  3. Click the green Configured button to display the Renren is currently enabled dialog box:

    The Modify Renren Dialog Box
  4. To change the Renren configuration, click Modify these settings.

  5. In the Renren dialog box, change the App Key and/or App Secret as needed, and then click Save:

    The Configure Renren Dialog Box

Although you can modify your Renren settings, you cannot delete those settings. If you delete the settings and then try to save your changes, you’ll see the error message Please enter your Consumer Key and Secret exactly as Renren shows them.

This means that you cannot “unconfigure” the provider: once configured, the Renren icon will always be shown as green (i.e., configured) in the Janrain Dashboard.

Removing Renren as a Social Login Provider

You can remove Renren as a social login provider by completing the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. In the widget, click the X in the upper right corner of the Renren icon.
  6. Scroll to the bottom of the page, select Save and Publish, and then click Publish. Renren no longer appears in the sign-on widget.

Note. You must always have at least one social login provider in the widget. If you delete all the providers and then click Publish, you’ll see the error message Couldn’t save configuration: No providers.


Salesforce Social Login Configuration Guide

Salesforce is a San Francisco-based cloud computing company. There are an estimated 4 million Salesforce subscribers.

Before You Begin

To use Salesforce for social login you must:

  1. Obtain a Salesforce developer’s account from https://login.salesforce.com.
  2. Do one of the following:
    • Open a previously-created Salesforce app, and copy the consumer key and consumer secret.
    • Create a new app and copy the consumer key and consumer secret.

  3. Use the Janrain Dashboard configure Salesforce as a social login provider.

In This Configuration Guide

Creating a Salesforce App

This section walks you through the process of creating an app that can be used to configure Salesforce social login. If you already have an app, see the Using an Existing Salesforce App for Social Login section of this documentation.

  1. Log on to the Salesforce Lightning Developers site at https://login.salesforce.com.
  2. From the Setup page, expand Apps and then click App Manager:

    Creating a Salesforce App
  3. From the Lightning Experience App Manager setup page, click New Connected App:

    Creating a Salesforce App
  4. On the New Connected App page, enter:

    • The name of your app in the Connected App Name field.
    • The API name of your app in the API Name field. This can be the same name as your connected app name; however, the API name cannot contain any blank spaces.
    • Your email address in the Contact Email field.

    Creating a Salesforce App
  5. Select Enable OAuth Settings.

  6. In the expanded OAuth settings section, in the Callback URL field, enter the Salesforce callback URL for your website. If you are using a standard Janrain domain, your redirect URL will look similar to this: https://greg-stemp.rpxnow.com/salesforce/callback.

  7. From the Available OAuth Scopes list, select the following three scopes and then click the Add button to add those items to the Selected OAuth Scopes list:

    • Access and manage your data (api)
    • Access your basic information (id, profile, email address, phone)
    • Perform requests on your behalf at any time (refresh_token, offline_access)

    Creating a Salesforce App
  8. Select Require Secret for Web Server Flow.

  9. Scroll to the bottom the page and then click Save:

    Creating a Salesforce App
  10. On the New Connected App page, click Continue:

    Creating a Salesforce App
  11. From the home page for your new app, click Click to reveal to display your consumer secret:

    Creating a Salesforce App
  12. Copy the Consumer Key and the Consumer Secret. You can copy this information to a text editor, then close the text editor after you have configured Janrain social login:

    Creating a Salesforce App
  13. Log off from the Salesforce Developer center.

Using an Existing Salesforce App for Social Login

If you already have a Salesforce app that can be used for social login, complete the following steps to retrieve the application’s consumer key and consumer secret:

  1. Log on to the Salesforce Lightning Developers site at https://login.salesforce.com.
  2. From the Setup page, expand Apps and then click App Manager:

    Use an Existing Salesforce App
  3. From the Lightning Experience App Manager page, click the Options button for your app and then click View:

    Use an Existing Salesforce App
  4. On the home page for your app, click Click to reveal:

    Use an Existing Salesforce App
  5. Copy and save the Consumer Key and the Consumer Secret. You can copy this information to a text editor, then close the text editor after you have configured Janrain social login:

    Use an Existing Salesforce App
  6. Log off from the Salesforce Developers site.

Configuring Salesforce as a Social Login Provider

To configure Salesforce as a social login provider, make sure you have your Salesforce consumer key and consumer secret, and then complete the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. From the list of Providers, click Salesforce.
  6. In the Salesforce dialog box, click Next until you reach the screen requesting the consumer key and consumer secret:

    The Configure Salesforce Dialog Box
  7. Paste your Salesforce consumer key in the Consumer Key field, paste your Salesforce consumer secret in the Consumer Secret field, and then click Save. Salesforce appears in your social login widget.

  8. When you are finished, select Save and Publish and then click Publish. It might take as long as one hour before Salesforce appears as a social login option on your web site.

See Also

Testing Salesforce Social Login

To test Salesforce social login, complete the following procedure:

  1. Do one of the following:

    • If you have just published your widget settings, click the Test your widget link that appears after the widget has been saved.
    • If you previously published your widget settings then, from the Engage Dashboard Sign-in page, click Launch a test widget.

  2. From the Test page, click the Salesforce icon:

    Testing Salesforce Logins
  3. In the Allow Access? | Salesforce window, click Allow, and then log on using a valid Salesforce account:

    Testing Salesforce Logins
  4. If login succeeds, information returned from the Salesforce profile is displayed in the API response preview field:

Salesforce API Response Preview

The returned profile information will vary depending on the Salesforce account used in the test.

You can verify Salesforce profile fields by completing the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click Salesforce.

  3. Profile information returned from Salesforce is displayed onscreen. For example:

    Salesforce Basic Profile

See Also

Assigning a Different Salesforce App for Social Login

If you want to use a different Salesforce app or if you need to change your existing app, you must update the Salesforce provider configuration settings. To do that, complete the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click Salesforce.

  3. Click the green Configured button to display the Salesforce is currently enabled dialog box:

    The Modify Salesforce Dialog Box
  4. To change the Salesforce configuration, click Modify these settings.

  5. In the Salesforce dialog box, change the Consumer Key and/or Consumer Secret as needed, and then click Save:

    The Configure Salesforce Dialog Box

Although you can modify your Salesforce settings, you cannot delete those settings. If you delete the settings and then try to save your changes, you’ll see the error message Please enter your Consumer Key and Secret exactly as Salesforce shows them.

This means that you cannot “unconfigure” the provider: once configured, the Salesforce icon will always be shown as green (i.e., configured) in the Janrain Dashboard.

Removing Salesforce as a Social Login Provider

If you no longer want to use Salesforce for social login, you can remove Salesforce as a social login provider by completing the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. In the widget, click the X in the upper right corner of the Salesforce icon.
  6. Scroll to the bottom of the page, select Save and Publish, and then click Publish. Salesforce no longer appears in the sign-on widget.

Note. You must always have at least one social login provider in the widget. If you delete all the providers and then click Publish, you’ll see the error message Couldn’t save configuration: No providers.


Sina Weibo Social Login Configuration Guide

Sina Weibo is a Chinese microblogging site (“weibo” is Chinese for “microblogging”) which has approximately 220 million subscribers and 100 million daily users.

Before You Begin

To use Sina Weibo for social login you must:

  1. Obtain a Sina Weibo developer’s account from https://open.weibo.com/developers.
  2. Do one of the following:
    • Open a previously-created Sina Weibo app, and copy the app key and app secret.
    • Create a new app and copy the app key and app secret.

  3. Use the Janrain Dashboard to configure Sian Weibo as a social login provider.

Note. Web pages on the Sina Weibo Developers site are written in Chinese. If you do not speak Chinese, you might want to use a web browser than can translate the Sina Weibo web pages. For this configuration guide, we used Google Chrome and its Translate to English option.


In This Configuration Guide

Creating a Sina Weibo Application

This section walks you through the process of creating a Sina Weibo application for social login. If you already have an application, see the Using an Existing Sina Weibo Application for Social Login section of this documentation.

To configure a Sina Weibo application, complete the following procedure:

  1. Log on to the Sina Weibo Developers site (https://open.weibo.com/developers).
  2. From the Developers site home page, click Web:

    Creating a Sina Weibo App
  3. From the Website access page, click Immediate access:

    Creating a Sina Weibo App
  4. On the Create a new application page, enter a name for your application in the Application Name field. Note that your application name cannot include blank spaces:

    Creating a Sina Weibo App
  5. Click Application Category and then click Web application.

  6. Select I have read and accepted the “microblogging developer agreement” and then click Create.

  7. On the Application status page, enter:

    • Your website URL in the Application Address field.
    • A brief description of your application in the first Application Description field.
    • A longer description of your application in the second Application Description field.

    Creating a Sina Weibo App
  8. Scroll down the page and locate the three green buttons used for uploading icons for your application:

    Creating a Sina Weibo App
  9. Click the first button (Add picture 1) and then use your operating system’s File Open dialog box to select a 16 pixel by 16 pixel icon (saved either as a .PNG or a .JPG file).

  10. Repeat the process with the Add picture 2 button to add an 80 pixel by 80 pixel icon, then click the Add picture 3 button to add a 120 pixel by 120 pixel icon.

  11. Click Save the above information to:

    Creating a Sina Weibo App
  12. Scroll back to the top of the page and, in the left navigation bar, click Advanced:

    Creating a Sina Weibo App
  13. On the Advanced Settings page, click Edit next to the label OAuth2.0 authorization settings:

    Creating a Sina Weibo App
  14. Enter your redirect URL in the Authorization callback page field. If you are using a standard Janrain domain, your redirect URL will look similar to this: https://greg-stemp.rpxnow.com/sinaweibo/callback.

  15. Enter your authorization cancellation page in the Cancel authorization callback field. This can simply be your website URL:

    Creating a Sina Weibo App
  16. Click Submit:

    Creating a Sina Weibo App
  17. On the Application Status page, copy and save the App Key and the App Secret. You can copy this information to a text editor, then close the text editor after you have configured Janrain social login:

    Use an Existing Sina Weibo App
  18. Log off from the Sina Weibo Developers site.

Using an Existing Sina Weibo Application for Social Login

If you already have a Sina Weibo application that can be used for social login, complete the following steps to retrieve the application’s app key and app secret:

  1. Log on to the Sina Weibo Developers site (https://open.weibo.com/developers).
  2. From the Sina Weibo Developers home page, click My Applications:

    Use an Existing Sina Weibo App
  3. From the home page for your applications, click the Settings icon for the application you want to use for social login:

    Use an Existing Sina Weibo App
  4. On the Application Status page, copy and save the App Key and the App Secret. You can copy this information to a text editor, then close the text editor after you have configured Janrain social login:

    Use an Existing Sina Weibo App
  5. Log off from the Sina Weibo Developers site.

Configuring Sina Weibo as a Social Login Provider

To configure Sina Weibo as a social login provider, make sure you have your Sina Weibo app key and app secret, and then complete the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. From the list of Providers, click Sina Weibo.
  6. In the Sina Weibo dialog box, click Next until you reach the screen requesting the app key and app secret:

    The Configure Sina Weibo Dialog Box
  7. Paste your Sina Weibo app key in the App Key field, paste your Sina Weibo app secret in the App Secret field, and then click Save. Sina Weibo appears in your social login widget.

  8. When you are finished, select Save and Publish and then click Publish. It might take as long as one hour before Sina Weibo appears as a social login option on your web site.

See Also

Testing Sina Weibo Social Login

To test Sina Weibo social login, complete the following procedure:

  1. Do one of the following:

    • If you have just published your widget settings, click the Test your widget link that appears after the widget has been saved.
    • If you previously published your widget settings then, from the Engage Dashboard Sign-in page, click Launch a test widget.

  2. From the Test page, click the Sina Weibo icon:

    Testing Sina Weibo Logins
  3. In the Application authorization window, click the red Allow button and then logon using a valid Sina Weibo account:

    Testing Sina Weibo Logins
  4. If login succeeds, information returned from the Sina Weibo profile is displayed in the API response preview field:

    Sina Weibo API Response Preview

The returned profile information will vary depending on the Sina Weibo account used in the test.

You can verify Sina Weibo profile fields by completing the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click Sina Weibo.

  3. Profile information returned from Sina Weibo is displayed onscreen. For example:

    Sina Weibo Basic Profile

See Also

Assigning a Different Sina Weibo App for Social Login

If you want to use a different Sina Weibo app or if you need to change your existing app, you must update the Sina Weibo provider configuration settings. To do that, complete the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click Sina Weibo.

  3. Click the green Configured button to display the Sina Weibo is currently enabled dialog box:

    The Modify Sina Weibo Dialog Box
  4. To change the Sina Weibo configuration, click Modify these settings.

  5. In the Sina Weibo dialog box, change the App Key and/or App Secret as needed, and then click Save:

    The Configure Sina Weibo Dialog Box

Although you can modify your Sina Weibo settings, you cannot delete those settings. If you delete the settings and then save your changes, you’ll see the error message Please enter your Consumer Key and Secret exactly as Sina Weibo shows them.

This means that you cannot “unconfigure” the provider: once configured, the Sina Weibo icon will always be shown as green (i.e., configured) in the Janrain Dashboard.

Removing Sina Weibo as a Social Login Provider

You can remove Sina Weibo as a social login provider by completing the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. In the widget, click the X in the upper right corner of the Sina Weibo icon.
  6. Scroll to the bottom of the page, select Save and Publish, and then click Publish. Sina Weibo no longer appears in the sign-on widget.

Note. You must always have at least one social login provider in the widget. If you delete all the providers and then click Publish, you’ll see the error message Couldn’t save configuration: No providers.


SoundCloud Social Login Configuration Guide

SoundCloud is a German-based distribution service that enables users to upload, promote, and share music that they have created. SoundCloud has approximately 175 million users from all over the world.

Before You Begin

At the moment, SoundCloud is not accepting new application registrations:

SoundCloud Application Registration

Because of that, new SoundCloud applications cannot be provisioned. However, previously-created SoundCloud applications can still be used for social login.

In This Configuration Guide

Using an Existing SoundCloud App for Social Login

If you already have a SoundCloud app that can be used for social login, complete the following steps to retrieve the application’s client ID and client secret:

  1. Log on to SoundCloud for Developers (https://developers.soundcloud.com).
  2. From the SoundCloud for Developers home page, click Your Apps and then click the name of the app you want to use to configure social login:

    Use an Existing SoundCloud App
  3. Copy the client ID and client secret. You can copy this information to a text editor, then close the text editor after you have configured Janrain social login.

  4. Log off of SoundCloud for Developers.

Configuring SoundCloud as a Social Login Provider

To configure SoundCloud as a social login provider, make sure you have your SoundCloud client ID and client secret, and then complete the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. From the list of Providers, click SoundCloud.
  6. In the SoundCloud dialog box, click Next until you reach the screen requesting the client ID and client secret:

    The Configure SoundCloud Dialog Box
  7. Paste your SoundCloud client ID in the Client ID field, paste your SoundCloud client secret in the Client Secret field, and then click Save. SoundCloud appears in your social login widget.

  8. When you are finished, select Save and Publish and then click Publish. It might take as long as one hour before SoundCloud appears as a social login option on your web site.

See Also

Testing SoundCloud Social Login

To test SoundCloud social login, complete the following procedure:

  1. Do one of the following:

    • If you have just published your widget settings, click the Test your widget link that appears after the widget has been saved.
    • If you previously published your widget settings then, from the Engage Dashboard Sign-in page, click Launch a test widget.

  2. From the Test page, click the SoundCloud icon:

    Testing SoundCloud Logins
  3. Logon using a valid SoundCloud account.

  4. If login succeeds, information returned from the SoundCloud profile is displayed in the API response preview field.

The returned profile information will vary depending on:

  • The SoundCloud account used in the test.
  • The profile information you requested for SoundCloud.

You can verify SoundCloud profile fields by completing the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click SoundCloud.

  3. Profile information returned from SoundCloud is displayed onscreen. For example:

    SoundCloud Basic Profile

Assigning a Different SoundCloud App for Social Login

If you need to change your existing app, you must update the SoundCloud provider configuration settings. To do that, complete the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click SoundCloud.

  3. Click the green Configured button to display the SoundCloud is currently enabled dialog box:

    The Modify SoundCloud Dialog Box
  4. To change the SoundCloud configuration, click Modify these settings.

  5. In the SoundCloud dialog box, change the Client ID and/or Client Secret as needed, and then click Save:

    The Configure SoundCloud Dialog Box

Although you can modify your SoundCloud settings, you cannot delete those settings. If you delete the settings and then try to save your changes, you’ll see the error message Please enter your Consumer Key and Secret exactly as SoundCloud shows them.

This means that you cannot “unconfigure” the provider: once configured, the SoundCloud icon will always be shown as green (i.e., configured) in the Janrain Dashboard.

See Also

Removing SoundCloud as a Social Login Provider

If you no longer want to use SoundCloud for social login, you can remove SoundCloud as a social login provider by completing the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. In the widget, click the X in the upper right corner of the SoundCloud icon.
  6. Scroll to the bottom of the page, select Save and Publish, and then click Publish. SoundCloud no longer appears in the sign-on widget.

Note. You must always have at least one social login provider in the widget. If you delete all the providers and then click Publish, you’ll see the error message Couldn’t save configuration: No providers.


Tencent Weibo Social Login Configuration Guide

Tencent Weibo is a Chinese microblogging site that includes Twitter-like features such as the ability to post messages of 140 characters or less, and to “retweet” those messages. One estimate places Tencent Weibo’s current number of users at 220 million.

Although it appears in the Engage Dashboard UI, Tencent Weibo can no longer be used as a Janrain social login provider.

Removing Tencent Weibo as a Social Login Provider

You can remove Tencent Weibo as a social login provider by completing the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. In the widget, click the X in the upper right corner of the Tencent Weibo icon.
  6. Scroll to the bottom of the page, select Save and Publish, and then click Publish. Tencent Weibo no longer appears in the sign-on widget.

Note. You must always have at least one social login provider in the widget. If you delete all the providers and then click Publish, you’ll see the error message Couldn’t save configuration: No providers.


Tumblr Social Login Configuration Guide

Tumblr is a microblogging and social networking site that hosts over 350 million blogs.

Before You Begin

To use Tumblr for social login you must:

  1. Obtain a Tumblr developer’s account from https://tumblr.com/oauth/apps.
  2. Do one of the following:
    • Open a previously-created Tumblr application, and copy the OAuth consumer key and secret key.
    • Create a new Tumblr application and copy the OAuth consumer key and secret key.

  3. Use the Janrain Engage Dashboard and the Tumblr OAuth consumer key and secret key to configure Tumblr as a social login provider.

In This Configuration Guide

Creating a Tumblr Application

This section walks you through the process of creating a Tumblr application for social login. If you already have an application, see the Using an Existing Tumblr Application for Social Login section of this documentation.

To configure a Tumblr application, complete the following procedure:

  1. Log on to the Tumblr Applications site (https://www.tumblr.com/oauth/apps).
  2. From the Applications page, click Register application:

    Creating a Tumblr App
  3. On the Register your application page, enter:

    • The name of your application in the Application Name field.
    • The URL of your web site in the Application Website field.
    • A brief description of your application in the Application Description field.
    • Your contact email address in the Administrative contact email field.
    • Your Tumblr redirect URL in the Default callback URL field. If you are using a standard Janrain domain, your redirect URL will look similar to this: https://greg-stemp.rpxnow.com/tumblr/callback.

    Creating a Tumblr App
  4. Scroll to the bottom of the page, select I’m not a robot and then click Register:

    Creating a Tumblr App
  5. From the home page for your new app, click Show secret key:

    Creating a Tumblr App
  6. Copy the OAuth Consumer Key and the Secret Key. You can copy this information to a text editor, then close the text editor after you have configured Janrain social login:

    Creating a Tumblr App
  7. Log off from the Tumblr Applications site.

Using an Existing Tumblr Application for Social Login

If you already have a Tumblr application that can be used for social login, complete the following steps to retrieve the application’s OAuth consumer key and secret key:

  1. Log on to the Tumblr Applications site (https://www.tumblr.com/oauth/apps).
  2. From the Applications page, locate the application you want to use for configuring social login and copy the OAuth Consumer Key. You can copy this information to a text editor, then close the text editor after you have configured Janrain social login. Click Show secret key:

    Use an Existing Tumblr App
  3. Copy the Secret Key. You can copy this information to a text editor, then close the text editor after you have configured Janrain social login:

    Use an Existing Tumblr App
  4. Log off from the Tumblr Applications site.

Configuring Tumblr as a Social Login Provider

To configure Tumblr as a social login provider, make sure you have your Tumbler OAuth consumer key and secret key, and then complete the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. From the list of Providers, click Tumblr.
  6. In the Tumblr dialog box, click Next until you reach the screen requesting the OAuth consumer key and secret key:

    The Configure Tumblr Dialog Box
  7. Paste your Tumblr OAuth consumer key in the OAuth Consumer Key field, paste your Tumblr secret key in the Secret Key field, and then click Save. Tumblr appears in your social login widget.

  8. When you are finished, select Save and Publish and then click Publish. It might take as long as one hour before Tumblr appears as a social login option on your web site.

See Also

Testing Tumblr Social Login

To test Tumblr social login, complete the following procedure:

  1. Do one of the following:

    • If you have just published your widget settings, click the Test your widget link that appears after the widget has been saved.
    • If you previously published your widget settings then, from the Engage Dashboard Sign-in page, click Launch a test widget.

  2. From the Test page, click the Tumblr icon:

    Testing Tumblr Logins
  3. In the Log in | Tumblr window, logon using a valid Tumblr account:

    Testing Tumblr Logins
  4. If login succeeds, information returned from the Tumblr profile is displayed in the API response preview field:

    Tumblr API Response Preview

The returned profile information will vary depending on the Tumblr account used in the test.

You can verify Tumblr profile fields by completing the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click Tumblr.

  3. Profile information returned from Tumblr is displayed onscreen. For example:

    Tumblr Basic Profile

See Also

Assigning a Different Tumblr Application for Social Login

If you want to use a different Tumblr app or if you need to change your existing app, you must update the Tumblr provider configuration settings. To do that, complete the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click Tumblr.

  3. Click the green Configured button to display the Tumblr is currently enabled dialog box:

    The Modify Tumblr Dialog Box
  4. To change the Tumblr configuration, click Modify these settings.

  5. In the Tumblr dialog box, change the OAuth Consumer Key and/or the Secret Key as needed, and then click Save:

    The Configure Tumblr Dialog Box

Although you can modify your Tumblr settings, you cannot delete those settings. If you delete the settings and then try to save your changes, you’ll see the error message Please enter your Consumer Key and Secret exactly as Tumblr shows them.

This means that you cannot “unconfigure” the provider: once configured, the Tumblr icon will always be shown as green (i.e., configured) in the Janrain Dashboard.

Removing Tumblr as a Social Login Provider

If you no longer want to use Tumblr for social login, you can remove Tumblr as a social login provider by completing the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. In the widget, click the X in the upper right corner of the Tumblr icon.
  6. Scroll to the bottom of the page, select Save and Publish, and then click Publish. Tumblr no longer appears in the sign-on widget.

Note. You must always have at least one social login provider in the widget. If you delete all the providers and then click Publish, you’ll see the error message Couldn’t save configuration: No providers.


Twitter Social Login Configuration Guide

Twitter is a social news and networking site with more than 300 million active users each month.

Before You Begin

To use Twitter for social login you must:

  1. Obtain a Twitter developer’s account from https://apps.twitter.com.
  2. Do one of the following:
    • Open a previously-created Twitter app, and copy the consumer key (API key) and consumer secret (API secret).
    • Create a new Twitter app and copy the consumer key and consumer secret.

  3. Use the Janrain Dashboard and the Twitter consumer key and consumer secret to configure Twitter as a social login provider.

** In This Configuration Guide**

Creating a Twitter App for Social Login

This section walks you through the process of creating a Twitter app for social login. If you already have an app, see the Using an Existing Twitter App for Social Login section of this documentation.

To create a Twitter app, complete the following procedure:

  1. Log on to the Twitter Apps (https://apps.twitter.com) site.
  2. From the Twitter Apps home page, click Create New App:

    Creating a Twitter App
  3. On the Create an Application page, enter:

    • The name of your application in the Name field.
    • A brief description of your application in the Description field.
    • The URL of your website in the Website field.
    • Your Twitter callback URL in the Callback URL field. If you are using a standard Janrain domain, your callback URL will look similar to this: https://greg-stemp.rpxnow.com/twitter/callback.

  4. Select Yes, I have read and agree to the Twitter Developer Agreement and then click Create your Twitter application:

    Creating a Twitter App
  5. On the Application Settings page, under Token Actions, click Create my access token:

    Creating a Twitter App
  6. Click Keys and Access Tokens:

    Creating a Twitter App
  7. From the Keys and Access Tokens tab, copy the Consumer Key (API Key) and the Consumer Secret (API Secret). You can copy this information to a text editor, then close the text editor after you have configured Janrain social login:

    Creating a Twitter App
  8. Log off from Twitter Apps.

Using an Existing Twitter App for Social Login

If you already have a Twitter app for social login, complete the following steps to retrieve the application’s API key and API secret:

  1. Log on to the Twitter Apps home page (https://app.twitter.com).
  2. From the Twitter Apps home page, click the name of the app you want to use to configure social login:

    Use an Existing Twitter App
  3. From the home page for your app, click Keys and Access Tokens:

    Use an Existing Twitter App
  4. From the Keys and Access Tokens tab, copy the Consumer Key (API Key) and the Consumer Secret (API Secret). You can copy this information to a text editor, then close the text editor after you have configured Janrain social login:

    Use an Existing Twitter App
  5. Log off from Twitter Apps.

Configuring Twitter as a Social Login Provider

To configure Twitter as a social login provider, make sure you have your Twitter consumer key and consumer secret, and then complete the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. From the list of Providers, click Twitter.
  6. In the Twitter dialog box, click Next until you reach the screen requesting the API key and API secret:

    The Configure Twitter Dialog Box
  7. Paste your Twitter consumer key in the API Key field, paste your Twitter consumer secret in the API Secret field, and then click Save. Twitter appears in your social login widget.

  8. When you are finished, select Save and Publish and then click Publish. It might take as long as one hour before Twitter appears as a social login option on your web site.

See Also

Testing Twitter Social Login

To test Twitter social login, complete the following procedure:

  1. Do one of the following:

    • If you have just published your widget settings, click the Test your widget link that appears after the widget has been saved.
    • If you previously published your widget settings then, from the Engage Dashboard Sign-in page, click Launch a test widget.

  2. From the Test page, click the Twitter icon:

    Testing Twitter Logins
  3. In the Twitter / Authorize an application window, logon using a valid Twitter account:

    Testing Twitter Logins
  4. If login succeeds, information returned from the Twitter profile is displayed in the API response preview field:

    Twitter API Response Preview

The returned profile information will vary depending on the Twitter account used in the test.

You can verify Twitter profile fields by completing the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click Twitter.

  3. Profile information returned from Twitter is displayed onscreen. For example:

    Twitter Basic Profile

See Also

Assigning a Different Twitter App for Social Login

If you want to use a different Twitter app or if you need to change your existing app, you must update the Twitter provider configuration settings. To do that, complete the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click Twitter.

  3. Click the green Configured button to display the Twitter is currently enabled dialog box:

    The Modify Twitter Dialog Box
  4. To change the Twitter configuration, click Modify these settings.

  5. In the Twitter dialog box, change the App Key and/or App Secret as needed, and then click Save:

    The Configure Google Dialog Box

Although you can modify your Twitter settings, you cannot delete those settings. If you delete the settings and then try to save your changes, you’ll see the error message Please enter your Consumer Key and Secret exactly as Twitter shows them.

This means that you cannot “unconfigure” the provider: once configured, the Twitter icon will always be shown as green (i.e., configured) in the Janrain Dashboard.

Removing Twitter as a Social Login Provider

If you no longer want to use Twitter for social login, you can remove Twitter as a social login provider by completing the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. In the widget, click the X in the upper right corner of the Twitter icon.
  6. Scroll to the bottom of the page, select Save and Publish, and then click Publish. Twitter no longer appears in the sign-on widget.

Note. You must always have at least one social login provider in the widget. If you delete all the providers and then click Publish, you’ll see the error message Couldn’t save configuration: No providers.


VK Social Login Configuration Guide

VK is a social media/social networking website based in Russia. VK has over 400 million subscribers.

Before You Begin

To use VK for social login you must:

  1. Obtain a VK developer’s account from https://vk.com/dev.
  2. Do one of the following:
    • Open a previously-created VK app, and copy the application ID and secure key.
    • Create a new VK app and copy the application ID and secure key.

  3. Use the Janrain Engage Dashboard and the VK application ID and secure key to configure VK as a social login provider.

In This Configuration Guide

Creating a VK App

This section walks you through the process of creating a VK app for social login. If you already have an app, see the Using an Existing VK App for Social Login section of this documentation.

To configure a VK app, complete the following procedure:

  1. Log on the VK Developers site (https://vk.com/dev).
  2. From the VK Developers home page, click My apps:

    Creating a VK App
  3. From the My applications page click Create an Application:

    Creating a VK App
  4. On the Create an Application page, select Website and then click Connect Application:

    Creating a VK App
  5. From the Confirmation required dialog box, click Get code:

    Creating a VK App
  6. A confirmation code will be sent to you via text message. Type the code in the Confirmation code field and then click Confirm:

    Creating a VK App
  7. On the Information page, type a title for your app in the Title field and then click Save:

    Creating a VK App
  8. Click Settings. On the Settings page, enter:

    • Your website URL in the Site address field.
    • Your “base domain” (your website URL minus the HTTP:// or HTTPS:// protocol) in the Base domain field.
    • Your VK redirect URL in the Authorized redirect URI field. If you are using a standard Janrain domain, your redirect URL will look similar to this: https://greg-stemp.rpxnow.com/vk/callback.

  9. Click Save.

  10. Copy the VK Application ID and Secure key. You can copy this information to a text editor, then close the text editor after you have configured Janrain social login:

    Creating a VK App
  11. Log off from the VK developer’s site.

Using an Existing VK App for Social Login

If you already have a VK app that can be used for social login, complete the following steps to retrieve the application ID and secure key:

  1. Log on to the VK Developers site (https://vk.com/dev).
  2. From the VK Developers home page, click My apps:

    Use an Existing VK App
  3. From the My applications page, locate the app you want to use for configuring social login and then click Manage:

    Use an Existing VK App
  4. From the home page for your app, click Settings:

    Use an Existing VK App
  5. From the Settings page, copy the Application ID and the Secure key. You can copy this information to a text editor, then close the text editor after you have configured Janrain social login:

    Use an Existing VK App
  6. Log off from the VK Developers site.

Configuring VK as a Social Login Provider

To configure VK as a social login provider, make sure you have your VK OAuth application ID and secure key, and then complete the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. From the list of Providers, click VK.
  6. In the VK dialog box, click Next until you reach the screen requesting the application ID and secure key:

    The Configure VK Dialog Box
  7. Paste your VK application ID in the Application ID field, paste your VK secure key in the Secure Key field, and then click Save. VK appears in your social login widget.

  8. When you are finished, select Save and Publish and then click Publish. It might take as long as one hour before VK appears as a social login option on your web site.

See Also

Testing VK Social Login

To test VK social login, complete the following procedure:

  1. Do one of the following:

    • If you have just published your widget settings, click the Test your widget link that appears after the widget has been saved.
    • If you previously published your widget settings then, from the Engage Dashboard Sign-in page, click Launch a test widget.

  2. From the Test page, click the VK icon:

    Testing VK Logins
  3. In the VK | Login window, logon using a valid VK account:

    Testing Tumblr Logins
  4. If login succeeds, information returned from the VK profile is displayed in the API response preview field:

    VK API Response Preview

The returned profile information will vary depending on:

  • The VK account used in the test.
  • The profile information you requested for VK.

You can verify VK profile fields by completing the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click VK.

  3. Profile information returned from VIK is displayed onscreen. For example:

    VK Basic Profile

Fields not marked with an Off or an Ask label are automatically returned when a user logs on using a VK account.

For fields that are marked with a label, click Off to request that the information be returned. The Off label will change to Ask, meaning that, at logon time, the user will be asked whether he or she gives permission for that data to be returned:

VK Permission Required Fields

For example, if you ask for a user’s contact information during logon, he or she will see the following message before they log on:

Testing VK Logins

The user can either click Allow to forward all the requested information, or can click Cancel to terminate logon.

On the Configure Providers page, click Ask to turn off the information request.

See Also

Assigning a Different VK App for Social Login

If you want to use a different VK app or if you need to change your existing app, you must update the VK provider configuration settings. To do that, complete the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click VK.

  3. Click the green Configured button to display the VK is currently enabled dialog box:

    The Modify VK Dialog Box
  4. To change the VK configuration, click Modify these settings.

  5. In the VK dialog box, change the Application ID and/or Secure Key as needed, and then click Save:

    The Configure VK Dialog Box

Although you can modify your VK settings, you cannot delete those settings. If you delete the settings and then try to save your changes, you’ll see the error message Please enter your Consumer Key and Secret exactly as VK shows them.

This means that you cannot “unconfigure” the provider: once configured, the VK icon will always be shown as green (i.e., configured) in the Janrain Dashboard.

Removing VK as a Social Login Provider

If you no longer want to use VK for social login, you can remove VK as a social login provider by completing the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. In the widget, click the X in the upper right corner of the VK icon.
  6. Scroll to the bottom of the page, select Save and Publish, and then click Publish. VK no longer appears in the sign-on widget.

Note. You must always have at least one social login provider in the widget. If you delete all the providers and then click Publish, you’ll see the error message Couldn’t save configuration: No providers.


WeChat Social Login Configuration Guide

WeChat is a Chinese social media application that has nearly 1 billion active users each month.

Before You Begin

Although not detailed in this configuration guide, you can create a new WeChat app that enables users to log on to your web site by using their WeChat account. To create a WeChat developer account, you must complete a lengthy application process that requires supplying information such as your personal ID and business license:

WeChat Registration

If you already have a WeChat developer account, you can create a social login app from the WeChat developer’s site (https://open.wechat.com).


Note. Web pages on the WeChat Developers site are written in Chinese. If you do not speak Chinese, you might want to use a web browser than can translate the WeChat web pages. For this configuration guide, we used Google Chrome and its Translate to English option.


In This Configuration Guide

Configuring WeChat as a Social Login Provider

To configure WeChat as a social login provider, make sure you have your WeChat application key and application secret, and then complete the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. From the list of Providers, click We Chat.
  6. In the WeChat dialog box, click Next until you reach the screen requesting the application key and application secret:

    The Configure WeChat Dialog Box
  7. Paste your WeChat application key in the Application Key field, paste your WeChat application secret in the Application Secret field, and then click Save. WeChat appears in your social login widget.

  8. When you are finished, select Save and Publish and then click Publish. It might take as long as one hour before WeChat appears as a social login option on your web site.

See Also

Testing WeChat Social Login

To test WeChat social login, complete the following procedure:

  1. Do one of the following:

    • If you have just published your widget settings, click the Test your widget link that appears after the widget has been saved.
    • If you previously published your widget settings then, from the Engage Dashboard Sign-in page, click Launch a test widget.

  2. From the Test page, click the WeChat icon:

    Testing WeChat Logins
  3. In the Login to WeChat window, logon using a valid WeChat account:

    Testing WeChat Logins
  4. If login succeeds, information returned from the WeChat profile is displayed in the API response preview field.

The returned profile information will vary depending on the WeChat account used in the test.

You can verify WeChat profile fields by completing the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click WeChat.

  3. Profile information returned from WeChat is displayed onscreen. For example:

    WeChat Basic Profile

See Also

Assigning a Different WeChat App for Social Login

If you want to use a different WeChat app or if you need to change your existing app, you must update the WeChat provider configuration settings. To do that, complete the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click WeChat.

  3. Click the green Configured button to display the WeChat is currently enabled dialog box:

    The Modify WeChat Dialog Box
  4. To change the WeChat configuration, click Modify these settings.

  5. In the WeChat dialog box, change the Application Key and/or Application Secret as needed, and then click Save:

    The Configure WeChat Dialog Box

Although you can modify your WeChat settings, you cannot delete those settings. If you delete the settings and then try to save your changes, you’ll see the error message Please enter your Consumer Key and Secret exactly as WeChat shows them.

This means that you cannot “unconfigure” the provider: once configured, the WeChat icon will always be shown as green (i.e., configured) in the Janrain Dashboard.

Removing WeChat as a Social Login Provider

You can remove WeChat as a social login provider by completing the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. In the widget, click the X in the upper right corner of the WeChat icon.
  6. Scroll to the bottom of the page, select Save and Publish, and then click Publish. WeChat no longer appears in the sign-on widget.

Note. You must always have at least one social login provider in the widget. If you delete all the providers and then click Publish, you’ll see the error message Couldn’t save configuration: No providers.


WordPress Social Login Configuration Guide

WordPress is a content management service known for hosting both websites and blogs. It is estimated that WordPress hosts more than 60 million websites.

Although it appears in the Engage Dashboard UI, WordPress can no longer be used as a Janrain social login provider.

Removing WordPress as a Social Login Provider

You can remove WordPress as a social login provider by completing the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. In the widget, click the X in the upper right corner of the WordPress icon.
  6. Scroll to the bottom of the page, select Save and Publish, and then click Publish. WordPress no longer appears in the sign-on widget.

Note. You must always have at least one social login provider in the widget. If you delete all the providers and then click Publish, you’ll see the error message Couldn’t save configuration: No providers.


Xing Social Login Configuration Guide

Xing is a European-based career-oriented social networking site (similar to LinkedIn) that hosts users from more than 200 different countries, including 11 million users in Germany, Austria, and Switzerland.

Before You Begin

As of Jan. 31, 2017, Xing has closed its public API. Existing apps are still functioning at this time, but it’s unclear how long they will continue to do so.

In This Configuration Guide

Using an Existing Xing App for Social Login

Xing has deprecated their public API as of January 2017. Because of this, new Xing applications cannot be provisioned. However, if you have a previously-created Xing application that app can still be used for social login.

  1. Log on to Xing Developers site (https://dev.xing.com).
  2. From the Xing Developer page, click Dashboards and then click My Apps:

    Use an Existing Xing App
  3. From the My Apps page, click the name of the app you want to use for social login.

  4. Copy the consumer key and consumer secret. You can copy this information to a text editor, then close the text editor after you have configured Janrain social login.

  5. Log off of the Xing Developers site.

Configuring Xing as a Social Login Provider

To configure Xing as a social login provider, make sure you have your Xing consumer key and consumer secret, and then complete the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. From the list of Providers, click Xing.
  6. In the Xing dialog box, click Next until you reach the screen requesting the consumer key and consumer secret:

    The Configure Xing Dialog Box
  7. Paste your Xing consumer key in the Consumer Key field, paste your Xing consumer secret in the Consumer Secret field, and then click Save. Xing appears in your social login widget.

  8. When you are finished, select Save and Publish and then click Publish. It might take as long as one hour before Xing appears as a social login option on your web site.

See Also

Testing Xing Social Login

To test Xing social login, complete the following procedure:

  1. Do one of the following:

    • If you have just published your widget settings, click the Test your widget link that appears after the widget has been saved.
    • If you previously published your widget settings then, from the Engage Dashboard Sign-in page, click Launch a test widget.

  2. From the Test page, click the Xing icon:

    Testing Xing Logins
  3. In the Xing window, logon using a valid Xing account:

    Testing Xing Logins
  4. If login succeeds, information returned from the Xing profile is displayed in the API response preview field.

The returned profile information will vary depending on the Xing account used in the test.

You can verify Xing profile fields by completing the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click Xing.

  3. Profile information returned from Xing is displayed onscreen. For example:

    Xing Basic Profile

See Also

Assigning a Different Xing App for Social Login

If you need to change your existing app, you must update the Xing provider configuration settings. To do that, complete the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click Xing.

  3. Click the green Configured button to display the Xing is currently enabled dialog box:

    The Modify Xing Dialog Box
  4. To change the Xing configuration, click Modify these settings.

  5. In the Xing dialog box, change the Consumer Key and/or Consumer Secret as needed, and then click Save:

    The Configure Xing Dialog Box

Although you can modify your Xing settings, you cannot delete those settings. If you delete the settings and then try to save your changes, you’ll see the error message Please enter your Consumer Key and Secret exactly as Xing shows them.

This means that you cannot “unconfigure” the provider: once configured, the Xing icon will always be shown as green (i.e., configured) in the Janrain Dashboard.

Removing Xing as a Social Login Provider

You can remove Xing as a social login provider by completing the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. In the widget, click the X in the upper right corner of the Xing icon.
  6. Scroll to the bottom of the page, select Save and Publish, and then click Publish. Xing no longer appears in the sign-on widget.

Note. You must always have at least one social login provider in the widget. If you delete all the providers and then click Publish, you’ll see the error message Couldn’t save configuration: No providers.


Yahoo! Social Login Configuration Guide

Yahoo! is an American web services provider that serves content to over 1 billion users each month. Yahoo! Mail alone has an estimated 225 million users.

Before You Begin

To use Yahoo! for social login you must:

  • Use the Janrain Dashboard to configure Yahoo! as a social login provider. No additional configuration is required.

In This Configuration Guide

Configuring Yahoo! as a Social Login Provider

To configure Yahoo! as a social login provider, complete the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. From the list of Providers, click Yahoo!. Yahoo appears in your social login widget.
  6. When you are finished, select Save and Publish and then click Publish. It might take as long as one hour before Yahoo! appears as a social login option on your web site.

See Also

Testing Yahoo! Social Login

To test Yahoo! social login, complete the following procedure:

  1. From the Sign-in page, click Launch a test widget.
  2. From the Test page, click the Yahoo! icon:

    Testing Yahoo! Login
  3. In the Yahoo! - login window, logon using a valid Yahoo! account:

    Testing Yahoo! Logins
  4. If login succeeds, information returned from the Yahoo! profile is displayed in the API response preview field:

    Yahoo! API Response Preview

The returned profile information will vary depending on:

  • The Yahoo! account used in the test.
  • The profile information you requested for Yahoo!

You can verify Yahoo! profile fields by completing the following procedure:

  1. From the Engage Dashboard home page, click the Manage Providers icon:

    The Manage Providers Icon
  2. From the Configure Providers page, click Yahoo!.

  3. Profile information returned from Yahoo! is displayed onscreen. For example:

    Yahoo! Basic Profile

Fields not marked with an Off or an Ask label are automatically returned when a user logs on using a Yahoo! account.

For fields that are marked with a label, click Off to request that the information be returned. The Off label will change to Ask, meaning that, at logon time, the user will be asked whether he or she gives permission for that data to be returned:

Yahoo! Permission Required Fields

On the Configure Providers page, click Ask to turn off the information request.

See Also

Removing Yahoo! as a Social Login Provider

If you no longer want to use Yahoo! for social login, you can remove Yahoo! as a social login provider by completing the following procedure:

  1. Log on to your Janrain Dashboard (https://dashboard.janrain.com).
  2. From the Dashboard home page, click the Manage Engage Dashboard icon.
  3. From the Engage Dashboard home page, in the Widgets and SDKs section, click Sign-Ins.
  4. From the Sign-in page, verify that Widget is selected and then expand Providers.
  5. In the widget, click the X in the upper right corner of the Yahoo! icon.
  6. Scroll to the bottom of the page, select Save and Publish, and then click Publish. Yahoo! no longer appears in the sign-on widget.

Note. You must always have at least one social login provider in the widget. If you delete all the providers and then click Publish, you’ll see the error message Couldn’t save configuration: No providers.


User Profile Data by Provider

Identity providers return user profile data along with session information when a user authenticates successfully. You can use the user profile information to help the user by filling out sign-up or registration forms, as well as to recognize each user and learn more about them in order to give the user a tailored experience.

The Janrain servers return normalized user profile data in standard Portable Contacts (POCO) format. This makes it easier for you to parse and use the profile data without having to learn about each provider’s data format.

Normalized User Profile Data

Janrain Social Login converts the data we receive in one of the diverse data formats returned by the identity providers into a single standard format. We call this process normalization. Programmers save time immediately by learning only one format, and repeatedly by not needing to update their code when new providers are added or providers change their data format.

Personal Data Fields

This section outlines the fields in the normalized profile structure. The Availability column shows whether or not all providers include the field in their profile data responses.

Key Description Availability
address See the address Field section for details. Available from most providers (with user consent).
birthday Date of birth in YYYY-MM-DD format. The Year field value may be 0000 if unavailable. Available from most providers (with user consent).
displayName The name of this contact, suitable for display to end users. Available from most providers (with user consent).
email An email address at which the person may be reached. Available from most providers (with user consent). Not available from LinkedIn, MySpace, or Twitter.
gender The person’s gender. Canonical values are female and male, but it may be any value. Available from most providers (with user consent).
identifier The user’s OpenID URL. Use this value to sign the user in to your website. Guaranteed
limitedData A boolean value. The value is true if Social Login was able to retrieve only limited public data from the user’s profile (for example, because the login session has expired or the user logged out from his/her account). If Janrain Social Login succeeded in retrieving the complete set of data, this field will be missing or set to false. Provided only by Facebook.
name A dictionary of name parts. See the name Field section for details. Available from most providers (with user consent). Yahoo! returns only a full name, not a first name or last name field.
phoneNumber A phone number at which the person may be reached. Available from most providers (with user consent).
photo The URL to a photo (GIF, JPG, or PNG) of the person. Available from most providers (with user consent).
preferredUsername The preferred user name of this contact (for sites that ask for a user name). Available from most providers (with user consent).
primaryKey The primary key of the user in your database. Present only if you are using the mapping API. Guaranteed (if a mapping exists).
providerName A human-readable name of the authentication provider that was used for this authentication. For well-known providers, Janrain sends values such as Google, Facebook, and MySpace (Other is sent for other providers). New provider names are added over time. Guaranteed
URL The URL of a webpage relating to this person. Available from most providers (with user consent).
utcOffset The offset from UTC of this contact’s current time zone, as of the time this response was returned. The value must conform to the offset portion of xs:dateTime (for example, -08:00).
Note: This value may change over time due to daylight savings time, and is thus meant to signify only the current value of the user’s timezone offset.
Available from most providers (with user consent).
verifiedEmail A timestamp. Available from:
  • Facebook
  • Foursquare
  • Google
  • PayPal
  • SalesForce
  • Yahoo!

name Field

The name field holds components of the end user’s real name. Providers may return:

  • The full name as a single string in the formatted sub-field, or
  • The individual component fields (using the other sub-fields), or
  • Both

If a provider returns both variants, the provider should describe the same name, with the formatted name indicating how the component fields should be combined.

Key Description
familyName The family name of this contact (last name in most Western languages).
For example, “Smarr”, full name “Mr. Joseph Robert Smarr, Esq.”.
formatted The full name, including all middle names, titles, and suffixes (as appropriate) formatted for display.
For example, “Mr. Joseph Robert Smarr, Esq.”.
This is the primary sub-field for this field, for the purposes of sorting and filtering.
givenName The given name of this contact (first name in most Western languages).
For example, “Joseph”, full name “Mr. Joseph Robert Smarr, Esq.”.
honorificPrefix The honorific prefix(es) of this contact (title in most Western languages).
For example, “Mr.”, full name “Mr. Joseph Robert Smarr, Esq.”.
honorificSuffix The honorific suffix(es) of this contact (suffix in most Western languages).
For example, “Esq.”, full name “Mr. Joseph Robert Smarr, Esq.”.
middleName The middle name(s) of this contact.
For example, “Robert”, full name “Mr. Joseph Robert Smarr, Esq.”.

address Field

Note: Not all providers return all address data, and the level of specificity of the address is determined by each provider.

Key Description
country The country name component.
formatted The full mailing address, formatted for display or use with a mailing label.
locality The city or locality component.
postalCode Postal code or ZIP code.
region The state or region component.
streetAddress The full street address component which may include house number, street name, PO box, and multi-line extended street address information.

Provider-specific Fields

Some identity providers return fields specific only to them. These fields are present in the provider dictionary keyed by the provider name.

Key Description Provider
active A boolean value where true means the user is active and false means the user is not active. Salesforce
awards Awards received. Xing
bloodType The user’s blood type. Mixi
favoriteThings List of the user’s favorite things, broken down by order (numerical value), type (category), and value (text). Mixi
followersCount How many people follow the user. Instagram
followsCount How many people the user follows. Instagram
friendshipList A list of the user’s friends on the Renren site. This is part of the extended profile data. Renren
haves List of key skills and qualifications. Xing
locale User’s locale. Salesforce
mediaCount How many pictures the user has posted. Instagram
occupation The user’s occupation. Mixi
organisationMember Any clubs, associations, and so on that the user is an active member of, including voluntary work. Xing
photos The photos the user has uploaded to the Renren site. This is part of the extended profile data. Renren
pings Whether Foursquare receives pings from this user, if they have a relationship. Foursquare
positions Collection of positions, each with boolean value isCurrent and name (employer name). Linkedin
qualifications Additional qualifications such as language certificates, diplomas, and so on. Xing
relationship The relationship of the acting user (me) to this user (them). Foursquare
type One of: brand, celebrity, or user. Users can establish their type when following relationships with celebrities. Foursquare
userType The user type. Salesforce
verifiedAccount This is true if the PayPal account has been verified, false if the account is unverified. PayPal
wants What the user is looking for. Xing

Facebook-specific Fields

We describe these fields separately because they have a different structure (each field contains a number of sub-fields or elements).

Key Sub-fields Type Description
albums plural A set of fields describing a photo album saved somewhere on Facebook.
id string The Facebook ID of the album, consisting of a string of numbers.
name string The text name of the album.
privacy string The privacy setting of the album, such as public, friends, or custom.
type string The type of Facebook post that contains the album (or link to the album) such as normal, wall, or profile.
games plural A set of fields describing a game. Can be any sort of game.
name string The text name of the game.
category string A Facebook category, such as interest.
id string The Facebook ID of the game, consisting of a string of numbers.
groups A set of fields describing a Facebook group.
name string The name of the Facebook group.
id string The Facebook ID of the group, consisting of a string of numbers.
videos A set of fields describing a video.
id string The Facebook ID of the video, consisting of a string of numbers.
description string A text string describing the video.
picture url The URL to a thumbnail picture of the video.
icon url The URL to an icon for the video.
embed_html string A block of html code that you can embed on your page to play video on your site.
Example: "embed_html": "",
source url The source for the video.

Provider Guide

The Provider Guide gives a complete list of identity providers and the features supported by each. Providers are added on a regular basis.

get_contacts Overview

The get_contacts endpoint is used to retrieve a list of the user’s contacts, as well as the contacts’ user data.

The get_contacts call uses the apiKey and identifier to return a list of all the contacts related to the user. The data returned and type of relationship differ between identity providers.

Most identity providers return only friends (the exceptions are noted below). These identity providers support this call:

  • Facebook
  • Google
  • LinkedIn
  • Microsoft Account
  • Myspace
  • RenRen
  • Salesforce
  • Sina Weibo
  • Soundcloud
  • Twitter—Supports followers, following, and friendships. Does not support friends.
  • VK—Supports friends, followers, and following. Does not support friendships.
  • Yahoo!

Twitter and get_contacts

You can use get_contacts to retrieve an array of a user’s followers or who the user is following.

Examples

A request for followers looks like this:

curl 'https://rpxnow.com/api/v2/get_contacts?apiKey=&identifier=http://twitter.com/id123456789&contactType=followers'

A request for following looks like this:

curl 'https://rpxnow.com/api/v2/get_contacts?apiKey=&identifier=http://twitter.com/id123456789&contactType=following'

A request for friends looks like this:

curl 'https://rpxnow.com/api/v2/get_contacts?apiKey=&identifier=http://twitter.com/id123456789&contactType=friends'

Note: A request for friends is not supported for Twitter.

VK and get_contacts

You can use get_contacts to retrieve an array of a user’s friends, followers, or whom the user is following.

Example

A request for followers looks like this:

curl -X POST \
-d apiKey=1234abcd1234abcd \
-d identifier=http://vk.com/id123456789 \
-d contactType=followers \
https://rpxnow.com/api/v2/get_contacts

A request for following looks like this:

curl -X POST \
-d apiKey=1234abcd1234abcd \
-d identifier=http://vk.com/id123456789 \
-d contactType=following \
https://rpxnow.com/api/v2/get_contacts

A request for friends looks like this:

curl -X POST \
-d apiKey=1234abcd1234abcd \
-d identifier=http://vk.com/id123456789 \
-d contactType=friends \
https://rpxnow.com/api/v2/get_contacts

Note: A request for friendships is not supported for VK.

Response

The following code sample shows the response to the request for followers. The responses to the other requests have a similar format.

{
  "response": {
    "entry": [
      {
        "photos": [
          {
            "value": "http://cs419026.userapi.com/u123456789/e_12345678.jpg",
            "type": "other"
          },
          {
            "value": "http://cs419026.userapi.com/u123456789/d_12345678.jpg",
            "type": "other"
          },
          {
            "value": "http://cs419026.userapi.com/u123456789/12345678.jpg",
            "type": "other"
          }
        ],
        "interests": [
          "Rock Climbing, Skiing, Shuffleboard"
        ],
        "relationships": [
          {
            "value": "Girlfriend",
            "type": "sweetheart"
          }
        ],
        "name": {
          "formatted": "Vkfriend Rpx-Friend",
          "familyName": "Rpx-Friend",
          "givenName": "Vkfriend"
        },
        "books": [
          "1Q84, Rosemary's Baby"
        ],
        "urls": [
          {
            "value": "http://vk.com/id12345678",
            "type": "profile"
          }
        ],
        "profileUrl": "http://vk.com/id12345678",
        "utcOffset": "-08:00",
        "organizations": [
          {
            "name": "Cleveland High School",
            "type": "school"
          }
        ],
        "phoneNumbers": [
          {
            "value": "503-444-3322",
            "type": "home"
          }
        ],
        "aboutMe": "Just hanging about.",
        "tvShows": [
          "Mad Men, Flight of the Concords"
        ],
        "id": "http://vk.com/id12345678",
        "relationshipStatus": "In love",
        "movies": [
          "Dr. Strangeglove, The Expendables.",
          "I also prefer mini series television, which is a lot like movies."
        ],
        "birthday": "1979-05-09",
        "displayName": "Vkfriend Rpx-Friend",
        "gender": "female"
      },
      {
        "photos": [
        {
          "value": "https://vk.com/images/12345678.gif",
          "type": "other"
        },
        {
          "value": "https://vk.com/images/12345678.gif",
          "type": "other"
        },
        {
          "value": "https://vk.com/images/12345678.gif",
          "type": "other"
        }
      ],
      "status" : "whoo! status!",
      "name": {
        "formatted": "Vkfriend Rpx-Friend",
        "familyName": "Rpx-Friend",
        "givenName": "Vkfriend"
      },
      "urls": [
        {
          "value": "http://vk.com/id12345678",
          "type": "profile"
        }
      ],
      "profileUrl": "http://vk.com/id184591843",
      "utcOffset": "-08:00",
      "organizations": [
        {
          "name": "Cleveland High School",
          "type": "school"
        }
      ],
      "id": "http://vk.com/id184591843",
      "displayName": "Vkfriend Rpx-Friend",
      "gender": "female"
    },
    {
      "photos": [
        {
          "value": "http://example.com/u12345678/12345678.jpg",
          "type": "other"
        },
        {
          "value": "http://example.com/u12345678/12345678.jpg",
          "type": "other"
        },
        {
          "value": "http://example.com/u12345678/12345678.jpg",
          "type": "other"
        }
      ],
      "interests": [
        "Monkey juggling"
      ],
      "status": "Good.",
      "name": {
        "formatted": "Mr. Example",
        "familyName": "Example",
        "givenName" : "Mr."
      },
      "urls": [
        {
          "value": "http://vk.com/id12345678",
          "type": "profile"
        }
      ],
      "profileUrl": "http://vk.com/id12345678",
      "utcOffset": "-08:00",
      "organizations": [
        {
          "department": "Acupuncture",
          "endDate": "1976",
          "name": "Medical School",
          "type": "school"
        },
        {
          "name": "High School",
          "type": "school"
        }
      ],
      "phoneNumbers": [
        {
          "value": "555 555 5556",
          "type": "home"
        },
        {
          "value": "555 555 5555",
          "type": "mobile"
        }
      ],
      "preferredUsername": "Example",
      "tvShows": [
        "Mash",
        "Mr Fink",
        "Sploosh",
        "Ploosh",
        "Smoosh"
      ],
      "id": "http://vk.com/id123456789",
      "movies": [
        "Movie"
      ],
      "birthday": "0000-01-01",
      "displayName": "Mr. Example",
      "gender": "male"
    }
  ],
  "startIndex": 1,
  "itemsPerPage": 3,
  "totalResults": 3
  },
  "stat": "ok"
}
Scroll ↓