-
Notifications
You must be signed in to change notification settings - Fork 4
/
rfc6819.xml
7256 lines (6503 loc) · 379 KB
/
rfc6819.xml
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
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE rfc SYSTEM "rfc2629.dtd">
<?rfc toc="yes"?>
<?rfc tocompact="yes"?>
<?rfc tocdepth="4"?>
<?rfc tocindent="yes"?>
<?rfc symrefs="yes"?>
<?rfc sortrefs="yes"?>
<?rfc comments="yes"?>
<?rfc inline="yes"?>
<?rfc compact="yes"?>
<?rfc subcompact="no"?>
<?rfc strict="no"?>
<?rfc rfcedstyle="yes"?>
<rfc category="info" number="6819"
ipr="trust200902" submissionType="IETF" consensus="yes">
<front>
<title abbrev="OAuth 2.0 Security">OAuth 2.0 Threat Model and Security Considerations</title>
<author fullname="Torsten Lodderstedt" initials="T." role="editor"
surname="Lodderstedt">
<organization>Deutsche Telekom AG</organization>
<address>
<email>[email protected]</email>
</address>
</author>
<author fullname="Mark McGloin" initials="M." surname="McGloin">
<organization>IBM</organization>
<address>
<email>[email protected]</email>
</address>
</author>
<author fullname="Phil Hunt" initials="P." surname="Hunt">
<organization>Oracle Corporation</organization>
<address>
<email>[email protected]</email>
</address>
</author>
<date month="January" year="2013" />
<area>Security Area</area>
<workgroup>OAuth Working Group</workgroup>
<keyword>authorization</keyword>
<keyword>authentication</keyword>
<keyword>token</keyword>
<keyword>counter-measures</keyword>
<keyword>HTTP</keyword>
<keyword>REST</keyword>
<abstract>
<t>
本ドキュメントでは, OAuth 2.0仕様が定めるSecurity Considerationsの範囲を超え,
OAuth 2.0プロトコルに関する包括的脅威モデルを基に, さらなるセキュリティ上の検討項目を示す.
</t>
<!--
<t>This document gives additional security considerations for OAuth,
beyond those in the OAuth 2.0 specification, based on a comprehensive
threat model for the OAuth 2.0 protocol.</t>
-->
</abstract>
</front>
<middle>
<section title="Introduction">
<t>
本ドキュメントでは, OAuth仕様が定めるSecurity Considerationsの範囲を超え,
OAuth 2.0プロトコル <xref target="RFC6749"></xref> に関する包括的脅威モデルを基に, さらなるセキュリティ上の検討項目を示す.
本ドキュメントは以下の項目について扱う.
<list style="symbols">
<t>
脅威モデル策定の前提となる仮説およびその影響範囲を定める.
</t>
<t>
OAuthプロトコルのセキュリティ上の特徴について述べ, それらが攻撃阻止のためにどのような役割を持つかをまとめる.
</t>
<t>
OAuthの包括的脅威モデル, およびそれらへの対抗策についてまとめる.
</t>
</list>
ここで述べる脅威には, OAuthトークンやそれによって保護されるリソースに対する意図的な攻撃の他, 適切なセキュリティ対策が施されていない場合に起こりうるセキュリティリスクも含む.
各脅威はプロトコル仕様の構造に基づいて整理され, デベロッパーが実装時に参照しやすく考慮されている.
例えば, アクセスを許可する際の脅威や各grant typeそれぞれに固有の脅威, リソースサーバーに関わる脅威などが, 該当する章・節にまとめて紹介されている.
</t>
<!--
<t>This document gives additional security considerations for OAuth,
beyond those in the OAuth specification, based on a comprehensive threat
model for the OAuth 2.0 protocol <xref target="RFC6749"></xref>.
It contains the following content:<list style="symbols">
<t>Documents any assumptions and scope considered when creating the
threat model.</t>
<t>Describes the security features built into the OAuth protocol
and how they are intended to thwart attacks.</t>
<t>Gives a comprehensive threat model for OAuth and describes the
respective countermeasures to thwart those threats.</t>
</list>Threats include any intentional attacks on OAuth tokens and
resources protected by OAuth tokens, as well as security risks introduced
if the proper security measures are not put in place. Threats are
structured along the lines of the protocol structure to help development
teams implement each part of the protocol securely, for example, all
threats for granting access, or all threats for a particular grant type,
or all threats for protecting the resource server.</t>
-->
<t>
注)
本ドキュメントはそれぞれの脅威の発生確率や具体的なリスクについては述べない.
そういった項目は, 実装やサービス内容に大きく左右されるためである.
本ドキュメントは抽象的なレベルでの議論を行うが, ここで述べられる情報は実装固有の脅威モデルを考慮する際の基礎となるであろう.
実装者には, 抽象的な脅威モデルを実際の実装にあてはめ, リスク分析を行うことが求められる.
なお本ドキュメントはOAuth 2.0仕様本体を対象としており, 本ドキュメント執筆現在仕様策定が進んでいるクライアント登録やディスカバリーなどの拡張仕様については考慮しない.
</t>
<!--
<t>Note: This document cannot assess the probability or the risk
associated with a particular threat because those aspects strongly
depend on the particular application and deployment OAuth is used to
protect. Similarly, impacts are given on a rather abstract level. But the
information given here may serve as a foundation for deployment-specific
threat models. Implementors may refine and detail the abstract threat
model in order to account for the specific properties of their
deployment and to come up with a risk analysis. As this document is
based on the base OAuth 2.0 specification, it does not consider proposed
extensions such as client registration or discovery, many of which are
still under discussion.</t>
-->
</section>
<section title="Overview">
<t></t>
<section title="Scope">
<t>
本ドキュメントで述べられるSecurity Considerationsは, <xref target="RFC6749"></xref> がサポートする, 特定のOAuthサーバーと紐づくクライアントのみを考慮する.
こういった実装は以下のような特徴を持つ.
</t>
<!--
<t>This security considerations document only considers clients bound
to a particular deployment as supported by <xref
target="RFC6749"></xref>. Such deployments have the
following characteristics:</t>
-->
<t>
<list style="symbols">
<t>
リソースサーバーURLは固定で実装時に既に周知されている.
認可サーバーURLは固定もしくは事前に知ることができる.
</t>
<t>
トークンのscopeに指定される値 (アプリケーションURLやmethodなど) は, 実装時に周知されている.
</t>
<t>
クライアント登録は現在のCore仕様の範囲外である.
従って本ドキュメントはstatic/dynamicに関わらず幅広いクライアント登録方法を想定する.
</t>
</list>
また以下の項目は対象外とする.
</t>
<!--
<t><list style="symbols">
<t>Resource server URLs are static and well-known at development
time; authorization server URLs can be static or discovered.</t>
<t>Token scope values (e.g., applicable URLs and methods) are
well-known at development time.</t>
<t>Client registration is out of
scope of the current core specification. Therefore, this document assumes a broad
variety of options, from static registration during development
time to dynamic registration at runtime.</t>
</list>The following are considered out of scope:</t>
-->
<t>
<list style="symbols">
<t>
認可サーバー・リソースサーバー間のコミュニケーション.
</t>
<t>
トークンフォーマット.
</t>
<t>
認可サーバーがユーザーを認証する方式.
ただしリソースオーナーパスワードクレデンシャルグラント (<xref target="RFC6749"></xref> Section 4.3 参照) については対象とする.
</t>
<t>
アサーション取得メカニズムおよび不正なアサーションによってもたらされる攻撃.
</t>
<t>
特定のOAuthサーバーと紐づけられていないクライアント.
例えばPortable Contacts API <xref target="Portable-Contacts"></xref> 経由でコンタクトリストにアクセスすることができるメールクライアントなど.
このようなクライアントは事前に特定のOAuthサーバーと紐づけておくことはできず, dynamicにOAuthプロトコルの各URLを検知 (discover) する必要がある.
</t>
</list>
</t>
<!--
<t><list style="symbols">
<t>Communication between the authorization server and resource
server.</t>
<t>Token formats.</t>
<t>Except for the resource owner password credentials grant type
(see <xref target="RFC6749"></xref>, Section 4.3), the
mechanism used by authorization servers to authenticate the
user.</t>
<t>Mechanism by which a user obtained an assertion and any
resulting attacks mounted as a result of the assertion being
false.</t>
<t>Clients not bound to a specific deployment: An example could be
a mail client with support for contact list access via the
portable contacts API (see <xref
target="Portable-Contacts"></xref>). Such clients cannot be
registered upfront with a particular deployment and should
dynamically discover the URLs relevant for the OAuth protocol.</t>
</list></t>
-->
</section>
<section title="Attack Assumptions">
<t>
攻撃者とリソースに関して, 以下の想定を置く.
</t>
<!--
<t>The following assumptions relate to an attacker and resources
available to an attacker. It is assumed that:</t>
-->
<t>
<list style="symbols">
<t>
攻撃者はクライアントと認可サーバー, およびクライアントとリソースサーバーの間のネットワークに直接アクセス可能であり, そこでのいかなる通信も盗聴できる状態にある.
ただし認可サーバー・リソースサーバー間の通信へはアクセスできないものとする.
</t>
<t>
攻撃者が攻撃に利用するリソースに制限は無い物とする.
</t>
<t>
OAuthプロトコルに関与する3者のうちの2者が, 共謀して残る1者に対する攻撃を行う可能性があるものとする.
例えば, クライアントと認可サーバーが攻撃者の管理下にあり, リソースアクセスを得るためユーザーを騙すため共謀するケースなどが考えられる.
</t>
</list>
</t>
<!--
<t><list style="symbols">
<t>the attacker has full access to the network
between the client and authorization servers and the client and
the resource server, respectively. The attacker may eavesdrop on
any communications between those parties. He is not assumed to
have access to communication between the authorization server
and resource server.</t>
<t>an attacker has unlimited resources to mount an attack.</t>
<t>two of the three parties involved in the OAuth
protocol may collude to mount an attack against the 3rd party. For
example, the client and authorization server may be under control
of an attacker and collude to trick a user to gain access to
resources.</t>
</list></t>
-->
</section>
<section title="Architectural Assumptions">
<t>
本セクションではセキュリティ上重要なデータに関して, OAuthの各エンティティが持ちうる機能, 制限および設計上のオプションについて仮定する.
これらは脅威解析における基礎となる.
</t>
<!--
<t>This section documents assumptions about the features,
limitations, and design options of the different entities of an OAuth
deployment along with the security-sensitive data elements managed by
those entities. These assumptions are the foundation of the threat
analysis.</t>
-->
<t>
OAuthプロトコルはある程度実装に自由度を残している.
Core仕様は認可サーバーとリソースサーバーの基本的なコンセプトを定めている.
これら両サーバーは単一のエンティティとして実装されることもあれば, 分散した複数のエンティティとして実装される場合もある.
後者の典型例としては, 複数のサービスを提供している事業者が, 単一の認証・認可サービスを, 特にミドルウェアレベルで共通に用いるケースなどがある.
</t>
<!--
<t>The OAuth protocol leaves deployments with a certain degree of
freedom regarding how to implement and apply the standard. The core
specification defines the core concepts of an authorization server and
a resource server. Both servers can be implemented in the same server
entity, or they may also be different entities. The latter is typically
the case for multi-service providers with a single authentication and
authorization system and is more typical in middleware
architectures.</t>
-->
<section title="Authorization Servers">
<t>
認可サーバーでは, 以下のデータが保存されているかアクセス可能な状態にある.
</t>
<!--
<t>The following data elements are stored or accessible on the
authorization server:</t>
-->
<t>
<list style="symbols">
<t>
ユーザーネームとパスワード
</t>
<t>
クライアントIDとクライアントシークレット
</t>
<t>
特定のクライアントと紐づけられたリフレッシュトークン
</t>
<t>
特定のクライアントと紐づけられたアクセストークン
(Handleベースデザイン <xref target="section_tokens"></xref> を用いる場合)
</t>
<t>
HTTPS 証明書/鍵
</t>
<t>
認可プロセスごとの "redirect_uri", "client_id" および認可コード "code"
(Handleベースデザイン <xref target="section_tokens"></xref> を用いる場合)
</t>
</list>
(訳注: Assertionタイプのトークンを用いる場合, redirect_uri や client_id などがトークン自体に含まれており, それらが認可サーバー上には保存されていない場合もある)
</t>
<!--
<t><list style="symbols">
<t>usernames and passwords</t>
<t>client ids and secrets</t>
<t>client-specific refresh tokens</t>
<t>client-specific access tokens (in the case of
handle-based design; see <xref target="section_tokens"></xref>)</t>
<t>HTTPS certificate/key</t>
<t>per-authorization process (in the case of
handle-based design; <xref target="section_tokens"></xref>):
"redirect_uri", "client_id", authorization "code"</t>
</list></t>
-->
</section>
<section title="Resource Server">
<t>
リソースサーバーでは, 以下のデータが保存されているかアクセス可能な状態にある.
</t>
<!--
<t>The following data elements are stored or accessible on the
resource server:</t>
-->
<t>
<list style="symbols">
<t>
ユーザーデータ (詳細はプロトコルの範囲外)
</t>
<t>
HTTPS 証明書/鍵
</t>
<t>
認可サーバークレデンシャルもしくは認可サーバー共有鍵/公開鍵
(前者はHandleベースデザイン <xref target="section_tokens"></xref> を用いる場合, 後者はAssertionベースデザイン <xref target="section_tokens"></xref> を用いる場合)
</t>
<t>
(リクエストごとの) アクセストークン
</t>
</list>
リソースサーバーはリフレッシュトークン, ユーザーパスワードおよびクライアントシークレットは知らないものとする.
</t>
<!--
<t><list style="symbols">
<t>user data (out of scope)</t>
<t>HTTPS certificate/key</t>
<t>either authorization server credentials (handle-based design;
see <xref target="section_tokens"></xref>) or authorization
server shared secret/public key (assertion-based design;
see <xref target="section_tokens"></xref>)</t>
<t>access tokens (per request)</t>
</list>
It is assumed that a resource server has no knowledge of
refresh tokens, user passwords, or client secrets.</t>
-->
</section>
<section title="Client">
<t>
OAuthでは, クライアントとはリソースオーナーの代理として, リソースオーナーの認可のもとで保護リソースへのアクセスを行うアプリケーションである.
Webアプリケーション, ユーザーエージェントベースアプリケーション, ネイティブアプリケーションといったクライアントタイプごとに, 実装上およびセキュリティ上の特徴は異なる.
クライアントタイプとそのプロフィールについては <xref target="RFC6749"></xref> Section 2.1 に定義されている.
</t>
<!--
<t>In OAuth, a client is an application making protected resource
requests on behalf of the resource owner and with its authorization.
There are different types of clients with different implementation
and security characteristics, such as web, user-agent-based, and
native applications. A full definition of the different client types
and profiles is given in <xref target="RFC6749"></xref>,
Section 2.1.</t>
-->
<t>
クライアントでは, 以下のデータが保存されているかアクセス可能な状態にある.
</t>
<!--
<t>The following data elements are stored or accessible on the
client:</t>
-->
<t>
<list style="symbols">
<t>
クライアントID (およびクライアントシークレットもしくはそれに相当する何らかのクライアントクレデンシャル)
</t>
<t>
エンドユーザーごと, もしくはその他のセキュリティコンテキストや委譲コンテキストごとの, 1つ以上のリフレッシュトークン (長期間) およびアクセストークン (短期間)
</t>
<t>
信頼された証明機関の証明書 (Trusted CA certificates, HTTPS)
</t>
<t>
認可プロセスごとの "redirect_uri", 認可コード "code"
</t>
</list>
</t>
<!--
<t><list style="symbols">
<t>client id (and client secret or corresponding client
credential)</t>
<t>one or more refresh tokens (persistent) and access tokens
(transient) per end user or other security-context or delegation
context</t>
<t>trusted certification authority (CA) certificates (HTTPS)</t>
<t>per-authorization process: "redirect_uri",
authorization "code"</t>
</list></t>
-->
</section>
</section>
</section>
<section anchor="sec_features" title="Security Features">
<t>
OAuth 2.0には, ある程度プロトコルレベルで攻撃やセキュリティリスクに対する対策が施されている.
</t>
<!--
<t>These are some of the security features that have been built into
the OAuth 2.0 protocol to mitigate attacks and security issues.</t>
-->
<section anchor="section_tokens" title="Tokens">
<t>
OAuthは広範囲に渡っていろいろな種類のトークン (アクセストークン, リフレッシュトークン, 認可コード) を用いる.
トークンの表現方法としては以下の2通りがある.
</t>
<!--
<t>OAuth makes extensive use of many kinds of tokens (access tokens,
refresh tokens, authorization "codes"). The information content of a
token can be represented in two ways, as follows:</t>
-->
<t>
<list style="hanging">
<t hangText="Handle (or artifact)">
"handle" ("artifact" とも呼ばれる) とは, 認可サーバー内部のデータ構造に対するある種の参照である.
内部データ構造には, ユーザーID (UID) やスコープなどのトークンの属性が含まれる.
handleを用いることで, トークン無効化処理を簡略化し, 暗号化メカニズムを不要にすることができる.
一方でhandleを用いると, 検証およびトークン内容取得のために, 発行者と消費者 (認可サーバーとリソースサーバーなど) の間の通信が必須となる.
これはトークンの発行者と利用者 (認可サーバーとリソースサーバーなど) が異なるエンティティである場合, パフォーマンスやスケーラビリティの点で不利である.
したがってhandleは主に発行者と消費者 (認可サーバーとリソースサーバーなど) が同一エンティティである場合に用いられることになるであろう.
handleトークンはしばしば "opaque" トークンと呼ばれるが, これはリソースサーバーがそのトークン自体を解読する必要がなく, 単なるトークン文字列として利用するのみだからである.
</t>
<t hangText="Assertion (aka self-contained token)">
assertionとはパース可能なトークンである.
assertionは典型的には有効期間, 発行対象 (audience) を持ち, 改竄防止および発行者認証のため電子署名が付けられる.
SAML assertion <xref target="OASIS.saml-core-2.0-os"></xref> や Kerberos ticket <xref target="RFC4120"></xref> が例として挙げられる.
assertionは典型的にはリソースサーバーに直接検証される.
このときリソースサーバーと認可サーバーの間で通信を行う必要はない.
これはトークンの発行者と利用者 (認可サーバーとリソースサーバーなど) が異なるエンティティである場合, パフォーマンスやスケーラビリティの点で有利である.
ただしassertionを用いた場合, トークン無効化の実装はhandleを用いた場合より困難である.
</t>
</list>
リソースサーバーへのリクエストにトークンを利用する場合, 以下の2つの方法を取りうる.
</t>
<!--
<t><list style="hanging">
<t hangText="Handle (or artifact)">A 'handle' is a reference
to some internal
data structure within the authorization server; the internal data
structure contains the attributes of the token, such as user id
(UID),
scope, etc. Handles enable simple revocation and do not require
cryptographic mechanisms to protect token content from being
modified. On the other hand, handles require communication between
the issuing and consuming entity (e.g., the authorization server
and resource server) in order to validate the token and
obtain token-bound data. This communication might have a
negative impact on
performance and scalability if both entities reside on different
systems. Handles are therefore typically used if the issuing and
consuming entity are the same. A 'handle' token is often referred
to as an 'opaque' token because the resource server does not need
to be able to interpret the token directly; it simply uses the
token.</t>
<t hangText="Assertion (aka self-contained token)">An
assertion is a parseable token.
An assertion typically has a duration, has an audience, and
is digitally signed in order to ensure data integrity and origin
authentication. It contains information about the user and the
client. Examples of assertion formats are
Security Assertion Markup Language (SAML) assertions <xref
target="OASIS.saml-core-2.0-os"> </xref> and Kerberos tickets
<xref target="RFC4120"></xref>. Assertions can typically be
directly validated and used by a resource server without
interactions with the authorization server. This results in
better performance and scalability in deployments where the
issuing and consuming entities reside on different systems.
Implementing token revocation is more difficult with
assertions than with handles.</t>
</list>Tokens can be used in two ways to invoke requests on resource
servers, as follows:</t>
-->
<t>
<list style="hanging">
<t hangText="bearer token">
bearer tokenとは, それを受け取ったいかなるクライアントにも利用可能なトークンである (<xref target="RFC6750"></xref>).
トークンを所有していることのみがその利用条件であるため, エンドポイント間での通信がセキュアに保たれ, 許可されたエンドポイントのみがそのトークンにアクセスできる状態を担保することが重要である.
bearer tokenは, クライアントアプリケーションにとっては (proof tokenのように) 利用に際して特別な処理を行う必要がないため便利である.
bearer tokenはWeb上で single-sign-on (SSO) を行う際ブラウザで用いられるcookieと類似の特徴を持つ.
</t>
<t hangText="proof token">
proof tokenは特定のクライアントにのみ利用可能なトークンである.
クライアントは, トークン利用に際して毎回自身がトークン利用可能な主体であることを証明するために何らかの処理を行う必要がある.
クライアントにリクエスト内容に対して特定のトークンと紐づいた秘密鍵を用いて電子署名を要求する, MACタイプのアクセストークン (<xref target="OAuth-HTTP-MAC"></xref>) などがその例である.
</t>
</list>
</t>
<!--
<t><list style="hanging">
<t hangText="bearer token">A 'bearer token' is a token that can be
used by any client who has received the token (e.g., <xref
target="RFC6750"></xref>). Because mere
possession is enough to use the token, it is important that
communication between endpoints be secured to ensure that only
authorized endpoints may capture the token. The bearer token is
convenient for client applications, as it does not require them to
do anything to use them (such as a proof of identity). Bearer
tokens have similar characteristics to web single-sign-on (SSO)
cookies used in browsers.</t>
<t hangText="proof token">A 'proof token' is a token that can only
be used by a specific client. Each use of the token requires the
client to perform some action that proves that it is the
authorized user of the token. Examples of this are
MAC-type access tokens, which
require the client to digitally sign the resource request with a
secret corresponding to the particular token sent with the
request (e.g., <xref target="OAuth-HTTP-MAC"></xref>).</t>
</list></t>
-->
<section title="Scope">
<t>
scopeは, 特定のトークンに紐づき, リソースサーバー, リソース, およびリソースへの操作に関するアクセス認可を示す.
scopeは, OAuthにおいてアクセストークンの持つ権限を明示的に示す手段となる.
scopeは, 認可サーバーとエンドユーザーが, 比較的セキュアでなく信頼度の低いと考えられるOAuthクライアントに対して, リソースへのアクセス権限を制限・制御するために用いられる.
クライアントは必要に応じてトークンの権限を狭めるためだけにscopeを用いることができる.
(例: セキュアでないチャネルを通じてトークンが送信される際, 潜在的リスクを軽減するためなど)
典型的には, scopeはトークンの有効期間 (lifetime) 制限と併用され, 補完関係にある.
</t>
<!--
<t>A scope represents the access authorization associated with a
particular token with respect to resource servers, resources, and
methods on those resources. Scopes are the OAuth way to explicitly
manage the power associated with an access token. A scope can be
controlled by the authorization server and/or the end user in order
to limit access to resources for OAuth clients that these parties
deem less secure or trustworthy. Optionally, the client can request
the scope to apply to the token but only for a lesser scope than
would otherwise be granted, e.g., to reduce the potential impact
if this token is sent over non-secure channels. A scope is typically
complemented by a restriction on a token's lifetime.</t>
-->
</section>
<section title="Limited Access Token Lifetime">
<t>
"expires_in" というプロトコルパラメーターによって, 認可サーバーはアクセストークンの有効期間 (lifetime) を制限し, そのlifetimeに関する情報をクライアントに通知することができる.
(lifetimeは, ユーザーの意思によって行われたり, 認可サーバーのポリシーによって決定される)
このメカニズムにより, 認可サーバーが比較的セキュアでないと見なすOAuthクライアントに対して有効期間の短いトークンを発行したり, セキュアでないチャネルを利用する際に同様に有効期間を短くしたりすることができる.
</t>
<!--
<t>The protocol parameter "expires_in" allows an authorization server
(based on its policies or on behalf of the end user) to limit the
lifetime of an access token and to pass this information to the
client. This mechanism can be used to issue short-lived tokens to
OAuth clients that the authorization server deems less secure, or
where sending tokens over non-secure channels.</t>
-->
</section>
</section>
<section title="Access Token">
<t>
アクセストークンはクライアントがリソースにアクセスする際に用いられる.
アクセストークンには, 典型的には (数分〜数時間程度の) セッションのlifetimeをカバーする程度の短い有効期間が設定される.
アクセストークンはリフレッシュトークンを用いることでリフレッシュ可能である.
有効期間の短いアクセストークンとリフレッシュトークンを併用することで, 明示的な無効化処理無しにアクセストークンの無効化が行われる可能性を高めることができる.
</t>
<!--
<t>An access token is used by a client to access a resource. Access
tokens typically have short life spans (minutes or hours) that cover
typical session lifetimes. An access token may be refreshed through
the use of a refresh token. The short lifespan of an access token, in
combination with the usage of refresh tokens, enables the possibility
of passive revocation of access authorization on the expiry of the
current access token.</t>
-->
</section>
<section title="Refresh Token">
<t>
リフレッシュトークンは, 特定のクライアントに対する長期間有効な認可情報を示す.
このトークンはクライアント・認可サーバー間でのみ送信される.
クライアントはこのトークンを使って新しい ("refresh" された) アクセストークンを取得することができる.
</t>
<!--
<t>A refresh token represents a long-lasting authorization of a
certain client to access resources on behalf of a resource owner. Such
tokens are exchanged between the client and authorization server only.
Clients use this kind of token to obtain ("refresh") new access tokens
used for resource server invocations.</t>
-->
<t>
リフレッシュトークンによって, アクセストークンの有効期間を短く保ちつつ, ユーザーの関与無しに長期間有効なアクセス権限を維持することができる.
リフレッシュトークンは, (分散環境など) リソースサーバーと認可サーバーが同一エンティティでない場合に1つのアドバンテージをもたらす.
認可サーバーがリフレッシュトークンを無効化するだけで, 発行済アクセストークンが期限切れになった時点ですべてのアクセス権限を無効化することができるのである.
この際, アクセストークンの有効期間を短く保つことは, タイムリーなアクセス権限無効化の為に重要なポイントとなる.
(訳注: アクセストークンが複数のリソースサーバーに分散してしまっている状況で, それを確実に無効化するのは面倒な処理である)
</t>
<!--
<t>A refresh token, coupled with a short access token lifetime, can be
used to grant longer access to resources without involving end-user
authorization. This offers an advantage where resource servers and
authorization servers are not the same entity, e.g., in a distributed
environment, as the refresh token is always exchanged at the
authorization server. The authorization server can revoke the refresh
token at any time, causing the granted access to be revoked once the
current access token expires. Because of this, a short access token
lifetime is important if timely revocation is a high priority.</t>
-->
<t>
リフレッシュトークンは, クライアント識別子および認可リクエストを行った特定のクライアントインスタンスに紐づいたsecretでもあり, リソースオーナー認可そのものを示すものでもある.
このことは以下の認可プロセスによって保証される.
</t>
<!--
<t>The refresh token is also a secret bound to the client identifier
and client instance that originally requested the authorization; the
refresh token also represents the original resource owner grant.
This is ensured by the authorization process as follows:</t>
-->
<t>
<list style="numbers">
<t>
リソースオーナーとユーザーエージェントがセキュアに認可コードをクライアントインスタンスに送付する.
</t>
<t>
クライアントは即座にセキュアチャネルを通じてそれを認可サーバーに送り, 受け取ったリフレッシュトークンをセキュアに保存する.
</t>
<t>
クライアントは常にリフレッシュトークンをセキュアチャネルを通じて送信し, アクセストークンを取得する.
(この際オプションで新たなリフレッシュトークンを得る)
</t>
</list>
以上により, クライアントが特定のトークンの秘匿性を維持する限り, リフレッシュトークンはクライアント自身を認証するためにも用いることができる.
</t>
<!--
<t><list style="numbers">
<t>The resource owner and user agent safely deliver the
authorization "code" to the client instance in the first place.</t>
<t>The client uses it immediately in secure transport-level
communications to the authorization server and then securely
stores the long-lived refresh token.</t>
<t>The client always uses the refresh token in secure
transport-level communications to the authorization server to get
an access token (and optionally roll over the refresh token).</t>
</list>So, as long as the confidentiality of the particular token can
be ensured by the client, a refresh token can also be used as an
alternative means to authenticate the client instance itself.</t>
-->
</section>
<section title="Authorization "code"">
<t>
認可コード ("code") はエンドユーザー認可の取得に成功した結果として発行され, クライアントがアクセストークンおよびリフレッシュトークンを取得する際の中間物として動作する.
認可コードは以下の2つの目的で, トークンの代わりにクライアントのリダイレクトURIに送信される.
</t>
<!--
<t>An authorization "code" represents the intermediate result of a
successful end-user authorization process and is used by the client to
obtain access and refresh tokens. Authorization "codes" are sent to the
client's redirect URI instead of tokens for two purposes:</t>
-->
<t>
<list style="numbers">
<t>
ブラウザベースフローでは, プロトコルパラメーターは潜在的攻撃者にアクセス可能な状態になる.
ブラウザキャッシュやログファイルなどがその経路となりうる.
また攻撃者によって異なる値に置き換えられる可能性もある.
これらのリスクを軽減するため, トークンの代わりに有効期間の短い認可コードを送信し, それをよりセキュアなクライアント・認可サーバー間のダイレクト通信を通じてトークンと交換するのである.
</t>
<t>
クライアント認証は, ダイレクト通信ではない認可リクエストより, ダイレクト通信によって行う方が遥かに簡単である.
認可リクエスト時にクライアント認証を行うには, 電子署名が必要となる.
</t>
</list>
</t>
<!--
<t><list style="numbers">
<t>Browser-based flows expose protocol parameters to potential
attackers via URI query parameters (HTTP referrer), the browser
cache, or log file entries, and could be replayed. In order to
reduce this threat, short-lived authorization "codes" are passed
instead of tokens and exchanged for tokens over a more secure
direct connection between the client and the authorization
server.</t>
<t>It is much simpler to authenticate clients during the direct
request between the client and the authorization server than in the
context of the indirect authorization request. The latter would
require digital signatures.</t>
</list></t>
-->
</section>
<section title="Redirect URI">
<t>
リダイレクトURIを用いることで, 不正クライアントの検知やフィッシング攻撃の防止に役立つ.
実際に認可リクエスト時に用いられたリダイレクトURIは, 認可コードをトークンと交換する際に提示され検証される.
これにより認可コードがリダイレクタを通じて偽のクライアントに漏洩した際にも, 攻撃を防ぐことができる.
認可サーバーはパブリッククライアントおよびimplicitグラントタイプを利用するコンフィデンシャルクライアントに対しては, リダイレクトURIの事前登録を必須とし, 認可リクエスト時に指定されるリダイレクトURIを事前登録済みのそれと比較検証するべきである.
</t>
<!--
<t>A redirect URI helps to detect malicious clients and prevents
phishing attacks from clients attempting to trick the user into
believing the phisher is the client. The value of the actual
redirect URI used in the authorization request has to be presented
and is verified when an authorization "code" is exchanged for tokens.
This helps to prevent attacks where the authorization "code" is
revealed through redirectors and counterfeit web application clients.
The authorization server should require public clients and
confidential clients using the implicit grant type to pre-register
their redirect URIs and validate against the registered
redirect URI in the authorization request.</t>
-->
</section>
<section title=""state" Parameter">
<t>
stateパラメーターは, リクエストとそれに対するコールバックを紐づけCSRF攻撃 (<xref target="section_csrf"></xref>) を防止するために用いられる.
CSRF攻撃においては, 攻撃者は自身のリソースへのアクセスを許可し, 攻撃者に対して発行されたトークンを含むリダイレクトリクエストをユーザーに実行させる.
stateパラメーターはユーザーエージェントと紐付けられ, ユーザーエージェントはそれをクライアントおよびユーザーエージェントのみにアクセス可能な場所に保存する.
(例: same-originポリシーによって保護された場所)
</t>
<!--
<t>The "state" parameter is used to link requests and callbacks to
prevent cross-site request forgery attacks (see <xref
target="section_csrf"></xref>) where an attacker authorizes access to
his own resources and then tricks a user into following a redirect
with the attacker's token. This parameter should bind to the
authenticated state in a user agent and, as per the core OAuth spec,
the user agent must be capable of keeping it in a location accessible
only by the client and user agent, i.e., protected by same-origin
policy.</t>
-->
</section>
<section title="Client Identifier">
<t>
認証プロトコルは一般的にエンドユーザーの代理として動作するソフトウェアコンポーネントの素性に関しては考慮しない.
しかしながらOAuthはそれを考慮し, 認可委譲におけるセキュリティレベルを向上している.
OAuthクライアントがユーザーが不在な状況でも動作しうるとうことも, その理由である.
</t>
<!--
<t>Authentication protocols have typically not taken into account the
identity of the software component acting on behalf of the end user.
OAuth does this in order to increase the security level in delegated
authorization scenarios and because the client will be able to act
without the user being present.</t>
-->
<t>
OAuthでは以下のように, 一連のリクエストが同一クライアントによって実行されているかを照合するため, クライアント識別子を用いる.
</t>
<!--
<t>OAuth uses the client identifier to collate associated requests to
the same originator, such as</t>
-->
<t>
<list style="symbols">
<t>
特定エンドユーザーの認可プロセスと, それに続くトークンエンドポイントにおける認可コードとトークンの交換リクエスト
</t>
<t>
エンドユーザーによる特定クライアントへの認可およびその際に発行された初期のトークンと, 該当クライアントがその後ユーザーの同意無しに取得したトークン
(初回以降の認可自動承認プロセスを意味する)
</t>
</list>
クライアント識別子は, 認可サーバーがユーザーに同意を求める際に, そのクライアントに関する情報を表示するためにも用いられる.
さらに特定のクライアントからのリクエスト数を制限したり, リクエストに対して課金を行う際に用いられることもある.
サーバーログファイルなどで異なるクライアントからのアクセスを区別する際に用いることもできるであろう.
</t>
<!--
<t><list style="symbols">
<t>a particular end-user authorization process and the
corresponding request on the token's endpoint to exchange the
authorization "code" for tokens, or</t>
<t>the initial authorization and issuance of a token by an
end user to a particular client, and subsequent requests by this
client to obtain tokens without user consent (automatic processing
of repeated authorizations)</t>
</list>This identifier may also be used by the authorization server
to display relevant registration information to a user when requesting
consent for a scope requested by a particular client. The client
identifier may be used to limit the number of requests for a particular
client or to charge the client per request. It may furthermore be
useful to differentiate access by different clients, e.g., in server
log files.</t>
-->
<t>
OAuthは, クライアントが認可サーバーに対して自身を認証する能力に基づいて, コンフィデンシャルとパブリックという2つのクライアントタイプを定義している.
(例: クライアントクレデンシャルの秘匿性を保持できるかどうかなど)
コンフィデンシャルクライアントはクライアントクレデンシャル (クライアント識別子と紐づいたクライアントシークレットなど) を秘匿に保つことができる, もしくはクライアントアサーション (SAML参照) や鍵暗号法などの手段によりセキュアにクライアント認証を行うことができる.
なお後者のクライアントアサーション (SAML参照) や鍵暗号法を用いた手段の方が, よりセキュアであると考えられる.
</t>
<!--
<t>OAuth defines two client types, confidential and public, based on
their ability to authenticate with the authorization server (i.e.,
ability to maintain the confidentiality of their client credentials).
Confidential clients are capable of maintaining the confidentiality of
client credentials (i.e., a client secret associated with the client
identifier) or capable of secure client authentication using other
means, such as a client assertion (e.g., SAML) or key cryptography. The
latter is considered more secure.</t>
-->
<t>
認可サーバーはクライアントがシークレットを秘匿に保てるかどうか, セキュアな認証方式を利用可能かどうかなどを特定すべきである.
ただしその代わりにエンドユーザーがクライアントの素性を検証することも可能である.
(信頼できるアプリケーションのみをインストールするなど)
リダイレクトURIは, クレデンシャルを偽のクライアントに送信することを防止するために用いられる場合もあるが, クライアントの素性を検証するために用いることはできない.
</t>
<!--
<t>The authorization server should determine whether the client is
capable of keeping its secret confidential or using secure
authentication. Alternatively, the end user can verify the identity of
the client, e.g., by only installing trusted applications. The
redirect URI can be used to prevent the delivery of credentials to a
counterfeit client after obtaining end-user authorization in some
cases but can't be used to verify the client identifier.</t>
-->
<t>
クライアントはクライアントタイプ, プロフィールおよびデプロイモデルによって以下のように分類できる.
(native, webアプリケーションなど, <xref target="RFC6749"></xref> Section 9参照)
</t>
<!--
<t>Clients can be categorized as follows based on the client type,
profile (e.g., native vs. web application; see <xref
target="RFC6749"></xref>, Section 9), and deployment model:</t>
-->
<t>
<list style="hanging">
<t hangText="Deployment-independent "client_id" with pre-registered "redirect_uri" and without "client_secret"">
このケースでは, クライアント識別子は同一ソフトウェアの複数インスタンスに共通して利用される.
このようなクライアント識別子はエンドユーザーの関与無しには検証できない.
ネイティブアプリケーションにおいては, ユーザーにクライアントのメタ情報を提示し, ログファイル中でクライアントを区別するには十分である.
このクライアント識別子に紐づくアクセス権限の無効化は, 同一ソフトウェアの全インスタンスに影響する.
</t>
<t hangText="Deployment-independent "client_id" with pre-registered "redirect_uri" and with "client_secret"">
これはネイティブアプリケーションのためだけのオプションである.
この分類は, クライアントシークレットが適切に保護されないため推奨されない. (<xref target="ObtainClientSecrets"></xref> 参照)
セキュリティ上の弱点のため, このようなクライアント識別子は上記のシークレットを持たないクライアントと同レベルの信頼度となる.
アクセス権減の無効化は, 同一ソフトウェアの全インスタンスに影響する.
</t>
<t hangText="Deployment-specific "client_id" with pre-registered "redirect_uri" and with "client_secret"">
クライアント登録プロセスにおいて, リダイレクトURI, WebサイトURL, Webサイト名および連絡先などのクライアント属性の検証が行われることが保証される.
このようなクライアントは上記のすべてのユースケースで利用可能である.
このレベルは手動もしくはユーザーごとに固有の登録プロセスを伴うWebアプリケーションで実現される.
ネイティブアプリケーションでこのレベルを実現するのは非常に困難である.
ただし, アプリケーションのインストールが管理者によって行われ, 管理者によってクライアントの真正性が検証されているか, (アプリケーションマーケットプロバイダなどにより) end-to-endで単一エンティティによってデバイスインストールごとにクライアントクレデンシャルの生成が行われている場合には, ネイティブアプリケーションでもこのレベルを実現することは可能である.
アクセス権限の無効化は, 単一のインスタンスにのみ影響する.
</t>
<t hangText="Deployment-specific "client_id" with "client_secret" without validated properties">
このようなクライアントは認可サーバーによって特定トランザクション内のリクエスト (認可リクエスト, トークン発行リクエスト, リフレッシュトークン発行リクエストおよびアクセストークンリフレッシュリクエストなど) でのみ識別される.
認可サーバーはいかなるクライアント属性をもエンドユーザーに保証することはできない.
再認可時の自動認可処理は可能である.
このようなクライアントクレデンシャルはクライアント属性の検証無しに自動的に生成可能である.
これは特にネイティブアプリケーションには新たな選択肢となりうるであろう.
アクセス権限の無効化は, 単一のインスタンスにのみ影響する.
</t>
</list>
</t>
<!--
<t><list style="hanging">
<t
hangText="Deployment-independent "client_id" with pre-registered "redirect_uri" and without "client_secret"">Such
an identifier is used by multiple installations of the same
software package. The identifier of such a client can only be
validated with the help of the end-user. This is a viable option
for native applications in order to identify the client for the
purpose of displaying meta information about the client to the
user and to differentiate clients in log files. Revocation of the
rights associated with such a client identifier will affect ALL
deployments of the respective software.</t>
<t
hangText="Deployment-independent "client_id" with pre-registered "redirect_uri" and with "client_secret"">This
is an option for native applications only, since web applications
would require different redirect URIs. This category is not
advisable because the client secret cannot be protected
appropriately (see <xref target="ObtainClientSecrets"></xref>).
Due to its security weaknesses, such client identities have the
same trust level as deployment-independent clients without secrets.
Revocation will affect ALL deployments.</t>
<t
hangText="Deployment-specific "client_id" with pre-registered "redirect_uri" and with "client_secret"">The
client registration process ensures the validation of the client's
properties, such as redirect URI, web site URL, web site name,
and contacts. Such a client identifier can be utilized for all
relevant use cases cited above. This level can be achieved for web
applications in combination with a manual or user-bound
registration process. Achieving this level for native applications
is much more difficult. Either the installation of the application
is conducted by an administrator, who validates the client's
authenticity, or the process from validating the application to
the installation of the application on the device and the creation
of the client credentials is controlled end-to-end by a single
entity (e.g., application market provider). Revocation will affect
a single deployment only.</t>
<t
hangText="Deployment-specific "client_id" with "client_secret" without validated properties">Such
a client can be recognized by the authorization server in
transactions with subsequent requests (e.g., authorization and
token issuance, refresh token issuance, and access token
refreshment). The authorization server cannot assure any property
of the client to end users. Automatic processing of
re-authorizations could be allowed as well. Such client
credentials can be generated automatically without any validation
of client properties, which makes it another option, especially for
native applications. Revocation will affect a single deployment
only.</t>
</list></t>