Skip to content
SuperTokens Docs
Esc
↑↓navigate↵open⌘Jpreview
Dashboard
On this page

Introduction

Authenticate multiple applications using SuperTokens and OAuth2 for unified login across platforms.

Overview

The Unified Login feature helps you in scenarios which involve different types of applications using a common Authorization Server. With it you can configure a common OAuth2 Provider that authenticates all your clients.

Prerequisites

Enable paid features

This feature is only available to paid users. Follow the instructions below to enable it.

This feature is available only with the SuperTokens Managed Service.

Managed Service

  1. Sign in to the SuperTokens dashboard.
  2. Select the managed service option from the service type select component.
  3. Select your core instance from the next elemenet or create a new one.
  4. Open Features sub-page and enable the required ones.

Before you can dive deeper in the functionality there are a few things to keep in mind:

  • The feature is available with the SuperTokens Managed Service. It is not included in the Self-Hosted version.
  • You can use it with the Node.js or the Python backend SDKs. On golang you have to wait for the next releases or configure a separate Authorization Service.
  • Magic link based login is not supported. However, you can switch to email/SMS OTP instead. This method offers the same level of security.
  • Step Up Authentication is not available out of the box. You have to use customizations to support the flow.

Getting started

Three separate quickstart guides are available for you to follow. They organize the content based on the specific use case that you want to implement.

Before you explore a guide, read through the OAuth2 Basics page first. It explains concepts used in each tutorial.

OAuth2 Basics

Go through a quick summary of the OAuth2 specifications to get accustomed with the language used in the quickstart guides.

Applications with a common backend

Implement an authentication flow that involves multiple frontend applications that communicate with a common backend.

Applications with separate backends

Implement an authentication flow that involves multiple frontend applications that communicate with separate backends.

Common authentication for web and mobile

Use a common authentication service for both web and mobile applications.

Customization

To adjust the functionality to fit your use case you can explore different sections from the documentation.

Work with scopes

Discover the built-in scopes and see how you can override them.

Verify Tokens

Learn how to validate tokens.

Add custom claims in tokens

Modify the token payload with custom claims.

API reference

API schema and response details