ForgeRock Developer Experience

Set up social login

Applies to:

  • ForgeRock SDK for Android

  • ForgeRock SDK for iOS

  • ForgeRock SDK for JavaScript

What is social login?

ForgeRock provides the capability within its authentication journeys/trees to support trusted Identity Providers (IdP), like Apple, Facebook, Google, and many others, for authentication and identity verification on behalf of ForgeRock. This is often referred to as social login or social authentication. These IdPs return the necessary user information to your ForgeRock® Identity Platform deployment.

Depending on the device platform—​Android, iOS, or web—​the user is either redirected from the current web application, or the ForgeRock login page to the IdP’s authorization server, or, if on a native mobile app, the user is directed to the IdP’s authentication SDK, if available. Once on the IdP through a web page or the SDK, the user authenticates, and provides the necessary consent required for sharing the information with ForgeRock. When complete, the user is redirected back to your app or to ForgeRock to complete the authentication journey.

It’s common to offer these social login options in addition to traditional authentication with username and password, but they can be used alone.

A screen capture of a login page with a common combination of methods:

Social login

Limitations

Before implementing social login, read Limitations.

Support matrices

Platform matrix

JavaScript SDK Android SDK iOS SDK

SDK Version

3.0.0 and above

3.0.0 and above

3.0.0 and above

AM Version

6.5.2 and above

7.1.0 and above

7.1.0 and above

Platform Setup

Not required

Required

Required

Callback matrix

JavaScript SDK Android SDK iOS SDK

SelectIdPCallback

Yes

Yes

Yes

IdPCallback

No

Yes

Yes

RedirectCallback

Yes

No

No

Supported providers matrix

The SDK social login feature supports the following providers:

JavaScript SDK Android SDK iOS SDK

Google

Yes

Yes

Yes

Facebook

Yes

Yes

Yes

Apple

Yes

Yes

Yes

Sign in with Apple is only supported on iOS 12+ devices.

Instructions

This how-to covers setting up an Identity Cloud tenant with the IdPs that the SDKs support: Apple, Facebook, and Google.

ForgeRock ID Cloud supports additional IdPs.