RapidIdentity Product Guides - 2019 Rolling Release

Social

To allow users to authenticate to RapidIdentity through any of the supported social networks, administrators must access the corresponding social network's developer's page.

Administrators will need the organization's redirect URI, which will take the following format.

https://<RF_HOST>:<RF_PORT>/idp/socialCallback?n=social_network

Once the process is complete, administrators can enable the social network authentication method and input the corresponding ID and Secret field values.

The configuration sequences listed below for each social network are the simplest and most recommended setups possible that will return a viable social network authentication. Some of the social network methods allow for more configuration options beyond what is listed in the sequences below. Administrators developing authentication policies should use caution when selecting social network configuration options beyond what is listed below.

The social networks may update their development pages periodically, thus the screenshots listed below may vary slightly. If a discrepancy is observed, please contact Support and the documentation will be updated as soon as possible.

Facebook

Follow these 14 steps to configure Facebook social authentication:

  1. Navigate and if necessary create an account.

  2. Click Create App

    Facebook_for_Devs.png
  3. Assign the Display Name a meaningful name (e.g. RapidFederation Test), select a meaningful category, and click Create App ID.  

    Facebook_for_Devs_2.png
  4. On the left vertical pane, Click Add Product and then in the Facebook Login option select Get Started

    Facebook_Add_Product.png
  5. When the page refreshes, the Facebook Login Product should be selected in the left sidebar. 

    Facebook_Login_Settings.png
  6. In this selection, navigate to the Valid OAuth redirect URIs and enter the redirect URI for your organization in the following syntax.

    https://<RF_HOST>:<RF_PORT>/idp/socialCallback?n=facebook

  7. Click Save Changes.

  8. Navigate to Settings > Basic in the left sidebar and then add the organizational domain to theApp Domain field. 

    Facebook_Settings_Basic.png
  9. Next, click Add Platform, select Website, and then add your organizational site in the following form.

    https://<RF_HOST>:<RF_PORT>

  10. Click Save Changes.

  11. Navigate to Settings > Advanced > Security > Require App Secret and select "No".

  12. Click Save Changes.

    Facebook_Settings_Advanced.png
  13. Finally, for each authentication policy using Facebook as an authentication method, enter the App ID and App Secret in the Authentication Policy.

    Facebook_Settings_Keys-obs.png
  14. Save all changes and input the App ID and App Secret into the Facebook Authentication Methods fields.

    Facebook_Settings_Advanced_Confirm.png
Google

Follow these 9 steps to configure Google social authentication:

  1. Navigate, sign in if necessary, and click Select a project | Create a project

    Legacy_Google_1.png
  2. Assign the project a meaningful name and click Create.

  3. Click Use Google APIs.

  4. Locate and enable Identity Toolkit API

    Legacy_Google_2.png
    Legacy_Google_3.png
  5. On the left-hand sidebar, click Credentials and then click New Credentials

    Legacy_Google_4.png
  6. Select OAuth client ID.

  7. Configure the consent screen as directed and click Save.

  8. Select Web Application and enter the redirect URI as follows.

    https://<RF_HOST>:<RF_PORT>/idp/socialCallback?n=googleplus

    Legacy_Google_5.png
  9. Click Create, and then enter the client ID and client Secret into the Google+ Authentication Methods fields.

LinkedIn

Follow these 4 steps to configure LinkedIn social authentication:

  1. Navigate and click Create Application.  

    LinkedIn_1.png
  2. Complete the required fields and click Submit.

    LinkedIn_2.png
  3. Retain the Default Application Permission of "r_basicprofile" and input the OAuth 2.0 authorized redirect URL. Click Update

    LinkedIn_3.png
  4. Enter the Client ID and Client Secret into the LinkedIn Authentication Methods fields.

Twitter

Follow these six steps to configure Twitter social authentication.

  1. Navigate and click Create New App

    Create_New_App.png
  2. Assign the app a meaningful name, complete the required fields and then click Create Your Twitter Application.

  3. Click Settings and update the Callback URL to the following.

    https://<RF_HOST>:<RF_PORT>/idp/socialCallback/twitter

    Settings.png
  4. Click Update Settings.

  5. Click Permissions and set to Read Only. Click Update Settings

    Read_Only.png
  6. Click Keys and Access Tokens and input the Consumer Key and Consumer Secret to the Twitter Authentication Methods fields.