-
Notifications
You must be signed in to change notification settings - Fork 17
/
openid-connect-basic-1_0.ja.html
3315 lines (2755 loc) · 157 KB
/
openid-connect-basic-1_0.ja.html
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
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html lang="en"><head><title>Draft: OpenID Connect
Basic Client Implementer's Guide 1.0 - draft 37</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="description" content="OpenID Connect
Basic Client Implementer's Guide 1.0 - draft 37">
<meta name="generator" content="xml2rfc v1.37pre1 (http://xml.resource.org/)">
<style type='text/css'><!--
body {
font-family: verdana, charcoal, helvetica, arial, sans-serif;
font-size: small; color: #000; background-color: #FFF;
margin: 2em;
}
h1, h2, h3, h4, h5, h6 {
font-family: helvetica, monaco, "MS Sans Serif", arial, sans-serif;
font-weight: bold; font-style: normal;
}
h1 { color: #900; background-color: transparent; text-align: right; }
h3 { color: #333; background-color: transparent; }
td.RFCbug {
font-size: x-small; text-decoration: none;
width: 30px; height: 30px; padding-top: 2px;
text-align: justify; vertical-align: middle;
background-color: #000;
}
td.RFCbug span.RFC {
font-family: monaco, charcoal, geneva, "MS Sans Serif", helvetica, verdana, sans-serif;
font-weight: bold; color: #666;
}
td.RFCbug span.hotText {
font-family: charcoal, monaco, geneva, "MS Sans Serif", helvetica, verdana, sans-serif;
font-weight: normal; text-align: center; color: #FFF;
}
table.TOCbug { width: 30px; height: 15px; }
td.TOCbug {
text-align: center; width: 30px; height: 15px;
color: #FFF; background-color: #900;
}
td.TOCbug a {
font-family: monaco, charcoal, geneva, "MS Sans Serif", helvetica, sans-serif;
font-weight: bold; font-size: x-small; text-decoration: none;
color: #FFF; background-color: transparent;
}
td.header {
font-family: arial, helvetica, sans-serif; font-size: x-small;
vertical-align: top; width: 33%;
color: #FFF; background-color: #666;
}
td.author { font-weight: bold; font-size: x-small; margin-left: 4em; }
td.author-text { font-size: x-small; }
/* info code from SantaKlauss at http://www.madaboutstyle.com/tooltip2.html */
a.info {
/* This is the key. */
position: relative;
z-index: 24;
text-decoration: none;
}
a.info:hover {
z-index: 25;
color: #FFF; background-color: #900;
}
a.info span { display: none; }
a.info:hover span.info {
/* The span will display just on :hover state. */
display: block;
position: absolute;
font-size: smaller;
top: 2em; left: -5em; width: 15em;
padding: 2px; border: 1px solid #333;
color: #900; background-color: #EEE;
text-align: left;
}
a { font-weight: bold; }
a:link { color: #900; background-color: transparent; }
a:visited { color: #633; background-color: transparent; }
a:active { color: #633; background-color: transparent; }
p { margin-left: 2em; margin-right: 2em; }
p.copyright { font-size: x-small; }
p.toc { font-size: small; font-weight: bold; margin-left: 3em; }
table.toc { margin: 0 0 0 3em; padding: 0; border: 0; vertical-align: text-top; }
td.toc { font-size: small; font-weight: bold; vertical-align: text-top; }
ol.text { margin-left: 2em; margin-right: 2em; }
ul.text { margin-left: 2em; margin-right: 2em; }
li { margin-left: 3em; }
/* RFC-2629 <spanx>s and <artwork>s. */
em { font-style: italic; }
strong { font-weight: bold; }
dfn { font-weight: bold; font-style: normal; }
cite { font-weight: normal; font-style: normal; }
tt { color: #036; }
tt, pre, pre dfn, pre em, pre cite, pre span {
font-family: "Courier New", Courier, monospace; font-size: small;
}
pre {
text-align: left; padding: 4px;
color: #000; background-color: #CCC;
}
pre dfn { color: #900; }
pre em { color: #66F; background-color: #FFC; font-weight: normal; }
pre .key { color: #33C; font-weight: bold; }
pre .id { color: #900; }
pre .str { color: #000; background-color: #CFF; }
pre .val { color: #066; }
pre .rep { color: #909; }
pre .oth { color: #000; background-color: #FCF; }
pre .err { background-color: #FCC; }
/* RFC-2629 <texttable>s. */
table.all, table.full, table.headers, table.none {
font-size: small; text-align: center; border-width: 2px;
vertical-align: top; border-collapse: collapse;
}
table.all, table.full { border-style: solid; border-color: black; }
table.headers, table.none { border-style: none; }
th {
font-weight: bold; border-color: black;
border-width: 2px 2px 3px 2px;
}
table.all th, table.full th { border-style: solid; }
table.headers th { border-style: none none solid none; }
table.none th { border-style: none; }
table.all td {
border-style: solid; border-color: #333;
border-width: 1px 2px;
}
table.full td, table.headers td, table.none td { border-style: none; }
hr { height: 1px; }
hr.insert {
width: 80%; border-style: none; border-width: 0;
color: #CCC; background-color: #CCC;
}
--></style>
</head>
<body>
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table>
<table summary="layout" width="66%" border="0" cellpadding="0" cellspacing="0"><tr><td><table summary="layout" width="100%" border="0" cellpadding="2" cellspacing="1">
<tr><td class="header">Draft</td><td class="header">N. Sakimura</td></tr>
<tr><td class="header"> </td><td class="header">NRI</td></tr>
<tr><td class="header"> </td><td class="header">J. Bradley</td></tr>
<tr><td class="header"> </td><td class="header">Ping Identity</td></tr>
<tr><td class="header"> </td><td class="header">M. Jones</td></tr>
<tr><td class="header"> </td><td class="header">Microsoft</td></tr>
<tr><td class="header"> </td><td class="header">B. de Medeiros</td></tr>
<tr><td class="header"> </td><td class="header">Google</td></tr>
<tr><td class="header"> </td><td class="header">C. Mortimore</td></tr>
<tr><td class="header"> </td><td class="header">Salesforce</td></tr>
<tr><td class="header"> </td><td class="header">August 3, 2015</td></tr>
</table></td></tr></table>
<h1><br />OpenID Connect
Basic Client Implementer's Guide 1.0 - draft 37</h1>
<h3>Abstract</h3>
<p>
OpenID Connect 1.0 は, OAuth 2.0 プロトコルの上にシンプルなアイデンティティレイヤーを付与したものである.
このプロトコルは, Client が Authorization Server の認証結果に基づいて End-User のアイデンティティを検証することを可能にする.
また同時に End-User の必要最低限のプロフィール情報を, 相互運用可能かつ RESTful な形で取得することも可能にする.
</p>
<p>
本ドキュメント OpenID Connect Basic Client Implementer's Guide 1.0 は, OpenID Connect Core 1.0 仕様のサブセットであり, OAuth Authorization Code Flow を利用して Web ベースの Relying Party を実装する際に読みやすいように構成されている.
本ドキュメントは Core 仕様と重複したコンテンツを含んでいるが, それは実装者が本ドキュメントを読むだけで OAuth Authorization Code Flow を利用した Relying Party を実装できるよう意図したものである.
</p>
<p>
OpenID Provider および Web ベース以外のアプリケーションの実装者は, Core 仕様を参照のこと.
</p><a name="toc"></a><br /><hr />
<h3>Table of Contents</h3>
<p class="toc">
<a href="#Introduction">1.</a>
Introduction<br />
<a href="#rnc">1.1.</a>
Requirements Notation and Conventions<br />
<a href="#Terminology">1.2.</a>
Terminology<br />
<a href="#Overview">1.3.</a>
Overview<br />
<a href="#ProtocolElements">2.</a>
Protocol Elements<br />
<a href="#CodeFlow">2.1.</a>
Code Flow<br />
<a href="#AuthenticationRequest">2.1.1.</a>
Client Prepares Authentication Request<br />
<a href="#RequestParameters">2.1.1.1.</a>
Request Parameters<br />
<a href="#CodeRequest">2.1.2.</a>
Client Sends Request to Authorization Server<br />
<a href="#Authenticates">2.1.3.</a>
Authorization Server Authenticates End-User<br />
<a href="#Consent">2.1.4.</a>
Authorization Server Obtains End-User Consent/Authorization<br />
<a href="#CodeResponse">2.1.5.</a>
Authorization Server Sends End-User Back to Client<br />
<a href="#CodeOK">2.1.5.1.</a>
End-User Grants Authorization<br />
<a href="#CodeAuthzError">2.1.5.2.</a>
End-User Denies Authorization or Invalid Request<br />
<a href="#ObtainingTokens">2.1.6.</a>
Client Obtains ID Token and Access Token<br />
<a href="#TokenRequest">2.1.6.1.</a>
Client Sends Code<br />
<a href="#TokenOK">2.1.6.2.</a>
Client Receives Tokens<br />
<a href="#IDToken">2.2.</a>
ID Token<br />
<a href="#IDTokenValidation">2.2.1.</a>
ID Token Validation<br />
<a href="#UserInfo">2.3.</a>
UserInfo Endpoint<br />
<a href="#UserInfoRequest">2.3.1.</a>
UserInfo Request<br />
<a href="#UserInfoResponse">2.3.2.</a>
Successful UserInfo Response<br />
<a href="#UserInfoErrorResponse">2.3.3.</a>
UserInfo Error Response<br />
<a href="#Scopes">2.4.</a>
Scope Values<br />
<a href="#StandardClaims">2.5.</a>
Standard Claims<br />
<a href="#AddressClaim">2.5.1.</a>
Address Claim<br />
<a href="#ClaimsLanguagesAndScripts">2.5.2.</a>
Claims Languages and Scripts<br />
<a href="#ClaimStability">2.5.3.</a>
Claim Stability and Uniqueness<br />
<a href="#Serializations">3.</a>
Serializations<br />
<a href="#QuerySerialization">3.1.</a>
Query String Serialization<br />
<a href="#FormSerialization">3.2.</a>
Form Serialization<br />
<a href="#StringOps">4.</a>
String Operations<br />
<a href="#TLS">5.</a>
TLS Version<br />
<a href="#ImplementationConsiderations">6.</a>
Implementation Considerations<br />
<a href="#DiscoReg">6.1.</a>
Discovery and Registration<br />
<a href="#Security">7.</a>
Security Considerations<br />
<a href="#TLSRequirements">7.1.</a>
TLS Requirements<br />
<a href="#Privacy">8.</a>
Privacy Considerations<br />
<a href="#PII">8.1.</a>
Personally Identifiable Information<br />
<a href="#AccessMonitoring">8.2.</a>
Data Access Monitoring<br />
<a href="#Correlation">8.3.</a>
Correlation<br />
<a href="#OfflineAccessPrivacy">8.4.</a>
Offline Access<br />
<a href="#IANA">9.</a>
IANA Considerations<br />
<a href="#rfc.references1">10.</a>
References<br />
<a href="#rfc.references1">10.1.</a>
Normative References<br />
<a href="#rfc.references2">10.2.</a>
Informative References<br />
<a href="#rfc.references3">10.3.</a>
翻訳プロジェクト<br />
<a href="#Acknowledgements">Appendix A.</a>
Acknowledgements<br />
<a href="#Notices">Appendix B.</a>
Notices<br />
<a href="#History">Appendix C.</a>
Document History<br />
<a href="#Translator">Appendix D.</a>
翻訳者<br />
<a href="#rfc.authors">§</a>
Authors' Addresses<br />
</p>
<br clear="all" />
<a name="Introduction"></a><br /><hr />
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table>
<a name="rfc.section.1"></a><h3>1.
Introduction</h3>
<p>
本ドキュメント OpenID Connect Basic Client Implementer's Guide 1.0 は, <a class='info' href='#OpenID.Core'>OpenID Connect Core 1.0<span> (</span><span class='info'>Sakimura, N., Bradley, J., Jones, M., de Medeiros, B., and C. Mortimore, “OpenID Connect Core 1.0,” August 2015.</span><span>)</span></a> [OpenID.Core] 仕様のサブセットであり, OAuth 2.0 <a class='info' href='#RFC6749'>[RFC6749]<span> (</span><span class='info'>Hardt, D., Ed., “The OAuth 2.0 Authorization Framework,” October 2012.</span><span>)</span></a> Authorization Code Flow を利用して Web ベースの Relying Party を実装する際に読みやすいように構成されている.
本ドキュメントは Core 仕様と重複したコンテンツを含んでいるが, それは実装者が本ドキュメントを読むだけで OAuth Authorization Code Flow を利用した Relying Party を実装できるよう意図したものである.
本実装者ガイドと OpenID Connect Core 仕様の間に齟齬がある場合は, Core 仕様を優先する.
</p>
<p>
OAuth Implicit Flow を利用する Web ベースの Relying Party を実装する場合には, <a class='info' href='#OpenID.Implicit'>OpenID Connect Implicit Client Implementer's Guide 1.0<span> (</span><span class='info'>Sakimura, N., Bradley, J., Jones, M., de Medeiros, B., and C. Mortimore, “OpenID Connect Implicit Client Implementer's Guide 1.0,” July 2015.</span><span>)</span></a> [OpenID.Implicit] を参照のこと.
OpenID Provider および Web ベース以外のアプリケーションの実装者は, Core 仕様を参照のこと.
本ガイドは OpenID Provider および Web ベース以外のアプリケーションに関する Implimentation Consideration および Security Considerations を省略している.
</p>
<p>
OpenID Connect のベースとなる <a class='info' href='#RFC6749'>OAuth 2.0 Authorization Framework<span> (</span><span class='info'>Hardt, D., Ed., “The OAuth 2.0 Authorization Framework,” October 2012.</span><span>)</span></a> [RFC6749] と <a class='info' href='#RFC6750'>OAuth 2.0 Bearer Token Usage<span> (</span><span class='info'>Jones, M. and D. Hardt, “The OAuth 2.0 Authorization Framework: Bearer Token Usage,” October 2012.</span><span>)</span></a> [RFC6750] は, 3rd-party アプリケーションが HTTP リソースへの限定的アクセス権を取得および行使するための全般的フレームワークを提供している.
これらはリソースアクセスのための Access Token を取得および行使する方法は定義するが, アイデンティティ情報を提供するための標準的手段は定義しない.
とりわけ, OAuth 2.0 のプロファイリングを行わずに End-User の認証に必要な情報を提供することは不可能である.
本ドキュメント読者は上記2つの仕様を理解していることが期待される.
</p>
<p>
OpenID Connect は OAuth 2.0 認可プロセスを拡張し, 認証目的で利用できるようにする.
本拡張を利用する場合, Client は <tt>openid</tt> scope を指定して Authorization Request を送信する.
本拡張を利用した Authorization Request は, Authentication Request と呼ばれる.
</p>
<p>
認証結果は ID Token (<a class='info' href='#IDToken'>Section 2.2<span> (</span><span class='info'>ID Token</span><span>)</span></a> 参照) と呼ばれる <a class='info' href='#JWT'>JSON Web Token (JWT)<span> (</span><span class='info'>Jones, M., Bradley, J., and N. Sakimura, “JSON Web Token (JWT),” May 2015.</span><span>)</span></a> [JWT] として返される.
OpenID Connect をサポートする OAuth 2.0 Authentication Server は, OpenID Provider (OP) とも呼ばれる.
OpenID Connect を利用する OAuth 2.0 Client は Relying Party (RP) とも呼ばれる.
</p>
<p>
本ドキュメントでは, Relying Party は Authorization Endpoint, Token Endpoint 等を含む OpenID Provider の設定情報を既に得ているものとする.
これらの情報は通常 <a class='info' href='#OpenID.Discovery'>OpenID Connect Discovery 1.0<span> (</span><span class='info'>Sakimura, N., Bradley, J., Jones, M., and E. Jay, “OpenID Connect Discovery 1.0,” August 2015.</span><span>)</span></a> [OpenID.Discovery] にある Discovery を通じて得られるが, その他の手段で得られることもある.
</p>
<p>
また同様に, Relying Party は OpenID Provider 利用に必要なクレデンシャルを取得し, OP 利用に必要な情報を登録しているものとする.
これの処理は通常 <a class='info' href='#OpenID.Registration'>OpenID Connect Dynamic Client Registration 1.0<span> (</span><span class='info'>Sakimura, N., Bradley, J., and M. Jones, “OpenID Connect Dynamic Client Registration 1.0,” August 2015.</span><span>)</span></a> [OpenID.Registration] にある Dynamic Registration を通じて行われるが, その他の手段で行われることもある.
</p>
<a name="rnc"></a><br /><hr />
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table>
<a name="rfc.section.1.1"></a><h3>1.1.
Requirements Notation and Conventions</h3>
<p>
本ドキュメント中の "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", および "OPTIONAL" の意味するところは, <a class='info' href='#RFC2119'>[RFC2119]<span> (</span><span class='info'>Bradner, S., “Key words for use in RFCs to Indicate Requirement Levels,” March 1997.</span><span>)</span></a> の定める通りである.
</p>
<p>
本ドキュメントの .txt バージョンでは, 表記そのままで利用される値についてはクオートで囲んでいる.
このような値をプロトコルメッセージ中で用いる場合, クオートを含めてはならない (MUST NOT).
HTML バージョンではクオートで囲う代わりに <tt>this fixed-width font</tt> を用いる.
</p>
<p>
<a class='info' href='#JWS'>JSON Web Signature (JWS)<span> (</span><span class='info'>Jones, M., Bradley, J., and N. Sakimura, “JSON Web Signature (JWS),” May 2015.</span><span>)</span></a> [JWS] を用いる場合, シリアライゼーションには JWS Compact Serialization を用いる.
JWS JSON Serialization は利用しない.
</p>
<p>
本ドキュメント中の RFC 2119 に定義されるキーワードが OpenID Provider の挙動に言及する場合, それはあくまで Client 実装者が OpenID Provider の挙動を理解しやすいように用いられているに過ぎない.
</p>
<a name="Terminology"></a><br /><hr />
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table>
<a name="rfc.section.1.2"></a><h3>1.2.
Terminology</h3>
<p>
本ドキュメントでは,
<a class='info' href='#RFC6749'>OAuth 2.0<span> (</span><span class='info'>Hardt, D., Ed., “The OAuth 2.0 Authorization Framework,” October 2012.</span><span>)</span></a> [RFC6749] で定義された "Access Token", "Authorization Code",
"Authorization Endpoint", "Authorization Grant", "Authorization Server",
"Client", "Client Authentication", "Client Identifier", "Client Secret",
"Grant Type", "Protected Resource", "Redirection URI", "Refresh Token",
"Resource Owner", "Resource Server", "Response Type" および "Token Endpoint",
<a class='info' href='#JWT'>JSON Web Token (JWT)<span> (</span><span class='info'>Jones, M., Bradley, J., and N. Sakimura, “JSON Web Token (JWT),” May 2015.</span><span>)</span></a> [JWT] で定義された "Claim Name", "Claim Value", "JSON Web Token (JWT)" および "JWT Claims Set",
<a class='info' href='#JWS'>JSON Web Signature (JWS)<span> (</span><span class='info'>Jones, M., Bradley, J., and N. Sakimura, “JSON Web Signature (JWS),” May 2015.</span><span>)</span></a> [JWS] で定義された "Header Parameter" および "JOSE Header",
<a class='info' href='#RFC7230'>RFC 7230<span> (</span><span class='info'>Fielding, R., Ed. and J. Reschke, Ed., “Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing,” June 2014.</span><span>)</span></a> [RFC7230] で定義された "User Agent" という用語を用いる.
</p>
<p>
本ドキュメントはその他に以下の用語を用いる.
</p>
<blockquote class="text"><dl>
<dt>Authentication</dt>
<dd>
提示された Identity と実際の Entity が紐づいているという十分な確信を得るためのプロセス.
</dd>
<dt>Authentication Request</dt>
<dd>
OpenID Connect が定める拡張パラメータおよびスコープを利用して, Authorization Server に End-User の認証を要求する OAuth 2.0 Authorization Request.
このとき Authorization Server は OpenID Connect Provider, Client は OpenID Connect Relying Party となる.
</dd>
<dt>Claim</dt>
<dd>
Entity に関する情報の部分集合.
</dd>
<dt>Claims Provider</dt>
<dd>
Entity の Claim を返すサーバー.
</dd>
<dt>End-User</dt>
<dd>
一連のフローに参加する人間.
</dd>
<dt>Entity</dt>
<dd>
あるコンテキストの中で識別される, 他と独立した個.
End-User は Entity の一例.
</dd>
<dt>ID Token</dt>
<dd>
Authentication イベントに関する Claim を含む <a class='info' href='#JWT'>JSON Web Token (JWT)<span> (</span><span class='info'>Jones, M., Bradley, J., and N. Sakimura, “JSON Web Token (JWT),” May 2015.</span><span>)</span></a> [JWT].
その他の Claim を含むこともある (MAY).
</dd>
<dt>Identifier</dt>
<dd>
あるコンテキスト中で Entity をユニークに特徴づける値.
</dd>
<dt>Issuer</dt>
<dd>
Claim を発行する Entity.
</dd>
<dt>Issuer Identifier</dt>
<dd>
検証可能な Issuer の識別子.
Issuer Identifier は, 大文字小文字を区別する URL である.
この URL は <tt>https</tt> スキーム, ホスト, そして任意でポート番号およびパス要素からなり, クエリーとフラグメント要素は含まない.
</dd>
<dt>OpenID Provider (OP)</dt>
<dd>
End-User を Authenticate できる OAuth 2.0 Authorization Server.
End-User の Authentication イベントに関する Claim を Relying Party に提供する.
</dd>
<dt>Pairwise Pseudonymous Identifier (PPID)</dt>
<dd>
ある Relying Party に対してのみ, ある Entity の識別子として提供される値.
他の Relying Party には, 当該 PPID を当該 Entity と関連づけることはできない.
</dd>
<dt>Personally Identifiable Information (PII)</dt>
<dd>
特定の人物に紐づき, 実際の人物の識別に用いることができる情報.
もしくは特定の人物に直接および間接的にリンクされる可能性のある情報.
</dd>
<dt>Relying Party (RP)</dt>
<dd>
OpenID Provider に End-User Authentication と Claim を要求する OAuth 2.0 Client.
</dd>
<dt>Subject Identifier</dt>
<dd>
Issuer にとって局地的にユニークで再利用されることのない End-User 識別子.
この値は Client に利用されることを想定する.
</dd>
<dt>UserInfo Endpoint</dt>
<dd>
Protected Resource のひとつ.
Access Token を提示する Client に対して, Authorization Grant に従って End-User に関する情報を提供する.
</dd>
<dt>Validation</dt>
<dd>
あるものごとの健全性および正当性を確立するためのプロセス.
</dd>
<dt>Verification</dt>
<dd>
ある事実や値の正確さを検査もしくは証明するためのプロセス.
</dd>
<dt>Voluntary Claim</dt>
<dd>
Client が End-User が要求するあるタスクを実行する際に, 有用ではあるが Essential ではないとを Client が指定した Claim.
</dd>
</dl></blockquote><p>
</p>
<p>
IMPORTANT NOTE TO READERS:
上記の用語定義は本ドキュメントが定めるところであり, 本ドキュメントの実装においてはこれらの定義に従うこと.
"Issuer Identifier" をはじめとして, 本ドキュメントで大文字表記されている用語はすべて上記の定義に従う.
本ドキュメントの読者は必ずこれらの用語定義に従うこと.
</p>
<a name="Overview"></a><br /><hr />
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table>
<a name="rfc.section.1.3"></a><h3>1.3.
Overview</h3>
<p>
OpenID Connect プロトコルは, おおまかに言って以下のステップに従う.
</p>
<p>
</p>
<ol class="text">
<li>
RP (Client) が OpenID Provider (OP) にリクエストを送る.
</li>
<li>
OP は End-User を認証し, 認可を受ける.
</li>
<li>
OP は ID Token および (通常は) Access Token を返す.
</li>
<li>
RP は Access Token を添えて UserInfo Endpoint にリクエストを送る.
</li>
<li>
UserInfo Endpoint は End-User の Claim を返す.
</li>
</ol><p>
</p>
<p>
これら一連のステップを以下に図示する.
</p><div style='display: table; width: 0; margin-left: 3em; margin-right: auto'><pre>
+--------+ +--------+
| | | |
| |---------(1) AuthN Request-------->| |
| | | |
| | +--------+ | |
| | | | | |
| | | End- |<--(2) AuthN & AuthZ-->| |
| | | User | | |
| RP | | | | OP |
| | +--------+ | |
| | | |
| |<--------(3) AuthN Response--------| |
| | | |
| |---------(4) UserInfo Request----->| |
| | | |
| |<--------(5) UserInfo Response-----| |
| | | |
+--------+ +--------+
</pre></div>
<a name="ProtocolElements"></a><br /><hr />
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table>
<a name="rfc.section.2"></a><h3>2.
Protocol Elements</h3>
<p>
Authentication Request は Authorization Code Flow, Implicit Flow および Hybrid Flow のいずれかのフローに従う.
Authorization Code Flow は, Authorization Server と Client 自身との間でセキュアに Client Secret を管理できる Client 向けのフローである.
それが不可能な Client は Implicit Flow を用いる.
しかしながら, Client Secret をセキュアに保持できないにも関わらず, Refresh Token 取得のためにしばしば Native アプリケーションやその他の Client が Authorization Code flow を利用することもある.
Hybrid Flow は Authorization Code Flow と Implicit Flow をあわせたものであり, Client が Authorization Server から直接 ID Token およびオプションで Access Token を受け取ることでレイテンシ低下を防ぎつつも, 後から Client が Token Endpoint にアクセスして各種トークン (特に Refresh Token) を取得できるようにするものである.
</p>
<p>
このドキュメントは Code Flow を利用する Client に対して必要十分な情報のみを提供する.
</p>
<a name="CodeFlow"></a><br /><hr />
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table>
<a name="rfc.section.2.1"></a><h3>2.1.
Code Flow</h3>
<p>
Code Flow は以下のステップからなる.
</p>
<p>
</p>
<ol class="text">
<li>
Client は必要なリクエストパラメータを含んだ Authentication Request を構築する.
</li>
<li>
Client は Authorization Server にリクエストを送信する.
</li>
<li>
Authorization Server は End-User を認証する.
</li>
<li>
Authorization Server は End-User の Consent/Authorization を取得する.
</li>
<li>
Authorization Server は End-User を <tt>code</tt> とともに Client に戻す.
</li>
<li>
Client は <tt>code</tt> を Token Endpoint に送信し, Access Token と ID Token を受け取る.
</li>
<li>
Client はそれらのトークンを検証し, End-User の Subject Identifier を取得する.
</li>
</ol><p>
</p>
<a name="AuthenticationRequest"></a><br /><hr />
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table>
<a name="rfc.section.2.1.1"></a><h3>2.1.1.
Client Prepares Authentication Request</h3>
<p>
RP が End-User を Authenticate したい, もしくは End-User が既に Authenticated であるかどうか知りたい場合, Client は Authorization Endpoint に Authentication Request を送る.
</p>
<p>
Authorization Endpoint との間の通信は TLS を利用しなければならない (MUST).
TLS の詳細については <a class='info' href='#TLSRequirements'>Section 7.1<span> (</span><span class='info'>TLS Requirements</span><span>)</span></a> を参照のこと.
</p>
<p>
Client は <a class='info' href='#RFC7231'>RFC 7231<span> (</span><span class='info'>Fielding, R., Ed. and J. Reschke, Ed., “Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content,” June 2014.</span><span>)</span></a> [RFC7231] に定義される HTTP <tt>GET</tt> もしくは HTTP <tt>POST</tt> を利用できる (MAY).
</p>
<p>
HTTP <tt>GET</tt> を利用する場合, パラメータは <a class='info' href='#QuerySerialization'>Section 3.1<span> (</span><span class='info'>Query String Serialization</span><span>)</span></a> にある Query String Serialization を用いてシリアライズされる.
HTTP <tt>POST</tt> を利用する場合, パラメータは <a class='info' href='#W3C.REC-html401-19991224'>[W3C.REC‑html401‑19991224]<span> (</span><span class='info'>Raggett, D., Hors, A., and I. Jacobs, “HTML 4.01 Specification,” December 1999.</span><span>)</span></a> にある <tt>application/x-www-form-urlencoded</tt> フォーマットを用いてエンティティボディ中に含まれる.
</p>
<p>
以下は Authentication Request URL の一例である.
(改行は掲載上の都合による)
</p><div style='display: table; width: 0; margin-left: 3em; margin-right: auto'><pre>
https://server.example.com/authorize?
response_type=code
&client_id=s6BhdRkqt3
&redirect_uri=https%3A%2F%2Fclient.example.org%2Fcb
&scope=openid%20profile
&state=af0ifjsldkj
</pre></div>
<a name="RequestParameters"></a><br /><hr />
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table>
<a name="rfc.section.2.1.1.1"></a><h3>2.1.1.1.
Request Parameters</h3>
<p>
OpenID Connect は以下の OAuth 2.0 リクエストパラメータを利用する.
</p>
<p>
</p>
<blockquote class="text"><dl>
<dt>response_type</dt>
<dd>
REQUIRED.
値は <tt>code</tt> とすること (MUST).
これにより Authorization Endpoint から返される <tt>code</tt> と交換で, Access Token および ID Token が Token Endpoint から返されることになる.
</dd>
<dt>client_id</dt>
<dd>
REQUIRED.
Authorization Server における OAuth 2.0 Client Identifier の値.
</dd>
<dt>scope</dt>
<dd>
REQUIRED.
OpenID Connect リクエストは scope に <tt>openid</tt> を含まねばならない (MUST).
OPTIONAL な scope としては,
<tt>profile</tt>,
<tt>email</tt>,
<tt>address</tt>,
<tt>phone</tt>,
および <tt>offline_access</tt> が定義されている.
それぞれの scope 値についての詳細は <a class='info' href='#Scopes'>Section 2.4<span> (</span><span class='info'>Scope Values</span><span>)</span></a> を参照のこと.
</dd>
<dt>redirect_uri</dt>
<dd>
REQUIRED.
レスポンスが返される Redirection URI.
この URI は, Client が OpenID Provider に対して事前に登録済みの Redirection URI のいずれかと完全一致しなければならない (MUST).
マッチングルールは <a class='info' href='#RFC3986'>[RFC3986]<span> (</span><span class='info'>Berners-Lee, T., Fielding, R., and L. Masinter, “Uniform Resource Identifier (URI): Generic Syntax,” January 2005.</span><span>)</span></a> (Simple String Comparison) の Section 6.2.1 に従うこと.
Redirection URI は <tt>https</tt> スキーマを利用することが望まれる (SHOULD) が, Client Type が <tt>confidential</tt> であり, かつ OP が <tt>http</tt> の利用を容認する場合に限り, <tt>http</tt> スキーマを利用してもよい (MAY).
Client Type 等の定義については OAuth 2.0 の Section 2.1 を参照のこと.
Redirection URI には, ネイティブアプリケーションにコールバックを送る目的などで, 上記以外のスキーマを利用することもできる.
</dd>
<dt>state</dt>
<dd>
RECOMMENDED.
リクエストとコールバックの間で維持されるランダムな値.
一般的に Cross-Site Request Forgery (CSRF, XSRF) 対策の目的で利用される, ブラウザ Cookie と紐づく暗号論的にセキュアな値を取る.
</dd>
</dl></blockquote><p>
</p>
<p>
本ドキュメントは上記に加えて以下のリクエストパラメータを定義する.
</p>
<p>
</p>
<blockquote class="text"><dl>
<dt>nonce</dt>
<dd>
OPTIONAL.
Client セッションと ID Token を紐づける文字列であり, リプレイアタック対策に用いられる.
この値は Authentication Request で指定され, そのままの値で ID Token に含まれる.
<tt>nonce</tt> 値には, 推測不可能なように十分なエントロピーを持たせること (MUST).
この条件を満たすには, 暗号論的にセキュアな乱数を HttpOnly なセッションクッキーとして用い, その暗号論的ハッシュ値を <tt>nonce</tt> として利用するといった方法が考えられる.
この場合, ID Token に含まれて返される <tt>nonce</tt> 値をセッションクッキーのハッシュ値と比較することで, 第三者によるリプレイアタックを検知することができる.
Code Flow を利用する場合, nonce の利用は OPTIONAL である.
</dd>
<dt>display</dt>
<dd>
OPTIONAL.
Authorization Server が認証および同意のためのユーザーインタフェースを End-User にどのように表示するかを指定するための ASCII 値 <a class='info' href='#RFC20'>[RFC20]<span> (</span><span class='info'>Cerf, V., “ASCII format for Network Interchange,” October 1969.</span><span>)</span></a>.
以下の値が定義されている.
<blockquote class="text"><dl>
<dt>page</dt>
<dd>
Authorization Server は認証および同意 UI を User Agent の全画面に表示すべきである (SHOULD).
display パラメータが指定されていない場合, この値がデフォルトとなる.
</dd>
<dt>popup</dt>
<dd>
Authorization Server は認証および同意 UI を User Agent のポップアップウィンドウに表示すべきである (SHOULD).
User Agent のポップアップウィンドウはログインダイアログに適切なサイズで, 親ウィンドウ全体を覆うことのないようにすべきである.
</dd>
<dt>touch</dt>
<dd>
Authorization Server は認証および同意 UI をタッチインタフェースを持つデバイスに適した形で表示すべきである (SHOULD).
</dd>
<dt>wap</dt>
<dd>
Authorization Server は認証および同意 UI を "feature phone" に適した形で表示すべきである (SHOULD).
</dd>
</dl></blockquote>
Authorization Server は User Agent の機能を検知して適切な表示を行うようにしても良い (MAY).
</dd>
<dt>prompt</dt>
<dd>
OPTIONAL.
Authorization Server が End-User に再認証および同意を再度要求するかどうか指定するための, スペース区切りの ASCII 文字列のリスト.
以下の値が定義されている.
<blockquote class="text"><dl>
<dt>none</dt>
<dd>
Authorization Server はいかなる認証および同意 UI をも表示してはならない (MUST NOT).
End-User が認証済でない場合, Client が要求する Claim 取得に十分な事前同意を取得済でない場合, またはリクエストを処理するために必要な何らかの条件を満たさない場合には, エラーが返される.
典型的なエラーコードは <tt>login_required</tt>, <tt>interaction_required</tt> である.
この prompt 値は現在の認証状態, 同意状況を確認する為にも利用できる.
</dd>
<dt>login</dt>
<dd>
Authorization Server は End-User を再認証するべきである (SHOULD).
再認証が不可能な場合はエラーを返す (MUST).
典型的なエラーコードは <tt>login_required</tt> である.
</dd>
<dt>consent</dt>
<dd>
Authorization Server は Client にレスポンスを返す前に End-User に同意を要求するべきである (SHOULD).
同意要求が不可能な場合はエラーを返す (MUST).
典型的なエラーコードは <tt>consent_required</tt> である.
</dd>
<dt>select_account</dt>
<dd>
Authorization Server は End-User にアカウント選択を促すべきである (SHOULD).
この prompt 値は, End-User が Authorization Server 上に複数アカウントを持っているとき, 現在のセッションに紐づくアカウントの中から一つを選択することを可能にする.
End-User によるアカウント選択が不可能な場合はエラーを返す (MUST).
典型的なエラーコードは <tt>account_selection_required</tt> である.
</dd>
</dl></blockquote>
<tt>prompt</tt> パラメータは Client に対して, End-User のセッションがアクティブであることを確認したり, End-User にリクエストに対する注意を促すことを可能にする.
<tt>none</tt> がその他の値とともに用いられる場合はエラーとなる.
</dd>
<dt>max_age</dt>
<dd>
OPTIONAL.
Authentication Age の最大値.
End-User が OP によって明示的に認証されてからの経過時間の最大許容値 (秒).
もし経過時間がこの値より大きい場合, OP は End-User を明示的に再認証しなければならない (MUST).
<tt>max_age</tt> が指定された場合, 発行される ID Token は <tt>auth_time</tt> Claim を含まねばならない (MUST).
</dd>
<dt>ui_locales</dt>
<dd>
OPTIONAL.
End-User の選好する UI の表示言語および文字種.
スペース区切りの <a class='info' href='#RFC5646'>BCP47<span> (</span><span class='info'>Phillips, A., Ed. and M. Davis, Ed., “Tags for Identifying Languages,” September 2009.</span><span>)</span></a> [RFC5646] 言語タグ値のリストとして表現され, 順序は選好順となる.
例えば "fr-CA fr en" という値が指定された場合, カナダで用いられるフランス語が第一選好となり, 次いで地域指定のないフランス語, そして英語と続く.
要求されたロケールがサポートされていない場合でも, OpenID Provider はエラーとするべきではない (SHOULD NOT).
</dd>
<dt>claims_locales</dt>
<dd>
OPTIONAL.
End-User の選好する Claim の表示言語および文字種.
スペース区切りの <a class='info' href='#RFC5646'>BCP47<span> (</span><span class='info'>Phillips, A., Ed. and M. Davis, Ed., “Tags for Identifying Languages,” September 2009.</span><span>)</span></a> [RFC5646] 言語タグ値のリストとして表現され, 順序は選好順となる.
要求されたロケールがサポートされていない場合でも, OpenID Provider はエラーとするべきではない (SHOULD NOT).
</dd>
<dt>id_token_hint</dt>
<dd>
OPTIONAL.
Authorization Server が以前発行した ID Token.
Client が認証した End-User の現在もしくは過去のセッションに関するヒントとして利用される.
もしこの ID Token に紐づく End-User が認証済, もしくはこのリクエスト中で認証された場合, Authorization Server はポジティブレスポンスを返す.
さもなければ, Authorization Server はエラーを返す (SHOULD).
<tt>prompt=none</tt> を利用する場合は, 可能であれば <tt>id_token_hint</tt> を指定するべきであり (SHOULD), さもなければ <tt>invalid_request</tt> を返しても良い (MAY).
ただしサーバーはその場合可能な限りサクセスレスポンスを返すこと.
<tt>id_token_hint</tt> 利用時は, ID Token の audience に Authorization Server 自身が含まれている必要はない.
</dd>
<dt>login_hint</dt>
<dd>
OPTIONAL.
Authorization Server に対する End-User ログイン識別子のヒントとして利用される.
RP が End-User に Email アドレス (もしくはその他の識別子) を要求し, それを Authorization Server にヒントとして送信することでヒントとする.
Discovery に利用された値をヒントの値として利用することを推奨する (RECOMMENDED).
この値は <tt>phone_number</tt> Claim に指定されるフォーマットに従った電話番号でもよい (MAY).
このパラメータを利用するか否かは OP の判断にゆだねる.
</dd>
<dt>acr_values</dt>
<dd>
OPTIONAL.
Authentication Context Class Reference リクエスト値.
Authorization Server が認証リクエストを処理する際に要求される <tt>acr</tt> の値をスペース区切りで示した文字列.
認証処理が満たした Authentication Context Class は, <a class='info' href='#IDToken'>Section 2.2<span> (</span><span class='info'>ID Token</span><span>)</span></a> に示す <tt>acr</tt> Claim Value として返される.
<tt>acr</tt> Claim はこのパラメータを用いることで Voluntary Claim としてリクエストされることになる.
</dd>
</dl></blockquote><p>
</p>
<a name="CodeRequest"></a><br /><hr />
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table>
<a name="rfc.section.2.1.2"></a><h3>2.1.2.
Client Sends Request to Authorization Server</h3>
<p>
Client は Authorization Endpoint に HTTPS で Authentication Request を送信する.
</p>
<p>
以下の例では Client が User Agent に HTTP 302 リダイレクトレスポンスを返し, User Agent に対して Authorization Endpoint に Authentication Request を送るよう指示している. (改行は掲載上の都合による)
</p><div style='display: table; width: 0; margin-left: 3em; margin-right: auto'><pre>
HTTP/1.1 302 Found
Location: https://server.example.com/authorize?
response_type=code
&client_id=s6BhdRkqt3
&redirect_uri=https%3A%2F%2Fclient.example.org%2Fcb
&scope=openid%20profile
&state=af0ifjsldkj
</pre></div>
<p>
User Agent は上記の Client からの HTTP 302 リダイレクトレスポンスに従い, Authorization Server に以下のようなリクエストを送る. (改行は掲載上の都合による)
</p><div style='display: table; width: 0; margin-left: 3em; margin-right: auto'><pre>
GET /authorize?
response_type=code
&client_id=s6BhdRkqt3
&redirect_uri=https%3A%2F%2Fclient.example.org%2Fcb
&scope=openid%20profile
&state=af0ifjsldkj HTTP/1.1
Host: server.example.com
</pre></div>
<a name="Authenticates"></a><br /><hr />
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table>
<a name="rfc.section.2.1.3"></a><h3>2.1.3.
Authorization Server Authenticates End-User</h3>
<p>
Authorization Server は, リクエストパラメータ値に基づき, End-User をログインさせたり既にログイン済みであることを検証する.
End-User とのインタラクションが HTTP で行われる場合は, <a class='info' href='#TLSRequirements'>Section 7.1<span> (</span><span class='info'>TLS Requirements</span><span>)</span></a> に基づきTLS を用いること (MUST).
認証手段の詳細については, 本ドキュメントの定めるところではない.
</p>
<a name="Consent"></a><br /><hr />
<table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc"> TOC </a></td></tr></table>
<a name="rfc.section.2.1.4"></a><h3>2.1.4.
Authorization Server Obtains End-User Consent/Authorization</h3>
<p>