maverick/docbrown
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
docbrown/docs/backend/auth-facebook.md
Alexis Moody f4a10e4a44
[deploy] Adds a new admin setting for experience levels. (#10870) 
* Adds a new admin setting for experience levels.

This is used in the post management UI to determine the range of experience. These values fallback to the ones we currently see in DEV, Total Newbies and Senior Devs. There is also a removal of the word coding when talking about experience level, since the context for each forem instance should be implied when referencing experience.

* Cleans up experience defaults

* Fixes instance_of usage
2020-10-16 12:40:25 -06:00

2.5 KiB
Raw Blame History

title
Facebook Authentication

Facebook App and Authentication

Forem allows you to authenticate using Facebook. In order to use this authentication method in local development, you will need to setup a Facebook App and retrieve its keys. Then you'll need to provide these keys to the Rails application.

Sign up

  1. Sign in to your Facebook account.

  2. In order to get the API keys, you will have to convert your account to a developer account.

Get API keys

  1. Sign up or sign in to your Facebook developer account.

  2. From My Apps dashboard, click on Add a New App.

    facebook-1

  3. Select For Everything Else

    facebook-2

  4. Fill in the app display name and contact email, then click on Create App ID

    facebook-3

  5. On the Add a Product screen, click Set Up under the Facebook Login section

    facebook-4

  6. Ignore the quickstart options, and click Settings -> Basic in the sidebar

    facebook-5

  7. From the basic settings screen dashboard copy the App ID and App Secret values to your .env file accordingly (name of Facebook key -> name of our SiteConfig variable).

    APP ID -> FACEBOOK_APP_ID
API secret -> FACEBOOK_APP_SECRET

    facebook-6

Configure the Facebook App

  1. From the basic settings screen dashboard set your application's domain name in App Domains field, and be sure to click Save Changes

    facebook-7

  2. Naviate to Facebook Login --> Settings, and enter the following callback URL in the field Valid OAuth Redirect URIs:

    https://<your domain>>/users/auth/facebook/callback

    facebook-8