-
Notifications
You must be signed in to change notification settings - Fork 0
/
dtsecurity-zerotouch-join.txt
2128 lines (1402 loc) · 79.8 KB
/
dtsecurity-zerotouch-join.txt
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
6tisch Working Group M. Richardson
Internet-Draft Sandelman Software Works
Intended status: Informational June 18, 2018
Expires: December 20, 2018
6tisch Zero-Touch Secure Join protocol
draft-ietf-6tisch-dtsecurity-zerotouch-join-03
Abstract
This document describes a Zero-touch Secure Join (ZSJ) mechanism to
enroll a new device (the "pledge") into a IEEE802.15.4 TSCH network
using the 6tisch signaling mechanisms. The resulting device will
obtain a domain specific credential that can be used with either
802.15.9 per-host pair keying protocols, or to obtain the network-
wide key from a coordinator. The mechanism describe here is an
augmentation to the one-touch mechanism described in
[I-D.ietf-6tisch-minimal-security], and a constrained version of
[I-D.ietf-anima-bootstrapping-keyinfra].
Status of This Memo
This Internet-Draft is submitted in full conformance with the
provisions of BCP 78 and BCP 79.
Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF). Note that other groups may also distribute
working documents as Internet-Drafts. The list of current Internet-
Drafts is at http://datatracker.ietf.org/drafts/current/.
Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress."
This Internet-Draft will expire on December 20, 2018.
Copyright Notice
Copyright (c) 2018 IETF Trust and the persons identified as the
document authors. All rights reserved.
This document is subject to BCP 78 and the IETF Trust's Legal
Provisions Relating to IETF Documents
(http://trustee.ietf.org/license-info) in effect on the date of
publication of this document. Please review these documents
carefully, as they describe your rights and restrictions with respect
Richardson Expires December 20, 2018 [Page 1]
Internet-Draft 6tisch Zero-Touch Secure Join protocol June 2018
to this document. Code Components extracted from this document must
include Simplified BSD License text as described in Section 4.e of
the Trust Legal Provisions and are provided without warranty as
described in the Simplified BSD License.
Table of Contents
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 4
1.1. Prior Bootstrapping Approaches . . . . . . . . . . . . . 6
1.2. Terminology . . . . . . . . . . . . . . . . . . . . . . . 6
1.3. Scope of solution . . . . . . . . . . . . . . . . . . . . 7
1.3.1. Support environment . . . . . . . . . . . . . . . . . 8
1.3.2. Constrained environments . . . . . . . . . . . . . . 8
1.3.3. Network Access Controls . . . . . . . . . . . . . . . 8
1.4. Leveraging the new key infrastructure / next steps . . . 8
1.4.1. Key Distribution Process . . . . . . . . . . . . . . 8
1.5. Requirements for Autonomic Network Infrastructure (ANI)
devices . . . . . . . . . . . . . . . . . . . . . . . . . 8
2. Architectural Overview . . . . . . . . . . . . . . . . . . . 8
2.1. Behavior of a Pledge . . . . . . . . . . . . . . . . . . 9
2.2. Secure Imprinting using Vouchers . . . . . . . . . . . . 10
2.3. Initial Device Identifier . . . . . . . . . . . . . . . . 10
2.3.1. Identification of the Pledge . . . . . . . . . . . . 11
2.3.2. MASA URI extension . . . . . . . . . . . . . . . . . 12
2.4. Protocol Flow . . . . . . . . . . . . . . . . . . . . . . 12
2.5. Architectural Components . . . . . . . . . . . . . . . . 13
2.5.1. Pledge . . . . . . . . . . . . . . . . . . . . . . . 13
2.5.2. Stateless IPIP Join Proxy . . . . . . . . . . . . . . 13
2.5.3. Domain Registrar . . . . . . . . . . . . . . . . . . 13
2.5.4. Manufacturer Service . . . . . . . . . . . . . . . . 14
2.5.5. Public Key Infrastructure (PKI) . . . . . . . . . . . 14
2.6. Certificate Time Validation . . . . . . . . . . . . . . . 14
2.6.1. Lack of realtime clock . . . . . . . . . . . . . . . 14
2.6.2. Infinite Lifetime of IDevID . . . . . . . . . . . . . 14
2.7. Cloud Registrar . . . . . . . . . . . . . . . . . . . . . 14
2.8. Determining the MASA to contact . . . . . . . . . . . . . 15
3. Voucher-Request artifact . . . . . . . . . . . . . . . . . . 15
4. Proxying details (Pledge - Proxy - Registrar) . . . . . . . . 15
5. Proxy details . . . . . . . . . . . . . . . . . . . . . . . . 15
5.1. Pledge discovery of Proxy . . . . . . . . . . . . . . . . 15
5.2. CoAP connection to Registrar . . . . . . . . . . . . . . 16
5.3. HTTPS proxy connection to Registrar . . . . . . . . . . . 16
5.4. Proxy discovery of Registrar . . . . . . . . . . . . . . 16
6. Protocol Details (Pledge - Registrar - MASA) . . . . . . . . 16
6.1. BRSKI-EST (D)TLS establishment details . . . . . . . . . 17
6.1.1. BRSKI-EST CoAP/DTLS estasblishment details . . . . . 17
6.1.2. BRSKI-EST CoAP/EDHOC estasblishment details . . . . . 17
6.2. Pledge Requests Voucher from the Registrar . . . . . . . 19
Richardson Expires December 20, 2018 [Page 2]
Internet-Draft 6tisch Zero-Touch Secure Join protocol June 2018
6.3. BRSKI-MASA TLS establishment details . . . . . . . . . . 19
6.4. Registrar Requests Voucher from MASA . . . . . . . . . . 19
6.4.1. MASA renewal of expired vouchers . . . . . . . . . . 20
6.4.2. MASA verification of voucher-request signature
consistency . . . . . . . . . . . . . . . . . . . . . 20
6.4.3. MASA authentication of registrar (certificate) . . . 20
6.4.4. MASA revocation checking of registrar (certificate) . 20
6.4.5. MASA verification of pledge prior-signed-voucher-
request . . . . . . . . . . . . . . . . . . . . . . . 21
6.4.6. MASA pinning of registrar . . . . . . . . . . . . . . 21
6.4.7. MASA nonce handling . . . . . . . . . . . . . . . . . 21
6.5. MASA Voucher Response . . . . . . . . . . . . . . . . . . 21
6.5.1. Pledge voucher verification . . . . . . . . . . . . . 22
6.5.2. Pledge authentication of provisional TLS connection . 22
6.6. Pledge Voucher Status Telemetry . . . . . . . . . . . . . 22
6.7. Registrar audit log request . . . . . . . . . . . . . . . 22
6.7.1. MASA audit log response . . . . . . . . . . . . . . . 22
6.7.2. Registrar audit log verification . . . . . . . . . . 22
6.8. EST Integration for PKI bootstrapping . . . . . . . . . . 22
6.8.1. EST Distribution of CA Certificates . . . . . . . . . 22
6.8.2. EST CSR Attributes . . . . . . . . . . . . . . . . . 23
6.8.3. EST Client Certificate Request . . . . . . . . . . . 23
6.8.4. Enrollment Status Telemetry . . . . . . . . . . . . . 23
6.8.5. Multiple certificates . . . . . . . . . . . . . . . . 23
6.8.6. EST over CoAP . . . . . . . . . . . . . . . . . . . . 23
6.9. Use of Secure Transport for Minimal Join . . . . . . . . 23
7. Reduced security operational modes . . . . . . . . . . . . . 24
7.1. Trust Model . . . . . . . . . . . . . . . . . . . . . . . 24
7.2. Pledge security reductions . . . . . . . . . . . . . . . 24
7.3. Registrar security reductions . . . . . . . . . . . . . . 24
7.4. MASA security reductions . . . . . . . . . . . . . . . . 24
8. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 24
8.1. Well-known EST registration . . . . . . . . . . . . . . . 24
8.2. PKIX Registry . . . . . . . . . . . . . . . . . . . . . . 24
8.3. Voucher Status Telemetry . . . . . . . . . . . . . . . . 24
8.4. DNS Service Names . . . . . . . . . . . . . . . . . . . . 25
8.5. MUD File Extension for the MASA server . . . . . . . . . 25
9. Privacy Considerations . . . . . . . . . . . . . . . . . . . 25
9.1. Privacy Considerations for Production network . . . . . . 25
9.2. Privacy Considerations for New Pledges . . . . . . . . . 25
9.2.1. EUI-64 derived address for join time IID . . . . . . 26
9.3. Privacy Considerations for Join Proxy . . . . . . . . . . 26
10. Security Considerations . . . . . . . . . . . . . . . . . . . 26
10.1. Security of MASA voucher signing key(s) . . . . . . . . 26
11. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 27
12. References . . . . . . . . . . . . . . . . . . . . . . . . . 27
12.1. Normative References . . . . . . . . . . . . . . . . . . 27
12.2. Informative References . . . . . . . . . . . . . . . . . 31
Richardson Expires December 20, 2018 [Page 3]
Internet-Draft 6tisch Zero-Touch Secure Join protocol June 2018
Appendix A. Extra text . . . . . . . . . . . . . . . . . . . . . 32
A.1. Assumptions . . . . . . . . . . . . . . . . . . . . . . . 32
A.1.1. One-Touch Assumptions . . . . . . . . . . . . . . . . 32
A.1.2. Factory provided credentials (if any) . . . . . . . . 33
A.1.3. Credentials to be introduced . . . . . . . . . . . . 33
A.2. Network Assumptions . . . . . . . . . . . . . . . . . . . 33
A.2.1. Security above and below IP . . . . . . . . . . . . . 33
A.2.2. Join network assumptions . . . . . . . . . . . . . . 34
A.2.3. Number and cost of round trips . . . . . . . . . . . 35
A.2.4. Size of packets, number of fragments . . . . . . . . 35
A.3. Target end-state for join process . . . . . . . . . . . . 35
Appendix B. Join Protocol . . . . . . . . . . . . . . . . . . . 35
B.1. Key Agreement process . . . . . . . . . . . . . . . . . . 36
B.2. Provisional Enrollment process . . . . . . . . . . . . . 36
Appendix C. IANA Considerations . . . . . . . . . . . . . . . . 37
Appendix D. Protocol Definition . . . . . . . . . . . . . . . . 37
D.1. Discovery . . . . . . . . . . . . . . . . . . . . . . . . 37
D.1.1. Proxy Discovery Protocol Details . . . . . . . . . . 38
D.1.2. Registrar Discovery Protocol Details . . . . . . . . 38
Author's Address . . . . . . . . . . . . . . . . . . . . . . . . 38
1. Introduction
Enrollment of new nodes into LLNs present unique challenges. The
constrained nodes has no user interfaces, and even if they did,
configuring thousands of such nodes manually is undesireable from a
human resources issue, as well as the difficulty in getting
consistent results.
This document is about a standard way to introduce new nodes into a
6tisch network that does not involve any direct manipulation of the
nodes themselves. This act has been called "zero-touch"
provisioning, and it does not occur by chance, but requires
coordination between the manufacturer of the node, the service
operator running the LLN, and the installers actually taking the
devices out of the shipping boxes.
This document is a constrained profile of
[I-D.ietf-anima-bootstrapping-keyinfra]. The above document/protocol
is referred by by it's acronym: BRSKI. The pronounciation of which
is "brew-ski", a common north american slang for beer with a pseudo-
polish ending. This constrained protocol is called ZSJ.
This document follows the same structure as it's parent in order to
emphasize the similarities, but specializes a number of things to
constrained networks of constrained devices. Like
[I-D.ietf-anima-bootstrapping-keyinfra], the networks which are in
scope for this protocol are deployed by a professional operator. The
Richardson Expires December 20, 2018 [Page 4]
Internet-Draft 6tisch Zero-Touch Secure Join protocol June 2018
deterministic mechanisms which have been designed into 6tisch have
been created to satisfy the operational needs of industrial settings
where such an operator exists.
This document builds upon the "one-touch" provisioning described in
[I-D.ietf-6tisch-minimal-security], reusing the OSCOAP Join Request
mechanism when appropriate, but preceeding it with either the EDHOC
key agreement protocol, or a DTLS channel. The [RFC7030] EST
protocol extended in [I-D.ietf-6tisch-minimal-security], has been
mapped by [I-D.ietf-ace-coap-est] into CoAP.
Otherwise, this document follows BRSKI with the following high-level
changes:
o HTTP is replaced with CoAP.
o TLS (HTTPS) is replaced with either DTLS+CoAP, or EDHOC/
OSCOAP+CoAP
o the domain-registrar anchor certificate is replaced with a Raw
Public Key (RPK) using [RFC7250].
o the PKCS7 signed JSON voucher format is replaced with CWT
o the GRASP discovery mechanism for the Proxy is replaced with an
announcement in the Enhanced Beacon
[I-D.richardson-6tisch-join-enhanced-beacon]
o the TCP circuit proxy mechanism is not used. The IPIP mechanism
if mandatory to implement when deployed with DTLS, while the CoAP
based stateless proxy mechanism is used for OSCOAP/EDHOC.
o real time clocks are assumed to be unavailable, so expiry dates in
ownership vouchers are never used
o nonce-full vouchers are encouraged, but off-line nonce-less
operation is also supported, however, the resulting vouchers have
infinite life.
802.1AR Client certificates are retained, but optionally are
specified by reference rather than value.
It is expected that the back-end network operator infrastructure
would be able to bootstrap ANIMA BRSKI-type devices over ethernet,
while also being able bootstrap 6tisch devices over 802.15.4 with few
changes.
Richardson Expires December 20, 2018 [Page 5]
Internet-Draft 6tisch Zero-Touch Secure Join protocol June 2018
NOTE TO RFC-EDITOR: during production of this document, it was
matched against [I-D.ietf-anima-bootstrapping-keyinfra] section by
section. This results in a few sections, such as IANA Considerations
where there is no requested activity. Those sections are marked "NO
ACTION, PLEASE REMOVE" and should be removed (along with this
paragraph) from the final document.
1.1. Prior Bootstrapping Approaches
Constrained devices as used in industrial control systems are usually
installed (or replaced) by technicians with expertise in the
equipment being serviced, not in secure enrollment of devices.
Devices therefore are typically pre-configured in advance, marked for
a particular factory, assembly line, or even down to the specific
machine. It is not uncommon for manufacturers to have a product code
(stock keeping unit -SKU) for each part, and for each customer as the
part will be loaded with customer specifc security configuration.
The resulting customer-specific parts are hard to inventory and
spare, and should parts be delivered to the wrong customer,
determining the reason for inability to configure is difficult and
time consuming.
End-user actions to configure the part at the time of installation,
aside from being error prone, also suffer from requiring a part that
has an interface.
1.2. Terminology
In this document, the key words "MUST", "MUST NOT", "REQUIRED",
"SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY",
and "OPTIONAL" are to be interpreted as described in BCP 14, RFC 2119
[RFC2119] and indicate requirement levels for compliant STuPiD
implementations.
The reader is expected to be familiar with the terms and concepts
defined in [I-D.ietf-6tisch-terminology], [RFC7252],
[I-D.ietf-core-object-security], and
[I-D.ietf-anima-bootstrapping-keyinfra]. The following terms are
imported: drop ship, imprint, enrollment, pledge, join proxy,
ownership voucher, join registrar/coordinator. The following terms
are repeated here for readability, but this document is not
authoritative for their definition:
pledge the prospective device, which has the identity provided to at
the factory. Neither the device nor the network knows if the
device yet knows if this device belongs with this network.
Richardson Expires December 20, 2018 [Page 6]
Internet-Draft 6tisch Zero-Touch Secure Join protocol June 2018
Joined Node the prospective device, after having completing the join
process, often just called a Node.
Join Proxy (JP): a stateless relay that provides connectivity
between the pledge and the join registrar/coordinator.
Join Registrar/Coordinator (JRC): central entity responsible for
authentication and authorization of joining nodes.
Audit Token A signed token from the manufacturer authorized signing
authority indicating that the bootstrapping event has been
successfully logged. This has been referred to as an
"authorization token" indicating that it authorizes bootstrapping
to proceed.
Ownership Voucher A signed voucher from the vendor vouching that a
specific domain "owns" the new entity as defined in
[I-D.ietf-anima-voucher].
MIC manufacturer installed certificate. An [ieee802-1AR] identity.
Not to be confused with a (cryptographic) "Message Integrity
Check"
1.3. Scope of solution
The solution described in this document is appropriate to enrolling
between hundreds to hundreds of thousands of diverse devices into a
network without any prior contact with the devices. The devices
could be shipped by the manufacturer directly to the customer site
without ever being seen by the operator of the network. As described
in BRSKI, in the audit-mode of operation the device will be claimed
by the first network that sees it. In the tracked owner mode of
operation, sales channel integration provides a strong connection
that the operator of the network is the legitimate owner of the
device.
BRSKI describes a more general, more flexible approach for
bootstrapping devices into an ISP or Enterprise network.
[I-D.ietf-6tisch-minimal-security] provides an extremely streamlined
approach to enrolling from hundreds to thousands of devices into a
network, provided that a unique secret key can be installed in each
device.
Richardson Expires December 20, 2018 [Page 7]
Internet-Draft 6tisch Zero-Touch Secure Join protocol June 2018
1.3.1. Support environment
TBD
1.3.2. Constrained environments
TBD
1.3.3. Network Access Controls
TBD
1.4. Leveraging the new key infrastructure / next steps
In constrained networks, it is unlikely that an ACP be formed. This
document does not preclude such a thing, but it is not mandated.
The resulting secure channel MAY be used just to distribute network-
wide keys using a protocol such as
[I-D.ietf-6tisch-minimal-security]. (XXX - do we need to signal this
somehow?)
The resulting secure channel MAY be instead used to do an enrollment
of an LDevID as in BRSKI, but the resulting certificate is used to do
per-pair keying such as described by {{ieee802159}.
1.4.1. Key Distribution Process
In addition to being used for the initial enrollment process, the
secure channel may be kept open (and reversed) to use for network
rekeying. Such a process is out of scope of this document, please
see future work such as [I-D.richardson-6tisch-minimal-rekey].
1.5. Requirements for Autonomic Network Infrastructure (ANI) devices
TBD
2. Architectural Overview
Section 2 of BRSKI has a diagram with all of the components shown
together. There are no significant changes to the diagram.
The use of a circuit proxy is not mandated. Instead the IPIP
mechanism described in appendix C ("IPIP Join Proxy mechanism")
SHOULD be be used instead as it supports both DTLS, EDHOC and OSCOAP
protocols.
Richardson Expires December 20, 2018 [Page 8]
Internet-Draft 6tisch Zero-Touch Secure Join protocol June 2018
The CoAP proxy mechanism MAY be implemented instead: the decision
depends upon the capabilities of the Registrar and the proxy. A
mechanism is included for the Registrar to announce it's capabilities
(XXX)
2.1. Behavior of a Pledge
The pledge goes through a series of steps which are outlined here at
a high level.
+--------------+
| Factory |
| default |
+------+-------+
|
+------v-------+
| (1) Discover |
+------------> |
| +------+-------+
| |
| +------v-------+
| | (2) Identity |
^------------+ |
| rejected +------+-------+
| |
| +------v-------+
| | (3) Request |
| | Join |
| +------+-------+
| |
| +------v-------+
| | (4) Imprint |
^------------+ |
| Bad MASA +------+-------+
| response | send Voucher Status Telemetry
| +------v-------+
| | (5) Enroll |
^------------+ |
| Enroll +------+-------+
| Failure |
| +------v-------+
| | (6) Enrolled |
^------------+ |
Factory +--------------+
reset
State descriptions for the pledge are as follows:
Richardson Expires December 20, 2018 [Page 9]
Internet-Draft 6tisch Zero-Touch Secure Join protocol June 2018
1. Discover a communication channel to a Registrar. This is done by
listening for beacons as described by
[I-D.richardson-anima-6join-discovery]
2. Identify itself. This is done by presenting an X.509 IDevID
credential to the discovered Registrar (via the Proxy) in a DTLS
or EDHOC handshake. (The Registrar credentials are only
provisionally accepted at this time).
The registrar identifies itself using a raw public key, while the
the pledge identifies itself to the registrar using an IDevID
credential.
3. Requests to Join the discovered Registrar. A unique nonce can be
included ensuring that any responses can be associated with this
particular bootstrapping attempt.
4. Imprint on the Registrar. This requires verification of the
vendor service (MASA) provided voucher. A voucher contains
sufficient information for the Pledge to complete authentication
of a Registrar. The voucher is signed by the vendor (MASA) using
a raw public key, previously installed into the pledge at
manufacturing time.
5. Optionally Enroll. By accepting the domain specific information
from a Registrar, and by obtaining a domain certificate from a
Registrar using a standard enrollment protocol, e.g. Enrollment
over Secure Transport (EST) [RFC7030].
6. The Pledge is now a member of, and can be managed by, the domain
and will only repeat the discovery aspects of bootstrapping if it
is returned to factory default settings.
2.2. Secure Imprinting using Vouchers
As in BRSKI, the format and cryptographic mechansim of vouchers is
described in detail in [I-D.ietf-anima-voucher]. As described in
section YYY, the physical format for vouchers in this document
differs from that of BRSKI, in that it uses
[I-D.ietf-ace-cbor-web-token] to encode the voucher and to sign it.
2.3. Initial Device Identifier
The essential component of the zero-touch operation is that the
pledge is provisioned with an 802.1AR (PKIX) certificate installed
during the manufacturing process.
Richardson Expires December 20, 2018 [Page 10]
Internet-Draft 6tisch Zero-Touch Secure Join protocol June 2018
It is expected that constrained devices will use a signature
algorithm corresponding to the hardware acceleration that they have,
if they have any. The anticipated algorithms are the ECDSA P-256
(secp256p1), and SHOULD be supported. Newer devices SHOULD begin to
appear using EdDSA curves using the 25519 curves.
The manufacturer will always know what algorithms are available in
the Pledge, and will use an appropriate one. The other components
that need to evaluate the IDevID (the Registrar and MASA) are
expected to support all common algorithms.
There are a number of simplications detailed later on in this
document designed to eliminate the need for an ASN.1 parser in the
pledge.
The pledge should consider it's 802.1AR certificate to be an opaque
blob of bytes, to be inserted into protocols at appropriate places.
The pledge SHOULD have access to it's public and private keys in the
most useable native format for computation.
The pledge MUST have the public key of the MASA built in a
manufacturer time. This is a seemingly identical requirement as for
BRSKI, but rather than being an abstract trust anchor that can be
augmented with a certificate chain, the pledge MUST be provided with
the Raw Public Key that the MASA will use to sign vouchers for that
pledge.
There are a number of security concerns with use of a single MASA
signing key, and section Section 10.1 addresses some of them with
some operational suggestions.
BRSKI places some clear requirements upon the contents of the IDevID,
but leaves the exact origin of the voucher serial-number open. This
document restricts the process to being the hwSerialNum OCTET STRING.
As CWT can handle binary formats, no base64 encoding is necessary.
The use of the MASA-URL extension is encouraged if the certificate is
sent at all.
EDNOTE: here belongs text about sending only a reference to the
IDevID rather than the entire certificate
2.3.1. Identification of the Pledge
TBD
Richardson Expires December 20, 2018 [Page 11]
Internet-Draft 6tisch Zero-Touch Secure Join protocol June 2018
2.3.2. MASA URI extension
TBD
2.4. Protocol Flow
The diagram from BRSKI is reproduced with some edits:
+--------+ +---------+ +------------+ +------------+
| Pledge | | IPIP | | Domain | | Vendor |
| | | Proxy | | Registrar | | Service |
| | | | | (JRC) | | (MASA) |
+--------+ +---------+ +------------+ +------------+
| | | |
|<-RFC4862 IPv6 adr | | |
| | | |
|<--------------------| | |
| Enhanced Beacon | | |
| periodic broadcast| | |
| | | |
|<------------------->C<----------------->| |
| DTLS via the IPIP Proxy | |
|<--Registrar DTLS server authentication--| |
[PROVISIONAL accept of server cert] | |
P---X.509 client authentication---------->| |
P | | |
P---Voucher Request (include nonce)------>| |
P | | |
P | | |
P | [accept device?] |
P | [contact Vendor] |
P | |--Pledge ID-------->|
P | |--Domain ID-------->|
P | |--nonce------------>|
P | | [extract DomainID]
P | | |
P | | [update audit log]
P | | |
P | | |
P | | |
P | | |
P | | |
P | |<-device audit log--|
P | |<- voucher ---------|
P | | |
P | | |
P | [verify audit log and voucher] |
P | | |
Richardson Expires December 20, 2018 [Page 12]
Internet-Draft 6tisch Zero-Touch Secure Join protocol June 2018
P<------voucher---------------------------| |
[verify voucher ] | | |
[verify provisional cert| | |
| | | |
|<--------------------------------------->| |
| Continue with RFC7030 enrollment | |
| using now bidirectionally authenticated | |
| DTLS session. | | |
| | | |
|<--------------------------------------->| |
| Use 6tisch-minimal-security join request |
Noteable changes are:
1. no IPv4 support/options.
2. no mDNS steps, 6tisch only uses Enhanced Beacon
3. nonce-full option is always mandatory
2.5. Architectural Components
The bootstrap process includes the following architectural
components:
2.5.1. Pledge
The Pledge is the device which is attempting to join. Until the
pledge completes the enrollment process, it has network connectivity
only to the Proxy.
2.5.2. Stateless IPIP Join Proxy
The stateless CoAP or DTLS Proxy provides CoAP or DTLS connectivity
(respectively) between the pledge and the registrar. The stateless
CoAP proxy mechanism is described in
[I-D.ietf-6tisch-minimal-security] section 5.1.
The stateless DTLS mechanism is not yet described (TBD).
2.5.3. Domain Registrar
The Domain Registrar (having the formal name Join Registrar/
Coordinator (JRC)), operates as a CMC Registrar, terminating the EST
and BRSKI connections. The Registrar is manually configured or
distributed with a list of trust anchors necessary to authenticate
any Pledge device expected on the network. The Registrar
communicates with the Vendor supplied MASA to establish ownership.
Richardson Expires December 20, 2018 [Page 13]
Internet-Draft 6tisch Zero-Touch Secure Join protocol June 2018
The JRC is typically located on the 6LBR/DODAG root, but it may be
located elsewhere, provided IP level connectivity can be established.
The 6LBR may also provide a proxy or relay function to connect to the
actual registrar in addition to the IPIP proxy described above. The
existence of such an additional proxy is a private matter, and this
documents assumes without loss of generality that the registrar is
co-located with the 6LBR.
2.5.4. Manufacturer Service
The Manufacturer Service provides two logically seperate functions:
the Manufacturer Authorized Signing Authority (MASA), and an
ownership tracking/auditing function. This function is identical to
that used by BRSKI, except that a different format voucher is used.
2.5.5. Public Key Infrastructure (PKI)
TBD
2.6. Certificate Time Validation
2.6.1. Lack of realtime clock
For the constrained situation it is assumed that devices have no real
time clock. These nodes do have access to a monotonically increasing
clock that will not go backwards in the form of the Absolute Sequence
Number. Synchronization to the ASN is required in order to transmit/
receive data and most nodes will maintain it in hardware.
The heuristic described in BRSKI under this section SHOULD be applied
if there are dates in the CWT format voucher.
Voucher requests SHOULD include a nonce. For devices intended for
off-line deployment, the vouchers will have been generated in advance
and no nonce-ful operation will not be possible.
2.6.2. Infinite Lifetime of IDevID
TBD
2.7. Cloud Registrar
In 6tisch, the pledge never has network connectivity until it is
enrolled, so no alternate registrar is ever possible.
Richardson Expires December 20, 2018 [Page 14]
Internet-Draft 6tisch Zero-Touch Secure Join protocol June 2018
2.8. Determining the MASA to contact
There are no changes from BRSKI: the IDevID provided by the pledge
will contain a MASA URL extension.
3. Voucher-Request artifact
The voucher-request artifact is defined in
[I-D.ietf-anima-constrained-voucher] section 6.1.
For the 6tisch ZSJ protocol defined in this document, only COSE
signed vouchers as described in [I-D.ietf-anima-constrained-voucher]
section 6.3.2 are supported.
4. Proxying details (Pledge - Proxy - Registrar)
The voucher-request artifact is defined in
[I-D.ietf-anima-constrained-voucher].
The 6tisch use of the constrained version differs from the non-
constrained version in two ways:
1. it does not include the pinned-domain-cert, but rather than
pinned-domain-subjet-public-key-info entry. This accomodates the
use of a raw public key to identify the registrar.
2. the pledge voucher-request is never signed.
An appendix shows detailed examples of COSE format voucher requests.
5. Proxy details
The role of the Proxy is to facilitate communication. In the
constrained situation the proxy needs to be stateless as there is
very little ram to begin with, and none can be allocated to keep
state for an unlimited number of potential pledges.
5.1. Pledge discovery of Proxy
In BRSKI, the pledge discovers the proxy via use of a GRASP M_FLOOD
messages sent by the proxy. In 6tisch ZSJ, the existence of the
proxy is announced by the Enhanced Beacon message described in
[I-D.richardson-6tisch-enrollment-enhanced-beacon]. The proxy as
described by [I-D.ietf-6tisch-minimal-security] section 10 is to be
used in an identical fashion when EDHOC and OSCOAP are used.
When DTLS security is provided, then the proxy mechanism described in
TBD must be used.
Richardson Expires December 20, 2018 [Page 15]
Internet-Draft 6tisch Zero-Touch Secure Join protocol June 2018
5.2. CoAP connection to Registrar
In BRSKI CoAP is future work. This document represents this work.
5.3. HTTPS proxy connection to Registrar
HTTPS connections are not used between the Pledge, Proxy and
Registrar. The Proxy relays CoAP or DTLS packets and does not
interpret or terminate either CoAP or DTLS connections. (HTTPS is
still used between the Registrar and MASA)
5.4. Proxy discovery of Registrar
In BRSKI, the proxy autonomically discovers the Registrar by
listening for GRASP messages.
In the constrained network, the proxies are optionally configured
with the address of the JRC by the Join Response in in
[I-D.ietf-6tisch-minimal-security] section 9.3.2. (As described in
that section, the address of the registrar otherwise defaults to be
that of the DODAG root)
Whether or not a 6LR will announce itself as a possible Join Proxy is
outside the scope of this document.
6. Protocol Details (Pledge - Registrar - MASA)
BRSKI is specified to run over HTTPS. This document respecifies it
to run over CoAP with either DTLS or EDHOC-provided OSCOAP security.
BRSKI introduces the concept of a provisional state for EST.
The same situation must also be added to DTLS: a situation where the
connection is active but the identity of the Registar has not yet
been confirmed. The DTLS MUST validate that the exchange has been
signed by the Raw Public Key that is presented by the Server, even
though there is as yet no trust in that key. Such a key is often
available through APIs that provide for channel binding, such as
described in [RFC5056].
There is an emerging (hybrid) possibility of DTLS-providing the
OSCOAP security, but such a specification does not yet exist, and
this document does at this point specify it.
[I-D.ietf-ace-coap-est] specifies that CoAP specifies the use of CoAP
Block-Wise Transfer ("Block") [RFC7959] to fragment EST messages at
the application layer.
Richardson Expires December 20, 2018 [Page 16]
Internet-Draft 6tisch Zero-Touch Secure Join protocol June 2018
BRSKI introduces the concept of a provisional state for EST. The
same situation must also be added to DTLS: a situation where the
connection is active but the identity of the Registar has not yet
been confirmed.
The DTLS MUST validate that the exchange has been signed by the Raw
Public Key that is presented by the Server, even though there is as
yet no trust in that key. Such a key is often available through APIs
that provide for channel binding, such as described in [RFC5056].
As in [I-D.ietf-ace-coap-est], support for Observe CoAP options
[RFC7641] with BRSKI is not supported in the current BRSKI/EST
message flows.
Observe options could be used by the server to notify clients about a
change in the cacerts or csr attributes (resources) and might be an
area of future work.
Redirection as described in [RFC7030] section 3.2.1 is NOT supported.
6.1. BRSKI-EST (D)TLS establishment details
6tisch ZSJ does not use TLS. The connection is either CoAP over
DTLS, or CoAP with EDHOC security.
6.1.1. BRSKI-EST CoAP/DTLS estasblishment details
The details in the BRSKI document apply directly to use of DTLS.
The registrar SHOULD authenticate itself with a raw public key. A
256 bit ECDSA raw public key is RECOMMENDED. Pledges SHOULD support
EDDSA keys if they contain hardware that supports doing so
efficiently.
TBD: the Pledge needs to signal what kind of Raw Public Key it
supports before the Registrar sends its ServerCertificate. Can SNI
be used to do this?
The pledge SHOULD authenticate itself with the built-in IDevID
certificate as a ClientCertificate.
6.1.2. BRSKI-EST CoAP/EDHOC estasblishment details
[I-D.selander-ace-cose-ecdhe] details how to use EDHOC. The EDHOC
description identifiers a party U (the initiator), and a party V.
The Pledge is the party U, and the JRC is the party V.
Richardson Expires December 20, 2018 [Page 17]
Internet-Draft 6tisch Zero-Touch Secure Join protocol June 2018
The communication from the Pledge is via CoAP via the Join Proxy.
The Join proxy relays traffic to the JRC, and using the mechanism
described in [I-D.ietf-6tisch-minimal-security] section 5.1. This is
designed so that the Join Proxy does not need to know if it is
performing the one-touch enrollment described in
[I-D.ietf-6tisch-minimal-security] or the zero-touch enrollment
protocol described in this document. A network could consist of a
mix of nodes of each type.
As generating ephemeral keys is expensive for a low-resource Pledge,
the use of a common E_U by the Pledge for multiple enrollment
attempts (should the first turn out to be the wrong network) is
encouraged.
The first communication detailed in [I-D.ietf-ace-coap-est] is to
query the "/.well-known/core" resource to request the Link for EST.
This is where the initial CoAP request is to sent.
The JRC MAY replace it's E_V ephermal key on a periodic basis, or
even for every communication session.
The Pledge's ID_U is the Pledge's IDevID. It is transmitted in an
x5bag [I-D.schaad-cose-x509]. An x5u (URL) MAY be used. An x5t
(hash) MAY also be used and would be the smallest, but the Registrar
may not know where to find the Pledge's IDevID unless the JRC has
been preloaded will all the IDevIDs via out-of-band mechanism. It is
impossible for the Pledge to know if the JRC has been loaded in such
a way so x5t is discouraged for general use.
The JRC's ID_V is the JRC's Raw Public Key. It is transmitted as a
key in COSE's YYY parameter.
The initial Mandatory to Implement (MTI) of an HKDF of SHA2-256, an
AEAD based upon AES-CCM-16-64-128, a signature verification of BBBB,
and signature generation of BBBB. The Pledge proposes a set of
algorithms that it supports, and Pledge need not support more than
one combination.
JRCs are expected to run on non-constrained servers, and are expected
to support the above initial MTI, and any subsequent ones that become
common. A JRC SHOULD support all available algorithms for a
significant amount of time. Even when algorithms become weak or
suspect, it is likely that it will still have to perform secure join
for older devices. A JRC that responds to such an older device might