Third-party Authentication Add-on for Facebook. Customer Guide.
###############################################################

The following configuration will allow the customers to configure the Facebook OAuth application to implement authentication with Facebook accounts on their LMS sites.

**Integration Requisites**

- It is required to have your LMS site in a domain of your own.
- Enterprise or performance subscription with the add-on third-party authentication enabled.

Configuring the Facebook OAUTH Application
===========================================

1. Log in to your Facebook account to access |developers_console_facebook_link|.

.. |developers_console_facebook_link| raw:: html

   <a href="https://developers.facebook.com/docs/facebook-login" target="_blank">The developer's console</a>

2. On the Add Products to your App page, select **Create an App**. This will allow you to create a new app for the integration with the LMS site.
      
   #. Select **Consumer**.
   #. Enter **App Display Name**.
   #. Enter **App Contact Email**. 
   #. Select **Create App**. You may be prompted to reenter your password for security reasons.

.. only:: html

   .. figure:: ../_assets/third-party-integration-facebookapp-newapp.gif


3. On your app dashboard, add a product using the option named **Facebook Login**.

   1. Select Web or www.
   2. Enter **your LMS domain**.
   3. Enter **Save Changes**.

.. only:: html

   .. figure:: ../_assets/third-party-integration-facebookapp-basicsettings.gif

4. Go to **Products** > **Facebook Login** > **Settings** and make sure the **Valid OAuth Redirect URIs** is configure with:

.. code-block:: javascript

   https://YOURLMSDOMAIN/auth/complete/facebook/

.. only:: html

   .. figure:: ../_assets/third-party-integration-facebookapp-redirecturl.gif

5. Provide eduNEXT with the credentials recently created.

   The *client ID* and *client secret* can be found at **Settings** > **Basic**. 

.. only:: html

   .. figure:: ../_assets/third-party-integration-facebookapp-credentials.gif


   The credentials look like the example below.

.. code-block:: bash

    App-ID = 12345678901233456
    App-Secret = xXxXXxXxXXxXXxXXxxXxxXxxXxXxxXxx


Send this information to the eduNEXT customer support team via the **Edunext Control Center** > **Customer Support** > **Submit a Ticket**.

.. note::  Make sure to switch the toggle from "In development" to "production".