OAuth 2 Facebook service: Difference between revisions

From MoodleDocs
m (added link to Spanish translation of page)
(Update to latest Facebook OAuth set up)
 
(7 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{OAuth2}}
{{OAuth2}}
=== Setup App in Facebook ===
To set up an OAuth 2 client with Facebook


To setup  an OAuth 2 client with Facebook, first we need to log in to the [https://developers.facebook.com/apps Facebook for Developers Apps page] and create a new app.
1. Log in to the page [https://developers.facebook.com/apps Facebook for Developers Apps] and click the 'Add a new app' button.
[[File:facebook-1-new-app.png|frame|Add a new app|alt=|center]]


[[File:facebook-1-new-app.png|none|frame|New App]]


Enter the name for the new App and choose a category (Education?).  
2. Select the app type '''Consumer''' and navigate to the next page.
[[File:facebook-app-type.png|center|thumb|600x600px]]


[[File:facebook-2-name.png|none|frame|Name it]]
Go to the app basic settings and set the app icon, and the URLs to your privacy policy and terms of service.
[[File:facebook-3-basic-settings.png|none|frame|Basic settings]]
Add the "Facebook Login" product to the app.
[[File:facebook-4-add-product.png|none|frame|Add a product]]
Configure the OAuth settings. Set the callback URL to "your site url + /admin/oauth2callback.php". If your moodle site is available at https://lemon.edu/ then the callback URL should be set to "https://lemon.edu/admin/oauth2callback.php". Enable the Web OAuth Login but for best security disable all other types of login.


3. Enter a display name, contact email, and a business account. The latter is likely to be required in a production environment, because individual Facebook accounts are  to 200 calls per hour. Then, click the button 'Create App'. For security, you might have to enter your Facebook credentials (password).
[[File:facebook-2-name.png|none|frame|Create App ID]]
3. Click Settings on the left, then add an app icon and URLs as desired, choose a category e.g. Education then click the button 'Save Changes'.
[[File:facebook-3-basic-settings.png|none|frame|App settings]]
4. Click the link '+Add Product' on the left then for 'Facebook Login' click the button 'Get Started'.
[[File:facebook-4-add-product.png|none|frame|Add Product]]
[[File:facebook-login.png|none|frame|Facebook Login]]
5. Click Web, then enter your site URL and click Save.
[[File:facebook-webapp-wizard.png|none|frame|Enter site URL]]
6. Click Settings under 'Facebook Login' on the left, then configure the Client OAuth Settings as follows:
* Set 'Web OAuth Login' and 'Use Strict Mode for Redirect URIs' to Yes and everything else to No (for security).
* Enter the callback URL to "your site url + /admin/oauth2callback.php" e.g. <nowiki>https://lemon.edu/admin/oauth2callback.php</nowiki>.
then click the button 'Save Changes'.
[[File:facebook-5-oauth-settings-v2.png|none|frame|OAuth settings]]
[[File:facebook-5-oauth-settings-v2.png|none|frame|OAuth settings]]
 
7. Click 'App Review' on the left, then click to make your app public.
Go to App Review and make your App public.
 
[[File:facebook-6-public.png|none|frame|Make it public]]
[[File:facebook-6-public.png|none|frame|Make it public]]
 
Finally, click Dashboard on the left, get the App ID and App Secret and enter them in Moodle as the client ID and secret.
Finally go to the basic settings and get the App ID and App secret and enter them in Moodle as the Client ID and Client Secret.
[[File:facebook_7_app_id_and_secret.png|none|frame|Getting the App ID and Secret]]
 
 
[[es:Servicio OAuth 2 Facebook]]
[[es:Servicio OAuth 2 Facebook]]
[[de:OAuth2 Facebook Service]]

Latest revision as of 09:13, 15 December 2022

To set up an OAuth 2 client with Facebook

1. Log in to the page Facebook for Developers Apps and click the 'Add a new app' button.

Add a new app


2. Select the app type Consumer and navigate to the next page.

facebook-app-type.png


3. Enter a display name, contact email, and a business account. The latter is likely to be required in a production environment, because individual Facebook accounts are to 200 calls per hour. Then, click the button 'Create App'. For security, you might have to enter your Facebook credentials (password).

Create App ID

3. Click Settings on the left, then add an app icon and URLs as desired, choose a category e.g. Education then click the button 'Save Changes'.

App settings

4. Click the link '+Add Product' on the left then for 'Facebook Login' click the button 'Get Started'.

Add Product
Facebook Login

5. Click Web, then enter your site URL and click Save.

Enter site URL

6. Click Settings under 'Facebook Login' on the left, then configure the Client OAuth Settings as follows:

  • Set 'Web OAuth Login' and 'Use Strict Mode for Redirect URIs' to Yes and everything else to No (for security).
  • Enter the callback URL to "your site url + /admin/oauth2callback.php" e.g. https://lemon.edu/admin/oauth2callback.php.

then click the button 'Save Changes'.

OAuth settings

7. Click 'App Review' on the left, then click to make your app public.

Make it public

Finally, click Dashboard on the left, get the App ID and App Secret and enter them in Moodle as the client ID and secret.

Getting the App ID and Secret