Function: buildAuthorizationUrl()

May 28, 2025 · View on GitHub

Support from the community to continue maintaining and improving this module is welcome. If you find the module useful, please consider supporting the project by becoming a sponsor.

▸ buildAuthorizationUrl(config, parameters): URL

Returns a URL to redirect the user-agent to, in order to request authorization at the Authorization Server

Note

URL of the authorization server's authorization endpoint must be configured.

Note

When used, PKCE code challenge, state, and nonce parameter values must always be random and be tied to the user-agent.

Parameters

Parameter	Type	Description
`config`	`Configuration`	-
`parameters`	`Record`<`string`, `string`> \| `URLSearchParams`	Authorization request parameters that will be included in the URL.searchParams

Returns

URL

URL Instance with URL.searchParams including client_id, response_type, and all parameters from the parameters argument

Example

let config!: client.Configuration
let redirect_uri!: string
let scope!: string

// these must be unique for every single authorization request
let code_verifier = client.randomPKCECodeVerifier()
let code_challenge =
  await client.calculatePKCECodeChallenge(code_verifier)

let redirectTo = client.buildAuthorizationUrl(config, {
  redirect_uri,
  scope,
  code_challenge,
  code_challenge_method: 'S256',
})
// redirect now