Linking accounts

Manage the identities associated with your user.

The user identity represents an authentication method associated to the user. For example, if a user signs in using their email, an email identity will be associated with the user.

Linking additional accounts#

Developers can use Openfort to prompt users to link additional accounts (such as a wallet or Discord profile) at any point in their user journey, not just during login.

Link email#

Links an email and password to an existing account using an authentication token.

import Openfort from "@openfort/openfort-js";
const openfort = new Openfort({
  baseConfiguration: {
      publishableKey: OPENFORT_PUBLISHABLE_KEY
  }
});
const email = 'EMAIL';
const password = 'PASSWORD';
const authToken = 'Authentication token';
async function linkEmailPassword() {
  await openfort.linkEmailPassword({email, password, authToken});
}

Initializes an OAuth linking process.

import Openfort from "@openfort/openfort-js";
const openfort = new Openfort({
  baseConfiguration: {
      publishableKey: OPENFORT_PUBLISHABLE_KEY
  }
});
const provider = 'OAuth provider';
const authToken = 'Authentication token';
async function initLinkOAuth() {
  await openfort.initLinkOAuth({provider, authToken});
}

Link wallets#

Links a wallet using SIWE.

import Openfort from "@openfort/openfort-js";
const openfort = new Openfort({
  baseConfiguration: {
      publishableKey: OPENFORT_PUBLISHABLE_KEY
  }
});
const signature = 'SIWE signature';
const message = 'SIWE message';
const walletClientType = 'Wallet client type';
const connectorType = 'Connector type';
const authToken = 'Authentication token';
async function linkWallet() {
  await openfort.linkWallet({signature, message, walletClientType, connectorType, authToken});
}

Unlinking accounts#

Once a user has linked additional accounts to their profile, you may also want to give them the option to unlink those accounts.

Unlink email#

Unlinks an email and password from an existing account using an authentication token.

import Openfort from "@openfort/openfort-js";
const openfort = new Openfort({
  baseConfiguration: {
      publishableKey: OPENFORT_PUBLISHABLE_KEY
  }
});
const email = 'EMAIL';
async function unlinkEmailPassword() {
  await openfort.unlinkEmailPassword(email);
}

Unlinks an OAuth provider from the account.

import Openfort from "@openfort/openfort-js";
const openfort = new Openfort({
  baseConfiguration: {
      publishableKey: OPENFORT_PUBLISHABLE_KEY
  }
});
const provider = 'OAuth provider';
const authToken = 'Authentication token';
async function unlinkOAuth() {
  await openfort.unlinkOAuth({provider, authToken});
}

Unlink wallets#

Unlinks a wallet.

import Openfort from "@openfort/openfort-js";
const openfort = new Openfort({
  baseConfiguration: {
      publishableKey: OPENFORT_PUBLISHABLE_KEY
  }
});
const address = 'Wallet address';
const authToken = 'Authentication token';
async function unlinkWallet() {
  await openfort.unlinkWallet({provider, address});
}