Microsoft Entra ID

Implements OpenID Connect. By default, nonce is set to _.

For usage, see OAuth 2.0 provider with PKCE.

import { MicrosoftEntraId } from "arctic";

const entraId = new MicrosoftEntraId(tenantId, clientId, clientSecret, redirectURI);

const url: URL = await entraId.createAuthorizationURL(state, codeVerifier, {
	// optional
	scopes // "openid" always included
});
const tokens: MicrosoftEntraIdTokens = await entraId.validateAuthorizationCode(code, codeVerifier);
const tokens: MicrosoftEntraIdTokens = await entraId.refreshAccessToken(refreshToken);

Get user profile

Add the profile scope. Optionally add the email scope to get user email.

const url = await entraId.createAuthorizationURL(state, codeVerifier, {
	scopes: ["profile", "email"]
});

Parse the ID token or use the userinfo endpoint. See ID token claims.

const tokens = await entraId.validateAuthorizationCode(code, codeVerifier);
const response = await fetch("https://graph.microsoft.com/oidc/userinfo", {
	headers: {
		Authorization: `Bearer ${tokens.accessToken}`
	}
});
const user = await response.json();