Facebook

To set up Facebook as a Social Login provider, follow these steps.

  1. Sign in to the Janrain Dashboard (dashboard.janrain.com).
  2. On the property you want to configure, click the Manage Engage app button (Manage_SL_App_Icon).
  3. On the Providers tile, click the Manage Providers button (Screen Shot 2014-04-24 at 9.10.09 AM).
  4. In the Provider list on the right side of the page, click Facebook.
  5. Click Configure. The Provider Setup Guide appears.

    facebook-1

    Figure 1: Provider Setup Guide, Intro Page

  6. If you already have a Facebook application:
    1. Navigate to developers.facebook.com/apps to retrieve configuration information.
    2. Skip to the final page of the Facebook Setup Wizard by clicking Next.
    3. Enter the App ID and App Secret values.
    4. Click Save.
  7. If you have not already set up a Facebook application, continue with the following steps (which correspond to the Provider Setup Guide instructions).
  8. If you do not have a Facebook developer’s account, create one.
  9. Sign in to Facebook, and navigate to developers.facebook.com/apps.
  10. Allow Developer access to your account if prompted.
  11. On the Provider Setup Guide, Click Next.
  12. On the Apps page, click Create New App. The Facebook Apps page appears.
  13. On the Facebook Apps page, enter a Display Name (application name). This name will be seen by each of your Facebook visitors at least once, so take care in selecting this name.
  14. Enter an optional Namespace.
  15. Select YES or NO to answer the question “Is this a test version of another app?”
    1. If you selected YES, in the Choose an App list, click an existing application name.
    2. If you selected NO, in the Choose a Category list, click a category for the new application.
  16. Click Create App. A Security Check dialog is displayed.
  17. Enter the displayed text in the box and click Submit.
  18. On the Provider Setup Guide, click Next.
  19. On the left navigation bar of the Apps page, click Settings.

    facebook-2

    Figure 2: Facebook Apps Page, Settings

  20. Click Add Platform. The Select Platform dialog appears.
  21. Click Website. A new Website section appears on the Apps page.

    facebook-3

    Figure 3: Facebook Apps Page, Website Section

  22. Register your website with the newly-created Facebook application by copying the Site URL value from the Provider Setup Guide and pasting it into the Site URL box in the Website section. This URL should be of the format https://yoursite.rpxnow.com.
  23. Check that your Basic information is correct and click Save Changes.
  24. Return to the Provider Setup Guide and click Next.
  25. On the Apps page, click App Details in the left navigation panel.

    facebook-4

    Figure 4: Facebook Apps Page, App Details

  26. In the Contact Info section, enter a Privacy Policy URL.
  27. If you are requesting permissions beyond that of the basic user profile:
    1. Enter text in the Short Description and Long Description boxes explaining how the permissions will be used. For example, “We request your interest data to personalize your experience on our site.”
    2. Click Save Changes at the bottom of the page.
    3. Return to the Provider Setup Guide and click Next.
  28. On the Apps page, scroll down to the Contact Info section. Enter your company’s Privacy Policy URL (this is required).
  29. On the left navigation bar, click Settings.
  30. Copy the App ID and App Secret values at the top of the page and paste them to the corresponding boxes on the Provider Setup Guide.

    facebook-5

    Figure 5: Provider Setup Guide, App Credentials Page

  31. On the Provider Setup Guide, click Save. The remainder of the setup process is automated and finishes in seconds. You may now add Facebook as a Social Login provider on the Janrain Dashboard.