diff --git a/xml/security_cryptopolicy.xml b/xml/security_cryptopolicy.xml
index f6a92fec98..97c5b21d03 100644
--- a/xml/security_cryptopolicy.xml
+++ b/xml/security_cryptopolicy.xml
@@ -114,7 +114,7 @@
policies, therefore see the man page of
crypto-policies. All predefined policies are located
in
- /usr/share/crypto-policies/policiesNAME.pol
+ /usr/share/crypto-policies/policies/NAME.pol
and are read-only.
@@ -178,8 +178,8 @@
/usr/share/crypto-policies/policies/modules.
However, your own subpolicies need to be stored in
/etc/crypto-policies/policies/modules (unless they
- are packaged) . The name of the subpolicy file must be
- MODULE.pmod, where
+ are packaged). The name of the subpolicy file must be
+ MODULE.pmod, where
MODULE is the name of the subpolicy. It needs
to be spelled in uppercase letters and without spaces.
@@ -216,7 +216,6 @@
Assuming the current system-wide policy is
DEFAULT and you want to apply the newly created
subpolicy to DEFAULT:
- command:
&prompt.root;update-crypto-policies --set DEFAULT:NO-RSA-PSK
@@ -226,17 +225,79 @@
DEFAULT:
update-crypto-policies --show
- DEFAULT:NO-RSA-PSK
+DEFAULT:NO-RSA-PSK
Reboot the system to apply the system-wide policy adjustment to the
- applications.
+ applications:
+&prompt.root;reboot
+
+
+ Creating a new policy from scratch
+
+
+ Instead of customizing an existing crypto-policy with a subpolicy you can
+ also decide to write a new policy from scratch. You can use any of the
+ predefined policies in
+ /usr/share/crypto-policies/policies/ as a starting
+ point. However, your own policy file needs to be stored in
+ /etc/crypto-policies/policies/. Name your file
+ MY_POLICY.pol, where
+ MY_POLICY is the name of the policy. Make sure
+ it is owned by &rootuser; and is not writable by non-privileged users.
+
-
+
+ Creating a new policy and applying it
+
+ The following example shows you how to create a new policy based on the
+ DEFAULT policy.
+
+
+
+
+ Copy the DEFAULT policy to
+ /etc/crypto-policies/policies/ and rename it:
+
+cp /usr/share/crypto-policies/policies/DEFAULT.pol /etc/crypto-policies/policies/MY_POLICY.pol
+
+
+
+ Edit the policy as desired and save it.
+
+
+
+
+ Switch the system to the new policy:
+
+&prompt.root;update-crypto-policies --set MY_POLICY
+
+
+
+ Reboot the system to apply the new policy to the
+ applications and running services:
+
+&prompt.root;reboot
+
+
+
+ Double-check if the policy is active:
+
+update-crypto-policies --show
+MY_POLICY
+
+
+
+ Reboot the system to apply the system-wide policy adjustment to the
+ applications.
+
+
+
+