Help Document
Enabling SSO with Facebook

    ENABLING SSO WITH FACEBOOK

    Administrators can enable Single Sign-On for their Magentrix portal through Facebook. Before SSO can be enabled for their portal, administrators must create an app and configure the app's OAuth on Facebook.

    Note*: If your app is configured to have more than basic Facebook login (email + public profile), social plugins, and Facebook sharing products, it will require an app review from Facebook before it can be made public.

    Requirements

    To enable SSO with Facebook, users must be assigned a security role with the following permissions:

    • Administrator System Role

    Users also require the following external permissions:

    • Users must be registered as a Facebook Developer

    TO CREATE AND CONFIGURE A FACEBOOK APP:

    • Create your Facebook App:
      1. In the Facebook Developers home page (https://developers.facebook.com/), click Add a New App.
      2. Complete the provided fields (name of your app e.g. ‘Magentrix’, and your email address) then click Create App ID.
      3. On the “Select a Product” page, select Facebook Login.
      4. On the following page, select the WWW web option.
      5. Enter the URL for your Magentrix instance, e.g.: community.mycompany.com and click Save and Continue. Please skip the additional steps for creating the app as they are not required for OAuth configuration.
    • Configure OAuth for your Facebook App:
      1. In the Facebook Developers home page, within the sidebar click Products > Facebook Login > Settings. Enable the Client OAuth Login and Web OAuth Login options.
      2. In the Valid OAuth redirect URIs field enter your Magentrix instance URL with the following format: {!instanceURL}/User/FacebookLoginCallBack. E.g.: https://community.mycompany.com/User/FacebookLoginCallBack
      3. Click Save Changes at the bottom of the page.
      4. On the top header of the page, click the ON/OFF toggle button and then click Confirm.

    TO ENABLE SSO WITH FACEBOOK:

    1. In the Setup Home page, click Extend > Connected Apps.
    2. Click New.
    3. Select Authorization Provider and then click Next.
    4. Select Facebook and then click Next.
    5. In the Consumer Key field, enter your Facebook App ID.
    6. In the Consumer Secret field, enter your Facebook App Secret.
    7. Click Save.

    SEE ALSO:


    << Required SAML Attributes for Just-In-Time Provisioning | Enabling SSO with Google >>