summaryrefslogtreecommitdiff
path: root/doc/rfc/rfc9172.txt
blob: beb800c9bb1a90b4ec2ba5123d641b77fdc2ee0a (plain) (blame)
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
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
1660
1661
1662
1663
1664
1665
1666
1667
1668
1669
1670
1671
1672
1673
1674
1675
1676
1677
1678
1679
1680
1681
1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
1703
1704
1705
1706
1707
1708
1709
1710
1711
1712
1713
1714
1715
1716
1717
1718
1719
1720
1721
1722
1723
1724
1725
1726
1727
1728
1729
1730
1731
1732
1733
1734
1735
1736
1737
1738
1739
1740
1741
1742
1743
1744
1745
1746
1747
1748
1749
1750
1751
1752
1753
1754
1755
1756
1757
1758
1759
1760
1761
1762
1763
1764
1765
1766
1767
1768
1769
1770
1771
1772
1773
1774
1775
1776
1777
1778
1779
1780
1781
1782
1783
1784
1785
1786
1787
1788
1789
1790
1791
1792
1793
1794
1795
1796
1797
1798
1799
1800
1801
1802
1803
1804
1805
1806
1807
1808
1809
1810
1811
1812
1813
1814
1815
1816
1817
1818
1819
1820
1821
1822
1823
1824
1825
1826
1827
1828
1829
1830
1831
1832
1833
1834
1835
1836
1837
1838
1839
1840
1841
1842
1843
1844
1845
1846
1847
1848
1849
1850
1851
1852
1853
1854
1855
1856
1857
1858
1859
1860
1861
1862
1863
1864
1865
1866
1867
1868
1869
1870
1871
1872
1873
1874
1875
1876
1877
1878
1879
1880
1881
1882
1883
1884
1885
1886
1887
1888
1889
1890
1891
1892
1893
1894
1895
1896
1897
1898
1899
1900
1901
1902
1903
1904
1905
1906
1907
1908
1909
1910
1911
1912
1913
1914
1915
1916
1917
1918
1919
1920
1921
1922
1923
1924
1925
1926
1927
1928
1929
1930
1931
1932
1933
1934
1935
1936
1937
1938
1939
1940
1941
1942
1943
1944
1945
1946
1947
1948
1949
1950
1951
1952
1953
1954
1955
1956
1957
1958
1959
1960
1961
1962
1963
1964
1965
1966
1967
1968
1969
1970
1971
1972
1973
1974
1975
1976
1977
1978
1979
1980
1981
1982
1983
1984
1985
1986
1987
1988
1989
Internet Engineering Task Force (IETF)                   E. Birrane, III
Request for Comments: 9172                                   K. McKeever
Category: Standards Track                                        JHU/APL
ISSN: 2070-1721                                             January 2022


                    Bundle Protocol Security (BPSec)

Abstract

   This document defines a security protocol providing data integrity
   and confidentiality services for the Bundle Protocol (BP).

Status of This Memo

   This is an Internet Standards Track document.

   This document is a product of the Internet Engineering Task Force
   (IETF).  It represents the consensus of the IETF community.  It has
   received public review and has been approved for publication by the
   Internet Engineering Steering Group (IESG).  Further information on
   Internet Standards is available in Section 2 of RFC 7841.

   Information about the current status of this document, any errata,
   and how to provide feedback on it may be obtained at
   https://www.rfc-editor.org/info/rfc9172.

Copyright Notice

   Copyright (c) 2022 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
   (https://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
   to this document.  Code Components extracted from this document must
   include Revised BSD License text as described in Section 4.e of the
   Trust Legal Provisions and are provided without warranty as described
   in the Revised BSD License.

Table of Contents

   1.  Introduction
     1.1.  Supported Security Services
     1.2.  Specification Scope
     1.3.  Related Documents
     1.4.  Terminology
   2.  Design Decisions
     2.1.  Block-Level Granularity
     2.2.  Multiple Security Sources
     2.3.  Mixed Security Policy
     2.4.  User-Defined Security Contexts
     2.5.  Deterministic Processing
   3.  Security Blocks
     3.1.  Block Definitions
     3.2.  Uniqueness
     3.3.  Target Multiplicity
     3.4.  Target Identification
     3.5.  Block Representation
     3.6.  Abstract Security Block
     3.7.  Block Integrity Block
     3.8.  Block Confidentiality Block
     3.9.  Block Interactions
     3.10. Parameter and Result Identification
     3.11. BPSec Block Examples
       3.11.1.  Example 1: Constructing a Bundle with Security
       3.11.2.  Example 2: Adding More Security at a New Node
   4.  Canonical Forms
   5.  Security Processing
     5.1.  Bundles Received from Other Nodes
       5.1.1.  Receiving BCBs
       5.1.2.  Receiving BIBs
     5.2.  Bundle Fragmentation and Reassembly
   6.  Key Management
   7.  Security Policy Considerations
     7.1.  Security Reason Codes
   8.  Security Considerations
     8.1.  Attacker Capabilities and Objectives
     8.2.  Attacker Behaviors and BPSec Mitigations
       8.2.1.  Eavesdropping Attacks
       8.2.2.  Modification Attacks
       8.2.3.  Topology Attacks
       8.2.4.  Message Injection
   9.  Security Context Considerations
     9.1.  Mandating Security Contexts
     9.2.  Identification and Configuration
     9.3.  Authorship
   10. Defining Other Security Blocks
   11. IANA Considerations
     11.1.  Bundle Block Types
     11.2.  Bundle Status Report Reason Codes
     11.3.  Security Context Identifiers
   12. References
     12.1.  Normative References
     12.2.  Informative References
   Acknowledgments
   Authors' Addresses

1.  Introduction

   This document defines security features for the Bundle Protocol (BP)
   [RFC9171] and is intended for use in Delay-Tolerant Networking (DTN)
   to provide security services between a security source and a security
   acceptor.  When the security source is the bundle source and the
   security acceptor is the bundle destination, the security service
   provides end-to-end protection.

   The Bundle Protocol specification [RFC9171] defines DTN as referring
   to "a network architecture providing communications in and/or through
   highly stressed environments" where "BP may be viewed as sitting at
   the application layer of some number of constituent networks, forming
   a store-carry-forward overlay network".  The phrase "stressed
   environment" refers to multiple challenging conditions including
   intermittent connectivity, large and/or variable delays, asymmetric
   data rates, and high bit error rates.

   It should be presumed that the BP will be deployed in an untrusted
   network, which poses the usual security challenges related to
   confidentiality and integrity.  However, the stressed nature of the
   BP operating environment imposes unique conditions where usual
   transport security mechanisms may not be sufficient.  For example,
   the store-carry-forward nature of the network may require protecting
   data at rest, preventing unauthorized consumption of critical
   resources such as storage space, and operating without regular
   contact with a centralized security oracle (such as a certificate
   authority).

   An end-to-end security service that operates in all of the
   environments where the BP operates is needed.

1.1.  Supported Security Services

   BPSec provides integrity and confidentiality services for BP bundles,
   as defined in this section.

   Integrity services ensure that changes to target data within a bundle
   can be discovered.  Data changes may be caused by processing errors,
   environmental conditions, or intentional manipulation.  In the
   context of BPSec, integrity services apply to plaintext in the
   bundle.

   Confidentiality services ensure that target data is unintelligible to
   nodes in DTN, except for authorized nodes possessing special
   information.  Generally, this means producing ciphertext from
   plaintext and generating authentication information for that
   ciphertext.  In this context, confidentiality applies to the contents
   of target data and does not extend to hiding the fact that
   confidentiality exists in the bundle.

   NOTE: Hop-by-hop authentication is NOT a supported security service
   in this specification, for two reasons:

   1.  The term "hop-by-hop" is ambiguous in a BP overlay, as nodes that
       are adjacent in the overlay may not be adjacent in physical
       connectivity.  This condition is difficult or impossible to
       detect; therefore, hop-by-hop authentication is difficult or
       impossible to enforce.

   2.  Hop-by-hop authentication cannot be deployed in a network if
       adjacent nodes in the network have incompatible security
       capabilities.

1.2.  Specification Scope

   This document defines the security services provided by the BPSec.
   This includes the data specification for representing these services
   as BP extension blocks and the rules for adding, removing, and
   processing these blocks at various points during the bundle's
   traversal of a delay-tolerant network.

   BPSec addresses only the security of data traveling over the DTN, not
   the underlying DTN itself.  Furthermore, while the BPSec protocol can
   provide security-at-rest in a store-carry-forward network, it does
   not address threats that share computing resources with the DTN and/
   or BPSec software implementations.  These threats may be malicious
   software or compromised libraries that intend to intercept data or
   recover cryptographic material.  Here, it is the responsibility of
   the BPSec implementer to ensure that any cryptographic material,
   including shared secrets or private keys, is protected against access
   within both memory and storage devices.

   Completely trusted networks are extremely uncommon.  Among untrusted
   networks, different networking conditions and operational
   considerations require security mechanisms of varying strengths.
   Mandating a single security context, which is a set of assumptions,
   algorithms, configurations, and policies used to implement security
   services, may result in too much security for some networks and too
   little security in others.  Default security contexts are defined in
   [RFC9173] to provide basic security services for interoperability
   testing and for operational use on the terrestrial Internet.  It is
   expected that separate documents will define different security
   contexts for use in different networks.

   This specification addresses neither the fitness of externally
   defined cryptographic methods nor the security of their
   implementation.

   This specification does not address the implementation of security
   policies and does not provide a security policy for the BPSec.
   Similar to cipher suites, security policies are based on the nature
   and capabilities of individual networks and network operational
   concepts.  This specification does provide policy considerations that
   can be taken into account when building a security policy.

   With the exception of the Bundle Protocol, this specification does
   not address how to combine the BPSec security blocks with other
   protocols, other BP extension blocks, or other best practices to
   achieve security in any particular network implementation.

1.3.  Related Documents

   This document is best read and understood within the context of the
   following other DTN documents:

   *  "Delay-Tolerant Networking Architecture" [RFC4838] defines the
      architecture for DTN and identifies certain security assumptions
      made by existing Internet protocols that are not valid in DTN.

   *  "Bundle Protocol Version 7" [RFC9171] defines the format and
      processing of bundles, the extension block format used to
      represent BPSec security blocks, and the canonical block structure
      used by this specification.

   *  "Concise Binary Object Representation (CBOR)" [RFC8949] defines a
      data format that allows for small code size, fairly small message
      size, and extensibility without version negotiation.  The block-
      type-specific data associated with BPSec security blocks is
      encoded in this data format.

   *  "Bundle Security Protocol Specification" [RFC6257] introduces the
      concept of using BP extension blocks for security services in DTN.
      BPSec is a continuation and refinement of this document.

1.4.  Terminology

   The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
   "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and
   "OPTIONAL" in this document are to be interpreted as described in
   BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all
   capitals, as shown here.

   This section defines terminology that either is unique to the BPSec
   or is necessary for understanding the concepts defined in this
   specification.

   Bundle Destination:  the Bundle Protocol Agent (BPA) that receives a
      bundle and delivers the payload of the bundle to an Application
      Agent.  Also, an endpoint comprising the node(s) at which the
      bundle is to be delivered.  The bundle destination acts as the
      security acceptor for every security target in every security
      block in every bundle it receives.

   Bundle Source:  the BPA that originates a bundle.  Also, any node ID
      of the node of which the BPA is a component.

   Cipher Suite:  a set of one or more algorithms providing integrity
      and/or confidentiality services.  Cipher suites may define user
      parameters (e.g., secret keys to use), but they do not provide
      values for those parameters.

   Forwarder:  any BPA that transmits a bundle in DTN.  Also, any node
      ID of the node of which the BPA that sent the bundle on its most
      recent hop is a component.

   Intermediate Receiver, Waypoint, or Next Hop:  any BPA that receives
      a bundle from a forwarder that is not the bundle destination.
      Also, any node ID of the node of which the BPA is a component.

   Path:  the ordered sequence of nodes through which a bundle passes on
      its way from source to destination.  The path is not necessarily
      known in advance by the bundle or any BPAs in DTN.

   Security Acceptor:  a BPA that processes and dispositions one or more
      security blocks in a bundle.  Security acceptors act as the
      endpoint of a security service represented in a security block.
      They remove the security blocks they act upon as part of
      processing and disposition.  Also, any node ID of the node of
      which the BPA is a component.

   Security Block:  a BPSec extension block in a bundle.

   Security Context:  the set of assumptions, algorithms,
      configurations, and policies used to implement security services.

   Security Operation:  the application of a given security service to a
      security target, notated as OP(security service, security target).
      For example, OP(bcb-confidentiality, payload).  Every security
      operation in a bundle MUST be unique, meaning that a given
      security service can only be applied to a security target once in
      a bundle.  A security operation is implemented by a security
      block.

   Security Service:  a process that gives some protection to a security
      target.  For example, this specification defines security services
      for plaintext integrity (bib-integrity) and authenticated
      plaintext confidentiality with additional authenticated data (bcb-
      confidentiality).

   Security Source:  a BPA that adds a security block to a bundle.
      Also, any node ID of the node of which the BPA is a component.

   Security Target:  the block within a bundle that receives a security
      service as part of a security operation.

   Security Verifier:  a BPA that verifies the data integrity of one or
      more security blocks in a bundle.  Unlike security acceptors,
      security verifiers do not act as the endpoint of a security
      service, and they do not remove verified security blocks.  Also,
      any node ID of the node of which the BPA is a component.

2.  Design Decisions

   The application of security services in DTN is a complex endeavor
   that must consider physical properties of the network (such as
   connectivity and propagation times), policies at each node,
   application security requirements, and current and future threat
   environments.  This section identifies those desirable properties
   that guide design decisions for this specification and that are
   necessary for understanding the format and behavior of the BPSec
   protocol.

2.1.  Block-Level Granularity

   Security services within this specification must allow different
   blocks within a bundle to have different security services applied to
   them.

   Blocks within a bundle represent different types of information.  The
   primary block contains identification and routing information.  The
   payload block carries application data.  Extension blocks carry a
   variety of data that may augment or annotate the payload or that
   otherwise provide information necessary for the proper processing of
   a bundle along a path.  Therefore, applying a single level and type
   of security across an entire bundle fails to recognize that blocks in
   a bundle represent different types of information with different
   security needs.

   For example, a payload block might be encrypted to protect its
   contents and an extension block containing summary information
   related to the payload might be integrity signed but unencrypted to
   provide waypoints access to payload-related data without providing
   access to the payload.

2.2.  Multiple Security Sources

   A bundle can have multiple security blocks, and these blocks can have
   different security sources.  BPSec implementations MUST NOT assume
   that all blocks in a bundle have the same security operations applied
   to them.

   The Bundle Protocol allows extension blocks to be added to a bundle
   at any time during its existence in DTN.  When a waypoint adds a new
   extension block to a bundle, that extension block MAY have security
   services applied to it by that waypoint.  Similarly, a waypoint MAY
   add a security service to an existing block, consistent with its
   security policy.

   When a waypoint adds a security service to the bundle, the waypoint
   is the security source for that service.  The security block(s) that
   represent that service in the bundle may need to record this security
   source, as the bundle destination might need this information for
   processing.

   For example, a bundle source may choose to apply an integrity service
   to its plaintext payload.  Later a waypoint node, representing a
   gateway to another portion of the delay-tolerant network, may receive
   the bundle and choose to apply a confidentiality service.  In this
   case, the integrity security source is the bundle source and the
   confidentiality security source is the waypoint node.

   In cases where the security source and security acceptor are not the
   bundle source and bundle destination, respectively, it is possible
   that the bundle will reach the bundle destination prior to reaching a
   security acceptor.  In cases where this may be a practical problem,
   it is recommended that solutions such as bundle encapsulation be used
   to ensure that a bundle be delivered to a security acceptor prior to
   being delivered to the bundle destination.  Generally, if a bundle
   reaches a waypoint that has the appropriate configuration and policy
   to act as a security acceptor for a security service in the bundle,
   then the waypoint should act as that security acceptor.

2.3.  Mixed Security Policy

   The security policy enforced by nodes in the delay-tolerant network
   may differ.

   Some waypoints will have security policies that require the waypoint
   to evaluate security services even if the waypoint is neither the
   bundle destination nor the final intended acceptor of the service.
   For example, a waypoint could choose to verify an integrity service
   even though the waypoint is not the bundle destination and the
   integrity service will be needed by other nodes along the bundle's
   path.

   Some waypoints will determine, through policy, that they are the
   intended recipient of the security service and will terminate the
   security service in the bundle.  For example, a gateway node could
   determine that, even though it is not the destination of the bundle,
   it should verify and remove a particular integrity service or attempt
   to decrypt a confidentiality service, before forwarding the bundle
   along its path.

   Some waypoints could understand security blocks but refuse to process
   them unless they are the bundle destination.

2.4.  User-Defined Security Contexts

   A security context is the set of assumptions, algorithms,
   configurations, and policies used to implement security services.
   Different contexts may specify different algorithms, different
   polices, or different configuration values used in the implementation
   of their security services.  BPSec provides a mechanism to define
   security contexts.  Users may select from registered security
   contexts and customize those contexts through security context
   parameters.

   For example, some users might prefer a SHA2 hash function for
   integrity, whereas other users might prefer a SHA3 hash function.
   Providing either separate security contexts or a single,
   parameterized security context allows users flexibility in applying
   the desired cipher suite, policy, and configuration when populating a
   security block.

2.5.  Deterministic Processing

   Whenever a node determines that it must process more than one
   security block in a received bundle (either because the policy at a
   waypoint states that it should process security blocks or because the
   node is the bundle destination), the order in which security blocks
   are processed must be deterministic.  All nodes must impose this same
   deterministic processing order for all security blocks.  This
   specification provides determinism in the application and evaluation
   of security services, even when doing so results in a loss of
   flexibility.

3.  Security Blocks

3.1.  Block Definitions

   This specification defines two types of security block: the Block
   Integrity Block (BIB) and the Block Confidentiality Block (BCB).

   *  The BIB is used to ensure the integrity of its plaintext security
      target(s).  The integrity information in the BIB MAY be verified
      by any node along the bundle path from the BIB security source to
      the bundle destination.  Waypoints add or remove BIBs from bundles
      in accordance with their security policy.  BIBs are never used for
      integrity protection of the ciphertext provided by a BCB.  Because
      security policy at BPSec nodes may differ regarding integrity
      verification, BIBs do not guarantee hop-by-hop authentication, as
      discussed in Section 1.1.

   *  The BCB indicates that the security target or targets have been
      encrypted at the BCB security source in order to protect their
      content while in transit.  As a matter of security policy, the BCB
      is decrypted by security acceptor nodes in the network, up to and
      including the bundle destination.  BCBs additionally provide
      integrity-protection mechanisms for the ciphertext they generate.

3.2.  Uniqueness

   Security operations in a bundle MUST be unique; the same security
   service MUST NOT be applied to a security target more than once in a
   bundle.  Since a security operation is represented by a security
   block, this means that multiple security blocks of the same type
   cannot share the same security targets.  A new security block MUST
   NOT be added to a bundle if a preexisting security block of the same
   type is already defined for the security target of the new security
   block.

   This uniqueness requirement ensures that there is no ambiguity
   related to the order in which security blocks are processed or how
   security policy can be specified to require certain security services
   be present in a bundle.

   Using the notation OP(service, target), several examples illustrate
   this uniqueness requirement.

   Signing the payload twice:  The two operations OP(bib-integrity,
      payload) and OP(bib-integrity, payload) are redundant and MUST NOT
      both be present in the same bundle at the same time.

   Signing different blocks:  The two operations OP(bib-integrity,
      payload) and OP(bib-integrity, extension_block_1) are not
      redundant and both may be present in the same bundle at the same
      time.  Similarly, the two operations OP(bib-integrity,
      extension_block_1) and OP(bib-integrity, extension_block_2) are
      also not redundant and may both be present in the bundle at the
      same time.

   Different services on same block:  The two operations OP(bib-
      integrity, payload) and OP(bcb-confidentiality, payload) are not
      inherently redundant and may both be present in the bundle at the
      same time, pursuant to other processing rules in this
      specification.

   Different services from different block types:  The notation
      OP(service, target) refers specifically to a security block, as
      the security block is the embodiment of a security service applied
      to a security target in a bundle.  Were some Other Security Block
      (OSB) to be defined providing an integrity service, then the
      operations OP(bib-integrity, target) and OP(osb-integrity, target)
      MAY both be present in the same bundle if so allowed by the
      definition of the OSB, as discussed in Section 10.

   NOTES:

   *  A security block may be removed from a bundle as part of security
      processing at a waypoint node with a new security block being
      added to the bundle by that node.  In this case, conflicting
      security blocks never coexist in the bundle at the same time and
      the uniqueness requirement is not violated.

   *  A ciphertext integrity-protection mechanism (such as associated
      authenticated data) calculated by a cipher suite and transported
      in a BCB is considered part of the confidentiality service;
      therefore, it is unique from the plaintext integrity service
      provided by a BIB.

   *  The security blocks defined in this specification (BIB and BCB)
      are designed with the intention that the BPA adding these blocks
      is the authoritative source of the security service.  If a BPA
      adds a BIB on a security target, then the BIB is expected to be
      the authoritative source of integrity for that security target.
      If a BPA adds a BCB to a security target, then the BCB is expected
      to be the authoritative source of confidentiality for that
      security target.  More complex scenarios, such as having multiple
      nodes in a network sign the same security target, can be
      accommodated using the definition of custom security contexts (see
      Section 9) and/or the definition of OSBs (see Section 10).

3.3.  Target Multiplicity

   A single security block MAY represent multiple security operations as
   a way of reducing the overall number of security blocks present in a
   bundle.  In these circumstances, reducing the number of security
   blocks in the bundle reduces the amount of redundant information in
   the bundle.

   A set of security operations can be represented by a single security
   block when all of the following conditions are true.

   *  The security operations apply the same security service.  For
      example, they are all integrity operations or all confidentiality
      operations.

   *  The security context parameters for the security operations are
      identical.

   *  The security source for the security operations is the same,
      meaning the set of operations are being added by the same node.

   *  No security operations have the same security target, as that
      would violate the need for security operations to be unique.

   *  None of the security operations conflict with security operations
      already present in the bundle.

   When representing multiple security operations in a single security
   block, the information that is common across all operations is
   represented once in the security block; the information that is
   different (e.g., the security targets) is represented individually.

   If a node processes any security operation in a security block, it is
   RECOMMENDED that it process all security operations in the security
   block.  This allows security sources to assert that the set of
   security operations in a security block are expected to be processed
   by the same security acceptor.  However, the determination of whether
   a node actually is a security acceptor or not is a matter of the
   policy of the node itself.  In cases where a receiving node
   determines that it is the security acceptor of only a subset of the
   security operations in a security block, the node may choose to only
   process that subset of security operations.

3.4.  Target Identification

   A security target is a block in the bundle to which a security
   service applies.  This target must be uniquely and unambiguously
   identifiable when processing a security block.  The definition of the
   extension block header from [RFC9171] provides a "block number" field
   suitable for this purpose.  Therefore, a security target in a
   security block MUST be represented as the block number of the target
   block.

3.5.  Block Representation

   Each security block uses the Canonical Bundle Block Format as defined
   in [RFC9171].  That is, each security block is comprised of the
   following elements:

   *  block type code
   *  block number
   *  block processing control flags
   *  cyclic redundancy check (CRC) type
   *  block-type-specific data
   *  CRC field (if present)

   Security-specific information for a security block is captured in the
   block-type-specific data field.

3.6.  Abstract Security Block

   The structure of the security-specific portions of a security block
   is identical for both the BIB and BCB block types.  Therefore, this
   section defines an Abstract Security Block (ASB) data structure and
   discusses its definition, its processing, and other constraints for
   using this structure.  An ASB is never directly instantiated within a
   bundle, it is only a mechanism for discussing the common aspects of
   BIB and BCB security blocks.

   The fields of the ASB SHALL be as follows, listed in the order in
   which they must appear.  The encoding of these fields MUST be in
   accordance with the canonical forms provided in Section 4.

   Security Targets:
         This field identifies the block(s) targeted by the security
         operation(s) represented by this security block.  Each target
         block is represented by its unique block number.  This field
         SHALL be represented by a Concise Binary Object Representation
         (CBOR) array of data items.  Each target within this CBOR array
         SHALL be represented by a CBOR unsigned integer.  This array
         MUST have at least one entry and each entry MUST represent the
         block number of a block that exists in the bundle.  There MUST
         NOT be duplicate entries in this array.  The order of elements
         in this list has no semantic meaning outside of the context of
         this block.  Within the block, the ordering of targets must
         match the ordering of results associated with these targets.

   Security Context Id:
         This field identifies the security context used to implement
         the security service represented by this block and applied to
         each security target.  This field SHALL be represented by a
         CBOR unsigned integer.  The values for this Id should come from
         the registry defined in Section 11.3.

   Security Context Flags:
         This field identifies which optional fields are present in the
         security block.  This field SHALL be represented as a CBOR
         unsigned integer whose contents shall be interpreted as a bit
         field.  Each bit in this bit field indicates the presence (bit
         set to 1) or absence (bit set to 0) of optional data in the
         security block.  The association of bits to security block data
         is defined as follows.

         Bit 0     (the least-significant bit, 0x01): "Security context
                   parameters present" flag.

         Bit >0    Reserved

         Implementations MUST set reserved bits to 0 when writing this
         field and MUST ignore the values of reserved bits when reading
         this field.  For unreserved bits, a value of 1 indicates that
         the associated security block field MUST be included in the
         security block.  A value of 0 indicates that the associated
         security block field MUST NOT be in the security block.

   Security Source:
         This field identifies the BPA that inserted the security block
         in the bundle.  Also, any node ID of the node of which the BPA
         is a component.  This field SHALL be represented by a CBOR
         array in accordance with the rules in [RFC9171] for
         representing endpoint IDs (EIDs).

   Security Context Parameters (Optional):
         This field captures one or more security context parameters
         that should be used when processing the security service
         described by this security block.  This field SHALL be
         represented by a CBOR array.  Each entry in this array is a
         single security context parameter.  A single parameter SHALL
         also be represented as a CBOR array comprising a 2-tuple of the
         Id and value of the parameter, as follows.

         Parameter Id:  This field identifies which parameter is being
            specified.  This field SHALL be represented as a CBOR
            unsigned integer.  Parameter Ids are selected as described
            in Section 3.10.

         Parameter Value:  This field captures the value associated with
            this parameter.  This field SHALL be represented by the
            applicable CBOR representation of the parameter, in
            accordance with Section 3.10.

         The logical layout of the parameters array is illustrated in
         Figure 1.

           +----------------+----------------+     +----------------+
           |  Parameter 1   |  Parameter 2   | ... |  Parameter N   |
           +------+---------+------+---------+     +------+---------+
           |  Id  |  Value  |  Id  |  Value  |     |  Id  |  Value  |
           +------+---------+------+---------+     +------+---------+

                      Figure 1: Security Context Parameters

   Security Results:
         This field captures the results of applying a security service
         to the security targets of the security block.  This field
         SHALL be represented as a CBOR array of target results.  Each
         entry in this array represents the set of security results for
         a specific security target.  The target results MUST be ordered
         identically to the Security Targets field of the security
         block.  This means that the first set of target results in this
         array corresponds to the first entry in the Security Targets
         field of the security block, and so on.  There MUST be one
         entry in this array for each entry in the Security Targets
         field of the security block.

         The set of security results for a target is also represented as
         a CBOR array of individual results.  An individual result is
         represented as a CBOR array comprising a 2-tuple of a result Id
         and a result value, defined as follows.

         Result Id:  This field identifies which security result is
            being specified.  Some security results capture the primary
            output of a cipher suite.  Other security results contain
            additional annotative information from cipher suite
            processing.  This field SHALL be represented as a CBOR
            unsigned integer.  Security result Ids will be as specified
            in Section 3.10.

         Result Value:  This field captures the value associated with
            the result.  This field SHALL be represented by the
            applicable CBOR representation of the result value, in
            accordance with Section 3.10.

         The logical layout of the security results array is illustrated
         in Figure 2.  In this figure, there are N security targets for
         this security block.  The first security target contains M
         results and the Nth security target contains K results.

         +--------------------------+     +---------------------------+
         |          Target 1        |     |         Target N          |
         +----------+----+----------+     +---------------------------+
         | Result 1 |    | Result M | ... | Result 1 |    |  Result K |
         +----+-----+ .. +----+-----+     +---+------+ .. +----+------+
         | Id |Value|    | Id |Value|     | Id |Value|    | Id | Value|
         +----+-----+    +----+-----+     +----+-----+    +----+------+

                            Figure 2: Security Results

3.7.  Block Integrity Block

   A BIB is a BP extension block with the following characteristics.

   *  The block type code value is as specified in Section 11.1.

   *  The block-type-specific data field follows the structure of the
      ASB.

   *  A security target listed in the Security Targets field MUST NOT
      reference a security block defined in this specification (e.g., a
      BIB or a BCB).

   *  The security context MUST utilize an authentication mechanism or
      an error detection mechanism.

   Notes:

   *  Designers SHOULD carefully consider the effect of setting flags
      that either discard the block or delete the bundle in the event
      that this block cannot be processed.

   *  Since OP(bib-integrity, target) is allowed only once in a bundle
      per target, it is RECOMMENDED that users wishing to support
      multiple integrity-protection mechanisms for the same target
      define a multi-result security context.  Such a context could
      generate multiple security results for the same security target
      using different integrity-protection mechanisms or different
      configurations for the same integrity-protection mechanism.

   *  A BIB is used to verify the plaintext integrity of its security
      target.  However, a single BIB MAY include security results for
      blocks other than its security target when doing so establishes a
      needed relationship between the BIB security target and other
      blocks in the bundle (such as the primary block).

   *  Security information MAY be checked at any hop on the way to the
      bundle destination that has access to the required keying
      information, in accordance with Section 3.9.

3.8.  Block Confidentiality Block

   A BCB is a BP extension block with the following characteristics.

   *  The block type code value is as specified in Section 11.1.

   *  The block processing control flags value can be set to whatever
      values are required by local policy with the following exceptions:

      -  BCBs MUST have the "Block must be replicated in every fragment"
         flag set if one of the targets is the payload block.  Having
         that BCB in each fragment indicates to a receiving node that
         the payload portion of each fragment represents ciphertext.

      -  BCBs MUST NOT have the "Block must be removed from bundle if it
         can't be processed" flag set.  Removing a BCB from a bundle
         without decrypting its security targets removes information
         from the bundle necessary for their later decryption.

   *  The block-type-specific data fields follow the structure of the
      ASB.

   *  A security target listed in the Security Targets field can
      reference the payload block, a non-security extension block, or a
      BIB.  A BCB MUST NOT include another BCB as a security target.  A
      BCB MUST NOT target the primary block.  A BCB MUST NOT target a
      BIB unless it shares a security target with that BIB.

   *  Any security context used by a BCB MUST utilize a confidentiality
      cipher that provides authenticated encryption with associated data
      (AEAD).

   *  Additional information created by a cipher suite (such as an
      authentication tag) can be placed either in a security result
      field or in the generated ciphertext.  The determination of where
      to place this information is a function of the cipher suite and
      security context used.

   The BCB modifies the contents of its security target(s).  When a BCB
   is applied, the security target body data are encrypted "in-place".
   Following encryption, the security target block-type-specific data
   field contains ciphertext, not plaintext.

   Notes:

   *  It is RECOMMENDED that designers carefully consider the effect of
      setting flags that delete the bundle in the event that this block
      cannot be processed.

   *  The BCB block processing control flags can be set independently
      from the processing control flags of the security target(s).  The
      setting of such flags should be an implementation/policy decision
      for the encrypting node.

3.9.  Block Interactions

   The security block types defined in this specification are designed
   to be as independent as possible.  However, there are some cases
   where security blocks may share a security target; this sharing
   creates processing dependencies.

   If a BCB and a BIB share a security target, an undesirable condition
   occurs: a waypoint would be unable to validate the BIB because the
   shared security target has been encrypted by the BCB.  To address
   this situation, the following processing rules MUST be followed:

   *  When adding a BCB to a bundle, if some (or all) of the security
      targets of the BCB match all of the security targets of an
      existing BIB, then the existing BIB MUST also be encrypted.  This
      can be accomplished either by adding a new BCB that targets the
      existing BIB or by adding the BIB to the list of security targets
      for the BCB.  Deciding which way to represent this situation is a
      matter of security policy.

   *  When adding a BCB to a bundle, if some (or all) of the security
      targets of the BCB match some (but not all) of the security
      targets of a BIB, then that BIB MUST be altered in the following
      way.  Any security results in the BIB associated with the BCB
      security targets MUST be removed from the BIB and placed in a new
      BIB.  This newly created BIB MUST then be encrypted.  The
      encryption of the new BIB can be accomplished either by adding a
      new BCB that targets the new BIB or by adding the new BIB to the
      list of security targets for the BCB.  Deciding which way to
      represent this situation is a matter of security policy.

   *  A BIB MUST NOT be added for a security target that is already the
      security target of a BCB as this would cause ambiguity in block
      processing order.

   *  A BIB integrity value MUST NOT be checked if the BIB is the
      security target of an existing BCB.  In this case, the BIB data is
      encrypted.

   *  A BIB integrity value MUST NOT be checked if the security target
      associated with that value is also the security target of a BCB.
      In such a case, the security target data contains ciphertext as it
      has been encrypted.

   *  As mentioned in Section 3.7, a BIB MUST NOT have a BCB as its
      security target.

   These restrictions on block interactions impose a necessary ordering
   when applying security operations within a bundle.  Specifically, for
   a given security target, BIBs MUST be added before BCBs.  This
   ordering MUST be preserved in cases where the current BPA is adding
   all of the security blocks for the bundle or where the BPA is a
   waypoint adding new security blocks to a bundle that already contains
   security blocks.

   In cases where a security source wishes to calculate both a plaintext
   integrity-protection mechanism and encrypt a security target, a BCB
   with a security context that generates an integrity-protection
   mechanism as one or more additional security results MUST be used
   instead of adding both a BIB and then a BCB for the security target
   at the security source.

3.10.  Parameter and Result Identification

   Each security context MUST define its own context parameters and
   results.  Each defined parameter and result is represented as the
   tuple of an identifier and a value.  Identifiers are always
   represented as a CBOR unsigned integer.  The CBOR encoding of values
   is as defined by the security context specification.

   Identifiers MUST be unique for a given security context but do not
   need to be unique amongst all security contexts.

   An example of a security context can be found in [RFC9173].

3.11.  BPSec Block Examples

   This section provides two examples of BPSec blocks applied to
   bundles.  In the first example, a single node adds several security
   operations to a bundle.  In the second example, a waypoint node
   received the bundle created in the first example and adds additional
   security operations.  In both examples, the first column represents
   blocks within a bundle and the second column represents the block
   number for the block, using the terminology B1...Bn for the purpose
   of illustration.

3.11.1.  Example 1: Constructing a Bundle with Security

   In this example, a bundle has four non-security-related blocks: the
   primary block (B1), two extension blocks (B4, B5), and a payload
   block (B6).  The bundle source wishes to provide an integrity
   signature of the plaintext associated with the primary block, the
   second extension block, and the payload.  The bundle source also
   wishes to provide confidentiality for the first extension block.  The
   resultant bundle is illustrated in Figure 3 and the security actions
   are described below.

                           Block in Bundle                ID
             +==========================================+====+
             |              Primary Block               | B1 |
             +------------------------------------------+----+
             |                    BIB                   | B2 |
             |   OP(bib-integrity, targets = B1, B5, B6)|    |
             +------------------------------------------+----+
             |                    BCB                   | B3 |
             |    OP(bcb-confidentiality, target = B4)  |    |
             +------------------------------------------+----+
             |       Extension Block (encrypted)        | B4 |
             +------------------------------------------+----+
             |              Extension Block             | B5 |
             +------------------------------------------+----+
             |               Payload Block              | B6 |
             +------------------------------------------+----+

                   Figure 3: Security at Bundle Creation

   The following security actions were applied to this bundle at its
   time of creation.

   *  An integrity signature applied to the canonical form of the
      primary block (B1), the canonical form of the block-type-specific
      data field of the second extension block (B5), and the canonical
      form of the payload block (B6).  This is accomplished by a single
      BIB (B2) with multiple targets.  A single BIB is used in this case
      because all three targets share a security source, security
      context, and security context parameters.  Had this not been the
      case, multiple BIBs could have been added instead.

   *  Confidentiality for the first extension block (B4).  This is
      accomplished by a BCB (B3).  Once applied, the block-type-specific
      data field of extension block B4 is encrypted.  The BCB MUST hold
      an authentication tag for the ciphertext either in the ciphertext
      that now populates the first extension block or as a security
      result in the BCB itself, depending on which security context is
      used to form the BCB.  A plaintext integrity signature may also
      exist as a security result in the BCB if one is provided by the
      selected confidentiality security context.

3.11.2.  Example 2: Adding More Security at a New Node

   Consider that the bundle as it is illustrated in Figure 3 is now
   received by a waypoint node that wishes to encrypt the second
   extension block and the bundle payload.  The waypoint security policy
   is to allow existing BIBs for these blocks to persist, as they may be
   required as part of the security policy at the bundle destination.

   The resultant bundle is illustrated in Figure 4 and the security
   actions are described below.  Note that block IDs provided here are
   ordered solely for the purpose of this example and are not meant to
   impose an ordering for block creation.  The ordering of blocks added
   to a bundle MUST always be in compliance with [RFC9171].

                           Block in Bundle                ID
             +==========================================+====+
             |              Primary Block               | B1 |
             +------------------------------------------+----+
             |                    BIB                   | B2 |
             |      OP(bib-integrity, target = B1)      |    |
             +------------------------------------------+----+
             |                    BIB (encrypted)       | B7 |
             |      OP(bib-integrity, targets = B5, B6) |    |
             +------------------------------------------+----+
             |                    BCB                   | B8 |
             |OP(bcb-confidentiality,targets = B5,B6,B7)|    |
             +------------------------------------------+----+
             |                    BCB                   | B3 |
             |    OP(bcb-confidentiality, target = B4)  |    |
             +------------------------------------------+----+
             |       Extension Block (encrypted)        | B4 |
             +------------------------------------------+----+
             |       Extension Block (encrypted)        | B5 |
             +------------------------------------------+----+
             |         Payload Block (encrypted)        | B6 |
             +------------------------------------------+----+

                  Figure 4: Security at Bundle Forwarding

   The following security actions were applied to this bundle prior to
   its forwarding from the waypoint node.

   *  Since the waypoint node wishes to encrypt the block-type-specific
      data field of blocks B5 and B6, it MUST also encrypt the block-
      type-specific data field of the BIBs providing plaintext integrity
      over those blocks.  However, BIB B2 could not be encrypted in its
      entirety because it also held a signature for the primary block
      (B1).  Therefore, a new BIB (B7) is created and security results
      associated with B5 and B6 are moved out of BIB B2 and into BIB B7.

   *  Now that there is no longer confusion about which plaintext
      integrity signatures must be encrypted, a BCB is added to the
      bundle with the security targets being the second extension block
      (B5) and the payload (B6) as well as the newly created BIB holding
      their plaintext integrity signatures (B7).  A single new BCB is
      used in this case because all three targets share a security
      source, security context, and security context parameters.  Had
      this not been the case, multiple BCBs could have been added
      instead.

4.  Canonical Forms

   Security services require consistency and determinism in how
   information is presented to cipher suites at security sources,
   verifiers, and acceptors.  For example, integrity services require
   that the same target information (e.g., the same bits in the same
   order) is provided to the cipher suite when generating an original
   signature and when validating a signature.  Canonicalization
   algorithms transcode the contents of a security target into a
   canonical form.

   Canonical forms are used to generate input to a security context for
   security processing at a BP node.  If the values of a security target
   are unchanged, then the canonical form of that target will be the
   same even if the encoding of those values for wire transmission is
   different.

   BPSec operates on data fields within bundle blocks (e.g., the block-
   type-specific data field).  In their canonical form, these fields
   MUST include their own CBOR encoding and MUST NOT include any other
   encapsulating CBOR encoding.  For example, the canonical form of the
   block-type-specific data field is a CBOR byte string existing within
   the CBOR array containing the fields of the extension block.  The
   entire CBOR byte string is considered the canonical block-type-
   specific data field.  The CBOR array framing is not considered part
   of the field.

   The canonical form of the primary block is as specified in [RFC9171]
   with the following constraint.

   *  CBOR values from the primary block MUST be canonicalized using the
      rules for Deterministically Encoded CBOR, as specified in
      [RFC8949].

   All non-primary blocks share the same block structure and are
   canonicalized as specified in [RFC9171] with the following
   constraints.

   *  CBOR values from the non-primary block MUST be canonicalized using
      the rules for Deterministically Encoded CBOR, as specified in
      [RFC8949].

   *  Only the block-type-specific data field may be provided to a
      cipher suite for encryption as part of a confidentiality security
      service.  Other fields within a non-primary block MUST NOT be
      encrypted or decrypted and MUST NOT be included in the canonical
      form used by the cipher suite for encryption and decryption.  An
      integrity-protection mechanism MAY be applied to these other
      fields as supported by the security context.  For example, these
      fields might be treated as associated authenticated data.

   *  Reserved and unassigned flags in the block processing control
      flags field MUST be set to 0 in a canonical form as it is not
      known if those flags will change in transit.

   Security contexts MAY define their own canonicalization algorithms
   and require the use of those algorithms over the ones provided in
   this specification.  In the event of conflicting canonicalization
   algorithms, algorithms defined in a security context take precedence
   over this specification when constructing canonical forms for that
   security context.

5.  Security Processing

   This section describes the security aspects of bundle processing.

5.1.  Bundles Received from Other Nodes

   Security blocks must be processed in a specific order when received
   by a BP node.  The processing order is as follows.

   *  When BIBs and BCBs share a security target, BCBs MUST be evaluated
      first and BIBs second.

5.1.1.  Receiving BCBs

   If a received bundle contains a BCB, the receiving node MUST
   determine whether it is the security acceptor for any of the security
   operations in the BCB.  If so, the node MUST process those operations
   and remove any operation-specific information from the BCB prior to
   delivering data to an application at the node or forwarding the
   bundle.  If processing a security operation fails, the target SHALL
   be processed according to the security policy.  A bundle status
   report indicating the failure MAY be generated.  When all security
   operations for a BCB have been removed from the BCB, the BCB MUST be
   removed from the bundle.

   If the receiving node is the destination of the bundle, the node MUST
   decrypt any BCBs remaining in the bundle.  If the receiving node is
   not the destination of the bundle, the node MUST process the BCB if
   directed to do so as a matter of security policy.

   If the security policy of a node specifies that a node should have
   applied confidentiality to a specific security target and no such BCB
   is present in the bundle, then the node MUST process this security
   target in accordance with the security policy.  It is RECOMMENDED
   that the node remove the security target from the bundle because the
   confidentiality (and possibly the integrity) of the security target
   cannot be guaranteed.  If the removed security target is the payload
   block, the bundle MUST be discarded.

   If an encrypted payload block cannot be decrypted (i.e., the
   ciphertext cannot be authenticated), then the bundle MUST be
   discarded and processed no further.  If an encrypted security target
   other than the payload block cannot be decrypted, then the associated
   security target and all security blocks associated with that target
   MUST be discarded and processed no further.  In both cases, requested
   status reports (see [RFC9171]) MAY be generated to reflect bundle or
   block deletion.

   When a BCB is decrypted, the recovered plaintext for each security
   target MUST replace the ciphertext in each of the security targets'
   block-type-specific data fields.  If the plaintext is of a different
   size than the ciphertext, the framing of the CBOR byte string of this
   field must be updated to ensure this field remains a valid CBOR byte
   string.  The length of the recovered plaintext is known by the
   decrypting security context.

   If a BCB contains multiple security operations, each operation
   processed by the node MUST be treated as if the security operation
   has been represented by a single BCB with a single security operation
   for the purposes of report generation and policy processing.

5.1.2.  Receiving BIBs

   If a received bundle contains a BIB, the receiving node MUST
   determine whether it is the security acceptor for any of the security
   operations in the BIB.  If so, the node MUST process those operations
   and remove any operation-specific information from the BIB prior to
   delivering data to an application at the node or forwarding the
   bundle.  If processing a security operation fails, the target SHALL
   be processed according to the security policy.  A bundle status
   report indicating the failure MAY be generated.  When all security
   operations for a BIB have been removed from the BIB, the BIB MUST be
   removed from the bundle.

   A BIB MUST NOT be processed if the security target of the BIB is also
   the security target of a BCB in the bundle.  Given the order of
   operations mandated by this specification, when both a BIB and a BCB
   share a security target, it means that the security target must have
   been encrypted after it was integrity signed; therefore, the BIB
   cannot be verified until the security target has been decrypted by
   processing the BCB.

   If the security policy of a node specifies that a node should have
   applied integrity to a specific security target and no such BIB is
   present in the bundle, then the node MUST process this security
   target in accordance with the security policy.  It is RECOMMENDED
   that the node remove the security target from the bundle if the
   security target is not the payload or primary block.  If the security
   target is the payload or primary block, the bundle MAY be discarded.
   This action can occur at any node that has the ability to verify an
   integrity signature, not just the bundle destination.

   If a receiving node is not the security acceptor of a security
   operation in a BIB, it MAY attempt to verify the security operation
   anyway to prevent forwarding corrupt data.  If the verification
   fails, the node SHALL process the security target in accordance with
   local security policy.  If a payload integrity check fails at a
   waypoint, it is RECOMMENDED that it be processed in the same way as a
   failure of a payload integrity check at the bundle destination.  If
   the check passes, the node MUST NOT remove the security operation
   from the BIB prior to forwarding.

   If a BIB contains multiple security operations, each operation
   processed by the node MUST be treated as if the security operation
   has been represented by a single BIB with a single security operation
   for the purposes of report generation and policy processing.

5.2.  Bundle Fragmentation and Reassembly

   If it is necessary for a node to fragment a bundle payload, and
   security services have been applied to that bundle, the fragmentation
   rules described in [RFC9171] MUST be followed.  As defined there and
   summarized here for completeness, only the payload block can be
   fragmented; security blocks, like all extension blocks, can never be
   fragmented.

   Due to the complexity of payload-block fragmentation, including the
   possibility of fragmenting payload-block fragments, integrity and
   confidentiality operations are not to be applied to a bundle
   representing a fragment.  Specifically, a BCB or BIB MUST NOT be
   added to a bundle if the "Bundle is a fragment" flag is set in the
   bundle processing control flags field.

   Security processing in the presence of payload-block fragmentation
   may be handled by other mechanisms outside of the BPSec protocol or
   by applying BPSec blocks in coordination with an encapsulation
   mechanism.  A node should apply any confidentiality protection prior
   to performing any fragmentation.

6.  Key Management

   There exists a myriad of ways to establish, communicate, and
   otherwise manage key information in DTN.  Certain DTN deployments
   might follow established protocols for key management, whereas other
   DTN deployments might require new and novel approaches.  BPSec
   assumes that key management is handled as a separate part of network
   management; this specification neither defines nor requires a
   specific strategy for key management.

7.  Security Policy Considerations

   When implementing BPSec, several policy decisions must be considered.
   This section describes key policies that affect the generation,
   forwarding, and receipt of bundles that are secured using this
   specification.  No single set of policy decisions is envisioned to
   work for all secure DTN deployments.

   *  If a bundle is received that contains combinations of security
      operations that are disallowed by this specification, the BPA must
      determine how to handle the bundle: the bundle may be discarded,
      the block affected by the security operation may be discarded, or
      one security operation may be favored over another.

   *  BPAs in the network must understand what security operations they
      should apply to bundles.  This decision may be based on the source
      of the bundle, the destination of the bundle, or some other
      information related to the bundle.

   *  If a waypoint has been configured to add a security operation to a
      bundle, and the received bundle already has the security operation
      applied, then the receiver must understand what to do.  The
      receiver may discard the bundle, discard the security target and
      associated BPSec blocks, replace the security operation, or take
      some other action.

   *  It is RECOMMENDED that security operations be applied to every
      block in a bundle and that the default behavior of a BPA be to use
      the security services defined in this specification.  Designers
      should only deviate from the use of security operations when the
      deviation can be justified -- such as when doing so causes
      downstream errors when processing blocks whose contents must be
      inspected or changed at one or more hops along the path.

   *  BCB security contexts can alter the size of extension blocks and
      the payload block.  Security policy SHOULD consider how changes to
      the size of a block could negatively effect bundle processing
      (e.g., calculating storage needs and scheduling transmission
      times).

   *  Adding a BIB to a security target that has already been encrypted
      by a BCB is not allowed.  If this condition is likely to be
      encountered, there are (at least) three possible policies that
      could handle this situation.

      1.  At the time of encryption, a security context can be selected
          that computes a plaintext integrity-protection mechanism that
          is included as a security context result field.

      2.  The encrypted block may be replicated as a new block with a
          new block number and may be given integrity protection.

      3.  An encapsulation scheme may be applied to encapsulate the
          security target (or the entire bundle) such that the
          encapsulating structure is, itself, no longer the security
          target of a BCB and may therefore be the security target of a
          BIB.

   *  Security policy SHOULD address whether cipher suites whose
      ciphertext is larger than the initial plaintext are permitted and,
      if so, for what types of blocks.  Changing the size of a block may
      cause processing difficulties for networks that calculate block
      offsets into bundles or predict transmission times or storage
      availability as a function of bundle size.  In other cases,
      changing the size of a payload as part of encryption has no
      significant impact.

7.1.  Security Reason Codes

   BPAs must process blocks and bundles in accordance with both BP
   policy and BPSec policy.  The decision to receive, forward, deliver,
   or delete a bundle may be communicated to the report-to address of
   the bundle in the form of a status report, as a method of tracking
   the progress of the bundle through the network.  The status report
   for a bundle may be augmented with a "reason code" explaining why the
   particular action was taken on the bundle.

   This section describes a set of reason codes associated with the
   security processing of a bundle.  The communication of security-
   related status reports might reduce the security of a network if
   these reports are intercepted by unintended recipients.  BPSec policy
   SHOULD specify the conditions in which sending security reason codes
   are appropriate.  Examples of appropriate conditions for the use of
   security reason codes could include the following.

   *  When the report-to address is verified as unchanged from the
      bundle source.  This can occur by placing an appropriate BIB on
      the bundle primary block.

   *  When the block containing a status report with a security reason
      code is encrypted by a BCB.

   *  When a status report containing a security reason code is only
      sent for security issues relating to bundles and/or blocks
      associated with non-operational user data or test data.

   *  When a status report containing a security reason code is only
      sent for security issues associated with non-operational security
      contexts, or security contexts using non-operational
      configurations, such as test keys.

   Security reason codes are assigned in accordance with Section 11.2
   and are as described below.

   Missing security operation:
         This reason code indicates that a bundle was missing one or
         more required security operations.  This reason code is
         typically used by a security verifier or security acceptor.

   Unknown security operation:
         This reason code indicates that one or more security operations
         present in a bundle cannot be understood by the security
         verifier or security acceptor for the operation.  For example,
         this reason code may be used if a security block references an
         unknown security context identifier or security context
         parameter.  This reason code should not be used for security
         operations for which the node is not a security verifier or
         security acceptor; there is no requirement that all nodes in a
         network understand all security contexts, security context
         parameters, and security services for every bundle in a
         network.

   Unexpected security operation:
         This reason code indicates that a receiving node is neither a
         security verifier nor a security acceptor for at least one
         security operation in a bundle.  This reason code should not be
         seen as an error condition: not every node is a security
         verifier or security acceptor for every security operation in
         every bundle.  In certain networks, this reason code may be
         useful in identifying misconfigurations of security policy.

   Failed security operation:
         This reason code indicates that one or more security operations
         in a bundle failed to process as expected for reasons other
         than misconfiguration.  This may occur when a security-source
         is unable to add a security block to a bundle.  This may occur
         if the target of a security operation fails to verify using the
         defined security context at a security verifier.  This may also
         occur if a security operation fails to be processed without
         error at a security acceptor.

   Conflicting security operation:
         This reason code indicates that two or more security operations
         in a bundle are not conformant with the BPSec specification and
         that security processing was unable to proceed because of a
         BPSec protocol violation.

8.  Security Considerations

   Given the nature of DTN applications, it is expected that bundles may
   traverse a variety of environments and devices that each pose unique
   security risks and requirements on the implementation of security
   within BPSec.  For this reason, it is important to introduce key
   threat models and describe the roles and responsibilities of the
   BPSec protocol in protecting the confidentiality and integrity of the
   data against those threats.  This section provides additional
   discussion on security threats that BPSec will face and describes how
   BPSec security mechanisms operate to mitigate these threats.

   The threat model described here is assumed to have a set of
   capabilities identical to those described by the Internet Threat
   Model in [RFC3552], but the BPSec threat model is scoped to
   illustrate threats specific to BPSec operating within DTN
   environments; therefore, it focuses on on-path attackers (OPAs).  In
   doing so, it is assumed that the delay-tolerant network (or
   significant portions of the delay-tolerant network) are completely
   under the control of an attacker.

8.1.  Attacker Capabilities and Objectives

   BPSec was designed to protect against OPA threats that may have
   access to a bundle during transit from its source, Alice, to its
   destination, Bob.  An OPA node, Olive, is a noncooperative node
   operating on the delay-tolerant network between Alice and Bob that
   has the ability to receive bundles, examine bundles, modify bundles,
   forward bundles, and generate bundles at will in order to compromise
   the confidentiality or integrity of data within the delay-tolerant
   network.  There are three classes of OPA nodes that are
   differentiated based on their access to cryptographic material:

   Unprivileged Node:  Olive has not been provisioned within the secure
      environment and only has access to cryptographic material that has
      been publicly shared.

   Legitimate Node:  Olive is within the secure environment; therefore,
      Olive has access to cryptographic material that has been
      provisioned to Olive (i.e., K_M) as well as material that has been
      publicly shared.

   Privileged Node:  Olive is a privileged node within the secure
      environment; therefore, Olive has access to cryptographic material
      that has been provisioned to Olive, Alice, and/or Bob (i.e., K_M,
      K_A, and/or K_B) as well as material that has been publicly
      shared.

   If Olive is operating as a privileged node, this is tantamount to
   compromise; BPSec does not provide mechanisms to detect or remove
   Olive from the delay-tolerant network or BPSec secure environment.
   It is up to the BPSec implementer or the underlying cryptographic
   mechanisms to provide appropriate capabilities if they are needed.
   It should also be noted that if the implementation of BPSec uses a
   single set of shared cryptographic material for all nodes, a
   legitimate node is equivalent to a privileged node because K_M == K_A
   == K_B.  For this reason, sharing cryptographic material in this way
   is not recommended.

   A special case of the legitimate node is when Olive is either Alice
   or Bob (i.e., K_M == K_A or K_M == K_B).  In this case, Olive is able
   to impersonate traffic as either Alice or Bob, respectively, which
   means that traffic to and from that node can be decrypted and
   encrypted, respectively.  Additionally, messages may be signed as
   originating from one of the endpoints.

8.2.  Attacker Behaviors and BPSec Mitigations

8.2.1.  Eavesdropping Attacks

   Once Olive has received a bundle, she is able to examine the contents
   of that bundle and attempt to recover any protected data or
   cryptographic keying material from the blocks contained within.  The
   protection mechanism that BPSec provides against this action is the
   BCB, which encrypts the contents of its security target, providing
   confidentiality of the data.  Of course, it should be assumed that
   Olive is able to attempt offline recovery of encrypted data, so the
   cryptographic mechanisms selected to protect the data should provide
   a suitable level of protection.

   When evaluating the risk of eavesdropping attacks, it is important to
   consider the lifetime of bundles on DTN.  Depending on the network,
   bundles may persist for days or even years.  Long-lived bundles imply
   that the data exists in the network for a longer period of time and,
   thus, there may be more opportunities to capture those bundles.
   Additionally, the implication is that long-lived bundles store
   information within that remains relevant and sensitive for long
   enough that, once captured, there is sufficient time to crack
   encryption associated with the bundle.  If a bundle does persist on
   the network for years and the cipher suite used for a BCB provides
   inadequate protection, Olive may be able to recover the protected
   data either before that bundle reaches its intended destination or
   before the information in the bundle is no longer considered
   sensitive.

   NOTE: Olive is not limited by the bundle lifetime and may retain a
   given bundle indefinitely.

   NOTE: Irrespective of whether BPSec is used, traffic analysis will be
   possible.

8.2.2.  Modification Attacks

   As a node participating in the delay-tolerant network between Alice
   and Bob, Olive will also be able to modify the received bundle,
   including non-BPSec data such as the primary block, payload blocks,
   or block processing control flags as defined in [RFC9171].  Olive
   will be able to undertake activities including modification of data
   within the blocks, replacement of blocks, addition of blocks, or
   removal of blocks.  Within BPSec, both the BIB and BCB provide
   integrity-protection mechanisms to detect or prevent data
   manipulation attempts by Olive.

   The BIB provides that protection to another block that is its
   security target.  The cryptographic mechanisms used to generate the
   BIB should be strong against collision attacks, and Olive should not
   have access to the cryptographic material used by the originating
   node to generate the BIB (e.g., K_A).  If both of these conditions
   are true, Olive will be unable to modify the security target or the
   BIB, and thus she cannot lead Bob to validate the security target as
   originating from Alice.

   Since BPSec security operations are implemented by placing blocks in
   a bundle, there is no in-band mechanism for detecting or correcting
   certain cases where Olive removes blocks from a bundle.  If Olive
   removes a BCB, but keeps the security target, the security target
   remains encrypted and there is a possibility that there may no longer
   be sufficient information to decrypt the block at its destination.
   If Olive removes both a BCB (or BIB) and its security target, there
   is no evidence left in the bundle of the security operation.
   Similarly, if Olive removes the BIB, but not the security target,
   there is no evidence left in the bundle of the security operation.
   In each of these cases, the implementation of BPSec must be combined
   with policy configuration at endpoints in the network that describe
   the expected and required security operations that must be applied on
   transmission and that are expected to be present on receipt.  This or
   other similar out-of-band information is required to correct for
   removal of security information in the bundle.

   A limitation of the BIB may exist within the implementation of BIB
   validation at the destination node.  If Olive is a legitimate node
   within the delay-tolerant network, the BIB generated by Alice with
   K_A can be replaced with a new BIB generated with K_M and forwarded
   to Bob.  If Bob is only validating that the BIB was generated by a
   legitimate user, Bob will acknowledge the message as originating from
   Olive instead of Alice.  Validating a BIB indicates only that the BIB
   was generated by a holder of the relevant key; it does not provide
   any guarantee that the bundle or block was created by the same
   entity.  In order to provide verifiable integrity checks, the BCB
   should require an encryption scheme that is Indistinguishable under
   adaptive Chosen Ciphertext Attack (IND-CCA2) secure.  Such an
   encryption scheme will guard against signature substitution attempts
   by Olive.  In this case, Alice creates a BIB with the protected data
   block as the security target and then creates a BCB with both the BIB
   and protected data block as its security targets.

8.2.3.  Topology Attacks

   If Olive is in an OPA position within the delay-tolerant network, she
   is able to influence how any bundles that come to her may pass
   through the network.  Upon receiving and processing a bundle that
   must be routed elsewhere in the network, Olive has three options as
   to how to proceed: not forward the bundle, forward the bundle as
   intended, or forward the bundle to one or more specific nodes within
   the network.

   Attacks that involve rerouting the bundles throughout the network are
   essentially a special case of the modification attacks described in
   this section, one where the attacker is modifying fields within the
   primary block of the bundle.  Given that BPSec cannot encrypt the
   contents of the primary block, alternate methods must be used to
   prevent this situation.  These methods may include requiring BIBs for
   primary blocks, using encapsulation, or otherwise strategically
   manipulating primary block data.  The details of any such mitigation
   technique are specific to the implementation of the deploying network
   and are outside of the scope of this document.

   Furthermore, routing rules and policies may be useful in enforcing
   particular traffic flows to prevent topology attacks.  While these
   rules and policies may utilize some features provided by BPSec, their
   definition is beyond the scope of this specification.

8.2.4.  Message Injection

   Olive is also able to generate new bundles and transmit them into the
   delay-tolerant network at will.  These bundles may be either 1)
   copies or slight modifications of previously observed bundles (i.e.,
   a replay attack) or 2) entirely new bundles generated based on the
   Bundle Protocol, BPSec, or other bundle-related protocols.  With
   these attacks, Olive's objectives may vary, but may be targeting
   either the Bundle Protocol or application-layer protocols conveyed by
   the Bundle Protocol.  The target could also be the storage and
   computing capabilities of the nodes running the bundle or
   application-layer protocols (e.g., a denial of service to flood on
   the storage of the store-and-forward mechanism or a computation that
   would process the bundles and perhaps prevent other activities).

   BPSec relies on cipher suite capabilities to prevent replay or forged
   message attacks.  A BCB used with appropriate cryptographic
   mechanisms may provide replay protection under certain circumstances.
   Alternatively, application data itself may be augmented to include
   mechanisms to assert data uniqueness and then be protected with a
   BIB, a BCB, or both along with other block data.  In such a case, the
   receiving node would be able to validate the uniqueness of the data.

   For example, a BIB may be used to validate the integrity of a
   bundle's primary block, which includes a timestamp and lifetime for
   the bundle.  If a bundle is replayed outside of its lifetime, then
   the replay attack will fail as the bundle will be discarded.
   Similarly, additional blocks, such as the Bundle Age, may be signed
   and validated to identify replay attacks.  Finally, security context
   parameters within BIBs and BCBs may include anti-replay mechanisms
   such as session identifiers, nonces, and dynamic passwords as
   supported by network characteristics.

9.  Security Context Considerations

9.1.  Mandating Security Contexts

   Because of the diversity of networking scenarios and node
   capabilities that may utilize BPSec, there is a risk that a single
   security context mandated for every possible BPSec implementation is
   not feasible.  For example, a security context appropriate for a
   resource-constrained node with limited connectivity may be
   inappropriate for use in a well-resourced, well-connected node.

   This does not mean that the use of BPSec in a particular network is
   meant to happen without security contexts for interoperability and
   default behavior.  Network designers must identify the minimal set of
   security contexts necessary for functions in their network.  For
   example, a default set of security contexts could be created for use
   over the terrestrial Internet, and they could be required by any
   BPSec implementation communicating over the terrestrial Internet.

   To ensure interoperability among various implementations, all BPSec
   implementations MUST support at least the current, mandatory security
   context(s) defined in IETF Standards Track RFCs.  As of this writing,
   that BP mandatory security context is specified in [RFC9173], but the
   mandatory security context(s) might change over time in accordance
   with usual IETF processes.  Such changes are likely to occur in the
   future if/when flaws are discovered in the applicable cryptographic
   algorithms, for example.

   Additionally, BPSec implementations need to support the security
   contexts that are required by the BP networks in which they are
   deployed.

   If a node serves as a gateway between two or more networks, the BPSec
   implementation at that node needs to support the union of security
   contexts mandated in those networks.

   BPSec has been designed to allow for a diversity of security contexts
   and for new contexts to be defined over time.  The use of different
   security contexts does not change the BPSec protocol itself, and the
   definition of new security contexts MUST adhere to the requirements
   of such contexts as presented in this section and generally in this
   specification.

   Implementers should monitor the state of security context
   specifications to check for future updates and replacement.

9.2.  Identification and Configuration

   Security blocks uniquely identify the security context to be used in
   the processing of their security services.  The security context for
   a security block MUST be uniquely identifiable and MAY use parameters
   for customization.

   To reduce the number of security contexts used in a network, security
   context designers should make security contexts customizable through
   the definition of security context parameters.  For example, a single
   security context could be associated with a single cipher suite and
   security context parameters could be used to configure the use of
   this security context with different key lengths and different key
   management options without needing to define separate security
   contexts for each possible option.

   A single security context may be used in the application of more than
   one security service.  This means that a security context identifier
   MAY be used with a BIB, with a BCB, or with any other BPSec-compliant
   security block.  The definition of a security context MUST identify
   which security services may be used with the security context, how
   security context parameters are interpreted as a function of the
   security operation being supported, and which security results are
   produced for each security service.

   Network operators must determine the number, type, and configuration
   of security contexts in a system.  Networks with rapidly changing
   configurations may define relatively few security contexts with each
   context customized with multiple parameters.  For networks with more
   stability, or an increased need for confidentiality, a larger number
   of contexts can be defined with each context supporting few, if any,
   parameters.

   +=============+============+=======================================+
   |   Context   | Parameters |               Definition              |
   |     Type    |            |                                       |
   +=============+============+=======================================+
   |     Key     | Encrypted  |     AES-GCM-256 cipher suite with     |
   |   Exchange  |  Key, IV   | provided ephemeral key encrypted with |
   |     AES     |            |   a predetermined key encryption key  |
   |             |            |  and cleartext initialization vector. |
   +-------------+------------+---------------------------------------+
   |  Pre-Shared |     IV     |     AES-GCM-256 cipher suite with     |
   |   Key AES   |            |  predetermined key and predetermined  |
   |             |            |          key-rotation policy.         |
   +-------------+------------+---------------------------------------+
   | Out-of-Band |    None    |   AES-GCM-256 cipher suite with all   |
   |     AES     |            |          info predetermined.          |
   +-------------+------------+---------------------------------------+

                    Table 1: Security Context Examples

9.3.  Authorship

   Developers or implementers should consider the diverse performance
   and conditions of networks on which the Bundle Protocol (and,
   therefore, BPSec) will operate.  Specifically, the delay and capacity
   of DTNs can vary substantially.  Developers should consider these
   conditions to better describe the conditions in which those contexts
   will operate or exhibit vulnerability, and selection of these
   contexts for implementation should be made with consideration for
   this reality.  There are key differences that may limit the
   opportunity for a security context to leverage existing cipher suites
   and technologies that have been developed for use in more reliable
   networks:

   Data Lifetime:  Depending on the application environment, bundles may
      persist on the network for extended periods of time, perhaps even
      years.  Cryptographic algorithms should be selected to ensure
      protection of data against attacks for a length of time reasonable
      for the application.

   One-Way Traffic:  Depending on the application environment, it is
      possible that only a one-way connection may exist between two
      endpoints, or if a two-way connection does exist, the round-trip
      time may be extremely large.  This may limit the utility of
      session key generation mechanisms, such as Diffie-Hellman, as a
      two-way handshake may not be feasible or reliable.

   Opportunistic Access:  Depending on the application environment, a
      given endpoint may not be guaranteed to be accessible within a
      certain amount of time.  This may make asymmetric cryptographic
      architectures that rely on a key distribution center or other
      trust center impractical under certain conditions.

   When developing security contexts for use with BPSec, the following
   information SHOULD be considered for inclusion in these
   specifications.

   Security Context Parameters:  Security contexts MUST define their
      parameter Ids, the data types of those parameters, and their CBOR
      encoding.

   Security Results:  Security contexts MUST define their security
      result Ids, the data types of those results, and their CBOR
      encoding.

   New Canonicalizations:  Security contexts may define new
      canonicalization algorithms as necessary.

   Ciphertext Size:  Security contexts MUST state whether their
      associated cipher suites generate ciphertext (to include any
      authentication information) that is of a different size than the
      input plaintext.

      If a security context does not wish to alter the size of the
      plaintext, it should place overflow bytes and authentication tags
      in security result fields.

   Block Header Information:  Security contexts SHOULD include block
      header information that is considered to be immutable for the
      block.  This information MAY include the block type code, block
      number, CRC type, and CRC field (if present or if missing and
      unlikely to be added later), and possibly certain block processing
      control flags.  Designers should input these fields as additional
      data for integrity protection when these fields are expected to
      remain unchanged over the path the block will take from the
      security source to the security acceptor.  Security contexts
      considering block header information MUST describe expected
      behavior when these fields fail their integrity verification.

   Handling CRC Fields:  Security contexts may include algorithms that
      alter the contexts of their security target block, such as the
      case when encrypting the block-type-specific data of a target
      block as part of a BCB confidentiality service.  Security context
      specifications SHOULD address how preexisting CRC type and CRC
      value fields be handled.  For example, a BCB security context
      could remove the plaintext CRC value from its target upon
      encryption and replace or recalculate the value upon decryption.

10.  Defining Other Security Blocks

   Other Security Blocks (OSBs) may be defined and used in addition to
   the security blocks identified in this specification.  BIB, BCB, and
   any future OSBs can coexist within a bundle and can be considered in
   conformance with BPSec if all of the following requirements are met
   by any future identified security blocks.

   *  OSBs MUST NOT reuse any enumerations identified in this
      specification, to include the block type codes for BIB and BCB.

   *  An OSB definition MUST state whether it can be the target of a BIB
      or a BCB.  The definition MUST also state whether the OSB can
      target a BIB or a BCB.

   *  An OSB definition MUST provide a deterministic processing order in
      the event that a bundle is received containing BIBs, BCBs, and
      OSBs.  This processing order MUST NOT alter the BIB and BCB
      processing orders identified in this specification.

   *  An OSB definition MUST provide a canonicalization algorithm if the
      default algorithm for non-primary-block canonicalization cannot be
      used to generate a deterministic input for a cipher suite.  This
      requirement can be waived if the OSB is defined so as to never be
      the security target of a BIB or a BCB.

   *  An OSB definition MUST NOT require any behavior of a BPSec BPA
      that is in conflict with the behavior identified in this
      specification.  In particular, the security processing
      requirements imposed by this specification must be consistent
      across all BPSec BPAs in a network.

   *  The behavior of an OSB when dealing with fragmentation must be
      specified and MUST NOT lead to ambiguous processing states.  In
      particular, an OSB definition should address how to receive and
      process an OSB in a bundle fragment that may or may not also
      contain its security target.  An OSB definition should also
      address whether an OSB may be added to a bundle marked as a
      fragment.

   Additionally, policy considerations for the management, monitoring,
   and configuration associated with blocks SHOULD be included in any
   OSB definition.

   NOTE: The burden of showing compliance with processing rules is
   placed upon the specifications defining new security blocks, and the
   identification of such blocks shall not, alone, require maintenance
   of this specification.

11.  IANA Considerations

   This specification includes fields that require registries managed by
   IANA.

11.1.  Bundle Block Types

   This specification allocates two block types from the existing
   "Bundle Block Types" registry defined in [RFC6255].

             +=======+=======================+===============+
             | Value |      Description      |   Reference   |
             +=======+=======================+===============+
             |   11  |    Block Integrity    | This document |
             +-------+-----------------------+---------------+
             |   12  | Block Confidentiality | This document |
             +-------+-----------------------+---------------+

                Table 2: Additional Entries for the "Bundle
                           Block Types" Registry

   The "Bundle Block Types" registry notes whether a block type is meant
   for use in BP version 6, BP version 7 (BPv7), or both.  The two block
   types defined in this specification are meant for use with BPv7.

11.2.  Bundle Status Report Reason Codes

   This specification allocates five reason codes from the existing
   "Bundle Status Report Reason Codes" registry defined in [RFC6255].

   +============+=======+============================+================+
   | BP Version | Value |        Description         |   Reference    |
   +============+=======+============================+================+
   |     7      |   12  | Missing security operation | This document, |
   |            |       |                            |  Section 7.1   |
   +------------+-------+----------------------------+----------------+
   |     7      |   13  | Unknown security operation | This document, |
   |            |       |                            |  Section 7.1   |
   +------------+-------+----------------------------+----------------+
   |     7      |   14  |    Unexpected security     | This document, |
   |            |       |         operation          |  Section 7.1   |
   +------------+-------+----------------------------+----------------+
   |     7      |   15  | Failed security operation  | This document, |
   |            |       |                            |  Section 7.1   |
   +------------+-------+----------------------------+----------------+
   |     7      |   16  |    Conflicting security    | This document, |
   |            |       |         operation          |  Section 7.1   |
   +------------+-------+----------------------------+----------------+

     Table 3: Additional Entries for the "Bundle Status Report Reason
                             Codes" Registry

11.3.  Security Context Identifiers

   BPSec has a Security Context Identifier field for which IANA has
   created a new registry named "BPSec Security Context Identifiers".
   Initial values for this registry are given below.

   The registration policy for this registry is Specification Required
   (see [RFC8126]).

   The value range: signed 16-bit integer.

                  +=======+=============+===============+
                  | Value | Description |   Reference   |
                  +=======+=============+===============+
                  |  < 0  |   Reserved  | This document |
                  +-------+-------------+---------------+
                  |   0   |   Reserved  | This document |
                  +-------+-------------+---------------+

                      Table 4: "BPSec Security Context
                            Identifier" Registry

   Negative security context identifiers are reserved for local/site-
   specific uses.  The use of 0 as a security context identifier is for
   nonoperational testing purposes only.

12.  References

12.1.  Normative References

   [RFC2119]  Bradner, S., "Key words for use in RFCs to Indicate
              Requirement Levels", BCP 14, RFC 2119,
              DOI 10.17487/RFC2119, March 1997,
              <https://www.rfc-editor.org/info/rfc2119>.

   [RFC3552]  Rescorla, E. and B. Korver, "Guidelines for Writing RFC
              Text on Security Considerations", BCP 72, RFC 3552,
              DOI 10.17487/RFC3552, July 2003,
              <https://www.rfc-editor.org/info/rfc3552>.

   [RFC6255]  Blanchet, M., "Delay-Tolerant Networking Bundle Protocol
              IANA Registries", RFC 6255, DOI 10.17487/RFC6255, May
              2011, <https://www.rfc-editor.org/info/rfc6255>.

   [RFC8174]  Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC
              2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174,
              May 2017, <https://www.rfc-editor.org/info/rfc8174>.

   [RFC8949]  Bormann, C. and P. Hoffman, "Concise Binary Object
              Representation (CBOR)", STD 94, RFC 8949,
              DOI 10.17487/RFC8949, December 2020,
              <https://www.rfc-editor.org/info/rfc8949>.

   [RFC9171]  Burleigh, S., Fall, K., and E. Birrane, III, "Bundle
              Protocol Version 7", RFC 9171, DOI 10.17487/RFC9171,
              January 2022, <https://www.rfc-editor.org/info/rfc9171>.

   [RFC9173]  Birrane, III, E., White, A., and S. Heiner, "Default
              Security Contexts for Bundle Protocol Security (BPSec)",
              RFC 9173, DOI 10.17487/RFC9173, January 2022,
              <https://www.rfc-editor.org/info/rfc9173>.

12.2.  Informative References

   [RFC4838]  Cerf, V., Burleigh, S., Hooke, A., Torgerson, L., Durst,
              R., Scott, K., Fall, K., and H. Weiss, "Delay-Tolerant
              Networking Architecture", RFC 4838, DOI 10.17487/RFC4838,
              April 2007, <https://www.rfc-editor.org/info/rfc4838>.

   [RFC6257]  Symington, S., Farrell, S., Weiss, H., and P. Lovell,
              "Bundle Security Protocol Specification", RFC 6257,
              DOI 10.17487/RFC6257, May 2011,
              <https://www.rfc-editor.org/info/rfc6257>.

   [RFC8126]  Cotton, M., Leiba, B., and T. Narten, "Guidelines for
              Writing an IANA Considerations Section in RFCs", BCP 26,
              RFC 8126, DOI 10.17487/RFC8126, June 2017,
              <https://www.rfc-editor.org/info/rfc8126>.

Acknowledgments

   The following participants contributed technical material, use cases,
   and useful thoughts on the overall approach to this security
   specification: Scott Burleigh of the IPNGROUP, Angela Hennessy of the
   Laboratory for Telecommunications Sciences, Amy Alford and Cherita
   Corbett of the Johns Hopkins University Applied Physics Laboratory
   (JHU/APL), and Angela Dalton of AMD Research.

   Additionally, Benjamin Kaduk of Akamai Technologies provided a
   detailed technical review that resulted in a stronger and more
   precise specification.

Authors' Addresses

   Edward J. Birrane, III
   The Johns Hopkins University Applied Physics Laboratory
   11100 Johns Hopkins Rd.
   Laurel, MD 20723
   United States of America

   Phone: +1 443 778 7423
   Email: Edward.Birrane@jhuapl.edu


   Kenneth McKeever
   The Johns Hopkins University Applied Physics Laboratory
   11100 Johns Hopkins Rd.
   Laurel, MD 20723
   United States of America

   Phone: +1 443 778 2237
   Email: Ken.McKeever@jhuapl.edu