Third-party auth providers

Learn how to integrate with third-party auth provider.

Openfort's embedded wallets are fully-compatible with any authentication provider that supports JWT-based, stateless authentication.

To make these instructions concrete, this guide uses Firebase as a sample third party auth provider.

First, follow the guide on how to configure third party authentication.

The supported authentication providers are ACCELBYTE, CUSTOM, FIREBASE, SUPABASE', LOOTLOCKER, PLAYFAB and 'OIDC'.

You will need to call the authenticateWithThirdPartyProvider method:

import {ThirdPartyOAuthProvider, TokenType} from "@openfort/openfort-js";
await openfort.authenticateWithThirdPartyProvider({
    provider: ThirdPartyOAuthProvider.FIREBASE,
    token: "YOUR_USER_AUTH_TOKEN",
    tokenType: TokenType.ID_TOKEN, // or CUSTOM_TOKEN
});

auth.tsx

openfortConfig.ts

import {GoogleAuthProvider, getAuth, signInWithPopup} from "firebase/auth";
import {ThirdPartyOAuthProvider, TokenType} from "@openfort/openfort-js";
import openfort from "./openfortConfig"
async function loginWithGoogle() {
  const googleProvider = new GoogleAuthProvider();
  signInWithPopup(auth, googleProvider)
    .then(async (result) => {
      const idToken = await result.user.getIdToken();
      const token = await openfort.authenticateWithThirdPartyProvider({provider:ThirdPartyOAuthProvider.FIREBASE, token:idToken, tokenType:TokenType.ID_TOKEN});
    })
}

Upon successful authentication, the SDK will return a Player object that contains the linked accounts. For example, if you used Firebase as the third-party provider, the response will look like this:

response.json

{
  "id": "pla_cc9ed2b7-c5f5-4c43-8dca-c4b104ba1762",
  "object": "player",
  "createdAt": 1710976453,
  "linkedAccounts": [
      {
          "provider": "firebase",
          "disabled": false,
          "externalUserId": "2"
      }
  ]
}