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).

    1
    2
    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