Guide to configure Facebook as an OAuth Server for Drupal 7

Step 1: Configure Facebook as an OAuth Server

  • Login/Signup in Facebook developer console at https://developers.facebook.com/.
    • Facebook_sso_Login/ Signup in Facebook
  • Go to My APPS Add New App.
    • Facebook_sso_Add New App
  • Enter the Display Name and Contact Email for your app under the Display Name and Contact Email fields respectively and then click on Create App ID button to create an App Id for your app.
    • Facebook_sso_display name
  • Select Integrate Facebook Login checkbox.
    • Facebook_sso_Integrate Facebook Login
  • Select Facebook Login Settings under Products option in the navigation bar.
    • Facebook_sso_Select Settings
  • Under Client OAuth Settings, enter the Callback/Redirect URL (from your miniOrange OAuth Client module) in the Valid OAuth Redirect URIs field. Click on the Save button to save your configurations.

    • Please Note: It is mandatory while configuring Facebook as an OAuth Server that your Callback/Redirect URI should be https and not http.

    Facebook_sso_Client OAuth Settings
  • Go to Settings Basic to view your App ID and App Secret.
    • Facebook_sso_App Id and App Secret
  • Enter your Privacy Policy URL in the Privacy Policy URL field and choose a category from the dropdown in the Category field. Click on the Save Changes button to save your configurations.
    • Facebook_sso_ Privacy Policy URL
  • Copy your App ID and your App Secret and save it in your miniOrange OAuth Client Module (under client id and client secret field respectively).
  • Change your app status from In Development to Live by clicking on OFF as shown in the image below. Then, click on Confirm to confirm your change of status.
    • Facebook_sso_Change you app status

Congratulations, you have successfully completed your Facebook OAuth Server side configurations.

Step 2: Configure miniOrange Drupal 7 OAuth Client module.

  • Click on the link here to download the miniOrange OAuth Client module.
  • Scroll down and download module by clicking in the zip option under Downloads.
    • Facebook_sso_Drupal go to link
  • Login in your Drupal 7 site’s admin console and click on Modules from the top navigation bar.
  • Select the Install new module option to install a new module on your Drupal 7 site.
    • Facebook_sso_Drupal install module
  • Upload the downloaded zip file of the Module and click on the Install button to continue.
  • Click on Modules from the top navigation bar again and scroll down till you find miniOrange OAuth 2.0 Client. Click on the checkbox next to it and click on the Save Configuration button to enable the module.
    • Facebook_sso_Drupal navigation bar
  • Now next to the miniOrange OAuth 2.0 Client, you will find an option to Configure the Module. Click on it to continue to the configuration page of the module.
    • Facebook_sso_Drupal configuration page
  • Register/Login to your miniOrange account.
    • Facebook_sso_Drupal register login
  • Click on the Configure OAuth tab and select your OAuth Provider from the Select Application dropdown. In case you do not find your OAuth Provider listed in the dropdown, please select Custom OAuth Provider and continue.
    • Facebook_sso_Drupal custom auth provider
  • Enter your OAuth Provider information in their respective fields and click on the Save button to continue. Also, copy the Callback/Redirect URL and save it on your OAuth Provider.
    • Facebook_sso_Drupal click on save
  • Now click on the Test Configuration option. This Test Configuration link will give you the list of the attributes that are coming from your OAuth Provider.
    • Facebook_sso_Drupal test configuration
  • Copy the email and the name attributes and save them under the Attribute & Role Mapping tab in the Email Attribute and Name Attribute text field respectively.

    • Please note: This step is mandatory for your login to work. Click on the Save button on the bottom of the page to save your attribute configurations.

    Facebook_sso_Drupal click on save
  • Now logout and go to your Drupal 7 site’s login page, you will automatically find a Login withyour OAuth Provider link there. If you want to add your login link to other pages as well, please follow the steps given in the below image:
    • Facebook_sso_Drupal logout
  • If you want to check out our complete list of features and our various licensing plans, you can go to the Licensing Plan tab in the module.
  • Still, if you are facing any difficulty or if you have any questions in mind, you can reach out to us by submitting a query in the Support tab of a module or by sending us a mail at info@miniorange.com.

    • Congratulations, you have successfully configured the miniOrange Drupal 7 OAuth Client module.