Debian Codegraph @

rfc9266.html

raw
1 <!DOCTYPE html>
2 <html lang="en" class="RFC">
3 <head>
4 <meta charset="utf-8">
5 <meta content="Common,Latin" name="scripts">
6 <meta content="initial-scale=1.0" name="viewport">
7 <title>RFC 9266: Channel Bindings for TLS 1.3</title>
8 <meta content="Sam Whited" name="author">
9 <meta content='
10
11 This document defines a channel binding type, tls-exporter, that is
12 compatible with TLS 1.3 in accordance with RFC 5056, "On the Use of
13 Channel Bindings to Secure Channels". Furthermore, it updates the
14 default channel binding to the new binding for versions of TLS greater
15 than 1.2. This document updates RFCs 5801, 5802, 5929, and 7677.
16
17 ' name="description">
18 <meta content="xml2rfc 3.12.10" name="generator">
19 <meta content="9266" name="rfc.number">
20 <!-- Generator version information:
21 xml2rfc 3.12.10
22 Python 3.6.15
23 appdirs 1.4.4
24 ConfigArgParse 1.4.1
25 google-i18n-address 2.4.0
26 html5lib 1.0.1
27 intervaltree 3.0.2
28 Jinja2 2.11.3
29 kitchen 1.2.6
30 lxml 4.7.1
31 MarkupSafe 2.0.1
32 pycairo 1.15.1
33 pycountry 19.8.18
34 pyflakes 2.1.1
35 PyYAML 5.4.1
36 requests 2.24.0
37 setuptools 40.5.0
38 six 1.14.0
39 WeasyPrint 52.5
40 -->
41 <link href="rfc9266.xml" rel="alternate" type="application/rfc+xml">
42 <link href="#copyright" rel="license">
43 <style type="text/css">/*
44
45 NOTE: Changes at the bottom of this file overrides some earlier settings.
46
47 Once the style has stabilized and has been adopted as an official RFC style,
48 this can be consolidated so that style settings occur only in one place, but
49 for now the contents of this file consists first of the initial CSS work as
50 provided to the RFC Formatter (xml2rfc) work, followed by itemized and
51 commented changes found necssary during the development of the v3
52 formatters.
53
54 */
55
56 /* fonts */
57 @import url('https://fonts.googleapis.com/css?family=Noto+Sans'); /* Sans-serif */
58 @import url('https://fonts.googleapis.com/css?family=Noto+Serif'); /* Serif (print) */
59 @import url('https://fonts.googleapis.com/css?family=Roboto+Mono'); /* Monospace */
60
61 @viewport {
62 zoom: 1.0;
63 width: extend-to-zoom;
64 }
65 @-ms-viewport {
66 width: extend-to-zoom;
67 zoom: 1.0;
68 }
69 /* general and mobile first */
70 html {
71 }
72 body {
73 max-width: 90%;
74 margin: 1.5em auto;
75 color: #222;
76 background-color: #fff;
77 font-size: 14px;
78 font-family: 'Noto Sans', Arial, Helvetica, sans-serif;
79 line-height: 1.6;
80 scroll-behavior: smooth;
81 }
82 .ears {
83 display: none;
84 }
85
86 /* headings */
87 #title, h1, h2, h3, h4, h5, h6 {
88 margin: 1em 0 0.5em;
89 font-weight: bold;
90 line-height: 1.3;
91 }
92 #title {
93 clear: both;
94 border-bottom: 1px solid #ddd;
95 margin: 0 0 0.5em 0;
96 padding: 1em 0 0.5em;
97 }
98 .author {
99 padding-bottom: 4px;
100 }
101 h1 {
102 font-size: 26px;
103 margin: 1em 0;
104 }
105 h2 {
106 font-size: 22px;
107 margin-top: -20px; /* provide offset for in-page anchors */
108 padding-top: 33px;
109 }
110 h3 {
111 font-size: 18px;
112 margin-top: -36px; /* provide offset for in-page anchors */
113 padding-top: 42px;
114 }
115 h4 {
116 font-size: 16px;
117 margin-top: -36px; /* provide offset for in-page anchors */
118 padding-top: 42px;
119 }
120 h5, h6 {
121 font-size: 14px;
122 }
123 #n-copyright-notice {
124 border-bottom: 1px solid #ddd;
125 padding-bottom: 1em;
126 margin-bottom: 1em;
127 }
128 /* general structure */
129 p {
130 padding: 0;
131 margin: 0 0 1em 0;
132 text-align: left;
133 }
134 div, span {
135 position: relative;
136 }
137 div {
138 margin: 0;
139 }
140 .alignRight.art-text {
141 background-color: #f9f9f9;
142 border: 1px solid #eee;
143 border-radius: 3px;
144 padding: 1em 1em 0;
145 margin-bottom: 1.5em;
146 }
147 .alignRight.art-text pre {
148 padding: 0;
149 }
150 .alignRight {
151 margin: 1em 0;
152 }
153 .alignRight > *:first-child {
154 border: none;
155 margin: 0;
156 float: right;
157 clear: both;
158 }
159 .alignRight > *:nth-child(2) {
160 clear: both;
161 display: block;
162 border: none;
163 }
164 svg {
165 display: block;
166 }
167 .alignCenter.art-text {
168 background-color: #f9f9f9;
169 border: 1px solid #eee;
170 border-radius: 3px;
171 padding: 1em 1em 0;
172 margin-bottom: 1.5em;
173 }
174 .alignCenter.art-text pre {
175 padding: 0;
176 }
177 .alignCenter {
178 margin: 1em 0;
179 }
180 .alignCenter > *:first-child {
181 border: none;
182 margin: 0 auto;
183 }
184
185 /* lists */
186 ol, ul {
187 padding: 0;
188 margin: 0 0 1em 2em;
189 }
190 ol ol, ul ul, ol ul, ul ol {
191 margin-left: 1em;
192 }
193 li {
194 margin: 0 0 0.25em 0;
195 }
196 .ulCompact li {
197 margin: 0;
198 }
199 ul.empty, .ulEmpty {
200 list-style-type: none;
201 }
202 ul.empty li, .ulEmpty li {
203 margin-top: 0.5em;
204 }
205 ul.ulBare, li.ulBare {
206 margin-left: 0em !important;
207 }
208 ul.compact, .ulCompact,
209 ol.compact, .olCompact {
210 line-height: 100%;
211 margin: 0 0 0 2em;
212 }
213
214 /* definition lists */
215 dl {
216 }
217 dl > dt {
218 float: left;
219 margin-right: 1em;
220 }
221 /*
222 dl.nohang > dt {
223 float: none;
224 }
225 */
226 dl > dd {
227 margin-bottom: .8em;
228 min-height: 1.3em;
229 }
230 dl.compact > dd, .dlCompact > dd {
231 margin-bottom: 0em;
232 }
233 dl > dd > dl {
234 margin-top: 0.5em;
235 margin-bottom: 0em;
236 }
237
238 /* links */
239 a {
240 text-decoration: none;
241 }
242 a[href] {
243 color: #22e; /* Arlen: WCAG 2019 */
244 }
245 a[href]:hover {
246 background-color: #f2f2f2;
247 }
248 figcaption a[href],
249 a[href].selfRef {
250 color: #222;
251 }
252 /* XXX probably not this:
253 a.selfRef:hover {
254 background-color: transparent;
255 cursor: default;
256 } */
257
258 /* Figures */
259 tt, code, pre, code {
260 background-color: #f9f9f9;
261 font-family: 'Roboto Mono', monospace;
262 }
263 pre {
264 border: 1px solid #eee;
265 margin: 0;
266 padding: 1em;
267 }
268 img {
269 max-width: 100%;
270 }
271 figure {
272 margin: 0;
273 }
274 figure blockquote {
275 margin: 0.8em 0.4em 0.4em;
276 }
277 figcaption {
278 font-style: italic;
279 margin: 0 0 1em 0;
280 }
281 @media screen {
282 pre {
283 overflow-x: auto;
284 max-width: 100%;
285 max-width: calc(100% - 22px);
286 }
287 }
288
289 /* aside, blockquote */
290 aside, blockquote {
291 margin-left: 0;
292 padding: 1.2em 2em;
293 }
294 blockquote {
295 background-color: #f9f9f9;
296 color: #111; /* Arlen: WCAG 2019 */
297 border: 1px solid #ddd;
298 border-radius: 3px;
299 margin: 1em 0;
300 }
301 cite {
302 display: block;
303 text-align: right;
304 font-style: italic;
305 }
306
307 /* tables */
308 table {
309 width: 100%;
310 margin: 0 0 1em;
311 border-collapse: collapse;
312 border: 1px solid #eee;
313 }
314 th, td {
315 text-align: left;
316 vertical-align: top;
317 padding: 0.5em 0.75em;
318 }
319 th {
320 text-align: left;
321 background-color: #e9e9e9;
322 }
323 tr:nth-child(2n+1) > td {
324 background-color: #f5f5f5;
325 }
326 table caption {
327 font-style: italic;
328 margin: 0;
329 padding: 0;
330 text-align: left;
331 }
332 table p {
333 /* XXX to avoid bottom margin on table row signifiers. If paragraphs should
334 be allowed within tables more generally, it would be far better to select on a class. */
335 margin: 0;
336 }
337
338 /* pilcrow */
339 a.pilcrow {
340 color: #666; /* Arlen: AHDJ 2019 */
341 text-decoration: none;
342 visibility: hidden;
343 user-select: none;
344 -ms-user-select: none;
345 -o-user-select:none;
346 -moz-user-select: none;
347 -khtml-user-select: none;
348 -webkit-user-select: none;
349 -webkit-touch-callout: none;
350 }
351 @media screen {
352 aside:hover > a.pilcrow,
353 p:hover > a.pilcrow,
354 blockquote:hover > a.pilcrow,
355 div:hover > a.pilcrow,
356 li:hover > a.pilcrow,
357 pre:hover > a.pilcrow {
358 visibility: visible;
359 }
360 a.pilcrow:hover {
361 background-color: transparent;
362 }
363 }
364
365 /* misc */
366 hr {
367 border: 0;
368 border-top: 1px solid #eee;
369 }
370 .bcp14 {
371 font-variant: small-caps;
372 }
373
374 .role {
375 font-variant: all-small-caps;
376 }
377
378 /* info block */
379 #identifiers {
380 margin: 0;
381 font-size: 0.9em;
382 }
383 #identifiers dt {
384 width: 3em;
385 clear: left;
386 }
387 #identifiers dd {
388 float: left;
389 margin-bottom: 0;
390 }
391 /* Fix PDF info block run off issue */
392 @media print {
393 #identifiers dd {
394 float: none;
395 }
396 }
397 #identifiers .authors .author {
398 display: inline-block;
399 margin-right: 1.5em;
400 }
401 #identifiers .authors .org {
402 font-style: italic;
403 }
404
405 /* The prepared/rendered info at the very bottom of the page */
406 .docInfo {
407 color: #666; /* Arlen: WCAG 2019 */
408 font-size: 0.9em;
409 font-style: italic;
410 margin-top: 2em;
411 }
412 .docInfo .prepared {
413 float: left;
414 }
415 .docInfo .prepared {
416 float: right;
417 }
418
419 /* table of contents */
420 #toc {
421 padding: 0.75em 0 2em 0;
422 margin-bottom: 1em;
423 }
424 nav.toc ul {
425 margin: 0 0.5em 0 0;
426 padding: 0;
427 list-style: none;
428 }
429 nav.toc li {
430 line-height: 1.3em;
431 margin: 0.75em 0;
432 padding-left: 1.2em;
433 text-indent: -1.2em;
434 }
435 /* references */
436 .references dt {
437 text-align: right;
438 font-weight: bold;
439 min-width: 7em;
440 }
441 .references dd {
442 margin-left: 8em;
443 overflow: auto;
444 }
445
446 .refInstance {
447 margin-bottom: 1.25em;
448 }
449
450 .references .ascii {
451 margin-bottom: 0.25em;
452 }
453
454 /* index */
455 .index ul {
456 margin: 0 0 0 1em;
457 padding: 0;
458 list-style: none;
459 }
460 .index ul ul {
461 margin: 0;
462 }
463 .index li {
464 margin: 0;
465 text-indent: -2em;
466 padding-left: 2em;
467 padding-bottom: 5px;
468 }
469 .indexIndex {
470 margin: 0.5em 0 1em;
471 }
472 .index a {
473 font-weight: 700;
474 }
475 /* make the index two-column on all but the smallest screens */
476 @media (min-width: 600px) {
477 .index ul {
478 -moz-column-count: 2;
479 -moz-column-gap: 20px;
480 }
481 .index ul ul {
482 -moz-column-count: 1;
483 -moz-column-gap: 0;
484 }
485 }
486
487 /* authors */
488 address.vcard {
489 font-style: normal;
490 margin: 1em 0;
491 }
492
493 address.vcard .nameRole {
494 font-weight: 700;
495 margin-left: 0;
496 }
497 address.vcard .label {
498 font-family: "Noto Sans",Arial,Helvetica,sans-serif;
499 margin: 0.5em 0;
500 }
501 address.vcard .type {
502 display: none;
503 }
504 .alternative-contact {
505 margin: 1.5em 0 1em;
506 }
507 hr.addr {
508 border-top: 1px dashed;
509 margin: 0;
510 color: #ddd;
511 max-width: calc(100% - 16px);
512 }
513
514 /* temporary notes */
515 .rfcEditorRemove::before {
516 position: absolute;
517 top: 0.2em;
518 right: 0.2em;
519 padding: 0.2em;
520 content: "The RFC Editor will remove this note";
521 color: #9e2a00; /* Arlen: WCAG 2019 */
522 background-color: #ffd; /* Arlen: WCAG 2019 */
523 }
524 .rfcEditorRemove {
525 position: relative;
526 padding-top: 1.8em;
527 background-color: #ffd; /* Arlen: WCAG 2019 */
528 border-radius: 3px;
529 }
530 .cref {
531 background-color: #ffd; /* Arlen: WCAG 2019 */
532 padding: 2px 4px;
533 }
534 .crefSource {
535 font-style: italic;
536 }
537 /* alternative layout for smaller screens */
538 @media screen and (max-width: 1023px) {
539 body {
540 padding-top: 2em;
541 }
542 #title {
543 padding: 1em 0;
544 }
545 h1 {
546 font-size: 24px;
547 }
548 h2 {
549 font-size: 20px;
550 margin-top: -18px; /* provide offset for in-page anchors */
551 padding-top: 38px;
552 }
553 #identifiers dd {
554 max-width: 60%;
555 }
556 #toc {
557 position: fixed;
558 z-index: 2;
559 top: 0;
560 right: 0;
561 padding: 0;
562 margin: 0;
563 background-color: inherit;
564 border-bottom: 1px solid #ccc;
565 }
566 #toc h2 {
567 margin: -1px 0 0 0;
568 padding: 4px 0 4px 6px;
569 padding-right: 1em;
570 min-width: 190px;
571 font-size: 1.1em;
572 text-align: right;
573 background-color: #444;
574 color: white;
575 cursor: pointer;
576 }
577 #toc h2::before { /* css hamburger */
578 float: right;
579 position: relative;
580 width: 1em;
581 height: 1px;
582 left: -164px;
583 margin: 6px 0 0 0;
584 background: white none repeat scroll 0 0;
585 box-shadow: 0 4px 0 0 white, 0 8px 0 0 white;
586 content: "";
587 }
588 #toc nav {
589 display: none;
590 padding: 0.5em 1em 1em;
591 overflow: auto;
592 height: calc(100vh - 48px);
593 border-left: 1px solid #ddd;
594 }
595 }
596
597 /* alternative layout for wide screens */
598 @media screen and (min-width: 1024px) {
599 body {
600 max-width: 724px;
601 margin: 42px auto;
602 padding-left: 1.5em;
603 padding-right: 29em;
604 }
605 #toc {
606 position: fixed;
607 top: 42px;
608 right: 42px;
609 width: 25%;
610 margin: 0;
611 padding: 0 1em;
612 z-index: 1;
613 }
614 #toc h2 {
615 border-top: none;
616 border-bottom: 1px solid #ddd;
617 font-size: 1em;
618 font-weight: normal;
619 margin: 0;
620 padding: 0.25em 1em 1em 0;
621 }
622 #toc nav {
623 display: block;
624 height: calc(90vh - 84px);
625 bottom: 0;
626 padding: 0.5em 0 0;
627 overflow: auto;
628 }
629 img { /* future proofing */
630 max-width: 100%;
631 height: auto;
632 }
633 }
634
635 /* pagination */
636 @media print {
637 body {
638
639 width: 100%;
640 }
641 p {
642 orphans: 3;
643 widows: 3;
644 }
645 #n-copyright-notice {
646 border-bottom: none;
647 }
648 #toc, #n-introduction {
649 page-break-before: always;
650 }
651 #toc {
652 border-top: none;
653 padding-top: 0;
654 }
655 figure, pre {
656 page-break-inside: avoid;
657 }
658 figure {
659 overflow: scroll;
660 }
661 pre.breakable {
662 break-inside: auto;
663 }
664 h1, h2, h3, h4, h5, h6 {
665 page-break-after: avoid;
666 }
667 h2+*, h3+*, h4+*, h5+*, h6+* {
668 page-break-before: avoid;
669 }
670 pre {
671 white-space: pre-wrap;
672 word-wrap: break-word;
673 font-size: 10pt;
674 }
675 table {
676 border: 1px solid #ddd;
677 }
678 td {
679 border-top: 1px solid #ddd;
680 }
681 }
682
683 /* This is commented out here, as the string-set: doesn't
684 pass W3C validation currently */
685 /*
686 .ears thead .left {
687 string-set: ears-top-left content();
688 }
689
690 .ears thead .center {
691 string-set: ears-top-center content();
692 }
693
694 .ears thead .right {
695 string-set: ears-top-right content();
696 }
697
698 .ears tfoot .left {
699 string-set: ears-bottom-left content();
700 }
701
702 .ears tfoot .center {
703 string-set: ears-bottom-center content();
704 }
705
706 .ears tfoot .right {
707 string-set: ears-bottom-right content();
708 }
709 */
710
711 @page :first {
712 padding-top: 0;
713 @top-left {
714 content: normal;
715 border: none;
716 }
717 @top-center {
718 content: normal;
719 border: none;
720 }
721 @top-right {
722 content: normal;
723 border: none;
724 }
725 }
726
727 @page {
728 size: A4;
729 margin-bottom: 45mm;
730 padding-top: 20px;
731 /* The follwing is commented out here, but set appropriately by in code, as
732 the content depends on the document */
733 /*
734 @top-left {
735 content: 'Internet-Draft';
736 vertical-align: bottom;
737 border-bottom: solid 1px #ccc;
738 }
739 @top-left {
740 content: string(ears-top-left);
741 vertical-align: bottom;
742 border-bottom: solid 1px #ccc;
743 }
744 @top-center {
745 content: string(ears-top-center);
746 vertical-align: bottom;
747 border-bottom: solid 1px #ccc;
748 }
749 @top-right {
750 content: string(ears-top-right);
751 vertical-align: bottom;
752 border-bottom: solid 1px #ccc;
753 }
754 @bottom-left {
755 content: string(ears-bottom-left);
756 vertical-align: top;
757 border-top: solid 1px #ccc;
758 }
759 @bottom-center {
760 content: string(ears-bottom-center);
761 vertical-align: top;
762 border-top: solid 1px #ccc;
763 }
764 @bottom-right {
765 content: '[Page ' counter(page) ']';
766 vertical-align: top;
767 border-top: solid 1px #ccc;
768 }
769 */
770
771 }
772
773 /* Changes introduced to fix issues found during implementation */
774 /* Make sure links are clickable even if overlapped by following H* */
775 a {
776 z-index: 2;
777 }
778 /* Separate body from document info even without intervening H1 */
779 section {
780 clear: both;
781 }
782
783
784 /* Top align author divs, to avoid names without organization dropping level with org names */
785 .author {
786 vertical-align: top;
787 }
788
789 /* Leave room in document info to show Internet-Draft on one line */
790 #identifiers dt {
791 width: 8em;
792 }
793
794 /* Don't waste quite as much whitespace between label and value in doc info */
795 #identifiers dd {
796 margin-left: 1em;
797 }
798
799 /* Give floating toc a background color (needed when it's a div inside section */
800 #toc {
801 background-color: white;
802 }
803
804 /* Make the collapsed ToC header render white on gray also when it's a link */
805 @media screen and (max-width: 1023px) {
806 #toc h2 a,
807 #toc h2 a:link,
808 #toc h2 a:focus,
809 #toc h2 a:hover,
810 #toc a.toplink,
811 #toc a.toplink:hover {
812 color: white;
813 background-color: #444;
814 text-decoration: none;
815 }
816 }
817
818 /* Give the bottom of the ToC some whitespace */
819 @media screen and (min-width: 1024px) {
820 #toc {
821 padding: 0 0 1em 1em;
822 }
823 }
824
825 /* Style section numbers with more space between number and title */
826 .section-number {
827 padding-right: 0.5em;
828 }
829
830 /* prevent monospace from becoming overly large */
831 tt, code, pre, code {
832 font-size: 95%;
833 }
834
835 /* Fix the height/width aspect for ascii art*/
836 pre.sourcecode,
837 .art-text pre {
838 line-height: 1.12;
839 }
840
841
842 /* Add styling for a link in the ToC that points to the top of the document */
843 a.toplink {
844 float: right;
845 margin-right: 0.5em;
846 }
847
848 /* Fix the dl styling to match the RFC 7992 attributes */
849 dl > dt,
850 dl.dlParallel > dt {
851 float: left;
852 margin-right: 1em;
853 }
854 dl.dlNewline > dt {
855 float: none;
856 }
857
858 /* Provide styling for table cell text alignment */
859 table td.text-left,
860 table th.text-left {
861 text-align: left;
862 }
863 table td.text-center,
864 table th.text-center {
865 text-align: center;
866 }
867 table td.text-right,
868 table th.text-right {
869 text-align: right;
870 }
871
872 /* Make the alternative author contact informatio look less like just another
873 author, and group it closer with the primary author contact information */
874 .alternative-contact {
875 margin: 0.5em 0 0.25em 0;
876 }
877 address .non-ascii {
878 margin: 0 0 0 2em;
879 }
880
881 /* With it being possible to set tables with alignment
882 left, center, and right, { width: 100%; } does not make sense */
883 table {
884 width: auto;
885 }
886
887 /* Avoid reference text that sits in a block with very wide left margin,
888 because of a long floating dt label.*/
889 .references dd {
890 overflow: visible;
891 }
892
893 /* Control caption placement */
894 caption {
895 caption-side: bottom;
896 }
897
898 /* Limit the width of the author address vcard, so names in right-to-left
899 script don't end up on the other side of the page. */
900
901 address.vcard {
902 max-width: 30em;
903 margin-right: auto;
904 }
905
906 /* For address alignment dependent on LTR or RTL scripts */
907 address div.left {
908 text-align: left;
909 }
910 address div.right {
911 text-align: right;
912 }
913
914 /* Provide table alignment support. We can't use the alignX classes above
915 since they do unwanted things with caption and other styling. */
916 table.right {
917 margin-left: auto;
918 margin-right: 0;
919 }
920 table.center {
921 margin-left: auto;
922 margin-right: auto;
923 }
924 table.left {
925 margin-left: 0;
926 margin-right: auto;
927 }
928
929 /* Give the table caption label the same styling as the figcaption */
930 caption a[href] {
931 color: #222;
932 }
933
934 @media print {
935 .toplink {
936 display: none;
937 }
938
939 /* avoid overwriting the top border line with the ToC header */
940 #toc {
941 padding-top: 1px;
942 }
943
944 /* Avoid page breaks inside dl and author address entries */
945 .vcard {
946 page-break-inside: avoid;
947 }
948
949 }
950 /* Tweak the bcp14 keyword presentation */
951 .bcp14 {
952 font-variant: small-caps;
953 font-weight: bold;
954 font-size: 0.9em;
955 }
956 /* Tweak the invisible space above H* in order not to overlay links in text above */
957 h2 {
958 margin-top: -18px; /* provide offset for in-page anchors */
959 padding-top: 31px;
960 }
961 h3 {
962 margin-top: -18px; /* provide offset for in-page anchors */
963 padding-top: 24px;
964 }
965 h4 {
966 margin-top: -18px; /* provide offset for in-page anchors */
967 padding-top: 24px;
968 }
969 /* Float artwork pilcrow to the right */
970 @media screen {
971 .artwork a.pilcrow {
972 display: block;
973 line-height: 0.7;
974 margin-top: 0.15em;
975 }
976 }
977 /* Make pilcrows on dd visible */
978 @media screen {
979 dd:hover > a.pilcrow {
980 visibility: visible;
981 }
982 }
983 /* Make the placement of figcaption match that of a table's caption
984 by removing the figure's added bottom margin */
985 .alignLeft.art-text,
986 .alignCenter.art-text,
987 .alignRight.art-text {
988 margin-bottom: 0;
989 }
990 .alignLeft,
991 .alignCenter,
992 .alignRight {
993 margin: 1em 0 0 0;
994 }
995 /* In print, the pilcrow won't show on hover, so prevent it from taking up space,
996 possibly even requiring a new line */
997 @media print {
998 a.pilcrow {
999 display: none;
1000 }
1001 }
1002 /* Styling for the external metadata */
1003 div#external-metadata {
1004 background-color: #eee;
1005 padding: 0.5em;
1006 margin-bottom: 0.5em;
1007 display: none;
1008 }
1009 div#internal-metadata {
1010 padding: 0.5em; /* to match the external-metadata padding */
1011 }
1012 /* Styling for title RFC Number */
1013 h1#rfcnum {
1014 clear: both;
1015 margin: 0 0 -1em;
1016 padding: 1em 0 0 0;
1017 }
1018 /* Make .olPercent look the same as <ol><li> */
1019 dl.olPercent > dd {
1020 margin-bottom: 0.25em;
1021 min-height: initial;
1022 }
1023 /* Give aside some styling to set it apart */
1024 aside {
1025 border-left: 1px solid #ddd;
1026 margin: 1em 0 1em 2em;
1027 padding: 0.2em 2em;
1028 }
1029 aside > dl,
1030 aside > ol,
1031 aside > ul,
1032 aside > table,
1033 aside > p {
1034 margin-bottom: 0.5em;
1035 }
1036 /* Additional page break settings */
1037 @media print {
1038 figcaption, table caption {
1039 page-break-before: avoid;
1040 }
1041 }
1042 /* Font size adjustments for print */
1043 @media print {
1044 body { font-size: 10pt; line-height: normal; max-width: 96%; }
1045 h1 { font-size: 1.72em; padding-top: 1.5em; } /* 1*1.2*1.2*1.2 */
1046 h2 { font-size: 1.44em; padding-top: 1.5em; } /* 1*1.2*1.2 */
1047 h3 { font-size: 1.2em; padding-top: 1.5em; } /* 1*1.2 */
1048 h4 { font-size: 1em; padding-top: 1.5em; }
1049 h5, h6 { font-size: 1em; margin: initial; padding: 0.5em 0 0.3em; }
1050 }
1051 /* Sourcecode margin in print, when there's no pilcrow */
1052 @media print {
1053 .artwork,
1054 .sourcecode {
1055 margin-bottom: 1em;
1056 }
1057 }
1058 /* Avoid narrow tables forcing too narrow table captions, which may render badly */
1059 table {
1060 min-width: 20em;
1061 }
1062 /* ol type a */
1063 ol.type-a { list-style-type: lower-alpha; }
1064 ol.type-A { list-style-type: upper-alpha; }
1065 ol.type-i { list-style-type: lower-roman; }
1066 ol.type-I { list-style-type: lower-roman; }
1067 /* Apply the print table and row borders in general, on request from the RPC,
1068 and increase the contrast between border and odd row background sligthtly */
1069 table {
1070 border: 1px solid #ddd;
1071 }
1072 td {
1073 border-top: 1px solid #ddd;
1074 }
1075 tr:nth-child(2n+1) > td {
1076 background-color: #f8f8f8;
1077 }
1078 /* Use style rules to govern display of the TOC. */
1079 @media screen and (max-width: 1023px) {
1080 #toc nav { display: none; }
1081 #toc.active nav { display: block; }
1082 }
1083 /* Add support for keepWithNext */
1084 .keepWithNext {
1085 break-after: avoid-page;
1086 break-after: avoid-page;
1087 }
1088 /* Add support for keepWithPrevious */
1089 .keepWithPrevious {
1090 break-before: avoid-page;
1091 }
1092 /* Change the approach to avoiding breaks inside artwork etc. */
1093 figure, pre, table, .artwork, .sourcecode {
1094 break-before: auto;
1095 break-after: auto;
1096 }
1097 /* Avoid breaks between <dt> and <dd> */
1098 dl {
1099 break-before: auto;
1100 break-inside: auto;
1101 }
1102 dt {
1103 break-before: auto;
1104 break-after: avoid-page;
1105 }
1106 dd {
1107 break-before: avoid-page;
1108 break-after: auto;
1109 orphans: 3;
1110 widows: 3
1111 }
1112 span.break, dd.break {
1113 margin-bottom: 0;
1114 min-height: 0;
1115 break-before: auto;
1116 break-inside: auto;
1117 break-after: auto;
1118 }
1119 /* Undo break-before ToC */
1120 @media print {
1121 #toc {
1122 break-before: auto;
1123 }
1124 }
1125 /* Text in compact lists should not get extra bottim margin space,
1126 since that would makes the list not compact */
1127 ul.compact p, .ulCompact p,
1128 ol.compact p, .olCompact p {
1129 margin: 0;
1130 }
1131 /* But the list as a whole needs the extra space at the end */
1132 section ul.compact,
1133 section .ulCompact,
1134 section ol.compact,
1135 section .olCompact {
1136 margin-bottom: 1em; /* same as p not within ul.compact etc. */
1137 }
1138 /* The tt and code background above interferes with for instance table cell
1139 backgrounds. Changed to something a bit more selective. */
1140 tt, code {
1141 background-color: transparent;
1142 }
1143 p tt, p code, li tt, li code {
1144 background-color: #f8f8f8;
1145 }
1146 /* Tweak the pre margin -- 0px doesn't come out well */
1147 pre {
1148 margin-top: 0.5px;
1149 }
1150 /* Tweak the comact list text */
1151 ul.compact, .ulCompact,
1152 ol.compact, .olCompact,
1153 dl.compact, .dlCompact {
1154 line-height: normal;
1155 }
1156 /* Don't add top margin for nested lists */
1157 li > ul, li > ol, li > dl,
1158 dd > ul, dd > ol, dd > dl,
1159 dl > dd > dl {
1160 margin-top: initial;
1161 }
1162 /* Elements that should not be rendered on the same line as a <dt> */
1163 /* This should match the element list in writer.text.TextWriter.render_dl() */
1164 dd > div.artwork:first-child,
1165 dd > aside:first-child,
1166 dd > figure:first-child,
1167 dd > ol:first-child,
1168 dd > div:first-child > pre.sourcecode,
1169 dd > table:first-child,
1170 dd > ul:first-child {
1171 clear: left;
1172 }
1173 /* fix for weird browser behaviour when <dd/> is empty */
1174 dt+dd:empty::before{
1175 content: "\00a0";
1176 }
1177 /* Make paragraph spacing inside <li> smaller than in body text, to fit better within the list */
1178 li > p {
1179 margin-bottom: 0.5em
1180 }
1181 /* Don't let p margin spill out from inside list items */
1182 li > p:last-of-type {
1183 margin-bottom: 0;
1184 }
1185 </style>
1186 <link href="rfc-local.css" rel="stylesheet" type="text/css">
1187 <link href="https://dx.doi.org/10.17487/rfc9266" rel="alternate">
1188 <link href="urn:issn:2070-1721" rel="alternate">
1189 <link href="https://datatracker.ietf.org/doc/draft-ietf-kitten-tls-channel-bindings-for-tls13" rel="prev">
1190 </head>
1191 <body>
1192 <script src="https://www.rfc-editor.org/js/metadata.min.js"></script>
1193 <table class="ears">
1194 <thead><tr>
1195 <td class="left">RFC 9266</td>
1196 <td class="center">Channel Bindings for TLS 1.3</td>
1197 <td class="right">July 2022</td>
1198 </tr></thead>
1199 <tfoot><tr>
1200 <td class="left">Whited</td>
1201 <td class="center">Standards Track</td>
1202 <td class="right">[Page]</td>
1203 </tr></tfoot>
1204 </table>
1205 <div id="external-metadata" class="document-information"></div>
1206 <div id="internal-metadata" class="document-information">
1207 <dl id="identifiers">
1208 <dt class="label-stream">Stream:</dt>
1209 <dd class="stream">Internet Engineering Task Force (IETF)</dd>
1210 <dt class="label-rfc">RFC:</dt>
1211 <dd class="rfc"><a href="https://www.rfc-editor.org/rfc/rfc9266" class="eref">9266</a></dd>
1212 <dt class="label-updates">Updates:</dt>
1213 <dd class="updates">
1214 <a href="https://www.rfc-editor.org/rfc/rfc5801" class="eref">5801</a>, <a href="https://www.rfc-editor.org/rfc/rfc5802" class="eref">5802</a>, <a href="https://www.rfc-editor.org/rfc/rfc5929" class="eref">5929</a>, <a href="https://www.rfc-editor.org/rfc/rfc7677" class="eref">7677</a> </dd>
1215 <dt class="label-category">Category:</dt>
1216 <dd class="category">Standards Track</dd>
1217 <dt class="label-published">Published:</dt>
1218 <dd class="published">
1219 <time datetime="2022-07" class="published">July 2022</time>
1220 </dd>
1221 <dt class="label-issn">ISSN:</dt>
1222 <dd class="issn">2070-1721</dd>
1223 <dt class="label-authors">Author:</dt>
1224 <dd class="authors">
1225 <div class="author">
1226 <div class="author-name">S. Whited</div>
1227 </div>
1228 </dd>
1229 </dl>
1230 </div>
1231 <h1 id="rfcnum">RFC 9266</h1>
1232 <h1 id="title">Channel Bindings for TLS 1.3</h1>
1233 <section id="section-abstract">
1234 <h2 id="abstract"><a href="#abstract" class="selfRef">Abstract</a></h2>
1235 <p id="section-abstract-1">
1236 This document defines a channel binding type, tls-exporter, that is
1237 compatible with TLS 1.3 in accordance with RFC 5056, "On the Use of
1238 Channel Bindings to Secure Channels". Furthermore, it updates the
1239 default channel binding to the new binding for versions of TLS greater
1240 than 1.2. This document updates RFCs 5801, 5802, 5929, and 7677.<a href="#section-abstract-1" class="pilcrow">¶</a></p>
1241 </section>
1242 <div id="status-of-memo">
1243 <section id="section-boilerplate.1">
1244 <h2 id="name-status-of-this-memo">
1245 <a href="#name-status-of-this-memo" class="section-name selfRef">Status of This Memo</a>
1246 </h2>
1247 <p id="section-boilerplate.1-1">
1248 This is an Internet Standards Track document.<a href="#section-boilerplate.1-1" class="pilcrow">¶</a></p>
1249 <p id="section-boilerplate.1-2">
1250 This document is a product of the Internet Engineering Task Force
1251 (IETF). It represents the consensus of the IETF community. It has
1252 received public review and has been approved for publication by
1253 the Internet Engineering Steering Group (IESG). Further
1254 information on Internet Standards is available in Section 2 of
1255 RFC 7841.<a href="#section-boilerplate.1-2" class="pilcrow">¶</a></p>
1256 <p id="section-boilerplate.1-3">
1257 Information about the current status of this document, any
1258 errata, and how to provide feedback on it may be obtained at
1259 <span><a href="https://www.rfc-editor.org/info/rfc9266">https://www.rfc-editor.org/info/rfc9266</a></span>.<a href="#section-boilerplate.1-3" class="pilcrow">¶</a></p>
1260 </section>
1261 </div>
1262 <div id="copyright">
1263 <section id="section-boilerplate.2">
1264 <h2 id="name-copyright-notice">
1265 <a href="#name-copyright-notice" class="section-name selfRef">Copyright Notice</a>
1266 </h2>
1267 <p id="section-boilerplate.2-1">
1268 Copyright (c) 2022 IETF Trust and the persons identified as the
1269 document authors. All rights reserved.<a href="#section-boilerplate.2-1" class="pilcrow">¶</a></p>
1270 <p id="section-boilerplate.2-2">
1271 This document is subject to BCP 78 and the IETF Trust's Legal
1272 Provisions Relating to IETF Documents
1273 (<span><a href="https://trustee.ietf.org/license-info">https://trustee.ietf.org/license-info</a></span>) in effect on the date of
1274 publication of this document. Please review these documents
1275 carefully, as they describe your rights and restrictions with
1276 respect to this document. Code Components extracted from this
1277 document must include Revised BSD License text as described in
1278 Section 4.e of the Trust Legal Provisions and are provided without
1279 warranty as described in the Revised BSD License.<a href="#section-boilerplate.2-2" class="pilcrow">¶</a></p>
1280 </section>
1281 </div>
1282 <div id="toc">
1283 <section id="section-toc.1">
1284 <a href="#" onclick="scroll(0,0)" class="toplink">▲</a><h2 id="name-table-of-contents">
1285 <a href="#name-table-of-contents" class="section-name selfRef">Table of Contents</a>
1286 </h2>
1287 <nav class="toc"><ul class="compact toc ulBare ulEmpty">
1288 <li class="compact toc ulBare ulEmpty" id="section-toc.1-1.1">
1289 <p id="section-toc.1-1.1.1" class="keepWithNext"><a href="#section-1" class="xref">1</a>.  <a href="#name-introduction" class="xref">Introduction</a></p>
1290 <ul class="compact toc ulBare ulEmpty">
1291 <li class="compact toc ulBare ulEmpty" id="section-toc.1-1.1.2.1">
1292 <p id="section-toc.1-1.1.2.1.1" class="keepWithNext"><a href="#section-1.1" class="xref">1.1</a>.  <a href="#name-conventions-and-terminology" class="xref">Conventions and Terminology</a></p>
1293 </li>
1294 </ul>
1295 </li>
1296 <li class="compact toc ulBare ulEmpty" id="section-toc.1-1.2">
1297 <p id="section-toc.1-1.2.1" class="keepWithNext"><a href="#section-2" class="xref">2</a>.  <a href="#name-the-tls-exporter-channel-bi" class="xref">The 'tls-exporter' Channel Binding Type</a></p>
1298 </li>
1299 <li class="compact toc ulBare ulEmpty" id="section-toc.1-1.3">
1300 <p id="section-toc.1-1.3.1"><a href="#section-3" class="xref">3</a>.  <a href="#name-tls-13-with-scram-or-gss-ap" class="xref">TLS 1.3 with SCRAM or GSS-API over SASL</a></p>
1301 </li>
1302 <li class="compact toc ulBare ulEmpty" id="section-toc.1-1.4">
1303 <p id="section-toc.1-1.4.1"><a href="#section-4" class="xref">4</a>.  <a href="#name-security-considerations" class="xref">Security Considerations</a></p>
1304 <ul class="compact toc ulBare ulEmpty">
1305 <li class="compact toc ulBare ulEmpty" id="section-toc.1-1.4.2.1">
1306 <p id="section-toc.1-1.4.2.1.1"><a href="#section-4.1" class="xref">4.1</a>.  <a href="#name-uniqueness-of-channel-bindi" class="xref">Uniqueness of Channel Bindings</a></p>
1307 </li>
1308 <li class="compact toc ulBare ulEmpty" id="section-toc.1-1.4.2.2">
1309 <p id="section-toc.1-1.4.2.2.1"><a href="#section-4.2" class="xref">4.2</a>.  <a href="#name-use-with-legacy-tls" class="xref">Use with Legacy TLS</a></p>
1310 </li>
1311 </ul>
1312 </li>
1313 <li class="compact toc ulBare ulEmpty" id="section-toc.1-1.5">
1314 <p id="section-toc.1-1.5.1"><a href="#section-5" class="xref">5</a>.  <a href="#name-iana-considerations" class="xref">IANA Considerations</a></p>
1315 <ul class="compact toc ulBare ulEmpty">
1316 <li class="compact toc ulBare ulEmpty" id="section-toc.1-1.5.2.1">
1317 <p id="section-toc.1-1.5.2.1.1"><a href="#section-5.1" class="xref">5.1</a>.  <a href="#name-registration-of-channel-bin" class="xref">Registration of Channel Binding Type</a></p>
1318 </li>
1319 <li class="compact toc ulBare ulEmpty" id="section-toc.1-1.5.2.2">
1320 <p id="section-toc.1-1.5.2.2.1"><a href="#section-5.2" class="xref">5.2</a>.  <a href="#name-registration-of-channel-bind" class="xref">Registration of Channel Binding TLS Exporter Label</a></p>
1321 </li>
1322 </ul>
1323 </li>
1324 <li class="compact toc ulBare ulEmpty" id="section-toc.1-1.6">
1325 <p id="section-toc.1-1.6.1"><a href="#section-6" class="xref">6</a>.  <a href="#name-references" class="xref">References</a></p>
1326 <ul class="compact toc ulBare ulEmpty">
1327 <li class="compact toc ulBare ulEmpty" id="section-toc.1-1.6.2.1">
1328 <p id="section-toc.1-1.6.2.1.1"><a href="#section-6.1" class="xref">6.1</a>.  <a href="#name-normative-references" class="xref">Normative References</a></p>
1329 </li>
1330 <li class="compact toc ulBare ulEmpty" id="section-toc.1-1.6.2.2">
1331 <p id="section-toc.1-1.6.2.2.1"><a href="#section-6.2" class="xref">6.2</a>.  <a href="#name-informative-references" class="xref">Informative References</a></p>
1332 </li>
1333 </ul>
1334 </li>
1335 <li class="compact toc ulBare ulEmpty" id="section-toc.1-1.7">
1336 <p id="section-toc.1-1.7.1"><a href="#appendix-A" class="xref"></a><a href="#name-authors-address" class="xref">Author's Address</a></p>
1337 </li>
1338 </ul>
1339 </nav>
1340 </section>
1341 </div>
1342 <div id="introduction">
1343 <section id="section-1">
1344 <h2 id="name-introduction">
1345 <a href="#section-1" class="section-number selfRef">1. </a><a href="#name-introduction" class="section-name selfRef">Introduction</a>
1346 </h2>
1347 <p id="section-1-1">
1348 The "tls-unique" channel binding type defined in
1349 <span>[<a href="#RFC5929" class="xref">RFC5929</a>]</span> was found to be susceptible to the "triple
1350 handshake vulnerability" <span>[<a href="#TRIPLE-HANDSHAKE" class="xref">TRIPLE-HANDSHAKE</a>]</span> without the
1351 extended master secret extension defined in <span>[<a href="#RFC7627" class="xref">RFC7627</a>]</span>.
1352 While TLS 1.3 uses a complete transcript hash akin to the extended
1353 master secret procedures, the safety of channel bindings with TLS 1.3
1354 was not analyzed as part of the core protocol work, so the
1355 specification of channel bindings for TLS 1.3 was deferred.
1356 <span><a href="https://www.rfc-editor.org/rfc/rfc8446#appendix-C.5" class="relref">Appendix C.5</a> of [<a href="#RFC8446" class="xref">RFC8446</a>]</span> notes the lack of channel bindings
1357 for TLS 1.3; this document defines such channel bindings and fills that
1358 gap.
1359 Furthermore, this document updates <span>[<a href="#RFC5929" class="xref">RFC5929</a>]</span> by adding an
1360 additional unique channel binding type, "tls-exporter", that replaces
1361 some usage of "tls-unique".<a href="#section-1-1" class="pilcrow">¶</a></p>
1362 <div id="conventions-and-terminology">
1363 <section id="section-1.1">
1364 <h3 id="name-conventions-and-terminology">
1365 <a href="#section-1.1" class="section-number selfRef">1.1. </a><a href="#name-conventions-and-terminology" class="section-name selfRef">Conventions and Terminology</a>
1366 </h3>
1367 <p id="section-1.1-1">
1368 Throughout this document, the acronym "EKM" is used to refer to
1369 "Exported Keying Material" as defined in <span>[<a href="#RFC5705" class="xref">RFC5705</a>]</span>.<a href="#section-1.1-1" class="pilcrow">¶</a></p>
1370 <p id="section-1.1-2">
1371 The key words "<span class="bcp14">MUST</span>", "<span class="bcp14">MUST NOT</span>", "<span class="bcp14">REQUIRED</span>", "<span class="bcp14">SHALL</span>", "<span class="bcp14">SHALL NOT</span>", "<span class="bcp14">SHOULD</span>", "<span class="bcp14">SHOULD NOT</span>", "<span class="bcp14">RECOMMENDED</span>", "<span class="bcp14">NOT RECOMMENDED</span>",
1372 "<span class="bcp14">MAY</span>", and "<span class="bcp14">OPTIONAL</span>" in this document are to be interpreted as
1373 described in BCP 14 <span>[<a href="#RFC2119" class="xref">RFC2119</a>]</span> <span>[<a href="#RFC8174" class="xref">RFC8174</a>]</span>
1374 when, and only when, they appear in all capitals, as shown here.<a href="#section-1.1-2" class="pilcrow">¶</a></p>
1375 </section>
1376 </div>
1377 </section>
1378 </div>
1379 <div id="tls-exporter">
1380 <section id="section-2">
1381 <h2 id="name-the-tls-exporter-channel-bi">
1382 <a href="#section-2" class="section-number selfRef">2. </a><a href="#name-the-tls-exporter-channel-bi" class="section-name selfRef">The 'tls-exporter' Channel Binding Type</a>
1383 </h2>
1384 <p id="section-2-1">
1385 Channel binding mechanisms are not useful until TLS implementations
1386 expose the required data. To facilitate this, "tls-exporter" uses
1387 Exported Keying Material (EKM), which is already widely exposed by TLS
1388 implementations. The EKM is obtained using the keying material
1389 exporters for TLS, as defined in <span>[<a href="#RFC5705" class="xref">RFC5705</a>]</span> and <span><a href="https://www.rfc-editor.org/rfc/rfc8446#section-7.5" class="relref">Section 7.5</a> of [<a href="#RFC8446" class="xref">RFC8446</a>]</span>, by supplying the
1390 following inputs:<a href="#section-2-1" class="pilcrow">¶</a></p>
1391 <span class="break"></span><dl class="dlParallel" id="section-2-2">
1392 <dt id="section-2-2.1">Label:</dt>
1393 <dd style="margin-left: 1.5em" id="section-2-2.2">
1394 The ASCII string "EXPORTER-Channel-Binding" with no terminating NUL.<a href="#section-2-2.2" class="pilcrow">¶</a>
1395 </dd>
1396 <dd class="break"></dd>
1397 <dt id="section-2-2.3">Context value:</dt>
1398 <dd style="margin-left: 1.5em" id="section-2-2.4">
1399 Zero-length string.<a href="#section-2-2.4" class="pilcrow">¶</a>
1400 </dd>
1401 <dd class="break"></dd>
1402 <dt id="section-2-2.5">Length:</dt>
1403 <dd style="margin-left: 1.5em" id="section-2-2.6">
1404 32 bytes.<a href="#section-2-2.6" class="pilcrow">¶</a>
1405 </dd>
1406 <dd class="break"></dd>
1407 </dl>
1408 <p id="section-2-3">
1409 This channel binding mechanism is defined only when the TLS handshake
1410 results in unique master secrets. This is true of TLS versions prior to
1411 1.3 when the extended master secret extension of
1412 <span>[<a href="#RFC7627" class="xref">RFC7627</a>]</span> is in use, and it is always true for TLS 1.3
1413 (see <span><a href="https://www.rfc-editor.org/rfc/rfc8446#appendix-D" class="relref">Appendix D</a> of [<a href="#RFC8446" class="xref">RFC8446</a>]</span>).<a href="#section-2-3" class="pilcrow">¶</a></p>
1414 </section>
1415 </div>
1416 <div id="scram">
1417 <section id="section-3">
1418 <h2 id="name-tls-13-with-scram-or-gss-ap">
1419 <a href="#section-3" class="section-number selfRef">3. </a><a href="#name-tls-13-with-scram-or-gss-ap" class="section-name selfRef">TLS 1.3 with SCRAM or GSS-API over SASL</a>
1420 </h2>
1421 <p id="section-3-1">
1422 The specifications for Salted Challenge Response Authentication Mechanism (SCRAM) <span>[<a href="#RFC5802" class="xref">RFC5802</a>]</span> <span>[<a href="#RFC7677" class="xref">RFC7677</a>]</span> and Generic Security
1423 Service Application Program Interface (GSS-API) over Simple
1424 Authentication and Security Layer (SASL) <span>[<a href="#RFC5801" class="xref">RFC5801</a>]</span>
1425 define "tls-unique" as the default channel binding to use over TLS.
1426 As "tls-unique" is not defined for TLS 1.3 (and greater), this
1427 document updates <span>[<a href="#RFC5801" class="xref">RFC5801</a>]</span>, <span>[<a href="#RFC5802" class="xref">RFC5802</a>]</span>,
1428 and <span>[<a href="#RFC7677" class="xref">RFC7677</a>]</span> to use "tls-exporter" as the default
1429 channel binding over TLS 1.3 (and greater).
1430 Note that this document does not change the default channel
1431 binding for SCRAM mechanisms over TLS 1.2 <span>[<a href="#RFC5246" class="xref">RFC5246</a>]</span>,
1432 which is still "tls-unique" (also note that RFC 5246 has been obsoleted
1433 by RFC 8446).<a href="#section-3-1" class="pilcrow">¶</a></p>
1434 <p id="section-3-2">
1435 Additionally, this document updates the aforementioned documents to make
1436 "tls-exporter" the mandatory-to-implement channel binding if any channel
1437 bindings are implemented for TLS 1.3.
1438 Implementations that support channel binding over TLS 1.3
1439 <span class="bcp14">MUST</span> implement "tls-exporter".<a href="#section-3-2" class="pilcrow">¶</a></p>
1440 </section>
1441 </div>
1442 <div id="security-considerations">
1443 <section id="section-4">
1444 <h2 id="name-security-considerations">
1445 <a href="#section-4" class="section-number selfRef">4. </a><a href="#name-security-considerations" class="section-name selfRef">Security Considerations</a>
1446 </h2>
1447 <p id="section-4-1">
1448 The channel binding type defined in this document is constructed so that
1449 disclosure of the channel binding data does not leak secret information
1450 about the TLS channel and does not affect the security of the TLS
1451 channel.<a href="#section-4-1" class="pilcrow">¶</a></p>
1452 <p id="section-4-2">
1453 The derived data <span class="bcp14">MUST NOT</span> be used for any purpose other
1454 than channel bindings as described in <span>[<a href="#RFC5056" class="xref">RFC5056</a>]</span>.
1455 In particular, implementations <span class="bcp14">MUST NOT</span> use channel binding as a
1456 secret key to protect privileged information.<a href="#section-4-2" class="pilcrow">¶</a></p>
1457 <p id="section-4-3">
1458 The Security Considerations sections of <span>[<a href="#RFC5056" class="xref">RFC5056</a>]</span>, <span>[<a href="#RFC5705" class="xref">RFC5705</a>]</span>, and <span>[<a href="#RFC8446" class="xref">RFC8446</a>]</span> apply to this document.<a href="#section-4-3" class="pilcrow">¶</a></p>
1459 <div id="unique-bindings">
1460 <section id="section-4.1">
1461 <h3 id="name-uniqueness-of-channel-bindi">
1462 <a href="#section-4.1" class="section-number selfRef">4.1. </a><a href="#name-uniqueness-of-channel-bindi" class="section-name selfRef">Uniqueness of Channel Bindings</a>
1463 </h3>
1464 <p id="section-4.1-1">
1465 The definition of channel bindings in <span>[<a href="#RFC5056" class="xref">RFC5056</a>]</span>
1466 defines the concept of a "unique" channel binding as being one that
1467 is unique to the channel endpoints and unique over time, that is,
1468 a value that is unique to a specific instance of the lower-layer
1469 security protocol.
1470 When TLS is the lower-layer security protocol, as for the channel binding
1471 type defined in this document, this concept of uniqueness
1472 corresponds to uniquely identifying the specific TLS connection.<a href="#section-4.1-1" class="pilcrow">¶</a></p>
1473 <p id="section-4.1-2">
1474 However, a stronger form of uniqueness is possible, which would entail
1475 uniquely identifying not just the lower-layer protocol but also the
1476 upper-layer application or authentication protocol that is consuming
1477 the channel binding.
1478 The distinction is relevant only when there are multiple instances of
1479 an authentication protocol, or multiple distinct authentication
1480 protocols, that run atop the same lower-layer protocol.
1481 Such a situation is rare; most consumers of channel bindings
1482 establish an instance of the lower-layer secure protocol, run a single
1483 application or authentication protocol as the upper-layer protocol,
1484 then terminate both upper and lower-layer protocols.
1485 In this situation, the stronger form of uniqueness is trivially
1486 achieved, given that the channel binding value is unique in the sense
1487 of <span>[<a href="#RFC5056" class="xref">RFC5056</a>]</span>.<a href="#section-4.1-2" class="pilcrow">¶</a></p>
1488 <p id="section-4.1-3">
1489 The channel binding type defined by this document provides only the
1490 weaker type of uniqueness, as per <span>[<a href="#RFC5056" class="xref">RFC5056</a>]</span>; it does
1491 not achieve the stronger uniqueness per the upper-layer protocol
1492 instance described above. This stronger form of uniqueness would be
1493 useful in that it provides protection against cross-protocol attacks
1494 for the multiple authentication protocols running over the same
1495 instance of the lower-layer protocol, and it provides protection
1496 against replay attacks that seek to replay a message from one
1497 instance of an authentication protocol in a different instance of
1498 the same authentication protocol, again running over the same
1499 instance of the lower-layer protocol. Both of these properties are
1500 highly desirable when performing formal analysis of upper-layer
1501 protocols; if these properties are not provided, such formal
1502 analysis is essentially impossible. In some cases, one or both of
1503 these properties may already be provided by specific upper-layer
1504 protocols, but that is dependent on the mechanism(s) in question,
1505 and formal analysis requires that the property is provided in a
1506 generic manner across all potential upper-layer protocols that
1507 exist or might exist in the future.<a href="#section-4.1-3" class="pilcrow">¶</a></p>
1508 <p id="section-4.1-4">
1509 Accordingly, applications that make use of the channel binding type
1510 defined in this document <span class="bcp14">MUST NOT</span> use the channel
1511 binding for more than one authentication mechanism instance on a given
1512 TLS connection.
1513 Such applications <span class="bcp14">MUST</span> immediately close the TLS
1514 connection after the conclusion of the upper-layer protocol.<a href="#section-4.1-4" class="pilcrow">¶</a></p>
1515 </section>
1516 </div>
1517 <div id="legacy-tls">
1518 <section id="section-4.2">
1519 <h3 id="name-use-with-legacy-tls">
1520 <a href="#section-4.2" class="section-number selfRef">4.2. </a><a href="#name-use-with-legacy-tls" class="section-name selfRef">Use with Legacy TLS</a>
1521 </h3>
1522 <p id="section-4.2-1">
1523 While it is possible to use this channel binding mechanism with TLS
1524 versions below 1.3, extra precaution must be taken to ensure that
1525 the chosen cipher suites always result in unique master secrets.
1526 For more information, see <span>[<a href="#RFC7627" class="xref">RFC7627</a>]</span> and the Security
1527 Considerations section of <span>[<a href="#RFC5705" class="xref">RFC5705</a>]</span> (TLS 1.3 always
1528 provides unique master secrets, as discussed in <span><a href="https://www.rfc-editor.org/rfc/rfc8446#appendix-D" class="relref">Appendix D</a> of [<a href="#RFC8446" class="xref">RFC8446</a>]</span>).<a href="#section-4.2-1" class="pilcrow">¶</a></p>
1529 <p id="section-4.2-2">
1530 When TLS renegotiation is enabled on a connection, the "tls-exporter"
1531 channel binding type is not defined for that connection, and
1532 implementations <span class="bcp14">MUST NOT</span> support it.<a href="#section-4.2-2" class="pilcrow">¶</a></p>
1533 <p id="section-4.2-3">
1534 In general, users wishing to take advantage of channel binding should
1535 upgrade to TLS 1.3 or later.<a href="#section-4.2-3" class="pilcrow">¶</a></p>
1536 </section>
1537 </div>
1538 </section>
1539 </div>
1540 <div id="iana-considerations">
1541 <section id="section-5">
1542 <h2 id="name-iana-considerations">
1543 <a href="#section-5" class="section-number selfRef">5. </a><a href="#name-iana-considerations" class="section-name selfRef">IANA Considerations</a>
1544 </h2>
1545 <div id="cb-type-registration">
1546 <section id="section-5.1">
1547 <h3 id="name-registration-of-channel-bin">
1548 <a href="#section-5.1" class="section-number selfRef">5.1. </a><a href="#name-registration-of-channel-bin" class="section-name selfRef">Registration of Channel Binding Type</a>
1549 </h3>
1550 <p id="section-5.1-1">
1551 IANA has registered tls-exporter in the "Channel-Binding
1552 Types" registry:<a href="#section-5.1-1" class="pilcrow">¶</a></p>
1553 <span class="break"></span><dl class="dlParallel" id="section-5.1-2">
1554 <dt id="section-5.1-2.1">Channel-binding unique prefix:</dt>
1555 <dd style="margin-left: 1.5em" id="section-5.1-2.2">tls-exporter<a href="#section-5.1-2.2" class="pilcrow">¶</a>
1556 </dd>
1557 <dd class="break"></dd>
1558 <dt id="section-5.1-2.3">Channel-binding type:</dt>
1559 <dd style="margin-left: 1.5em" id="section-5.1-2.4">unique<a href="#section-5.1-2.4" class="pilcrow">¶</a>
1560 </dd>
1561 <dd class="break"></dd>
1562 <dt id="section-5.1-2.5">Channel type:</dt>
1563 <dd style="margin-left: 1.5em" id="section-5.1-2.6">TLS <span>[<a href="#RFC8446" class="xref">RFC8446</a>]</span><a href="#section-5.1-2.6" class="pilcrow">¶</a>
1564 </dd>
1565 <dd class="break"></dd>
1566 <dt id="section-5.1-2.7">Published specification:</dt>
1567 <dd style="margin-left: 1.5em" id="section-5.1-2.8">RFC 9266<a href="#section-5.1-2.8" class="pilcrow">¶</a>
1568 </dd>
1569 <dd class="break"></dd>
1570 <dt id="section-5.1-2.9">Channel-binding is secret:</dt>
1571 <dd style="margin-left: 1.5em" id="section-5.1-2.10">no<a href="#section-5.1-2.10" class="pilcrow">¶</a>
1572 </dd>
1573 <dd class="break"></dd>
1574 <dt id="section-5.1-2.11">Description:</dt>
1575 <dd style="margin-left: 1.5em" id="section-5.1-2.12">The EKM value obtained from the current TLS connection.<a href="#section-5.1-2.12" class="pilcrow">¶</a>
1576 </dd>
1577 <dd class="break"></dd>
1578 <dt id="section-5.1-2.13">Intended usage:</dt>
1579 <dd style="margin-left: 1.5em" id="section-5.1-2.14">COMMON<a href="#section-5.1-2.14" class="pilcrow">¶</a>
1580 </dd>
1581 <dd class="break"></dd>
1582 <dt id="section-5.1-2.15">
1583 Person and email address to contact for further information:
1584 </dt>
1585 <dd style="margin-left: 1.5em" id="section-5.1-2.16">Sam Whited &lt;[email protected]&gt;<a href="#section-5.1-2.16" class="pilcrow">¶</a>
1586 </dd>
1587 <dd class="break"></dd>
1588 <dt id="section-5.1-2.17">Owner/Change controller name and email address:</dt>
1589 <dd style="margin-left: 1.5em" id="section-5.1-2.18">IESG<a href="#section-5.1-2.18" class="pilcrow">¶</a>
1590 </dd>
1591 <dd class="break"></dd>
1592 <dt id="section-5.1-2.19">Expert reviewer name and contact information:</dt>
1593 <dd style="margin-left: 1.5em" id="section-5.1-2.20">
1594 IETF KITTEN WG &lt;[email protected]&gt; or IETF TLS WG &lt;[email protected]&gt;<a href="#section-5.1-2.20" class="pilcrow">¶</a>
1595 </dd>
1596 <dd class="break"></dd>
1597 <dt id="section-5.1-2.21">Note:</dt>
1598 <dd style="margin-left: 1.5em" id="section-5.1-2.22">
1599 See the published specification for advice on the applicability of
1600 this channel binding type.<a href="#section-5.1-2.22" class="pilcrow">¶</a>
1601 </dd>
1602 <dd class="break"></dd>
1603 </dl>
1604 </section>
1605 </div>
1606 <div id="exporter-registration">
1607 <section id="section-5.2">
1608 <h3 id="name-registration-of-channel-bind">
1609 <a href="#section-5.2" class="section-number selfRef">5.2. </a><a href="#name-registration-of-channel-bind" class="section-name selfRef">Registration of Channel Binding TLS Exporter Label</a>
1610 </h3>
1611 <p id="section-5.2-1">
1612 IANA has added the following registration in the "TLS Exporter
1613 Labels" registry under the "Transport Layer Security (TLS)
1614 Parameters" registry:<a href="#section-5.2-1" class="pilcrow">¶</a></p>
1615 <span class="break"></span><dl class="dlParallel" id="section-5.2-2">
1616 <dt id="section-5.2-2.1">Value:</dt>
1617 <dd style="margin-left: 1.5em" id="section-5.2-2.2">EXPORTER-Channel-Binding<a href="#section-5.2-2.2" class="pilcrow">¶</a>
1618 </dd>
1619 <dd class="break"></dd>
1620 <dt id="section-5.2-2.3">DTLS-OK:</dt>
1621 <dd style="margin-left: 1.5em" id="section-5.2-2.4">Y<a href="#section-5.2-2.4" class="pilcrow">¶</a>
1622 </dd>
1623 <dd class="break"></dd>
1624 <dt id="section-5.2-2.5">Recommended:</dt>
1625 <dd style="margin-left: 1.5em" id="section-5.2-2.6">Y<a href="#section-5.2-2.6" class="pilcrow">¶</a>
1626 </dd>
1627 <dd class="break"></dd>
1628 <dt id="section-5.2-2.7">Reference:</dt>
1629 <dd style="margin-left: 1.5em" id="section-5.2-2.8">RFC 9266<a href="#section-5.2-2.8" class="pilcrow">¶</a>
1630 </dd>
1631 <dd class="break"></dd>
1632 </dl>
1633 </section>
1634 </div>
1635 </section>
1636 </div>
1637 <section id="section-6">
1638 <h2 id="name-references">
1639 <a href="#section-6" class="section-number selfRef">6. </a><a href="#name-references" class="section-name selfRef">References</a>
1640 </h2>
1641 <section id="section-6.1">
1642 <h3 id="name-normative-references">
1643 <a href="#section-6.1" class="section-number selfRef">6.1. </a><a href="#name-normative-references" class="section-name selfRef">Normative References</a>
1644 </h3>
1645 <dl class="references">
1646 <dt id="RFC2119">[RFC2119]</dt>
1647 <dd>
1648 <span class="refAuthor">Bradner, S.</span>, <span class="refTitle">"Key words for use in RFCs to Indicate Requirement Levels"</span>, <span class="seriesInfo">BCP 14</span>, <span class="seriesInfo">RFC 2119</span>, <span class="seriesInfo">DOI 10.17487/RFC2119</span>, <time datetime="1997-03" class="refDate">March 1997</time>, <span>&lt;<a href="https://www.rfc-editor.org/info/rfc2119">https://www.rfc-editor.org/info/rfc2119</a>&gt;</span>. </dd>
1649 <dd class="break"></dd>
1650 <dt id="RFC5056">[RFC5056]</dt>
1651 <dd>
1652 <span class="refAuthor">Williams, N.</span>, <span class="refTitle">"On the Use of Channel Bindings to Secure Channels"</span>, <span class="seriesInfo">RFC 5056</span>, <span class="seriesInfo">DOI 10.17487/RFC5056</span>, <time datetime="2007-11" class="refDate">November 2007</time>, <span>&lt;<a href="https://www.rfc-editor.org/info/rfc5056">https://www.rfc-editor.org/info/rfc5056</a>&gt;</span>. </dd>
1653 <dd class="break"></dd>
1654 <dt id="RFC5705">[RFC5705]</dt>
1655 <dd>
1656 <span class="refAuthor">Rescorla, E.</span>, <span class="refTitle">"Keying Material Exporters for Transport Layer Security (TLS)"</span>, <span class="seriesInfo">RFC 5705</span>, <span class="seriesInfo">DOI 10.17487/RFC5705</span>, <time datetime="2010-03" class="refDate">March 2010</time>, <span>&lt;<a href="https://www.rfc-editor.org/info/rfc5705">https://www.rfc-editor.org/info/rfc5705</a>&gt;</span>. </dd>
1657 <dd class="break"></dd>
1658 <dt id="RFC5801">[RFC5801]</dt>
1659 <dd>
1660 <span class="refAuthor">Josefsson, S.</span> and <span class="refAuthor">N. Williams</span>, <span class="refTitle">"Using Generic Security Service Application Program Interface (GSS-API) Mechanisms in Simple Authentication and Security Layer (SASL): The GS2 Mechanism Family"</span>, <span class="seriesInfo">RFC 5801</span>, <span class="seriesInfo">DOI 10.17487/RFC5801</span>, <time datetime="2010-07" class="refDate">July 2010</time>, <span>&lt;<a href="https://www.rfc-editor.org/info/rfc5801">https://www.rfc-editor.org/info/rfc5801</a>&gt;</span>. </dd>
1661 <dd class="break"></dd>
1662 <dt id="RFC5802">[RFC5802]</dt>
1663 <dd>
1664 <span class="refAuthor">Newman, C.</span>, <span class="refAuthor">Menon-Sen, A.</span>, <span class="refAuthor">Melnikov, A.</span>, and <span class="refAuthor">N. Williams</span>, <span class="refTitle">"Salted Challenge Response Authentication Mechanism (SCRAM) SASL and GSS-API Mechanisms"</span>, <span class="seriesInfo">RFC 5802</span>, <span class="seriesInfo">DOI 10.17487/RFC5802</span>, <time datetime="2010-07" class="refDate">July 2010</time>, <span>&lt;<a href="https://www.rfc-editor.org/info/rfc5802">https://www.rfc-editor.org/info/rfc5802</a>&gt;</span>. </dd>
1665 <dd class="break"></dd>
1666 <dt id="RFC5929">[RFC5929]</dt>
1667 <dd>
1668 <span class="refAuthor">Altman, J.</span>, <span class="refAuthor">Williams, N.</span>, and <span class="refAuthor">L. Zhu</span>, <span class="refTitle">"Channel Bindings for TLS"</span>, <span class="seriesInfo">RFC 5929</span>, <span class="seriesInfo">DOI 10.17487/RFC5929</span>, <time datetime="2010-07" class="refDate">July 2010</time>, <span>&lt;<a href="https://www.rfc-editor.org/info/rfc5929">https://www.rfc-editor.org/info/rfc5929</a>&gt;</span>. </dd>
1669 <dd class="break"></dd>
1670 <dt id="RFC7677">[RFC7677]</dt>
1671 <dd>
1672 <span class="refAuthor">Hansen, T.</span>, <span class="refTitle">"SCRAM-SHA-256 and SCRAM-SHA-256-PLUS Simple Authentication and Security Layer (SASL) Mechanisms"</span>, <span class="seriesInfo">RFC 7677</span>, <span class="seriesInfo">DOI 10.17487/RFC7677</span>, <time datetime="2015-11" class="refDate">November 2015</time>, <span>&lt;<a href="https://www.rfc-editor.org/info/rfc7677">https://www.rfc-editor.org/info/rfc7677</a>&gt;</span>. </dd>
1673 <dd class="break"></dd>
1674 <dt id="RFC8174">[RFC8174]</dt>
1675 <dd>
1676 <span class="refAuthor">Leiba, B.</span>, <span class="refTitle">"Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words"</span>, <span class="seriesInfo">BCP 14</span>, <span class="seriesInfo">RFC 8174</span>, <span class="seriesInfo">DOI 10.17487/RFC8174</span>, <time datetime="2017-05" class="refDate">May 2017</time>, <span>&lt;<a href="https://www.rfc-editor.org/info/rfc8174">https://www.rfc-editor.org/info/rfc8174</a>&gt;</span>. </dd>
1677 <dd class="break"></dd>
1678 <dt id="RFC8446">[RFC8446]</dt>
1679 <dd>
1680 <span class="refAuthor">Rescorla, E.</span>, <span class="refTitle">"The Transport Layer Security (TLS) Protocol Version 1.3"</span>, <span class="seriesInfo">RFC 8446</span>, <span class="seriesInfo">DOI 10.17487/RFC8446</span>, <time datetime="2018-08" class="refDate">August 2018</time>, <span>&lt;<a href="https://www.rfc-editor.org/info/rfc8446">https://www.rfc-editor.org/info/rfc8446</a>&gt;</span>. </dd>
1681 <dd class="break"></dd>
1682 </dl>
1683 </section>
1684 <section id="section-6.2">
1685 <h3 id="name-informative-references">
1686 <a href="#section-6.2" class="section-number selfRef">6.2. </a><a href="#name-informative-references" class="section-name selfRef">Informative References</a>
1687 </h3>
1688 <dl class="references">
1689 <dt id="RFC5246">[RFC5246]</dt>
1690 <dd>
1691 <span class="refAuthor">Dierks, T.</span> and <span class="refAuthor">E. Rescorla</span>, <span class="refTitle">"The Transport Layer Security (TLS) Protocol Version 1.2"</span>, <span class="seriesInfo">RFC 5246</span>, <span class="seriesInfo">DOI 10.17487/RFC5246</span>, <time datetime="2008-08" class="refDate">August 2008</time>, <span>&lt;<a href="https://www.rfc-editor.org/info/rfc5246">https://www.rfc-editor.org/info/rfc5246</a>&gt;</span>. </dd>
1692 <dd class="break"></dd>
1693 <dt id="RFC7627">[RFC7627]</dt>
1694 <dd>
1695 <span class="refAuthor">Bhargavan, K., Ed.</span>, <span class="refAuthor">Delignat-Lavaud, A.</span>, <span class="refAuthor">Pironti, A.</span>, <span class="refAuthor">Langley, A.</span>, and <span class="refAuthor">M. Ray</span>, <span class="refTitle">"Transport Layer Security (TLS) Session Hash and Extended Master Secret Extension"</span>, <span class="seriesInfo">RFC 7627</span>, <span class="seriesInfo">DOI 10.17487/RFC7627</span>, <time datetime="2015-09" class="refDate">September 2015</time>, <span>&lt;<a href="https://www.rfc-editor.org/info/rfc7627">https://www.rfc-editor.org/info/rfc7627</a>&gt;</span>. </dd>
1696 <dd class="break"></dd>
1697 <dt id="TRIPLE-HANDSHAKE">[TRIPLE-HANDSHAKE]</dt>
1698 <dd>
1699 <span class="refAuthor">Bhargavan, K.</span>, <span class="refAuthor">Delignat-Lavaud, A.</span>, <span class="refAuthor">Fournet, C.</span>, <span class="refAuthor">Pironti, A.</span>, and <span class="refAuthor">P. Strub</span>, <span class="refTitle">"Triple Handshakes Considered Harmful: Breaking and Fixing Authentication over TLS"</span>, <time datetime="2014-03" class="refDate">March 2014</time>, <span>&lt;<a href="https://www.mitls.org/pages/attacks/3SHAKE">https://www.mitls.org/pages/attacks/3SHAKE</a>&gt;</span>. </dd>
1700 <dd class="break"></dd>
1701 </dl>
1702 </section>
1703 </section>
1704 <div id="authors-addresses">
1705 <section id="appendix-A">
1706 <h2 id="name-authors-address">
1707 <a href="#name-authors-address" class="section-name selfRef">Author's Address</a>
1708 </h2>
1709 <address class="vcard">
1710 <div dir="auto" class="left"><span class="fn nameRole">Sam Whited</span></div>
1711 <div dir="auto" class="left">
1712 <span class="locality">Atlanta</span>, <span class="region">GA</span> </div>
1713 <div dir="auto" class="left"><span class="country-name">United States of America</span></div>
1714 <div class="email">
1715 <span>Email:</span>
1716 <a href="mailto:[email protected]" class="email">[email protected]</a>
1717 </div>
1718 <div class="url">
1719 <span>URI:</span>
1720 <a href="https://blog.samwhited.com/" class="url">https://blog.samwhited.com/</a>
1721 </div>
1722 </address>
1723 </section>
1724 </div>
1725 <script>const toc = document.getElementById("toc");
1726 toc.querySelector("h2").addEventListener("click", e => {
1727 toc.classList.toggle("active");
1728 });
1729 toc.querySelector("nav").addEventListener("click", e => {
1730 toc.classList.remove("active");
1731 });
1732 </script>
1733 </body>
1734 </html>