]> git.ipfire.org Git - thirdparty/kea.git/commitdiff
[#3541] addressed review comments
authorRazvan Becheriu <razvan@isc.org>
Wed, 11 Jun 2025 09:43:13 +0000 (12:43 +0300)
committerRazvan Becheriu <razvan@isc.org>
Wed, 11 Jun 2025 09:43:13 +0000 (12:43 +0300)
26 files changed:
doc/examples/agent/comments.json
doc/examples/agent/https.json
doc/examples/agent/rbac.json
doc/examples/agent/simple.json
doc/examples/kea4/all-keys.json
doc/examples/kea4/ha-load-balancing-server1-mt-with-tls.json
doc/examples/kea4/ha-load-balancing-server2-mt.json
doc/examples/kea6/all-keys.json
doc/examples/kea6/ha-hot-standby-server1-with-tls.json
doc/examples/kea6/ha-hot-standby-server2.json
doc/examples/template-ha-mt-tls/kea-ca-1.conf
doc/examples/template-ha-mt-tls/kea-ca-2.conf
doc/examples/template-ha-mt-tls/kea-dhcp4-1.conf
doc/examples/template-ha-mt-tls/kea-dhcp4-2.conf
doc/examples/template-power-user-home/kea-ca-1.conf
doc/examples/template-power-user-home/kea-ca-2.conf
doc/examples/template-power-user-home/kea-dhcp4-1.conf
doc/examples/template-power-user-home/kea-dhcp4-2.conf
doc/sphinx/arm/agent.rst
doc/sphinx/arm/ddns.rst
doc/sphinx/arm/dhcp4-srv.rst
doc/sphinx/arm/dhcp6-srv.rst
doc/sphinx/arm/hooks-ha.rst
doc/sphinx/arm/hooks-rbac.rst
doc/sphinx/arm/security.rst
src/bin/keactrl/kea-ctrl-agent.conf.pre

index 97c8a7f3dd5da5cb4eb6dfd9d5fd666777ce185d..61f8980d8ade80c90b670ae396d1c13dbd7206c4 100644 (file)
@@ -16,7 +16,6 @@
         // listener is different (e.g. 8001) than the one used by CA. Note
         // the commands should still be sent via CA. The dedicated listener
         // is specifically for HA updates only.
-        // For security reasons, a port lower than 1024 should be used (e.g. 890).
         "http-port": 8000,
 
         // Extra HTTP headers to add in responses.
index c566c4e938dd9e52e21836c4554e30a12bb9bfd1..c06039c99f3073e42e60c59ad1fd30707d5cc38b 100644 (file)
@@ -13,7 +13,6 @@
         // listener is different (e.g. 8001) than the one used by CA. Note
         // the commands should still be sent via CA. The dedicated listener
         // is specifically for HA updates only.
-        // For security reasons, a port lower than 1024 should be used (e.g. 890).
         "http-port": 8000,
 
         // TLS trust anchor (Certificate Authority). This is a file name or
index fa35242f97925dbb2dac616bec5f0abfabeb3146..575cfd90e5fc7b5d44be300f2d0056e5f8c84361 100644 (file)
@@ -13,7 +13,6 @@
         // listener is different (e.g. 8001) than the one used by CA. Note
         // the commands should still be sent via CA. The dedicated listener
         // is specifically for HA updates only.
-        // For security reasons, a port lower than 1024 should be used (e.g. 890).
         "http-port": 8000,
 
         // TLS trust anchor (Certificate Authority). This is a file name or
index f76fddc71065a78642c8874964d578db943f4148..62596c45ca5b6526c615dc283f4ec43e2e7b9c5f 100644 (file)
@@ -13,7 +13,6 @@
         // listener is different (e.g. 8001) than the one used by CA. Note
         // the commands should still be sent via CA. The dedicated listener
         // is specifically for HA updates only.
-        // For security reasons, a port lower than 1024 should be used (e.g. 890).
         "http-port": 8000,
 
         // Extra HTTP headers to add in responses.
index cb765ce85e253fbd399cd4be252e83cd53af5849..53079ea04819debdb8f6f04407d235eb89e2a0f4 100644 (file)
                 // commands should still be sent to a control socket.
                 // The dedicated listener is specifically for HA
                 // updates only.
-                // For security reasons, a port lower than 1024 should be used (e.g. 894).
                 "socket-port": 8004,
 
                 // TLS trust anchor (Certificate Authority). This is a
index a25161338f393d59cf72e57efb9f94db331553d9..74af394b0288fb3b470820254545211d1985d2e8 100644 (file)
                             // instance if multi-threading is enabled.
                             // The "http-host" and "http-port" values must be set to different
                             // values then the ones used by the Control Agent.
-                            // For security reasons, a port lower than 1024 should be used (e.g. 895).
                             "url": "http://192.168.56.33:8005",
                             // Trust anchor aka certificate authority file or directory.
                             "trust-anchor": "/usr/lib/kea/CA.pem",
                             // to run on the partner's machine if multi-threading is enabled.
                             // The "http-host" and "http-port" values must be set to different
                             // values then the ones used by the Control Agent.
-                            // For security reasons, a port lower than 1024 should be used (e.g. 895).
                             "url": "http://192.168.56.66:8005",
                             // Trust anchor aka certificate authority file or directory.
                             "trust-anchor": "/usr/lib/kea/CA.pem",
index 528b0a5c74003ec7e09a09d547b4c1cd4f0b335e..1b910d2fc766d80d6f6cec315bb0e3591afaba01 100644 (file)
                             // to run on the partner's machine if multi-threading is enabled.
                             // The "http-host" and "http-port" values must be set to different
                             // values then the ones used by the Control Agent.
-                            // For security reasons, a port lower than 1024 should be used (e.g. 895).
                             "url": "http://192.168.56.33:8005",
                             // The partner is primary. This server is secondary.
                             "role": "primary"
                             // instance if multi-threading is enabled.
                             // The "http-host" and "http-port" values must be set to different
                             // values then the ones used by the Control Agent.
-                            // For security reasons, a port lower than 1024 should be used (e.g. 895).
                             "url": "http://192.168.56.66:8005",
                             // This server is secondary. The other one must be
                             // primary.
index 8b370aa13ab496c30e51ea21eb906eb42b89edc8..f5c560021b0505ec41cb2ff18423488370d5da36 100644 (file)
                 // commands should still be sent to a control socket.
                 // The dedicated listener is specifically for HA
                 // updates only.
-                // For security reasons, a port lower than 1024 should be used (e.g. 896).
                 "socket-port": 8006,
 
                 // TLS trust anchor (Certificate Authority). This is a
index 49c100b548d8a06b06edc93c3c2e9d3d1b3dcd7e..328824468341dc0d23c55174112ed94d9008aa5f 100644 (file)
@@ -94,7 +94,6 @@
                             // Control Agent must run along with this DHCPv6 server
                             // instance and the "http-host" and "http-port" must be
                             // set to the corresponding values.
-                            // For security reasons, a port lower than 1024 should be used (e.g. 897).
                             "url": "http://192.168.56.33:8007",
                             // This server is primary. The other one must be
                             // standby.
                             // channel can be reached. The Control Agent is required
                             // to run on the partner's machine with "http-host" and
                             // "http-port" values set to the corresponding values.
-                            // For security reasons, a port lower than 1024 should be used (e.g. 897).
                             "url": "http://192.168.56.66:8007",
                             // The partner is standby. This server is primary.
                             "role": "standby"
index 6335f9046ac81569667c9ef3aeac3754d623b7f7..b3bd9daccd2829d16f4eb52b20d919a4c50825ec 100644 (file)
@@ -85,7 +85,6 @@
                             // channel can be reached. The Control Agent is required
                             // to run on the partner's machine with "http-host" and
                             // "http-port" values set to the corresponding values.
-                            // For security reasons, a port lower than 1024 should be used (e.g. 897).
                             "url": "http://192.168.56.33:8007",
                             // The partner is primary. This server is standby.
                             "role": "primary"
@@ -97,7 +96,6 @@
                             // Control Agent must run along with this DHCPv6 server
                             // instance and the "http-host" and "http-port" must be
                             // set to the corresponding values.
-                            // For security reasons, a port lower than 1024 should be used (e.g. 897).
                             "url": "http://192.168.56.66:8007",
                             // This server is standby. The other one must be
                             // primary.
index f9578b6f38d19c3f032486eb614deae8cfdcdb1d..e937feaeec5cc26056cddadc98f0124afa609cc9 100644 (file)
@@ -33,7 +33,6 @@
         // listener is different (e.g. 8001) than the one used by CA. Note
         // the commands should still be sent via CA. The dedicated listener
         // is specifically for HA updates only.
-        // For security reasons, a port lower than 1024 should be used (e.g. 890).
         "http-port": 8001,
 
         "control-sockets":
index 8a4e8bef706cb7d84516d997870a16cebd6bf46b..2322261ee34c714defd81274684838de025b8045 100644 (file)
@@ -33,7 +33,6 @@
         // listener is different (e.g. 8001) than the one used by CA. Note
         // the commands should still be sent via CA. The dedicated listener
         // is specifically for HA updates only.
-        // For security reasons, a port lower than 1024 should be used (e.g. 890).
         "http-port": 8001,
 
         "control-sockets":
index 9b3d58275c6e267b96f7f791578e8525450db684..8d485b54e7320e00af854442bbc7eff1d16c1a01 100644 (file)
                             // The Control Agent is not needed for the High Availability
                             // with multi-threading, but if it is used, it must use
                             // different values for "http-host" and "http-port".
-                            // For security reasons, a port lower than 1024 should be used (e.g. 895).
                             "url": "http://192.168.1.2:8005",
                             // Trust anchor aka certificate authority file or directory.
                             "trust-anchor": "/usr/lib/kea/CA.pem",
                             // The Control Agent is not needed for the High Availability
                             // with multi-threading, but if it is used, it must use
                             // different values for "http-host" and "http-port".
-                            // For security reasons, a port lower than 1024 should be used (e.g. 895).
                             "url": "http://192.168.1.3:8005",
                             // Trust anchor aka certificate authority file or directory.
                             "trust-anchor": "/usr/lib/kea/CA.pem",
index 27bee613c9e691489d28dfa7461e2d2e7cfe591d..48ddc8c2298969ad5e3886e7c672a15122a5dc60 100644 (file)
                             // The Control Agent is not needed for the High Availability
                             // with multi-threading, but if it is used, it must use
                             // different values for "http-host" and "http-port".
-                            // For security reasons, a port lower than 1024 should be used (e.g. 895).
                             "url": "http://192.168.1.2:8005",
                             // Trust anchor aka certificate authority file or directory.
                             "trust-anchor": "/usr/lib/kea/CA.pem",
                             // The Control Agent is not needed for the High Availability
                             // with multi-threading, but if it is used, it must use
                             // different values for "http-host" and "http-port".
-                            // For security reasons, a port lower than 1024 should be used (e.g. 895).
                             "url": "http://192.168.1.3:8005",
                             // Trust anchor aka certificate authority file or directory.
                             "trust-anchor": "/usr/lib/kea/CA.pem",
index da4f19c3f46dad65036b4f52eb9c2de50b822805..a280448708dc3fb1ec46b486c42b13003c0f5d09 100644 (file)
@@ -9,7 +9,6 @@
         "http-host": "192.168.1.2",
 
         // This specifies the port CA will listen on.
-        // For security reasons, a port lower than 1024 should be used (e.g. 890).
         "http-port": 8000,
 
         "control-sockets":
index bb3d0d6a33160681ad2140acaaf583647d794164..5d114d103082936896c02159811eb6685bfa36ba 100644 (file)
@@ -9,7 +9,6 @@
         "http-host": "192.168.1.3",
 
         // This specifies the port CA will listen on.
-        // For security reasons, a port lower than 1024 should be used (e.g. 890).
         "http-port": 8000,
 
         "control-sockets":
index 8b2e5980d233f061b6906c843468a53e3d04db23..045ce64fbfcf1742c69adc739675415a40c22dc1 100644 (file)
                             // Control Agent must run along with this DHCPv4 server
                             // instance and the "http-host" and "http-port" must be
                             // set to the corresponding values.
-                            // For security reasons, a port lower than 1024 should be used (e.g. 895).
                             "url": "http://192.168.1.2:8005",
                             // This server is primary. The other one must be
                             // secondary.
                             // channel can be reached. The Control Agent is required
                             // to run on the partner's machine with "http-host" and
                             // "http-port" values set to the corresponding values.
-                            // For security reasons, a port lower than 1024 should be used (e.g. 895).
                             "url": "http://192.168.1.3:8005",
                             // The other server is secondary. This one must be
                             // primary.
index 5d0166edd23512ce61d8d1569118d7a85d0f7212..1a932a0a4bc6fed1e09683130e3ce57ebc638a49 100644 (file)
                             // channel can be reached. The Control Agent is required
                             // to run on the partner's machine with "http-host" and
                             // "http-port" values set to the corresponding values.
-                            // For security reasons, a port lower than 1024 should be used (e.g. 895).
                             "url": "http://192.168.1.2:8005",
                             // The other server is primary. This one must be
                             // secondary.
                             // Control Agent must run along with this DHCPv4 server
                             // instance and the "http-host" and "http-port" must be
                             // set to the corresponding values.
-                            // For security reasons, a port lower than 1024 should be used (e.g. 895).
                             "url": "http://192.168.1.3:8005",
                             // This server is secondary. The other one must be
                             // primary.
index 0816c571213da52fbfbd7ef68f3bb059fa256107..ec8c0132708c5a13262e183f48a77b21914c35f1 100644 (file)
@@ -114,8 +114,6 @@ provided above, the RESTful service will be available at the URL
 ``https://10.20.30.40:8000/``. If these parameters are not specified, the
 default URL is ``http://127.0.0.1:8000/``.
 
-For security reasons, a port lower than 1024 should be used (e.g. 890).
-
 When using Kea's HA hook library with multi-threading,
 the address:port combination used for CA must be
 different from the HA peer URLs, which are strictly
index 08aa0bf8f1549af03514e7dfc5b88463e39bcb50..43e8702c45341c445d54f1cf425af07401ec97e2 100644 (file)
@@ -403,8 +403,6 @@ TLS is required). The ``socket-address`` (default ``127.0.0.1``) and
 ``socket-port`` (default 8000) specify an IP address and port to which
 the HTTP service will be bound.
 
-For security reasons, a port lower than 1024 should be used (e.g. 892).
-
 The ``trust-anchor``, ``cert-file``, ``key-file``, and ``cert-required``
 parameters specify the TLS setup for HTTP, i.e. HTTPS. If these parameters
 are not specified, HTTP is used. The TLS/HTTPS support in Kea is
index ceaf0441fbcb4229a2e8a368317bd7dac75951b1..a1d47ef3fbf5568a72dffd510fbfd01c5aeec8d3 100644 (file)
@@ -7910,8 +7910,6 @@ TLS is required). The ``socket-address`` (default ``127.0.0.1``) and
 ``socket-port`` (default 8000) specify an IP address and port to which
 the HTTP service will be bound.
 
-For security reasons, a port lower than 1024 should be used (e.g. 894).
-
 Since Kea 2.7.5 the ``http-headers`` parameter specifies a list of
 extra HTTP headers to add to HTTP responses.
 
index 14ce9793bfb91b58b63ad0ae9b3b594ae85eab45..13f28cc450c3ebe314c91490153eb3e926d257da 100644 (file)
@@ -7816,8 +7816,6 @@ TLS is required). The ``socket-address`` (default ``::1``) and
 ``socket-port`` (default 8000) specify an IP address and port to which
 the HTTP service will be bound.
 
-For security reasons, a port lower than 1024 should be used (e.g. 896).
-
 Since Kea 2.7.5 the ``http-headers`` parameter specifies a list of
 extra HTTP headers to add to HTTP responses.
 
index e00cb255efcc5d783a713385d96f6635de191236..30ffc57599a3260c31c1f22bde8300cd8dc13896 100644 (file)
@@ -1593,7 +1593,6 @@ machine as the primary server. This configuration is valid for both the
         // listener is different (e.g. 8001) than the one used by CA. Note
         // the commands should still be sent via CA. The dedicated listener
         // is specifically for HA updates only.
-        // For security reasons, a port lower than 1024 should be used (e.g. 890).
        "http-port": 8000,
 
        "control-sockets": {
@@ -1685,7 +1684,6 @@ as illustrated below:
                              // DHCPv4 server open its own socket. Note that it
                              // must be different than the one used by the CA
                              // (typically 8000). In this example, 8005 is used.
-                             // For security reasons, a port lower than 1024 should be used (e.g. 895).
                              "url": "http://192.0.2.1:8005",
                              // This server is primary. The other one must be
                              // secondary.
@@ -1699,7 +1697,6 @@ as illustrated below:
                              // DHCPv4 server open its own socket. Note that it
                              // must be different than the one used by the CA
                              // (typically 8000). In this example, 8005 is used.
-                             // For security reasons, a port lower than 1024 should be used (e.g. 895).
                              "url": "http://192.0.2.2:8005",
                              // The partner is a secondary. This server is a
                              // primary as specified in the previous "peers"
index c4a1dcc1b1251bf4c1e6d00f88db975a376dfe6a..88bad10c152ee29396eb19035e13398012c93caa 100644 (file)
@@ -249,7 +249,6 @@ in the Kea source and is copied below.
         // listener is different (e.g. 8001) than the one used by CA. Note
         // the commands should still be sent via CA. The dedicated listener
         // is specifically for HA updates only.
-        // For security reasons, a port lower than 1024 should be used (e.g. 890).
         "http-port": 8000,
 
         // TLS trust anchor (Certificate Authority). This is a file name or
index 6d451c6f08597a3cb7f9ed4f913af1d4928dc505..aa4a055a50c1a007c2b1123eefa73c93dfd888f0 100644 (file)
@@ -317,8 +317,6 @@ capabilities mechanism on Linux systems, Kea can run from an unprivileged accoun
 The Control Agent (CA) can accept incoming HTTP or HTTPS connections. The default port is 8000, which
 does not require privileged access.
 
-For security reasons, a port lower than 1024 should be used (e.g. 890).
-
 Securing Kea Administrative Access
 ----------------------------------
 
index 600de21e1f3a9bbbf89d35644d39658d840e204f..29d81111b097991fd83e1ebac69583d65977cd22 100644 (file)
@@ -6,7 +6,7 @@
 // do. Comments in this configuration file sometimes refer to sections for more
 // details. These are section numbers in Kea User's Guide. The version matching
 // your software should come with your Kea package, but it is also available
-// in ISC's Knowledge base (https://kea.readthedocs.io; the direct link for
+// in ISC's Knowledgebase (https://kea.readthedocs.io; the direct link for
 // the stable version is https://kea.readthedocs.io/).
 //
 // This configuration file contains only Control Agent's configuration.
@@ -24,7 +24,6 @@
     // listener is different (e.g. 8001) than the one used by CA. Note
     // the commands should still be sent via CA. The dedicated listener
     // is specifically for HA updates only.
-    // For security reasons, a port lower than 1024 should be used (e.g. 890).
     "http-port": 8000,
 
     // Allow access only to kea-api user.