Skip to main content
Social login allows users to authenticate with their existing accounts from providers like Google, Apple, Microsoft, GitHub, and Okta.

Prerequisites

Before you start, make sure you have:
  • A Prelude account with access to the Session API
  • An Application ID (appID) — see Applications
  • Your Management API key for backend calls
  • OAuth credentials from the provider you want to configure (client ID, client secret, etc.)

Supported providers

ProviderIdentifier
Googlegoogle
Appleapple
Microsoftmicrosoft
GitHubgithub
Oktaokta

Configuration options

All providers share the following options:
FieldTypeDescription
client_idstringOAuth client ID from the provider.
client_secretstringOAuth client secret from the provider.
enabledbooleanSet to true to enable the provider.
options.use_email_as_identifierbooleanWhen true, creates an email identifier for new OAuth users.
options.allow_email_account_mergebooleanWhen true, allows merging accounts that share the same verified email address.
Some providers require additional configuration — see the provider-specific guides below.

Provider guides

Google

Configure Google OAuth for your application.

Apple

Configure Apple OAuth for your application.

Microsoft

Configure Microsoft OAuth for your application.

GitHub

Configure GitHub OAuth for your application.

Okta

Configure Okta OAuth for your application.