Set up Facebook as an identity provider

Last updated on August 5, 2026

Overview​

This guide helps verified Facebook developers connect Facebook accounts to AccelByte Gaming Services (AGS). You may need to set up additional features within Meta for Developers that we haven't listed here. For full information about setting up Facebook Login, we recommend contacting your Meta representative and reviewing Meta's developer documentation.

Goals​

Enable Facebook authentication for your publisher website (Private Cloud only).

Prerequisites​

  • A Meta for Developers account. Follow this link to create a new account, or log in to your existing account https://developers.facebook.com/async/registration/
  • An AccelByte Admin Portal Account to set up authentication and manage permissions.
  • A publisher Namespace for your publisher website and Launcher.
  • A publisher website.
  • Familiarity with AGS Identity and Access Management (IAM) Clients.

Set up the Facebook app​

Create a Facebook application​

Create a Facebook app under your Meta for Developers account. Follow the Create an App Guide

Add a Facebook login product to your app​

Add a Facebook login product to your app. Follow the Facebook Login for the Web with the JavaScript SDK Guide.

Set up advanced access​

Request advanced access to public_profile permissions. For more detail about Facebook permissions, refer to the Facebook Permissions Reference Page.

note

If you have trouble setting up on Meta for Developers, contact Customer Support to get a guide from AccelByte.

Set up a Web login for Facebook​

AGS Public Cloud

Web login integration is currently unavailable in AGS Public Cloud and is only supported in AGS Private Cloud.

Use these steps to set up Facebook logins for the publisher website, so players can sign in with their Facebook accounts.

Configuration steps​

  1. In the AGS Admin portal, go to your publisher namespace.

  2. On the sidebar menu, go to Foundations > 3rd Party Integrations > Auth & Account Linking.

  3. On the Auth & Account Linking page, click + Add New button.

    AccelByte Admin Portal Login

  4. On the Select login provider page, find Facebook and click on it.

    Facebook login

  5. The Set up Facebook login provider form appears. A Facebook setup guide link is provided at the top for reference.

    Facebook Create Configuration

  6. Fill in the following fields:

    • Platform ID: facebook. Set automatically. Cannot be changed.
    • Client ID: Your Facebook App ID from the Meta App Dashboard.
    • Client Secret: Your Facebook App Secret from the Meta App Dashboard.
    • Redirect URI: Your Facebook login redirect URI: <BaseURL>/iam/v3/platforms/facebook/authenticate (BaseURL is your domain address, e.g., https://development.accelbyte.io). Also register the following as allowed redirect URIs in the Meta App Dashboard:
      • <BaseURL>/iam/v3/platforms/facebook/authenticate
      • <BaseURL>/iam/v3/public/namespaces/<Namespace>/users/me/platforms/facebook/web/link/establish (used for account linking)

  7. Click Add & Activate to create and activate the provider in one step. Alternatively, click Add to create without activating.

Edit a login provider​

  1. On the Auth & Account Linking page, click the Facebook entry.

  2. A dialog appears with the provider's configuration. Update the fields as needed.

  3. Use the Status toggle at the top to activate or deactivate the provider.

    Facebook login provider dialog with Active toggle

  4. Click Save.

Create an IAM Client​

An IAM client is a representation of the game client that you want to release on your target platform.

If you already have an IAM Client for your game on a specific SDK Platform (e.g., Xbox, Steam, or Playstation), you don't have to create a new IAM Client. Since Facebook is not a platform on which to build games, you can use an existing IAM Client. Learn more about IAM Clients by reading Manage access control for applications.

Test your login​

  1. Go to your publisher website and click Login.

    Publisher website login page

  2. Click the Facebook Icon. If you can't find it, click More login options.

    Login Page

    The system redirects you to the Facebook Web Login page.

    Login With Facebook

  3. Fill in your Facebook credentials to proceed.

That's it! You've completed the required steps.

Facebook Login

note

The system asks players to link their Facebook account with an existing or new AccelByte account. AccelByte is working to make this configurable, so that players can log in to the publisher website with a headless account.

Troubleshooting​

You can find common errors and issues along with recommendations on how to resolve them in this section.

Can't get advanced access​

You can't get Advanced Access if you don't list a valid Privacy Policy URL and data deletion information in Basic Information.

Failed login via Facebook​

If you use Development Mode, ensure you log in using Test User or Real User accounts with the Tester role.

Last updated on
On this page