---
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](https://facebook.com) to your Facebook account.

2. In order to get the API keys, you will have to
   [convert your account to a developer account](https://developers.facebook.com/).

## Get API keys

1. [Sign up](#facebook-sign-up) or [sign in](https://developers.facebook.com) to
   your Facebook developer account.

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

![facebook-1](https://user-images.githubusercontent.com/37842/90912963-1f254f00-e3a1-11ea-9db9-2b77bddfe185.png)

3. Select **For Everything Else**

![facebook-2](https://user-images.githubusercontent.com/37842/90913109-627fbd80-e3a1-11ea-8d78-d0b2bde76b3d.png)

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

![facebook-3](https://user-images.githubusercontent.com/37842/90913171-7b886e80-e3a1-11ea-9359-c4642c05c7b6.png)

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

![facebook-4](https://user-images.githubusercontent.com/37842/90913219-8d6a1180-e3a1-11ea-86cb-d0b0d8681887.png)

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

![facebook-5](https://user-images.githubusercontent.com/37842/90913319-b5f20b80-e3a1-11ea-866a-0b06cf3296c7.png)

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

   ```text
   APP ID -> FACEBOOK_APP_ID
   API secret -> FACEBOOK_APP_SECRET
   ```

 ![twitter-5](https://user-images.githubusercontent.com/37842/90913396-d5893400-e3a1-11ea-93f5-a0fbb06a0c53.png)