1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
import * as oauth from '../src/index.js'
// a random client authentication key is generated here for the example's sake, you would however// use crypto.subtle.importKey to import a private key that is pre-registered on the ASconst { privateKey } = await oauth.generateKeyPair('ES256')const keyID = 'a52faab2-f688-44b6-bde8-f493aeb526fb' // the `kid` the authorization server expects, or undefined if not applicable
const issuer = new URL('https://example.as.com')const as = await oauth  .discoveryRequest(issuer)  .then((response) => oauth.processDiscoveryResponse(issuer, response))
const client: oauth.Client = {  client_id: 'abc4ba37-4ab8-49b5-99d4-9441ba35d428',  token_endpoint_auth_method: 'private_key_jwt',}
const redirect_uri = 'https://example.rp.com/cb'
if (as.code_challenge_methods_supported?.includes('S256') !== true) {  // This example assumes S256 PKCE support is signalled  // If it isn't supported, random `nonce` must be used for CSRF protection.  throw new Error()}
const code_verifier = oauth.generateRandomCodeVerifier()const code_challenge = await oauth.calculatePKCECodeChallenge(code_verifier)const code_challenge_method = 'S256'
{  // redirect user to as.authorization_endpoint
  const authorizationUrl = new URL(as.authorization_endpoint!)  authorizationUrl.searchParams.set('client_id', client.client_id)  authorizationUrl.searchParams.set('code_challenge', code_challenge)  authorizationUrl.searchParams.set('code_challenge_method', code_challenge_method)  authorizationUrl.searchParams.set('redirect_uri', redirect_uri)  authorizationUrl.searchParams.set('response_type', 'code')  authorizationUrl.searchParams.set('scope', 'openid email')}
// one eternity later, the user lands back on the redirect_urilet sub: stringlet access_token: string{  // @ts-expect-error  const currentUrl: URL = getCurrentUrl()  const params = oauth.validateAuthResponse(as, client, currentUrl, oauth.expectNoState)  if (oauth.isOAuth2Error(params)) {    console.log('error', params)    throw new Error() // Handle OAuth 2.0 redirect error  }
  const response = await oauth.authorizationCodeGrantRequest(    as,    client,    params,    redirect_uri,    code_verifier,    {      clientPrivateKey: {        key: privateKey,        kid: keyID,      },    },  )
  let challenges: oauth.WWWAuthenticateChallenge[] | undefined  if ((challenges = oauth.parseWwwAuthenticateChallenges(response))) {    for (const challenge of challenges) {      console.log('challenge', challenge)    }    throw new Error() // Handle www-authenticate challenges as needed  }
  const result = await oauth.processAuthorizationCodeOpenIDResponse(as, client, response)  if (oauth.isOAuth2Error(result)) {    console.log('error', result)    throw new Error() // Handle OAuth 2.0 response body error  }
  console.log('result', result)  ;({ access_token } = result)  const claims = oauth.getValidatedIdTokenClaims(result)  console.log('ID Token Claims', claims)  ;({ sub } = claims)}
// fetch userinfo response{  const response = await oauth.userInfoRequest(as, client, access_token)
  let challenges: oauth.WWWAuthenticateChallenge[] | undefined  if ((challenges = oauth.parseWwwAuthenticateChallenges(response))) {    for (const challenge of challenges) {      console.log('challenge', challenge)    }    throw new Error() // Handle www-authenticate challenges as needed  }
  const result = await oauth.processUserInfoResponse(as, client, sub, response)  console.log('result', result)}