Debian Codegraph @

upstream/opensuse-tumbleweed/man7/crypto-policies.7

raw
1 '\" t
2 .\" Title: crypto-policies
3 .\" Author: [see the "AUTHOR" section]
4 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
5 .\" Date: 11/11/2025
6 .\" Manual: \ \&
7 .\" Source: crypto-policies
8 .\" Language: English
9 .\"
10 .TH "CRYPTO\-POLICIES" "7" "11/11/2025" "crypto\-policies" "\ \&"
11 .\" -----------------------------------------------------------------
12 .\" * Define some portability stuff
13 .\" -----------------------------------------------------------------
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15 .\" http://bugs.debian.org/507673
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
18 .ie \n(.g .ds Aq \(aq
19 .el .ds Aq '
20 .\" -----------------------------------------------------------------
21 .\" * set default formatting
22 .\" -----------------------------------------------------------------
23 .\" disable hyphenation
24 .nh
25 .\" disable justification (adjust text to left margin only)
26 .ad l
27 .\" -----------------------------------------------------------------
28 .\" * MAIN CONTENT STARTS HERE *
29 .\" -----------------------------------------------------------------
30 .SH "NAME"
31 crypto-policies \- system\-wide crypto policies overview
32 .SH "DESCRIPTION"
33 .sp
34 The security of cryptographic components of the operating system does not remain constant over time\&. Algorithms, such as cryptographic hashing and encryption, typically have a lifetime, after which they are considered either too risky to use or plain insecure\&. That means, we need to phase out such algorithms from the default settings or completely disable them if they could cause an irreparable problem\&.
35 .sp
36 While in the past the algorithms were not disabled in a consistent way and different applications applied different policies, the system\-wide crypto\-policies followed by the crypto core components allow consistently deprecating and disabling algorithms system\-wide\&.
37 .sp
38 Several preconfigured policies (\fBDEFAULT\fR, \fBLEGACY\fR, \fBFUTURE\fR, and \fBFIPS\fR) and subpolicies are included in the \fBcrypto\-policies(7)\fR package\&. System administrators or third\-party vendors can define custom policies and subpolicies\&.
39 .sp
40 The recommended way to modify the effective configuration is to apply a custom subpolicy on top of a predefined policy\&. This allows configuration to evolve with future updates of the predefined policies keeping desired modification in place\&. Modifying effective configuration by defining a fully custom policy prevents the configuration from evolving with future updates of the predefined policies\&. The syntax to define custom policies and subpolicies is described in the CRYPTO POLICY DEFINITION FORMAT section below\&.
41 .sp
42 For rationale, see \fBRFC 7457\fR for a list of attacks taking advantage of legacy crypto algorithms\&.
43 .SH "COVERED APPLICATIONS"
44 .sp
45 Crypto\-policies apply to the configuration of the core cryptographic subsystems, covering \fBTLS\fR, \fBIKE\fR, \fBIPSec\fR, \fBDNSSec\fR, and \fBKerberos\fR protocols; i\&.e\&., the supported secure communications protocols on the base operating system\&.
46 .sp
47 Once an application runs in the operating system, it follows the default or selected policy and refuses to fall back to algorithms and protocols not within the policy, unless the user has explicitly requested the application to do so\&. That is, the policy applies to the default behavior of applications when running with the system\-provided configuration but the user can override it on an application\-specific basis\&.
48 .sp
49 The policies currently provide settings for these applications and libraries:
50 .sp
51 .RS 4
52 .ie n \{\
53 \h'-04'\(bu\h'+03'\c
54 .\}
55 .el \{\
56 .sp -1
57 .IP \(bu 2.3
58 .\}
59 \fBBIND\fR
60 DNS name server daemon (scopes:
61 \fBBIND\fR,
62 \fBDNSSec\fR)
63 .RE
64 .sp
65 .RS 4
66 .ie n \{\
67 \h'-04'\(bu\h'+03'\c
68 .\}
69 .el \{\
70 .sp -1
71 .IP \(bu 2.3
72 .\}
73 \fBGnuTLS\fR
74 TLS library (scopes:
75 \fBGnuTLS\fR,
76 \fBSSL\fR,
77 \fBTLS\fR)
78 .RE
79 .sp
80 .RS 4
81 .ie n \{\
82 \h'-04'\(bu\h'+03'\c
83 .\}
84 .el \{\
85 .sp -1
86 .IP \(bu 2.3
87 .\}
88 \fBOpenJDK\fR
89 runtime environment (scopes:
90 \fBjava\-tls\fR,
91 \fBSSL\fR,
92 \fBTLS\fR)
93 .RE
94 .sp
95 .RS 4
96 .ie n \{\
97 \h'-04'\(bu\h'+03'\c
98 .\}
99 .el \{\
100 .sp -1
101 .IP \(bu 2.3
102 .\}
103 \fBKerberos 5\fR
104 library (scopes:
105 \fBkrb5\fR,
106 \fBKerberos\fR)
107 .RE
108 .sp
109 .RS 4
110 .ie n \{\
111 \h'-04'\(bu\h'+03'\c
112 .\}
113 .el \{\
114 .sp -1
115 .IP \(bu 2.3
116 .\}
117 \fBLibreswan\fR
118 IPsec and IKE protocol implementation (scopes:
119 \fBlibreswan\fR,
120 \fBIPSec\fR,
121 \fBIKE\fR)
122 .RE
123 .sp
124 .RS 4
125 .ie n \{\
126 \h'-04'\(bu\h'+03'\c
127 .\}
128 .el \{\
129 .sp -1
130 .IP \(bu 2.3
131 .\}
132 \fBNSS\fR
133 TLS library (scopes:
134 \fBNSS\fR; specific algorithm usage purposes are also affected by
135 \fBSSL\fR,
136 \fBTLS\fR,
137 \fBpkcs12\fR,
138 \fBpkcs12\-import\fR,
139 \fBsmime\fR,
140 \fBsmime\-import\fR
141 scopes, and internal use
142 \fBnss\-tls\fR,
143 \fBnss\-pkcs12\fR,
144 \fBnss\-pkcs12\-import\fR,
145 \fBnss\-smime\fR
146 and
147 \fBnss\-smime\-import\fR
148 scopes\&.)
149 .RE
150 .sp
151 .RS 4
152 .ie n \{\
153 \h'-04'\(bu\h'+03'\c
154 .\}
155 .el \{\
156 .sp -1
157 .IP \(bu 2.3
158 .\}
159 \fBOpenSSH\fR
160 SSH2 protocol implementation (scopes:
161 \fBOpenSSH\fR,
162 \fBSSH\fR)
163 .RE
164 .sp
165 .RS 4
166 .ie n \{\
167 \h'-04'\(bu\h'+03'\c
168 .\}
169 .el \{\
170 .sp -1
171 .IP \(bu 2.3
172 .\}
173 \fBOpenSSL\fR
174 TLS library (scopes:
175 \fBOpenSSL\fR,
176 \fBSSL\fR,
177 \fBTLS\fR)
178 .RE
179 .sp
180 .RS 4
181 .ie n \{\
182 \h'-04'\(bu\h'+03'\c
183 .\}
184 .el \{\
185 .sp -1
186 .IP \(bu 2.3
187 .\}
188 \fBlibssh\fR
189 SSH2 protocol implementation (scopes:
190 \fBlibssh\fR,
191 \fBSSH\fR)
192 .RE
193 .sp
194 .RS 4
195 .ie n \{\
196 \h'-04'\(bu\h'+03'\c
197 .\}
198 .el \{\
199 .sp -1
200 .IP \(bu 2.3
201 .\}
202 \fBsequoia\fR
203 PGP implementation, for usage outside of rpm\-sequoia (scopes:
204 \fBsequoia\fR)
205 .RE
206 .sp
207 .RS 4
208 .ie n \{\
209 \h'-04'\(bu\h'+03'\c
210 .\}
211 .el \{\
212 .sp -1
213 .IP \(bu 2.3
214 .\}
215 \fBrpm\-sequoia\fR
216 RPM Sequoia PGP backend (scopes:
217 \fBrpm\fR,
218 \fBrpm\-sequoia\fR)
219 .RE
220 .sp
221 Applications using the above libraries and tools are covered by the cryptographic policies unless they are explicitly configured otherwise\&.
222 .SH "PROVIDED POLICIES"
223 .PP
224 \fBLEGACY\fR
225 .RS 4
226 This policy ensures maximum compatibility with legacy systems; it is less secure and it includes support for
227 \fBTLS 1\&.0\fR,
228 \fBTLS 1\&.1\fR, and
229 \fBSSH2\fR
230 protocols or later\&. The algorithms
231 \fBDSA\fR
232 and
233 \fB3DES\fR
234 are allowed, while
235 \fBRSA\fR
236 and
237 \fBDiffie\-Hellman\fR
238 parameters are accepted if larger than 1024 bits\&. This policy provides at least 64\-bit security\&.
239 .sp
240 .RS 4
241 .ie n \{\
242 \h'-04'\(bu\h'+03'\c
243 .\}
244 .el \{\
245 .sp -1
246 .IP \(bu 2.3
247 .\}
248 MACs: all
249 \fBHMAC\fR
250 with
251 \fBSHA\-1\fR
252 or better + all modern MACs (\fBPoly1305\fR
253 etc\&.)
254 .RE
255 .sp
256 .RS 4
257 .ie n \{\
258 \h'-04'\(bu\h'+03'\c
259 .\}
260 .el \{\
261 .sp -1
262 .IP \(bu 2.3
263 .\}
264 Curves: all prime >= 255 bits (including Bernstein curves)
265 .RE
266 .sp
267 .RS 4
268 .ie n \{\
269 \h'-04'\(bu\h'+03'\c
270 .\}
271 .el \{\
272 .sp -1
273 .IP \(bu 2.3
274 .\}
275 Signature algorithms: with
276 \fBSHA1\fR
277 hash or better (\fBDSA\fR
278 allowed)
279 .RE
280 .sp
281 .RS 4
282 .ie n \{\
283 \h'-04'\(bu\h'+03'\c
284 .\}
285 .el \{\
286 .sp -1
287 .IP \(bu 2.3
288 .\}
289 \fBTLS\fR
290 Ciphers: all available >= 112\-bit key, >= 128\-bit block (including
291 \fB3DES\fR, excluding
292 \fBRC4\fR)
293 .RE
294 .sp
295 .RS 4
296 .ie n \{\
297 \h'-04'\(bu\h'+03'\c
298 .\}
299 .el \{\
300 .sp -1
301 .IP \(bu 2.3
302 .\}
303 Non\-TLS Ciphers: same as
304 \fBTLS\fR
305 ciphers with added
306 \fBCamellia\fR
307 .RE
308 .sp
309 .RS 4
310 .ie n \{\
311 \h'-04'\(bu\h'+03'\c
312 .\}
313 .el \{\
314 .sp -1
315 .IP \(bu 2.3
316 .\}
317 Key exchange:
318 \fBECDHE\fR,
319 \fBRSA\fR,
320 \fBDHE\fR
321 .RE
322 .sp
323 .RS 4
324 .ie n \{\
325 \h'-04'\(bu\h'+03'\c
326 .\}
327 .el \{\
328 .sp -1
329 .IP \(bu 2.3
330 .\}
331 \fBDH\fR
332 params size: >= 1024
333 .RE
334 .sp
335 .RS 4
336 .ie n \{\
337 \h'-04'\(bu\h'+03'\c
338 .\}
339 .el \{\
340 .sp -1
341 .IP \(bu 2.3
342 .\}
343 \fBRSA\fR
344 keys size: >= 1024
345 .RE
346 .sp
347 .RS 4
348 .ie n \{\
349 \h'-04'\(bu\h'+03'\c
350 .\}
351 .el \{\
352 .sp -1
353 .IP \(bu 2.3
354 .\}
355 \fBDSA\fR
356 params size: >= 1024
357 .RE
358 .sp
359 .RS 4
360 .ie n \{\
361 \h'-04'\(bu\h'+03'\c
362 .\}
363 .el \{\
364 .sp -1
365 .IP \(bu 2.3
366 .\}
367 \fBTLS\fR
368 protocols:
369 \fBTLS\fR
370 >= 1\&.0,
371 \fBDTLS\fR
372 >= 1\&.0
373 .RE
374 .RE
375 .PP
376 \fBDEFAULT\fR
377 .RS 4
378 The
379 \fBDEFAULT\fR
380 policy is a reasonable default policy for today\(cqs standards\&. It allows the
381 \fBTLS 1\&.2\fR, and
382 \fBTLS 1\&.3\fR
383 protocols, as well as
384 \fBIKEv2\fR
385 and
386 \fBSSH2\fR\&. The
387 \fBDiffie\-Hellman\fR
388 parameters are accepted if they are at least 2048 bits long\&. This policy provides at least 112\-bit security with the exception of allowing
389 \fBSHA\-1\fR
390 signatures in DNSSec where they are still prevalent\&.
391 .sp
392 .RS 4
393 .ie n \{\
394 \h'-04'\(bu\h'+03'\c
395 .\}
396 .el \{\
397 .sp -1
398 .IP \(bu 2.3
399 .\}
400 MACs: all
401 \fBHMAC\fR
402 with
403 \fBSHA\-1\fR
404 or better + all modern MACs (\fBPoly1305\fR
405 etc\&.)
406 .RE
407 .sp
408 .RS 4
409 .ie n \{\
410 \h'-04'\(bu\h'+03'\c
411 .\}
412 .el \{\
413 .sp -1
414 .IP \(bu 2.3
415 .\}
416 Curves: all prime >= 255 bits (including Bernstein curves)
417 .RE
418 .sp
419 .RS 4
420 .ie n \{\
421 \h'-04'\(bu\h'+03'\c
422 .\}
423 .el \{\
424 .sp -1
425 .IP \(bu 2.3
426 .\}
427 Signature algorithms: with
428 \fBSHA\-224\fR
429 hash or better (no
430 \fBDSA\fR)
431 .RE
432 .sp
433 .RS 4
434 .ie n \{\
435 \h'-04'\(bu\h'+03'\c
436 .\}
437 .el \{\
438 .sp -1
439 .IP \(bu 2.3
440 .\}
441 \fBTLS\fR
442 Ciphers: >= 128\-bit key, >= 128\-bit block (\fBAES\fR,
443 \fBChaCha20\fR, including
444 \fBAES\-CBC\fR)
445 .RE
446 .sp
447 .RS 4
448 .ie n \{\
449 \h'-04'\(bu\h'+03'\c
450 .\}
451 .el \{\
452 .sp -1
453 .IP \(bu 2.3
454 .\}
455 non\-TLS Ciphers: as
456 \fBTLS\fR
457 Ciphers with added
458 \fBCamellia\fR
459 .RE
460 .sp
461 .RS 4
462 .ie n \{\
463 \h'-04'\(bu\h'+03'\c
464 .\}
465 .el \{\
466 .sp -1
467 .IP \(bu 2.3
468 .\}
469 key exchange:
470 \fBECDHE\fR,
471 \fBRSA\fR,
472 \fBDHE\fR
473 (no
474 \fBDHE\-DSS\fR)
475 .RE
476 .sp
477 .RS 4
478 .ie n \{\
479 \h'-04'\(bu\h'+03'\c
480 .\}
481 .el \{\
482 .sp -1
483 .IP \(bu 2.3
484 .\}
485 \fBDH\fR
486 params size: >= 2048
487 .RE
488 .sp
489 .RS 4
490 .ie n \{\
491 \h'-04'\(bu\h'+03'\c
492 .\}
493 .el \{\
494 .sp -1
495 .IP \(bu 2.3
496 .\}
497 \fBRSA\fR
498 keys size: >= 2048
499 .RE
500 .sp
501 .RS 4
502 .ie n \{\
503 \h'-04'\(bu\h'+03'\c
504 .\}
505 .el \{\
506 .sp -1
507 .IP \(bu 2.3
508 .\}
509 \fBTLS\fR
510 protocols:
511 \fBTLS\fR
512 >= 1\&.2,
513 \fBDTLS\fR
514 >= 1\&.2
515 .RE
516 .RE
517 .PP
518 \fBNEXT\fR
519 .RS 4
520 The
521 \fBNEXT\fR
522 policy is just an alias to the
523 \fBDEFAULT\fR
524 policy\&.
525 .RE
526 .PP
527 \fBFUTURE\fR
528 .RS 4
529 A conservative security policy that is believed to withstand any near\-term future attacks at the expense of interoperability\&. It may prevent communication with many commonly used systems that only offer weaker security\&. This policy does not allow the use of
530 \fBSHA\-1\fR
531 in signature algorithms\&. The policy also provides some (not complete) preparation for post\-quantum encryption support in form of 256\-bit symmetric encryption requirement\&. The
532 \fBRSA\fR
533 and
534 \fBDiffie\-Hellman\fR
535 parameters are accepted if larger than 3071 bits\&. This policy provides at least 128\-bit security\&.
536 .sp
537 .RS 4
538 .ie n \{\
539 \h'-04'\(bu\h'+03'\c
540 .\}
541 .el \{\
542 .sp -1
543 .IP \(bu 2.3
544 .\}
545 MACs: all
546 \fBHMAC\fR
547 with
548 \fBSHA\-256\fR
549 or better + all modern MACs (\fBPoly1305\fR
550 etc\&.)
551 .RE
552 .sp
553 .RS 4
554 .ie n \{\
555 \h'-04'\(bu\h'+03'\c
556 .\}
557 .el \{\
558 .sp -1
559 .IP \(bu 2.3
560 .\}
561 Curves: all prime >= 255 bits (including Bernstein curves)
562 .RE
563 .sp
564 .RS 4
565 .ie n \{\
566 \h'-04'\(bu\h'+03'\c
567 .\}
568 .el \{\
569 .sp -1
570 .IP \(bu 2.3
571 .\}
572 Signature algorithms: with
573 \fBSHA\-256\fR
574 hash or better (no
575 \fBDSA\fR)
576 .RE
577 .sp
578 .RS 4
579 .ie n \{\
580 \h'-04'\(bu\h'+03'\c
581 .\}
582 .el \{\
583 .sp -1
584 .IP \(bu 2.3
585 .\}
586 \fBTLS\fR
587 Ciphers: >= 256\-bit key, >= 128\-bit block, only Authenticated Encryption (AE) ciphers
588 .RE
589 .sp
590 .RS 4
591 .ie n \{\
592 \h'-04'\(bu\h'+03'\c
593 .\}
594 .el \{\
595 .sp -1
596 .IP \(bu 2.3
597 .\}
598 non\-TLS Ciphers: same as
599 \fBTLS\fR
600 ciphers with added non AE ciphers and
601 \fBCamellia\fR
602 .RE
603 .sp
604 .RS 4
605 .ie n \{\
606 \h'-04'\(bu\h'+03'\c
607 .\}
608 .el \{\
609 .sp -1
610 .IP \(bu 2.3
611 .\}
612 key exchange:
613 \fBECDHE\fR,
614 \fBDHE\fR
615 (no
616 \fBDHE\-DSS\fR, no
617 \fBRSA\fR)
618 .RE
619 .sp
620 .RS 4
621 .ie n \{\
622 \h'-04'\(bu\h'+03'\c
623 .\}
624 .el \{\
625 .sp -1
626 .IP \(bu 2.3
627 .\}
628 \fBDH\fR
629 params size: >= 3072
630 .RE
631 .sp
632 .RS 4
633 .ie n \{\
634 \h'-04'\(bu\h'+03'\c
635 .\}
636 .el \{\
637 .sp -1
638 .IP \(bu 2.3
639 .\}
640 \fBRSA\fR
641 keys size: >= 3072
642 .RE
643 .sp
644 .RS 4
645 .ie n \{\
646 \h'-04'\(bu\h'+03'\c
647 .\}
648 .el \{\
649 .sp -1
650 .IP \(bu 2.3
651 .\}
652 \fBTLS\fR
653 protocols:
654 \fBTLS\fR
655 >= 1\&.2,
656 \fBDTLS\fR
657 >= 1\&.2
658 .RE
659 .RE
660 .PP
661 \fBBSI\fR
662 .RS 4
663 A security policy based on recommendations by the german government agency BSI (Bundesamt fuer Sicherheit in der Informationstechnik, translated as "agency for security in software technology") in its ruleset BSI TR 02102 (TR \- technical recommendation)\&. The BSI TR 02102 standard is updated in regular intervals\&.
664 .sp
665 .if n \{\
666 .RS 4
667 .\}
668 .nf
669 This policy does not allow the use of *SHA\-1* in signature algorithms
670 (except *DNSSEC* and *RPM*)\&.
671 .fi
672 .if n \{\
673 .RE
674 .\}
675 .sp
676 .if n \{\
677 .RS 4
678 .\}
679 .nf
680 The policy also provides some (not complete) preparation for
681 post\-quantum encryption support in form of 256\-bit symmetric encryption
682 requirement\&.
683 .fi
684 .if n \{\
685 .RE
686 .\}
687 .sp
688 .if n \{\
689 .RS 4
690 .\}
691 .nf
692 The *RSA* parameters are accepted if larger than 2047 bits, and
693 *Diffie\-Hellman* parameters are accepted if larger than 3071 bits\&.
694 .fi
695 .if n \{\
696 .RE
697 .\}
698 .sp
699 .if n \{\
700 .RS 4
701 .\}
702 .nf
703 This policy provides at least 128\-bit security, excepting the transition
704 of *RSA*\&.
705 .fi
706 .if n \{\
707 .RE
708 .\}
709 .sp
710 .RS 4
711 .ie n \{\
712 \h'-04'\(bu\h'+03'\c
713 .\}
714 .el \{\
715 .sp -1
716 .IP \(bu 2.3
717 .\}
718 MACs: all
719 \fBHMAC\fR
720 with
721 \fBSHA\-256\fR
722 or better + all modern MACs
723 .RE
724 .sp
725 .RS 4
726 .ie n \{\
727 \h'-04'\(bu\h'+03'\c
728 .\}
729 .el \{\
730 .sp -1
731 .IP \(bu 2.3
732 .\}
733 Curves: all prime >= 255 bits (including Bernstein curves)
734 .RE
735 .sp
736 .RS 4
737 .ie n \{\
738 \h'-04'\(bu\h'+03'\c
739 .\}
740 .el \{\
741 .sp -1
742 .IP \(bu 2.3
743 .\}
744 Signature algorithms: with
745 \fBSHA\-256\fR
746 hash or better (no
747 \fBDSA\fR)
748 .RE
749 .sp
750 .RS 4
751 .ie n \{\
752 \h'-04'\(bu\h'+03'\c
753 .\}
754 .el \{\
755 .sp -1
756 .IP \(bu 2.3
757 .\}
758 \fBTLS\fR
759 Ciphers: >= 256\-bit key, >= 128\-bit block, only Authenticated Encryption (AE) ciphers
760 .RE
761 .sp
762 .RS 4
763 .ie n \{\
764 \h'-04'\(bu\h'+03'\c
765 .\}
766 .el \{\
767 .sp -1
768 .IP \(bu 2.3
769 .\}
770 non\-TLS Ciphers: same as
771 \fBTLS\fR
772 ciphers with added non AE ciphers
773 .RE
774 .sp
775 .RS 4
776 .ie n \{\
777 \h'-04'\(bu\h'+03'\c
778 .\}
779 .el \{\
780 .sp -1
781 .IP \(bu 2.3
782 .\}
783 key exchange:
784 \fBECDHE\fR,
785 \fBDHE\fR
786 (no
787 \fBDHE\-DSS\fR, no
788 \fBRSA\fR)
789 .RE
790 .sp
791 .RS 4
792 .ie n \{\
793 \h'-04'\(bu\h'+03'\c
794 .\}
795 .el \{\
796 .sp -1
797 .IP \(bu 2.3
798 .\}
799 \fBDH\fR
800 params size: >= 3072
801 .RE
802 .sp
803 .RS 4
804 .ie n \{\
805 \h'-04'\(bu\h'+03'\c
806 .\}
807 .el \{\
808 .sp -1
809 .IP \(bu 2.3
810 .\}
811 \fBRSA\fR
812 keys size: >= 2048 (until end of 2023, then it will switch to 3072)
813 .RE
814 .sp
815 .RS 4
816 .ie n \{\
817 \h'-04'\(bu\h'+03'\c
818 .\}
819 .el \{\
820 .sp -1
821 .IP \(bu 2.3
822 .\}
823 \fBTLS\fR
824 protocols:
825 \fBTLS\fR
826 >= 1\&.2,
827 \fBDTLS\fR
828 >= 1\&.2
829 .sp
830 .if n \{\
831 .RS 4
832 .\}
833 .nf
834 Note that compared to others profiles *Chacha20* and *Camellia* are not
835 recommended by the BSI\&.
836 .fi
837 .if n \{\
838 .RE
839 .\}
840 .RE
841 .RE
842 .PP
843 \fBFIPS\fR
844 .RS 4
845 A policy to aid conformance to the
846 \fBFIPS 140\fR
847 requirements\&. This policy is used internally by the
848 \fBfips\-mode\-setup(8)\fR
849 tool which can switch the system to the
850 \fBFIPS 140\fR
851 mode\&. This policy provides at least 112\-bit security\&.
852 .sp
853 .RS 4
854 .ie n \{\
855 \h'-04'\(bu\h'+03'\c
856 .\}
857 .el \{\
858 .sp -1
859 .IP \(bu 2.3
860 .\}
861 MACs: all
862 \fBHMAC\fR
863 with
864 \fBSHA1\fR
865 or better
866 .RE
867 .sp
868 .RS 4
869 .ie n \{\
870 \h'-04'\(bu\h'+03'\c
871 .\}
872 .el \{\
873 .sp -1
874 .IP \(bu 2.3
875 .\}
876 Curves: all prime >= 256 bits, hybrid ML\-KEM
877 .RE
878 .sp
879 .RS 4
880 .ie n \{\
881 \h'-04'\(bu\h'+03'\c
882 .\}
883 .el \{\
884 .sp -1
885 .IP \(bu 2.3
886 .\}
887 Signature algorithms: with
888 \fBSHA\-256\fR
889 hash or better (no
890 \fBDSA\fR), pure ML\-DSA
891 .RE
892 .sp
893 .RS 4
894 .ie n \{\
895 \h'-04'\(bu\h'+03'\c
896 .\}
897 .el \{\
898 .sp -1
899 .IP \(bu 2.3
900 .\}
901 \fBTLS\fR
902 Ciphers: >= 128\-bit key, >= 128\-bit block (\fBAES\fR, including
903 \fBAES\-CBC\fR)
904 .RE
905 .sp
906 .RS 4
907 .ie n \{\
908 \h'-04'\(bu\h'+03'\c
909 .\}
910 .el \{\
911 .sp -1
912 .IP \(bu 2.3
913 .\}
914 non\-TLS Ciphers: same as
915 \fBTLS\fR
916 Ciphers
917 .RE
918 .sp
919 .RS 4
920 .ie n \{\
921 \h'-04'\(bu\h'+03'\c
922 .\}
923 .el \{\
924 .sp -1
925 .IP \(bu 2.3
926 .\}
927 key exchange:
928 \fBECDHE\fR,
929 \fBDHE\fR
930 (no
931 \fBDHE\-DSS\fR, no
932 \fBRSA\fR), KEM\-ECDH
933 .RE
934 .sp
935 .RS 4
936 .ie n \{\
937 \h'-04'\(bu\h'+03'\c
938 .\}
939 .el \{\
940 .sp -1
941 .IP \(bu 2.3
942 .\}
943 \fBDH\fR
944 params size: >= 2048
945 .RE
946 .sp
947 .RS 4
948 .ie n \{\
949 \h'-04'\(bu\h'+03'\c
950 .\}
951 .el \{\
952 .sp -1
953 .IP \(bu 2.3
954 .\}
955 \fBRSA\fR
956 params size: >= 2048
957 .RE
958 .sp
959 .RS 4
960 .ie n \{\
961 \h'-04'\(bu\h'+03'\c
962 .\}
963 .el \{\
964 .sp -1
965 .IP \(bu 2.3
966 .\}
967 \fBTLS\fR
968 protocols:
969 \fBTLS\fR
970 >= 1\&.2,
971 \fBDTLS\fR
972 >= 1\&.2
973 .RE
974 .RE
975 .PP
976 \fBEMPTY\fR
977 .RS 4
978 All cryptographic algorithms are disabled (used for debugging only, do not use)\&.
979 .RE
980 .SH "CRYPTO POLICY DEFINITION FORMAT"
981 .sp
982 The crypto policy definition files have a simple syntax following an \fBINI\fR file \fIkey\fR = \fIvalue\fR syntax with these particular features:
983 .sp
984 .RS 4
985 .ie n \{\
986 \h'-04'\(bu\h'+03'\c
987 .\}
988 .el \{\
989 .sp -1
990 .IP \(bu 2.3
991 .\}
992 Comments are indicated by
993 \fI#\fR
994 character\&. Everything on the line following the character is ignored\&.
995 .RE
996 .sp
997 .RS 4
998 .ie n \{\
999 \h'-04'\(bu\h'+03'\c
1000 .\}
1001 .el \{\
1002 .sp -1
1003 .IP \(bu 2.3
1004 .\}
1005 Backslash
1006 \fI\e\fR
1007 character followed immediately with the end\-of\-line character indicates line continuation\&. The following line is concatenated to the current line after the backslash and end\-of\-line characters are removed\&.
1008 .RE
1009 .sp
1010 .RS 4
1011 .ie n \{\
1012 \h'-04'\(bu\h'+03'\c
1013 .\}
1014 .el \{\
1015 .sp -1
1016 .IP \(bu 2.3
1017 .\}
1018 Value types for integer options can be decimal integers (\fIoption = 1\fR)\&.
1019 .RE
1020 .sp
1021 .RS 4
1022 .ie n \{\
1023 \h'-04'\(bu\h'+03'\c
1024 .\}
1025 .el \{\
1026 .sp -1
1027 .IP \(bu 2.3
1028 .\}
1029 Multiple\-choice options can be specified by setting them to a list of values (\fIoption = value1 value2\fR)\&. This list can further be altered by prepending/omitting/appending values (\fIoption = \fR\fIprepended \-omitted appended\fR)\&. A follow\-up reassignment will reset the list\&. The latter syntax cannot be combined with the former one in the same directive\&. Setting an option to an empty list is possible with
1030 \fIoption =\fR\&.
1031 .RE
1032 .sp
1033 .RS 4
1034 .ie n \{\
1035 \h'-04'\(bu\h'+03'\c
1036 .\}
1037 .el \{\
1038 .sp -1
1039 .IP \(bu 2.3
1040 .\}
1041 Asterisk sign can be used for wildcard matching as a shortcut for specifying multiple values when setting multiple\-choice options\&. Note that wildcard matching can lead to future updates implicitly enabling algorithms not yet available in the current version\&. If this is a concern, do not use wildcard\-matching outside of algorithm\-omitting directives\&.
1042 .RE
1043 .sp
1044 .RS 4
1045 .ie n \{\
1046 \h'-04'\(bu\h'+03'\c
1047 .\}
1048 .el \{\
1049 .sp -1
1050 .IP \(bu 2.3
1051 .\}
1052 In order to limit the scope of the directive and make it affect just some of the backends, the following extended syntax can be used:
1053 \fIoption@scope = \&...\fR,
1054 \fIoption@{scope1,scope2,\&...} = \&...\fR\&. Negation of scopes is possible with
1055 \fIoption@!scope\fR
1056 / \*(Aqoption@{scope1,scope2,\&...}\&. Scope selectors are case\-insensitive\&.
1057 .RE
1058 .sp
1059 The available options are:
1060 .sp
1061 .RS 4
1062 .ie n \{\
1063 \h'-04'\(bu\h'+03'\c
1064 .\}
1065 .el \{\
1066 .sp -1
1067 .IP \(bu 2.3
1068 .\}
1069 \fBmac\fR: List of allowed MAC algorithms
1070 .RE
1071 .sp
1072 .RS 4
1073 .ie n \{\
1074 \h'-04'\(bu\h'+03'\c
1075 .\}
1076 .el \{\
1077 .sp -1
1078 .IP \(bu 2.3
1079 .\}
1080 \fBgroup\fR: List of allowed groups or elliptic curves for key exchanges for use with other protocols
1081 .RE
1082 .sp
1083 .RS 4
1084 .ie n \{\
1085 \h'-04'\(bu\h'+03'\c
1086 .\}
1087 .el \{\
1088 .sp -1
1089 .IP \(bu 2.3
1090 .\}
1091 \fBhash\fR: List of allowed cryptographic hash (message digest) algorithms
1092 .RE
1093 .sp
1094 .RS 4
1095 .ie n \{\
1096 \h'-04'\(bu\h'+03'\c
1097 .\}
1098 .el \{\
1099 .sp -1
1100 .IP \(bu 2.3
1101 .\}
1102 \fBsign\fR: List of allowed signature algorithms
1103 .RE
1104 .sp
1105 .RS 4
1106 .ie n \{\
1107 \h'-04'\(bu\h'+03'\c
1108 .\}
1109 .el \{\
1110 .sp -1
1111 .IP \(bu 2.3
1112 .\}
1113 \fBcipher\fR: List of allowed symmetric encryption algorithms (including the modes) for use with other protocols
1114 .RE
1115 .sp
1116 .RS 4
1117 .ie n \{\
1118 \h'-04'\(bu\h'+03'\c
1119 .\}
1120 .el \{\
1121 .sp -1
1122 .IP \(bu 2.3
1123 .\}
1124 \fBkey_exchange\fR: List of allowed key exchange algorithms
1125 .RE
1126 .sp
1127 .RS 4
1128 .ie n \{\
1129 \h'-04'\(bu\h'+03'\c
1130 .\}
1131 .el \{\
1132 .sp -1
1133 .IP \(bu 2.3
1134 .\}
1135 \fBprotocol\fR: List of allowed TLS, DTLS and IKE protocol versions; mind that some backends do not allow selectively disabling protocols versions and only use the oldest version as the lower boundary\&.
1136 .RE
1137 .sp
1138 .RS 4
1139 .ie n \{\
1140 \h'-04'\(bu\h'+03'\c
1141 .\}
1142 .el \{\
1143 .sp -1
1144 .IP \(bu 2.3
1145 .\}
1146 \fBmin_dh_size\fR: Integer value of minimum number of bits of parameters for
1147 \fBDH\fR
1148 key exchange
1149 .RE
1150 .sp
1151 .RS 4
1152 .ie n \{\
1153 \h'-04'\(bu\h'+03'\c
1154 .\}
1155 .el \{\
1156 .sp -1
1157 .IP \(bu 2.3
1158 .\}
1159 \fBmin_dsa_size\fR: Integer value of minimum number of bits for
1160 \fBDSA\fR
1161 keys
1162 .RE
1163 .sp
1164 .RS 4
1165 .ie n \{\
1166 \h'-04'\(bu\h'+03'\c
1167 .\}
1168 .el \{\
1169 .sp -1
1170 .IP \(bu 2.3
1171 .\}
1172 \fBmin_rsa_size\fR: Integer value of minimum number of bits for
1173 \fBRSA\fR
1174 keys
1175 .RE
1176 .sp
1177 .RS 4
1178 .ie n \{\
1179 \h'-04'\(bu\h'+03'\c
1180 .\}
1181 .el \{\
1182 .sp -1
1183 .IP \(bu 2.3
1184 .\}
1185 \fBmin_ec_size\fR: Integer value of minimum number of bits for
1186 \fBEC\fR
1187 keys (Applies to
1188 \fBJava\fR
1189 back end only)
1190 .RE
1191 .sp
1192 .RS 4
1193 .ie n \{\
1194 \h'-04'\(bu\h'+03'\c
1195 .\}
1196 .el \{\
1197 .sp -1
1198 .IP \(bu 2.3
1199 .\}
1200 \fBsha1_in_certs\fR: Value of 1 if
1201 \fBSHA1\fR
1202 allowed in certificate signatures, 0 otherwise (Applies to
1203 \fBGnuTLS\fR
1204 back end only\&.)
1205 .RE
1206 .sp
1207 .RS 4
1208 .ie n \{\
1209 \h'-04'\(bu\h'+03'\c
1210 .\}
1211 .el \{\
1212 .sp -1
1213 .IP \(bu 2.3
1214 .\}
1215 \fBarbitrary_dh_groups\fR: Value of 1 if arbitrary group in
1216 \fBDiffie\-Hellman\fR
1217 is allowed, 0 otherwise
1218 .RE
1219 .sp
1220 .RS 4
1221 .ie n \{\
1222 \h'-04'\(bu\h'+03'\c
1223 .\}
1224 .el \{\
1225 .sp -1
1226 .IP \(bu 2.3
1227 .\}
1228 \fBssh_certs\fR: Value of 1 if
1229 \fBOpenSSH\fR
1230 certificate authentication is allowed, 0 otherwise
1231 .RE
1232 .sp
1233 .RS 4
1234 .ie n \{\
1235 \h'-04'\(bu\h'+03'\c
1236 .\}
1237 .el \{\
1238 .sp -1
1239 .IP \(bu 2.3
1240 .\}
1241 \fBetm\fR:
1242 \fBANY\fR/\fBDISABLE_ETM\fR/\fBDISABLE_NON_ETM\fR
1243 allows both EtM (Encrypt\-then\-Mac) and E&M (Encrypt\-and\-Mac), disables EtM, and disables E&M respectively\&. (Currently only implemented for SSH, do not use without
1244 \fB@SSH\fR
1245 scope\&.)
1246 .RE
1247 .sp
1248 Full policy definition files have suffix \&.pol, subpolicy files have suffix \&.pmod\&. Subpolicies do not have to have values set for all the keys listed above\&.
1249 .sp
1250 The effective configuration of a policy with subpolicies applied is the same as a configuration from a single policy obtained by concatenating the policy and the subpolicies in question\&.
1251 .sp
1252 \fBPolicy file placement and naming:\fR
1253 .sp
1254 The policy files shipped in packages are placed in /usr/share/crypto\-policies/policies and the subpolicies in /usr/share/crypto\-policies/policies/modules\&.
1255 .sp
1256 Locally configured policy files should be placed in /etc/crypto\-policies/policies and subpolicies in /etc/crypto\-policies/policies/modules\&.
1257 .sp
1258 The policy and subpolicy files must have names in upper\-case except for the \&.pol and \&.pmod suffix as the update\-crypto\-policies command always converts the policy name to upper\-case before searching for the policy on the filesystem\&.
1259 .SH "COMMANDS"
1260 .PP
1261 \fBupdate\-crypto\-policies(8)\fR
1262 .RS 4
1263 This command manages the policies available to the various cryptographic back ends and allows the system administrator to change the active cryptographic policy\&.
1264 .RE
1265 .PP
1266 \fBfips\-mode\-setup(8)\fR
1267 .RS 4
1268 This command allows the system administrator to enable or disable the system FIPS mode and also to apply the
1269 \fBFIPS\fR
1270 cryptographic policy which limits the allowed algorithms and protocols to those allowed by the FIPS 140 requirements\&.
1271 .RE
1272 .SH "NOTES"
1273 .sp
1274 \fBKnown notable exceptions\fR
1275 .sp
1276 .RS 4
1277 .ie n \{\
1278 \h'-04'\(bu\h'+03'\c
1279 .\}
1280 .el \{\
1281 .sp -1
1282 .IP \(bu 2.3
1283 .\}
1284 \fBGo\-language\fR
1285 applications do not yet follow the system\-wide policy\&.
1286 .RE
1287 .sp
1288 .RS 4
1289 .ie n \{\
1290 \h'-04'\(bu\h'+03'\c
1291 .\}
1292 .el \{\
1293 .sp -1
1294 .IP \(bu 2.3
1295 .\}
1296 \fBGnuPG\-2\fR
1297 application does not follow the system\-wide policy\&.
1298 .RE
1299 .sp
1300 In general only the data\-in\-transit is currently covered by the system\-wide policy\&.
1301 .sp
1302 If the system administrator changes the system\-wide policy with the \fBupdate\-crypto\-policies(8)\fR command it is advisable to restart the system as the individual back\-end libraries read the configuration files usually during their initialization\&. The changes in the policy thus take place in most cases only when the applications using the back\-end libraries are restarted\&.
1303 .sp
1304 \fBRemoved cipher suites and protocols\fR
1305 .sp
1306 The following cipher suites and protocols are completely removed from the core cryptographic libraries listed above:
1307 .sp
1308 .RS 4
1309 .ie n \{\
1310 \h'-04'\(bu\h'+03'\c
1311 .\}
1312 .el \{\
1313 .sp -1
1314 .IP \(bu 2.3
1315 .\}
1316 \fBDES\fR
1317 .RE
1318 .sp
1319 .RS 4
1320 .ie n \{\
1321 \h'-04'\(bu\h'+03'\c
1322 .\}
1323 .el \{\
1324 .sp -1
1325 .IP \(bu 2.3
1326 .\}
1327 All export grade cipher suites
1328 .RE
1329 .sp
1330 .RS 4
1331 .ie n \{\
1332 \h'-04'\(bu\h'+03'\c
1333 .\}
1334 .el \{\
1335 .sp -1
1336 .IP \(bu 2.3
1337 .\}
1338 \fBMD5\fR
1339 in signatures
1340 .RE
1341 .sp
1342 .RS 4
1343 .ie n \{\
1344 \h'-04'\(bu\h'+03'\c
1345 .\}
1346 .el \{\
1347 .sp -1
1348 .IP \(bu 2.3
1349 .\}
1350 \fBSSLv2\fR
1351 .RE
1352 .sp
1353 .RS 4
1354 .ie n \{\
1355 \h'-04'\(bu\h'+03'\c
1356 .\}
1357 .el \{\
1358 .sp -1
1359 .IP \(bu 2.3
1360 .\}
1361 \fBSSLv3\fR
1362 .RE
1363 .sp
1364 .RS 4
1365 .ie n \{\
1366 \h'-04'\(bu\h'+03'\c
1367 .\}
1368 .el \{\
1369 .sp -1
1370 .IP \(bu 2.3
1371 .\}
1372 All
1373 \fBECC\fR
1374 curves smaller than 224 bits
1375 .RE
1376 .sp
1377 .RS 4
1378 .ie n \{\
1379 \h'-04'\(bu\h'+03'\c
1380 .\}
1381 .el \{\
1382 .sp -1
1383 .IP \(bu 2.3
1384 .\}
1385 All binary field
1386 \fBECC\fR
1387 curves
1388 .RE
1389 .sp
1390 \fBCipher suites and protocols disabled in all predefined policies\fR
1391 .sp
1392 The following ciphersuites and protocols are available but disabled in all predefined crypto policies:
1393 .sp
1394 .RS 4
1395 .ie n \{\
1396 \h'-04'\(bu\h'+03'\c
1397 .\}
1398 .el \{\
1399 .sp -1
1400 .IP \(bu 2.3
1401 .\}
1402 \fBDH\fR
1403 with parameters < 1024 bits
1404 .RE
1405 .sp
1406 .RS 4
1407 .ie n \{\
1408 \h'-04'\(bu\h'+03'\c
1409 .\}
1410 .el \{\
1411 .sp -1
1412 .IP \(bu 2.3
1413 .\}
1414 \fBRSA\fR
1415 with key size < 1024 bits
1416 .RE
1417 .sp
1418 .RS 4
1419 .ie n \{\
1420 \h'-04'\(bu\h'+03'\c
1421 .\}
1422 .el \{\
1423 .sp -1
1424 .IP \(bu 2.3
1425 .\}
1426 \fBCamellia\fR
1427 .RE
1428 .sp
1429 .RS 4
1430 .ie n \{\
1431 \h'-04'\(bu\h'+03'\c
1432 .\}
1433 .el \{\
1434 .sp -1
1435 .IP \(bu 2.3
1436 .\}
1437 \fBRC4\fR
1438 .RE
1439 .sp
1440 .RS 4
1441 .ie n \{\
1442 \h'-04'\(bu\h'+03'\c
1443 .\}
1444 .el \{\
1445 .sp -1
1446 .IP \(bu 2.3
1447 .\}
1448 \fBARIA\fR
1449 .RE
1450 .sp
1451 .RS 4
1452 .ie n \{\
1453 \h'-04'\(bu\h'+03'\c
1454 .\}
1455 .el \{\
1456 .sp -1
1457 .IP \(bu 2.3
1458 .\}
1459 \fBSEED\fR
1460 .RE
1461 .sp
1462 .RS 4
1463 .ie n \{\
1464 \h'-04'\(bu\h'+03'\c
1465 .\}
1466 .el \{\
1467 .sp -1
1468 .IP \(bu 2.3
1469 .\}
1470 \fBIDEA\fR
1471 .RE
1472 .sp
1473 .RS 4
1474 .ie n \{\
1475 \h'-04'\(bu\h'+03'\c
1476 .\}
1477 .el \{\
1478 .sp -1
1479 .IP \(bu 2.3
1480 .\}
1481 Integrity only ciphersuites
1482 .RE
1483 .sp
1484 .RS 4
1485 .ie n \{\
1486 \h'-04'\(bu\h'+03'\c
1487 .\}
1488 .el \{\
1489 .sp -1
1490 .IP \(bu 2.3
1491 .\}
1492 \fBTLS\fR
1493 \fBCBC mode\fR
1494 ciphersuites using
1495 \fBSHA\-384\fR
1496 HMAC
1497 .RE
1498 .sp
1499 .RS 4
1500 .ie n \{\
1501 \h'-04'\(bu\h'+03'\c
1502 .\}
1503 .el \{\
1504 .sp -1
1505 .IP \(bu 2.3
1506 .\}
1507 \fBAES\-CCM8\fR
1508 .RE
1509 .sp
1510 .RS 4
1511 .ie n \{\
1512 \h'-04'\(bu\h'+03'\c
1513 .\}
1514 .el \{\
1515 .sp -1
1516 .IP \(bu 2.3
1517 .\}
1518 all
1519 \fBECC\fR
1520 curves incompatible with
1521 \fBTLS 1\&.3\fR, including secp256k1
1522 .RE
1523 .sp
1524 .RS 4
1525 .ie n \{\
1526 \h'-04'\(bu\h'+03'\c
1527 .\}
1528 .el \{\
1529 .sp -1
1530 .IP \(bu 2.3
1531 .\}
1532 \fBIKEv1\fR
1533 .RE
1534 .sp
1535 \fBNotable irregularities in the individual configuration generators\fR
1536 .sp
1537 .RS 4
1538 .ie n \{\
1539 \h'-04'\(bu\h'+03'\c
1540 .\}
1541 .el \{\
1542 .sp -1
1543 .IP \(bu 2.3
1544 .\}
1545 \fBOpenSSL\fR
1546 and
1547 \fBNSS\fR: Disabling all TLS and/or all DTLS versions isn\(cqt actually possible\&. Trying to do so will result in the library defaults being applied instead\&.
1548 .RE
1549 .sp
1550 .RS 4
1551 .ie n \{\
1552 \h'-04'\(bu\h'+03'\c
1553 .\}
1554 .el \{\
1555 .sp -1
1556 .IP \(bu 2.3
1557 .\}
1558 \fBOpenSSL\fR: The minimum length of the keys and some other parameters are enforced by the @SECLEVEL value which does not provide a fine granularity\&. The list of
1559 \fBTLS\fR
1560 ciphers is not generated as an exact list but by subtracting from all the supported ciphers for the enabled key exchange methods\&. For that reason there is no way to disable a random cipher\&. In particular all
1561 \fBAES\-128\fR
1562 ciphers are disabled if the
1563 \fBAES\-128\-GCM\fR
1564 is not present in the list; all
1565 \fBAES\-256\fR
1566 ciphers are disabled if the
1567 \fBAES\-256\-GCM\fR
1568 is not present\&. The
1569 \fBCBC\fR
1570 ciphers are disabled if there isn\(cqt
1571 \fBHMAC\-SHA1\fR
1572 in the hmac list and
1573 \fBAES\-256\-CBC\fR
1574 in the cipher list\&. To disable the
1575 \fBCCM\fR
1576 ciphers both
1577 \fBAES\-128\-CCM\fR
1578 and
1579 \fBAES\-256\-CCM\fR
1580 must not be present in the cipher list\&.
1581 .RE
1582 .sp
1583 .RS 4
1584 .ie n \{\
1585 \h'-04'\(bu\h'+03'\c
1586 .\}
1587 .el \{\
1588 .sp -1
1589 .IP \(bu 2.3
1590 .\}
1591 \fBGnuTLS\fR: The minimum length of the keys and some other parameters are enforced by min\-verification\-profile setting in the
1592 \fBGnuTLS\fR
1593 configuration file which does not provide fine granularity\&.
1594 .RE
1595 .sp
1596 .RS 4
1597 .ie n \{\
1598 \h'-04'\(bu\h'+03'\c
1599 .\}
1600 .el \{\
1601 .sp -1
1602 .IP \(bu 2.3
1603 .\}
1604 \fBGnuTLS\fR: PSK key exchanges have to be explicitly enabled by the applications using them\&.
1605 .RE
1606 .sp
1607 .RS 4
1608 .ie n \{\
1609 \h'-04'\(bu\h'+03'\c
1610 .\}
1611 .el \{\
1612 .sp -1
1613 .IP \(bu 2.3
1614 .\}
1615 \fBGnuTLS\fR: HMAC\-SHA2\-256 and HMAC\-SHA2\-384 MACs are disabled due to concerns over the constant\-timedness of the implementation\&.
1616 .RE
1617 .sp
1618 .RS 4
1619 .ie n \{\
1620 \h'-04'\(bu\h'+03'\c
1621 .\}
1622 .el \{\
1623 .sp -1
1624 .IP \(bu 2.3
1625 .\}
1626 \fBOpenSSH\fR:
1627 \fBDH\fR
1628 group 1 is always disabled on server even if the policy allows 1024 bit
1629 \fBDH\fR
1630 groups in general\&. The OpenSSH configuration option HostKeyAlgorithms is set only for the
1631 \fBSSH\fR
1632 server as otherwise the handling of the existing known hosts entries would be broken on client\&.
1633 .RE
1634 .sp
1635 .RS 4
1636 .ie n \{\
1637 \h'-04'\(bu\h'+03'\c
1638 .\}
1639 .el \{\
1640 .sp -1
1641 .IP \(bu 2.3
1642 .\}
1643 \fBLibreswan\fR: The
1644 \fBkey_exchange\fR
1645 parameter does not affect the generated configuration\&. The use of regular
1646 \fBDH\fR
1647 or
1648 \fBECDH\fR
1649 can be limited with appropriate setting of the
1650 \fBgroup\fR
1651 parameter\&.
1652 .RE
1653 .sp
1654 .RS 4
1655 .ie n \{\
1656 \h'-04'\(bu\h'+03'\c
1657 .\}
1658 .el \{\
1659 .sp -1
1660 .IP \(bu 2.3
1661 .\}
1662 \fBSequoia\fR: only
1663 \fBhash_algorithms\fR,
1664 \fBsymmetric_algorithms\fR,
1665 \fBasymmetric_algorithms\fR
1666 and
1667 \fBaead_algorithms\fR
1668 are controlled by crypto\-policies\&.
1669 \fBasymmetric_algorithms\fR
1670 is not controlled directly, but deduced from
1671 \fBsign\fR
1672 and
1673 \fBgroup\fR\&.
1674 .RE
1675 .sp
1676 .RS 4
1677 .ie n \{\
1678 \h'-04'\(bu\h'+03'\c
1679 .\}
1680 .el \{\
1681 .sp -1
1682 .IP \(bu 2.3
1683 .\}
1684 \fBOpenSSL\fR: order of
1685 \fBgroup\fR
1686 values is only respected within PQ and classic group "classes", and all PQ groups are automatically sorted higher than classic ones\&. To optimize latency while connecting to both PQ and non\-PQ \-aware hosts, key shares are generated and sent for the one highest priority PQ group and the one highest priority classic group\&. To prioritize PQ groups when both are supported, the servers prefer a PQ group over a classic group if there\(cqs an overlap in any of the PQ groups\&.
1687 .RE
1688 .sp
1689 .RS 4
1690 .ie n \{\
1691 \h'-04'\(bu\h'+03'\c
1692 .\}
1693 .el \{\
1694 .sp -1
1695 .IP \(bu 2.3
1696 .\}
1697 \fBNSS\fR: order of
1698 \fBgroup\fR
1699 values is ignored and built\-in order is used instead\&.
1700 .RE
1701 .sp
1702 .RS 4
1703 .ie n \{\
1704 \h'-04'\(bu\h'+03'\c
1705 .\}
1706 .el \{\
1707 .sp -1
1708 .IP \(bu 2.3
1709 .\}
1710 \fBNSS\fR: currently is the only one respecting the
1711 \fBpkcs12\fR
1712 /
1713 \fBpkcs12\-import\fR
1714 scopes\&.
1715 \fBpkcs12\fR
1716 implies
1717 \fBpkcs12\-import\fR, it\(cqs not possible to allow exporting without allowing importing\&. The same applies to
1718 \fBsmime\fR
1719 /
1720 \fBsmime\-import\fR
1721 scopes, and their
1722 \fBnss\-\fR
1723 prefixed internal\-use variants\&. These scopes cannot be used for enabling signature algorithms that weren\(cqt otherwise enabled\&.
1724 .RE
1725 .SH "HISTORY"
1726 .sp
1727 The \fBECDHE\-GSS\fR and \fBDHE\-GSS\fR algorithms are newly introduced and must be specified in the base policy for the SSH GSSAPI key exchange methods to be enabled\&. Previously the legacy SSH GSSAPI key exchange methods were automatically enabled when the \fBSHA1\fR hash and \fBDH\fR parameters of at least 2048 bits were enabled\&.
1728 .sp
1729 Before the introduction of the \fBcustom crypto policies\fR support it was possible to have an completely arbitrary crypto policy created as a set of arbitrary back\-end config files in /usr/share/crypto\-policies/<POLICYNAME> directory\&. With the introduction of the \fBcustom crypto policies\fR it is still possible but there must be an empty (possibly with any comment lines) <POLICYNAME>\&.pol file in /usr/share/crypto\-policies/policies so the update\-crypto\-policies command can recognize the arbitrary custom policy\&. No subpolicies must be used with such an arbitrary custom policy\&. Modifications from \fBlocal\&.d\fR will be appended to the files provided by the policy\&.
1730 .sp
1731 The use of the following historaically available options is discouraged:
1732 .sp
1733 .RS 4
1734 .ie n \{\
1735 \h'-04'\(bu\h'+03'\c
1736 .\}
1737 .el \{\
1738 .sp -1
1739 .IP \(bu 2.3
1740 .\}
1741 \fBmin_tls_version\fR: Lowest allowed TLS protocol version (recommended replacement:
1742 \fBprotocol@TLS\fR)
1743 .RE
1744 .sp
1745 .RS 4
1746 .ie n \{\
1747 \h'-04'\(bu\h'+03'\c
1748 .\}
1749 .el \{\
1750 .sp -1
1751 .IP \(bu 2.3
1752 .\}
1753 \fBmin_dtls_version\fR: Lowest allowed DTLS protocol version (recommended replacement:
1754 \fBprotocol@TLS\fR)
1755 .RE
1756 .sp
1757 The following options are deprecated, please rewrite your policies:
1758 .sp
1759 .RS 4
1760 .ie n \{\
1761 \h'-04'\(bu\h'+03'\c
1762 .\}
1763 .el \{\
1764 .sp -1
1765 .IP \(bu 2.3
1766 .\}
1767 \fBike_protocol\fR: List of allowed IKE protocol versions (recommended replacement:
1768 \fBprotocol@IKE\fR, mind the relative position to other
1769 \fBprotocol\fR
1770 directives)\&.
1771 .RE
1772 .sp
1773 .RS 4
1774 .ie n \{\
1775 \h'-04'\(bu\h'+03'\c
1776 .\}
1777 .el \{\
1778 .sp -1
1779 .IP \(bu 2.3
1780 .\}
1781 \fBtls_cipher\fR: list of allowed symmetric encryption algorithms for use with the TLS protocol (recommended replacement:
1782 \fBcipher@TLS\fR, mind the relative position to other
1783 \fBcipher\fR
1784 directives)\&.
1785 .RE
1786 .sp
1787 .RS 4
1788 .ie n \{\
1789 \h'-04'\(bu\h'+03'\c
1790 .\}
1791 .el \{\
1792 .sp -1
1793 .IP \(bu 2.3
1794 .\}
1795 \fBssh_cipher\fR: list of allowed symmetric encryption algorithms for use with the SSH protocol (recommended replacement:
1796 \fBcipher@SSH\fR, mind the relative position to other
1797 \fBcipher\fR
1798 directives)\&.
1799 .RE
1800 .sp
1801 .RS 4
1802 .ie n \{\
1803 \h'-04'\(bu\h'+03'\c
1804 .\}
1805 .el \{\
1806 .sp -1
1807 .IP \(bu 2.3
1808 .\}
1809 \fBssh_group\fR: list of allowed groups or elliptic curves for key exchanges for use with the SSH protocol (recommended replacement:
1810 \fBgroup@SSH\fR, mind the relative position to other
1811 \fBgroup\fR
1812 directives)\&.
1813 .RE
1814 .sp
1815 .RS 4
1816 .ie n \{\
1817 \h'-04'\(bu\h'+03'\c
1818 .\}
1819 .el \{\
1820 .sp -1
1821 .IP \(bu 2.3
1822 .\}
1823 \fBsha1_in_dnssec\fR: Allow
1824 \fBSHA1\fR
1825 usage in DNSSec protocol even if it is not present in the
1826 \fBhash\fR
1827 and
1828 \fBsign\fR
1829 lists (recommended replacements:
1830 \fBhash@DNSSec\fR,
1831 \fBsign@DNSSec\fR)\&.
1832 .RE
1833 .sp
1834 .RS 4
1835 .ie n \{\
1836 \h'-04'\(bu\h'+03'\c
1837 .\}
1838 .el \{\
1839 .sp -1
1840 .IP \(bu 2.3
1841 .\}
1842 \fBssh_etm\fR: Value of 1 if
1843 \fBOpenSSH\fR
1844 EtM (encrypt\-then\-mac) extension is allowed, 0 otherwise\&. Use
1845 \fBetm@SSH\fR
1846 instead\&.
1847 .RE
1848 .SH "FILES"
1849 .PP
1850 /etc/crypto\-policies/back\-ends
1851 .RS 4
1852 The individual cryptographical back\-end configuration files\&. Usually linked to the configuration shipped in the crypto\-policies package unless a configuration from
1853 local\&.d
1854 is added\&.
1855 .RE
1856 .PP
1857 /etc/crypto\-policies/config
1858 .RS 4
1859 A file containing the name of the active crypto\-policy set on the system\&.
1860 .RE
1861 .PP
1862 /etc/crypto\-policies/local\&.d
1863 .RS 4
1864 Additional configuration shipped by other packages or created by the system administrator\&. The contents of the
1865 <back\-end>\-file\&.config
1866 is appended to the configuration from the policy back end as shipped in the crypto\-policies package\&.
1867 .RE
1868 .PP
1869 /usr/share/crypto\-policies/policies
1870 .RS 4
1871 System policy definition files\&.
1872 .RE
1873 .PP
1874 /usr/share/crypto\-policies/policies/modules
1875 .RS 4
1876 System subpolicy definition files\&.
1877 .RE
1878 .PP
1879 /etc/crypto\-policies/policies
1880 .RS 4
1881 Custom policy definition files as configured by the system administrator\&.
1882 .RE
1883 .PP
1884 /etc/crypto\-policies/policies/modules
1885 .RS 4
1886 Custom subpolicy definition files as configured by the system administrator\&.
1887 .RE
1888 .PP
1889 /usr/share/crypto\-policies/<\*(AqPOLICYNAME\*(Aq>
1890 .RS 4
1891 Pre\-generated back\-end configurations for policy
1892 \fIPOLICYNAME\fR\&.
1893 .RE
1894 .SH "SEE ALSO"
1895 .sp
1896 update\-crypto\-policies(8), fips\-mode\-setup(8)
1897 .SH "AUTHOR"
1898 .sp
1899 Written by Tomáš Mráz\&.