Add Facebook login¶

You can add Facebook login to your applications using Asgardeo and enable users to log in with their Facebook accounts.

Follow this guide for instructions.

Register Asgardeo on Facebook¶

You need to register Asgardeo as an app on Facebook.

Note

You can follow the Facebook Documentation for detailed instructions.

To register an app on Facebook:

Go to the My Apps page in Meta for developers.
Click Create App.
Select the use case as Authenticate and request data from users with Facebook Login and click Next.
Select the login type out of the options and click Next.
Provide Display Name and click Create App to create an application.
While in the created application, select Use cases from the left navigation.
Under Use cases > Authentication and account creation, click Customize.
Under Facebook Login > Quickstart, click Go to quickstart.
Select Web as the platform for this app and provide the following Site URL with your organization name and click Save.

bash no-line-numbers https://api.asgardeo.io/t/<organization_name>
Return to the Use cases > Customize section and under Facebook login > Settings, click Go to settings.
Add the following as the Valid OAuth Redirect URIs and click Save changes.
```
https://api.asgardeo.io/t/{organization_name}
```
Enable Client OAuth Login and Web OAuth Login (these are enabled by default) and save the changes.
On the left navigation panel, go to App settings > Basic and take note of the App ID and App Secret.

Register the Facebook IdP¶

Now, let's register the Facebook IdP in Asgardeo.

On the Asgardeo Console, go to Connections.
Click Create Connection and select Facebook.

Enter the following details of the Facebook identity provider and click Finish:

Parameter	Description
Name	A unique name for this Facebook identity provider.
App ID	App ID obtained from Facebook.
App Secret	The app secret obtained from Facebook.

Go to the Settings tab and see the list of permissions granted by Facebook to Asgardeo.
- email: Grants read access to a user's primary email address.
- public_profile: Grants read access to a user's default public profile details.
Note

Asgardeo needs these permissions to get user information. Asgardeo checks the attribute configurations of the application and sends the relevant attributes received from Facebook to the app. You can read the Facebook documentation to learn more.

Before you begin

You need to register an application with Asgardeo. You can register your own application or use one of the sample applications provided.

On the Asgardeo Console, go to Applications.
Select your application, go to the Login Flow tab and add Facebook login as follows:
Classic EditorVisual Editor
To add Facebook login using the Classic Editor:
1. If you haven't already defined a sign-in flow, click Start with Default configuration to get started.
2. Click Add Authentication on the step, select your Facebook identity provider, and click Add.
To add Facebook login using the Visual Editor:
1. Switch to the Visual Editor tab, by default the Username & Password login flow will be added onto the Visual Editor's workspace.
2. Click on + Add Sign In Option to add a new authenticator to the same step and select your Facebook connection.
Recommendations

It is recommended to add your social and enterprise connections to the first authentication step as they are used for identifying the user.
Click Update to save your changes.

Try it out¶

Follow the steps given below.

Access the application URL.
Click Login to open the Asgardeo login page.
On the Asgardeo login page, click Sign in with Facebook.
Log in to Facebook with an existing user account.
The user is now redirected to the application and logged in.

Note

When a user successfully logs in with Facebook for the first time, a user account is created in the Asgardeo Console with the Facebook username. This new user account will be managed by Facebook.

Configure connection¶

To learn more about other configurations available for the connection, refer to the add federated login documentation.