Connect Apps to Facebook

Add Facebook Sign in to your apps in less than 5 minutes.

This guide shows how to connect your Authgear application to Facebook so users can log in using the Login with Facebook feature.

Step 1: Create an App in Facebook for Developers

If you are using Authgear in your existing Facebook Apps, you may skip to the next step to set up the OAuth client.

Prerequisite

You will need a Facebook developer Account. Register as one by clicking Get Started in the Facebook for Developers website.

Create an App

To create a new app, go to the Facebook Developers Apps panel then click the Click Create App button.

On the "Use cases" screen, select Others and "Authenticate and request data from users with Facebook Login" as your app use case then, click Next.

Follow the on-screen instructions to finish the app creation process.

Step 2: Add "email" permission

1. Go to "Use Cases" configuration in your application just created.

2. Customize the "Authenticate and request data from users with Facebook Login" use case.

3. Enable "email" permission, make sure both "public_profile" and "email" are enabled.

Step 3: Set up the OAuth Client

1. In the use case settings, make sure Client OAuth Login and Web OAuth Login are enabled.

2. Add https://<YOUR_AUTHGEAR_ENDPOINT>/sso/oauth2/callback/facebook to Valid OAuth Redirect URIs and save the changes.

Redirect URI has the form of https://<YOUR_AUTHGEAR_ENDPOINT>/sso/oauth2/callback/:alias. The alias is used as the identifier of OAuth provider. You can configure the alias in Authgear Portal.

See Your Authgear Endpoint for instructions on how to get the value for YOUR_AUTHGEAR_ENDPOINT.

Step 4: Configure Login with Facebook in Authgear Portal

Get your OAuth Client details

After setting up the OAuth Client, go to App settings > Basic in the sidebar.

You will need the App ID and App Secret to configure Facebook Login so, note them down.

App review submission maybe needed to complete this step. Please follow the on-screen instructions.

Configure in Authgear Portal

1. In the portal, go to Authentication > Social / Enterprise Login.

2. Enable Login with Facebook.

3. Fill in the Client ID with the App ID obtained from the Facebook Developers portal, and Client Secret with the App Secret in the previous step.

4. Save the settings.

🎉 Done! You have just added Facebook Login to your apps!

Your end-users can now sign in with Facebook on Authgear's pre-built Log In and Sign Up page. Existing end-users can connect their account to Facebook in the User Settings page.

Your end-users can connect to their Facebook account in User Settings page