generated from martinthomson/internet-draft-template
-
Notifications
You must be signed in to change notification settings - Fork 4
Expand file tree
/
Copy pathdraft-ietf-oauth-rfc7523bis.xml
More file actions
939 lines (857 loc) · 34.7 KB
/
draft-ietf-oauth-rfc7523bis.xml
File metadata and controls
939 lines (857 loc) · 34.7 KB
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
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
<?xml version='1.0' encoding='UTF-8'?>
<?xml-stylesheet type='text/xsl' href='http://xml2rfc.tools.ietf.org/authoring/rfc2629.xslt' ?>
<!DOCTYPE rfc PUBLIC "-//IETF//DTD RFC 2629//EN" "http://xml2rfc.tools.ietf.org/authoring/rfc2629.dtd">
<rfc xmlns:xi="http://www.w3.org/2001/XInclude"
category="std" ipr="trust200902"
submissionType="IETF" consensus="yes"
docName="draft-ietf-oauth-rfc7523bis-latest"
updates="7521, 7522, 7523, 9126">
<?rfc toc="yes"?>
<?rfc tocompact="yes"?>
<?rfc tocdepth="5"?>
<?rfc tocindent="yes"?>
<?rfc symrefs="yes"?>
<?rfc sortrefs="yes"?>
<?rfc compact="yes"?>
<?rfc subcompact="no"?>
<front>
<title abbrev="JWT Client Auth Updates">Updates to OAuth 2.0 JSON Web Token (JWT) Client Authentication and Assertion-Based Authorization Grants</title>
<author fullname="Michael B. Jones" surname="Jones" initials="M.B.">
<organization>Self-Issued Consulting</organization>
<address>
<email>michael_b_jones@hotmail.com</email>
<uri>https://self-issued.info/</uri>
</address>
</author>
<author fullname="Brian Campbell" initials="B." surname="Campbell">
<organization abbrev="Ping Identity">Ping Identity</organization>
<address>
<email>bcampbell@pingidentity.com</email>
</address>
</author>
<author fullname="Chuck Mortimore" initials="C." surname="Mortimore">
<organization abbrev="Disney">Disney</organization>
<address>
<email>charliemortimore@gmail.com</email>
</address>
</author>
<author fullname="Filip Skokan" initials="F." surname="Skokan">
<organization abbrev="Okta">Okta</organization>
<address>
<email>panva.ip@gmail.com</email>
</address>
</author>
<date day="2" month="March" year="2026" />
<area>Security</area>
<workgroup>OAuth Working Group</workgroup>
<keyword>OAuth</keyword>
<keyword>JWT</keyword>
<keyword>Assertion</keyword>
<keyword>Token</keyword>
<keyword>Security Token</keyword>
<abstract>
<t>
This specification updates the requirements for audience values
in OAuth 2.0 Client Assertion Authentication and Assertion-based Authorization Grants
to address a security vulnerability identified in the previous
requirements for those audience values in multiple OAuth 2.0 specifications.
</t>
</abstract>
</front>
<middle>
<section title="Introduction" anchor="Introduction">
<t>
Multiple OAuth 2.0 specifications use tokens (also known as "assertions")
that are sent to authorization servers.
These tokens contain an audience value or values intended to
identify the recipients that the token is intended for.
When the token is a JSON Web Token (JWT) <xref target="JWT"/>,
the audience value(s) are contained in the
<spanx style="verb">aud</spanx> (audience) claim.
</t>
<t>
When performing a security analysis of a pre-final version of
the OpenID Federation specification <xref target="OpenID.Federation"/>,
University of Stuttgart security researchers
Pedram Hosseyni, Dr. Ralf Küsters, and Tim Würtele
discovered a vulnerability affecting multiple OpenID and OAuth
specifications caused by ambiguities in the audience values
of tokens sent to authorization servers.
The vulnerability was disclosed to the OAuth working group
in an interim meeting in January 2025 called for that purpose,
including providing a description of the vulnerability
<xref target="private_key_jwt.Disclosure"/>.
A paper they published describing the attack is
<xref target="Audience.Injection"/>.
</t>
<t>
This specification updates the affected OAuth specifications
to address the security vulnerability identified.
Specifically, it eliminates former choices in the audience values
of tokens sent to OAuth 2.0 authorization servers.
<xref target="RFC8414"/> section 3.3 requires that the client having retrieved the metadata validates the returned issuer value.
Other endpoint values of the metadata are not directly validated and, if used as audience when sent to a different endpoint, can open an attack vector.
</t>
<t>
A general description of the updates made is
to require that the issuer identifier URL of the authorization server,
as defined in <xref target="RFC8414"/>,
be used as the sole value of the audience of the JWT client authentication assertion.
Furthermore, the authorization server rejects any JWT client authentication assertion that
does not contain its own issuer identifier as the sole audience value.
An explicit type for each affected kind of token,
as defined in <xref target="RFC8725"/>,
is also defined to facilitate distinguishing between
tokens produced in accordance with specifications
published prior to these updates and those incorporating them.
Specific updates made to each affected specification follow.
</t>
<section title="Notational Conventions" anchor="NotationalConventions">
<t>
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and
"OPTIONAL" in this document are to be interpreted as described in
BCP 14 <xref target="RFC2119"/> <xref target="RFC8174"/> when, and
only when, they appear in all capitals, as shown here.
</t>
</section>
<section title="Terminology" anchor="Terminology">
<t>
All terms are as defined in the following specifications:
"The OAuth 2.0 Authorization Framework" <xref target="RFC6749"/>,
"Assertion Framework for OAuth 2.0 Client Authentication and Authorization Grants" <xref target="RFC7521"/>,
and "JSON Web Token (JWT)" <xref target="JWT"/>.
</t>
</section>
</section>
<section title="Updates to RFC 7521" anchor="RFC7521Updates">
<t>
This section updates
"Assertion Framework for OAuth 2.0 Client Authentication and
Authorization Grants" <xref target="RFC7521"/>
to tighten its audience requirements.
</t>
<t>
The description of the Audience parameter
in Section 5.1 of <xref target="RFC7521"/> (Assertion Metamodel)
is replaced by:
<list style="hanging">
<t hangText="Audience">
<vspace/>
A value that identifies the party intended to process the assertion.
The issuer identifier of the authorization server,
as defined in <xref target="RFC8414"/>, can be used to indicate that
the authorization server is a valid intended audience of the assertion.
</t>
</list>
</t>
</section>
<section title="Updates to RFC 7522" anchor="RFC7522Updates">
<t>
This section updates
"Security Assertion Markup Language (SAML) 2.0 Profile for OAuth 2.0
Client Authentication and Authorization Grants" <xref target="RFC7522"/>.
It tightens its audience requirements for SAML authorization grants and
it deprecates the use of SAML assertions for client authentication.
</t>
<t>
The text and example in Section 2.2 of <xref target="RFC7522"/>
(Using SAML Assertions for Client Authentication)
is replaced by:
<list style="empty">
<t>
SAML Bearer Assertions
MUST NOT be used for client authentication for any new applications.
(The authors are not actually aware of any applications
using this feature of <xref target="RFC7522"/>.)
Should any applications already be doing this in the manner
described in Section 2.2 of <xref target="RFC7522"/>,
it is left to the discretion of their implementers and deployers
whether to migrate away from this feature and/or
potentially tighten the audience values used
in a manner parallel to the changes being made to RFC 7523
by this specification.
</t>
</list>
</t>
<t>
The description of the Audience element in Item 2 of
Section 3 of <xref target="RFC7522"/> (Assertion Format and Processing Requirements)
is replaced by:
<list style="empty">
<t>
The Assertion MUST contain a <Conditions> element
with an <AudienceRestriction> element
with an <Audience> element that identifies the
authorization server as the intended audience.
The client is responsible for ensuring that the audience of the Assertion
is appropriate for the authorization server to which it is sent.
This MAY be the issuer identifier of the authorization server,
the token endpoint URL of the authorization server, or
a SAML Entity ID.
Section 2.5.1.4 of
"Assertions and Protocols for the OASIS Security Assertion Markup Language (SAML) V2.0"
<xref target="OASIS.saml-core-2.0-os"/>
defines the <AudienceRestriction> and <Audience> elements.
The authorization server MUST reject any assertion that does not
contain its own identity as the intended audience.
</t>
</list>
</t>
</section>
<section title="Updates to RFC 7523" anchor="RFC7523Updates">
<t>
This section updates
"JSON Web Token (JWT) Profile for OAuth 2.0 Client Authentication and Authorization Grants" <xref target="RFC7523"/>
to tighten its audience requirements.
</t>
<t>
In Section 3 of <xref target="RFC7523"/> (JWT Format and Processing Requirements),
Item 3, which describes the audience value,
is replaced by:
<list style="empty">
<t>
The JWT MUST contain an <spanx style="verb">aud</spanx>
(audience) claim containing a value that
identifies the authorization server as the intended audience.
Two cases are differentiated:
<list style="letters">
<t>
For the authorization grant,
the client is responsible for ensuring that the audience of the JWT assertion
is appropriate for the authorization server to which it is sent. An
authorization server MAY be identified by either its issuer identifier
or its token endpoint URL.
</t>
<t>
For client authentication,
the <spanx style="verb">aud</spanx> (audience) claim value MUST use
the issuer identifier <xref target="RFC8414"/>
of the authorization server as its sole value.
The authorization server MUST have an issuer identifier
to be used with this specification.
Unlike the <spanx style="verb">aud</spanx> value specified
in <xref target="RFC7523"/>, there MUST be no value other than
the issuer identifier of the intended authorization server
used as the audience of the JWT;
this includes that the token endpoint URL of the authorization server
MUST NOT be used as an audience value.
The authorization server MUST reject any JWT that does not
contain its issuer identifier as its sole audience value.
</t>
</list>
In the absence of an application profile specifying
otherwise, applications MUST compare the audience
values using the Simple String Comparison method defined in Section
6.2.1 of RFC 3986 <xref target="RFC3986"/>.
</t>
</list>
</t>
<t>
In Section 3.2 of <xref target="RFC7523"/> (Client Authentication Processing),
the following requirement is added:
<list style="empty">
<t>
Client authentication JWTs SHOULD be explicitly typed by using the
<spanx style="verb">typ</spanx> header parameter value
<spanx style="verb">client-authentication+jwt</spanx>
or another more specific explicit type value defined by a specification profiling this specification.
</t>
<t>
The introduction of strong typing for JWTs (using explicit <spanx style="verb">typ</spanx>
values) serves as a signal to distinguish between tokens produced in accordance with
specifications published prior to these updates and those incorporating them. However,
the primary security protection comes from the tightened audience requirements. Since
strong typing alone does not prevent the attacks described in <xref
target="private_key_jwt.Disclosure" /> and <xref target="Audience.Injection" />, the
use of explicit typing is RECOMMENDED for clients, enabling them to signal their intention of sending
a JWT conforming to the requirements herein. However, it is NOT RECOMMENDED for servers to reject JWTs
that do not have explicit types, as doing so would cause interoperability issues with clients that
already conform to the tightened audience requirements but have not yet adopted explicit typing.
This approach balances security signaling with practical
deployment considerations, avoiding disruption to client deployments that already
conform to the tightened audience requirements but have not yet adopted explicit typing.
</t>
</list>
</t>
<t>
In Section 4 of <xref target="RFC7523"/> (Authorization Grant Example),
the sentence:
<list style="empty">
<t>
The intended audience of the JWT is
<spanx style="verb">https://jwt-rp.example.net</spanx>, which is an
identifier with which the authorization server identifies itself.
</t>
</list>
is replaced by:
<list style="empty">
<t>
The intended audience of the JWT is
<spanx style="verb">https://authz.example.net</spanx>,
which is the authorization server's issuer identifier.
</t>
</list>
</t>
<figure title="Example JWT Claims Set" anchor="JWTClaims">
<preamble>
In the same section, the JWT Claims Set example is replaced by:
</preamble>
<artwork><![CDATA[
{
"aud": "https://authz.example.net",
"iss": "https://jwt-idp.example.com",
"sub": "mailto:mike@example.com",
"iat": 1731721541,
"exp": 1731725141,
"http://claims.example.com/member": true
}
]]></artwork>
</figure>
<t>
In the list of agreements required by participants
in Section 5 of <xref target="RFC7523"/> (Interoperability Considerations),
an agreement on "audience identifiers" is no longer needed
for client authentication JWTs.
</t>
<t>
The additional example in the following subsection
is added after Section 4 of <xref target="RFC7523"/>
</t>
<section title="Client Authentication JWT Example" anchor="ClientAuthExample">
<t>
The following example illustrates what a client authentication JWT
and token request using it would look like.
</t>
<t>
The example shows a JWT issued and signed by the OAuth client identified as
<spanx style='verb'>https://client.example/</spanx>.
The intended audience of the JWT is
<spanx style="verb">https://authz.example.net</spanx>,
which is the authorization server's issuer identifier.
The JWT is sent as part of a token request to the authorization server's
token endpoint at <spanx style='verb'>https://authz.example.net/token.oauth2</spanx>.
</t>
<figure>
<preamble>
Below is an example JSON object that could be encoded to
produce the JWT Claims Set for a client authentication JWT:
</preamble>
<artwork><![CDATA[
{
"aud": "https://authz.example.net",
"iss": "https://client.example/",
"sub": "https://client.example/",
"iat": 1752702206,
"exp": 1752705806
}
]]></artwork>
</figure>
<figure>
<preamble>
The following example JSON object, used as the header parameters of a JWT,
declares that the JWT is a client authentication JWT,
is signed with the Elliptic Curve Digital Signature Algorithm (ECDSA) P-256 with SHA-256,
and was signed with a key identified by
the <spanx style="verb">kid</spanx> value <spanx style="verb">16</spanx>.
</preamble>
<artwork><![CDATA[
{
"typ": "client-authentication+jwt",
"alg": "ES256",
"kid": "16"
}
]]></artwork>
</figure>
<figure>
<preamble>
To present the JWT with the claims and header parameters shown above
as part of an access token request, for example,
the client might make the following HTTPS request
(with extra line breaks for display purposes only):
</preamble>
<artwork><![CDATA[
POST /token.oauth2 HTTP/1.1
Host: authz.example.net
Content-Type: application/x-www-form-urlencoded
grant_type=authorization_code&
code=n0esc3NRze7LTCu7iYzS6a5acc3f0ogp4&
client_assertion_type=urn%3Aietf%3Aparams%3Aoauth%3A
client-assertion-type%3Ajwt-bearer&
client_assertion=eyJ0eXAiOiJjbGllbnQtYXV0aGVudGljYXRpb24rand0IiwiYWx
nIjoiRVMyNTYiLCJraWQiOiIxNiJ9.eyJhdWQiOiAiaHR0cHM6Ly9hdXRoei5leGFt
cGxlLm5ldCIsImlzcyI6ICJodHRwczovL2NsaWVudC5leGFtcGxlLyIsInN1YiI6IC
JodHRwczovL2NsaWVudC5leGFtcGxlLyIsImlhdCI6IDE3NTI3MDIyMDYsImV4cCI6
IDE3NTI3MDU4MDZ9.6KrSQUxdl9ehs[...omitted for brevity...]bwc0ZOJw
]]></artwork>
</figure>
</section>
</section>
<section title="Updates to RFC 9126" anchor="RFC9126Updates">
<t>
This section updates
"OAuth 2.0 Pushed Authorization Requests" <xref target="RFC9126"/>
to tighten its audience requirements.
</t>
<t>
The last paragraph in Section 2 of <xref target="RFC9126"/>
(Pushed Authorization Request Endpoint),
which describes the audience value
is replaced by:
<list style="empty">
<t>
This update resolves the potential ambiguity regarding
the appropriate audience value to use when employing
JWT client assertion-based authentication
(as defined in Section 2.2 of <xref target="RFC7523"/>
and as updated by <xref target="RFC7523Updates"/> with the
<spanx style="verb">private_key_jwt</spanx> or
<spanx style="verb">client_secret_jwt</spanx> authentication method names
per Section 9 of <xref target="OpenID.Core"/>)
that was described in <xref target="RFC9126"/>.
To address that ambiguity, the issuer identifier URL
of the authorization server according to <xref target="RFC8414"/>
MUST be used as the sole value of the audience.
The authorization server MUST reject any such JWT that does not
contain its own issuer identifier as the sole audience value.
</t>
<t>
Client authentication JWTs SHOULD be explicitly typed by using the
<spanx style="verb">typ</spanx> header parameter value
<spanx style="verb">client-authentication+jwt</spanx>
or another more specific explicit type value defined by a specification profiling this specification.
</t>
<t>
The introduction of strong typing for JWTs (using explicit <spanx style="verb">typ</spanx>
values) serves as a signal to distinguish between tokens produced in accordance with
specifications published prior to these updates and those incorporating them. However,
the primary security protection comes from the tightened audience requirements. Since
strong typing alone does not prevent the attacks described in <xref
target="private_key_jwt.Disclosure" /> and <xref target="Audience.Injection" />, the
use of explicit typing is RECOMMENDED for clients, enabling them to signal their intention of sending
a JWT conforming to the requirements herein. However, it is NOT RECOMMENDED for servers to reject JWTs
that do not have explicit types, as doing so would cause interoperability issues with clients that
already conform to the tightened audience requirements but have not yet adopted explicit typing.
This approach balances security signaling with practical
deployment considerations, avoiding disruption to client deployments that already
conform to the tightened audience requirements but have not yet adopted explicit typing.
</t>
</list>
</t>
</section>
<section anchor="Security" title="Security Considerations">
<t>
The security considerations described within the following specifications are all applicable
to this document:
"Assertion Framework for OAuth 2.0 Client Authentication and Authorization Grants" <xref target="RFC7521"/>,
"Security Assertion Markup Language (SAML) 2.0 Profile for OAuth 2.0
Client Authentication and Authorization Grants" <xref target="RFC7522"/>,
"JSON Web Token (JWT) Profile for OAuth 2.0 Client Authentication and Authorization Grants" <xref target="RFC7523"/>,
"OAuth 2.0 Pushed Authorization Requests" <xref target="RFC9126"/>,
"The OAuth 2.0 Authorization Framework" <xref target="RFC6749"/>,
and "JSON Web Token (JWT)" <xref target="JWT"/>.
</t>
<t>
This specification tightens token audience requirements to prevent attacks
that could result from exploiting audience ambiguities
previously allowed by
<xref target="RFC7521"/>, <xref target="RFC7522"/>,
<xref target="RFC7523"/>, and <xref target="RFC9126"/>.
These attacks are described in <xref target="private_key_jwt.Disclosure"/>
and <xref target="Audience.Injection"/>.
</t>
</section>
<section title="IANA Considerations" anchor="IANA">
<section title="Media Type Registration" anchor="MediaReg">
<t>
This section registers the following media type <xref target="RFC2046"/>
in the "Media Types" registry <xref target="IANA.MediaTypes"/>
in the manner described in <xref target="RFC6838"/>.
</t>
<section title="Registry Contents" anchor="MediaContents">
<t>
<?rfc subcompact="yes"?>
<list style="symbols">
<t>
Type name: application
</t>
<t>
Subtype name: client-authentication+jwt
</t>
<t>
Required parameters: n/a
</t>
<t>
Optional parameters: n/a
</t>
<t>
Encoding considerations: binary;
A client authentication JWT is a JWT;
JWT values are encoded as a
series of base64url-encoded values (some of which may be the
empty string) separated by period ('.') characters.
</t>
<t>
Security considerations: See <xref target="Security"/> of this specification
</t>
<t>
Interoperability considerations: n/a
</t>
<t>
Published specification: <xref target="RFC7523Updates"/> of this specification
</t>
<t>
Applications that use this media type:
Applications that use this specification
</t>
<t>
Fragment identifier considerations: n/a
</t>
<t>
Additional information:<list style="empty">
<t>Magic number(s): n/a</t>
<t>File extension(s): n/a</t>
<t>Macintosh file type code(s): n/a </t></list>
<vspace/>
</t>
<t>
Person & email address to contact for further information:
<vspace/>
Michael B. Jones, michael_b_jones@hotmail.com
</t>
<t>
Intended usage: COMMON
</t>
<t>
Restrictions on usage: none
</t>
<t>
Author: Michael B. Jones, michael_b_jones@hotmail.com
</t>
<t>
Change controller: IETF
</t>
<t>
Provisional registration? No
</t>
</list>
<?rfc subcompact="no"?>
</t>
</section>
</section>
<section title="OAuth Token Endpoint Authentication Methods" anchor="MethodsReg">
<t>
This section updates entries in the "OAuth Token Endpoint Authentication Methods" registry of <xref target="IANA.OAuthParameters"/>
</t>
<section title="Registry Contents" anchor="MethodsContents">
<t>
<?rfc subcompact="yes"?>
<list style="symbols">
<t>
Token Endpoint Authentication Method Name: private_key_jwt
</t>
<t>
Change Controller: IETF
</t>
<t>
Reference: Section 9 of <xref target="OpenID.Core"/>, [[this specification]]
</t>
</list>
<?rfc subcompact="no"?>
</t>
<t></t>
<t>
<?rfc subcompact="yes"?>
<list style="symbols">
<t>
Token Endpoint Authentication Method Name: client_secret_jwt
</t>
<t>
Change Controller: IETF
</t>
<t>
Reference: Section 9 of <xref target="OpenID.Core"/>, [[this specification]]
</t>
</list>
<?rfc subcompact="no"?>
</t>
</section>
</section>
<section title="OAuth URI Registration Updates">
<t>
This section requests updates to the following entries in the "OAuth URI" registry of <xref target="IANA.OAuthParameters"/>
to add [[this specification]] as an additional reference.
<?rfc subcompact="yes"?>
<list style="symbols">
<t>urn:ietf:params:oauth:grant-type:jwt-bearer</t>
<t>urn:ietf:params:oauth:client-assertion-type:jwt-bearer</t>
<t>urn:ietf:params:oauth:grant-type:saml2-bearer</t>
<t>urn:ietf:params:oauth:client-assertion-type:saml2-bearer</t>
</list>
<?rfc subcompact="no"?>
</t>
</section>
</section>
</middle>
<back>
<references title="Normative References">
<xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.2119.xml"/>
<xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.3986.xml"/>
<xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.6749.xml"/>
<xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.7521.xml"/>
<xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.7522.xml"/>
<xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.7523.xml"/>
<xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.8174.xml"/>
<xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.8414.xml"/>
<xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.8725.xml"/>
<xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.9126.xml"/>
<!-- Reference from https://bib.ietf.org/public/rfc/bibxml/reference.RFC.7519.xml with change to anchor="JWT" -->
<reference anchor="JWT" target="https://www.rfc-editor.org/info/rfc7519">
<front>
<title>JSON Web Token (JWT)</title>
<author fullname="M. Jones" initials="M." surname="Jones"/>
<author fullname="J. Bradley" initials="J." surname="Bradley"/>
<author fullname="N. Sakimura" initials="N." surname="Sakimura"/>
<date month="May" year="2015"/>
<abstract>
<t>JSON Web Token (JWT) is a compact, URL-safe means of representing claims to be transferred between two parties. The claims in a JWT are encoded as a JSON object that is used as the payload of a JSON Web Signature (JWS) structure or as the plaintext of a JSON Web Encryption (JWE) structure, enabling the claims to be digitally signed or integrity protected with a Message Authentication Code (MAC) and/or encrypted.</t>
</abstract>
</front>
<seriesInfo name="RFC" value="7519"/>
<seriesInfo name="DOI" value="10.17487/RFC7519"/>
</reference>
<reference target="https://docs.oasis-open.org/security/saml/v2.0/saml-core-2.0-os.pdf" anchor="OASIS.saml-core-2.0-os">
<front><title>Assertions and Protocols for the OASIS Security Assertion Markup Language
(SAML) V2.0</title>
<author fullname="Scott Cantor" initials="S." surname="Cantor">
<organization>Internet2</organization>
<address><email>cantor.2@osu.edu</email></address></author>
<author fullname="John Kemp" initials="J." surname="Kemp"><organization>Nokia</organization>
<address><email>John.Kemp@nokia.com</email></address></author><author fullname="Rob Philpott" initials="R." surname="Philpott">
<organization>RSA Security</organization>
<address><email>rphilpott@rsasecurity.com</email></address></author>
<author fullname="Eve Maler" initials="E." surname="Maler">
<organization>Sun Microsystems</organization><address><email>eve.maler@sun.com</email></address></author>
<date year="2005" month="March"/></front>
<seriesInfo name="OASIS Standard" value="saml-core-2.0-os"/>
</reference>
<reference anchor="OpenID.Core" target="https://openid.net/specs/openid-connect-core-1_0.html">
<front>
<title>OpenID Connect Core 1.0 incorporating errata set 2</title>
<author fullname="Nat Sakimura" initials="N." surname="Sakimura">
<organization abbrev="NAT.Consulting (was at NRI)">NAT.Consulting</organization>
</author>
<author fullname="John Bradley" initials="J." surname="Bradley">
<organization abbrev="Yubico (was at Ping Identity)">Yubico</organization>
</author>
<author fullname="Michael B. Jones" initials="M.B." surname="Jones">
<organization abbrev="Self-Issued Consulting (was at Microsoft)">Self-Issued Consulting</organization>
</author>
<author fullname="Breno de Medeiros" initials="B." surname="de Medeiros">
<organization abbrev="Google">Google</organization>
</author>
<author fullname="Chuck Mortimore" initials="C." surname="Mortimore">
<organization abbrev="Disney (was at Salesforce)">Disney</organization>
</author>
<date day="15" month="December" year="2023"/>
</front>
</reference>
</references>
<references title="Informative References">
<xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.2046.xml"/>
<xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.6838.xml"/>
<reference anchor="Audience.Injection" target="https://eprint.iacr.org/2025/629">
<front>
<title>Audience Injection Attacks: A New Class of Attacks on Web-Based Authorization and Authentication Standards</title>
<author fullname="Pedram Hosseyni" initials="P." surname="Hosseyni">
<organization>University of Stuttgart</organization>
</author>
<author fullname="Ralf Küsters" initials="R." surname="Küsters">
<organization>University of Stuttgart</organization>
</author>
<author fullname="Tim Würtele" initials="T." surname="Würtele">
<organization>University of Stuttgart</organization>
</author>
<date month="April" year="2025"/>
</front>
<seriesInfo name="Cryptology ePrint Archive" value="Paper 2025/629" />
</reference>
<reference anchor="private_key_jwt.Disclosure" target="https://openid.net/wp-content/uploads/2025/01/OIDF-Responsible-Disclosure-Notice-on-Security-Vulnerability-for-private_key_jwt.pdf">
<front>
<title>OIDF Responsible Disclosure Notice on Security Vulnerability for private_key_jwt</title>
<author>
<organization>OpenID Foundation</organization>
</author>
<date year="2025" month="January" day="24"/>
</front>
</reference>
<reference anchor="OpenID.Federation" target="https://openid.net/specs/openid-federation-1_0.html">
<front>
<title>OpenID Federation 1.0</title>
<author fullname="Roland Hedberg">
<organization>independent</organization>
</author>
<author fullname="Michael B. Jones">
<organization>Self-Issued Consulting</organization>
</author>
<author fullname="A. Solberg">
<organization>Sikt</organization>
</author>
<author fullname="John Bradley">
<organization>Yubico</organization>
</author>
<author fullname="Giuseppe De Marco">
<organization>independent</organization>
</author>
<author fullname="Vladimir Dzhuvinov">
<organization>Connect2id</organization>
</author>
<date day="17" month="February" year="2026"/>
</front>
</reference>
<reference anchor="IANA.MediaTypes" target="https://www.iana.org/assignments/media-types">
<front>
<title>Media Types</title>
<author>
<organization>IANA</organization>
</author>
<date/>
</front>
</reference>
<reference anchor="IANA.OAuthParameters" target="https://www.iana.org/assignments/oauth-parameters/oauth-parameters.xhtml">
<front>
<title>OAuth Parameters</title>
<author>
<organization>IANA</organization>
</author>
<date/>
</front>
</reference>
</references>
<section title="Document History" anchor="History">
<t>
[[ to be removed by the RFC Editor before publication as an RFC ]]
</t>
<t>
-06
<list style="symbols">
<t>
Applied shepherd review comments by Rifaat Shekh-Yusef.
</t>
</list>
</t>
<t>
-05
<list style="symbols">
<t>
Applied editorial suggestions by Axel Nennker.
</t>
</list>
</t>
<t>
-04
<list style="symbols">
<t>
Applied editorial suggestions by Jamshid Khosravian.
</t>
</list>
</t>
<t>
-03
<list style="symbols">
<t>
Update OAuth Token Endpoint Authentication Methods IANA entries with reference to this specification
</t>
<t>
Relaxed client requirement to use strong typed JWTs. SHOULD instead of MUST.
</t>
<t>
Do not restrict the "aud" claim's type. Allow it to be an array with a single member.
</t>
<t>
Advise the client to ensure that the audience of an assertion authorization grant makes sense with respect to where it’s being sent.
</t>
<t>
Updates to the abstract and introduction to (hopefully) better reflect the more targeted scope of the work.
</t>
<t>
Remove JWTs for Client Authentication example replacement (not worth it for including typ in the encoded JWT header).
</t>
<t>
Add request to update existing OAuth URI registrations to add reference to this specification for the four relevant URNs.
</t>
<t>
Fixup the new Client Authentication JWT Example.
</t>
</list>
-02
<list style="symbols">
<t>
Added Filip Skokan as an author.
</t>
<t>
Applied Brian Campbell's suggestions made at IETF 122. Specifically:
<list style="symbols">
<t>
Focused RFC 7523 updates on JWT client authentication case.
</t>
<t>
Described client responsibilities for the audience value
of authorization grants.
No longer mandate that the audience for authorization grants
be the issuer identifier, so as to make a minimum of breaking changes.
</t>
<t>
Deprecated the use of SAML assertions for client authentication.
</t>
</list>
</t>
</list>
</t>
<t>
-01
<list style="symbols">
<t>
Reworked to make updates to RFC 7523, rather than replacing it.
</t>
<t>
Removed updates to RFC 9101.
</t>
<t>
Added reference to the University of Stuttgart paper <xref target="Audience.Injection"/>.
</t>
</list>
</t>
<t>
-00
<list style="symbols">
<t>
Initial working group draft, replacing draft-jones-oauth-rfc7523bis-00.
</t>
</list>
</t>
</section>
<section title="Acknowledgements" anchor="Acknowledgements" numbered="no">
<t>
We would like to acknowledge the contributions of the following
people to this specification:
Brock Allen,
John Bradley,
Ralph Bragg,
Joseph Heenan,
Pedram Hosseyni,
Pieter Kasselman,
Jamshid Khosravian,
Ralf Küsters,
Martin Lindström,
Axel Nennker,
Aaron Parecki,
Dean H. Saxe,
Arndt Schwenkschuster,
Rifaat Shekh-Yusef,
and
Tim Würtele.
</t>
</section>
</back>
</rfc>