Configuring Facebook login for Yeeflow Service Portal

 Updating the Facebook app API or creating a new app will break existing logins. 

Configuration

Go to developers.facebook.com/apps and …

1. Login with the credentials of the account you want to connect to Yeeflow service portal and follow the wizard.
   If you already have other apps instead of Get Started you will see the entry My Apps, then just click on  Add new app and follow the guide from step 1b

   

   image1394×713 145 KB

    

   1a. Select Developer

   

   image931×551 28.8 KB
   
   1b. Provide a name for the app, for example Yeeflow Login and click on Next.
   
   

   image929×587 32.8 KB
   
   1c. Click on Add your first product
   
   

   image931×512 85.5 KB

    

2. Click Set Up below Facebook Login.
   

3. From the menu on the left, exit Quickstart by clicking on Settings under Facebook Login

   

   firefox_2018-03-14_17-38-241485×381 49.6 KB

    

4. Setup the Valid OAuth redirect URI field, entering https://yeeflow.example.com/auth/facebook/callback – obviously, replacing the domain with your site’s actual domain name and matching the HTTPS protocol. Remember that the HTTPS protocol is now mandatory for all URI redirects. Click Save Changes.
   Once completed, a successful setup should look like this in Products/Facebook Login/Settings:

   

   image1189×743 44.9 KB

    

5. Navigate to Settings/Basic, enter your Yeeflow service portal URL (https://yeeflow.example.com) in the App Domains field and also enter the URL for your Yeeflow service portal site privacy policy and Terms of Service in the appropriate fields and also upload the icon of your site. (Mind that for your privacy and tos link to be verified, you should have a valid SSL certificate integrates, which is not self-signed. If the certificate is missing, or self-signed, you won’t be able to save your changes).
   If you have a company that does business in the European Union, you may want to fill in the Data Protection Officer Contact Information form before clicking on Save Changes.

    

   

   image1475×734 67.4 KB

    

   ⚠️ Facebook has changed this step to ask for extra information. We are currently working to determine what you need to provide; see recent replies. (November 2020)

   There is now a field for User Data Deletion information for GDPR compliance. Select “Data Deletion Instructions URL” from the dropdown and add a link to a page (such as https://yeeflow.example.com/tos#deletion) which contains a sentence like “Accounts on this site can be anonymized or deleted at the user’s request. Contact our @support group for details.”

6. At the bottom of the page click on  Add Platform and select Website

   

   firefox_2018-03-14_18-11-01844×527 33 KB

    

7. Enter your Yeeflow service portal URL here, for example https://yeeflow.example.com and click Save Changes

   

   firefox_2018-03-14_18-12-061221×215 6.72 KB

    

8. Click on the Status button to change your app from in development to public.

   

   firefox_2018-03-14_18-18-081212×172 11.5 KB
   
   The category you select does not matter.
   
   

   firefox_2018-03-14_18-19-19571×589 31 KB
   
   After a few seconds the button will become:
   

    

9. In Yeeflow service portal site settings, enter your Facebook app’s App ID and App Secret in the facebook app id and facebook app secret fields. You’ll also want to check off Enable Facebook authentication, requires facebook_app_id and facebook_app_secret

That’s it! Facebook login should work now. Be sure to test it from a “normal” Facebook account, not your developer account.