Skip to content

Commit e4c1f54

Browse files
committed
Add a "Limitations" section to certificates-rotation
1 parent 5cee36a commit e4c1f54

File tree

1 file changed

+22
-0
lines changed

1 file changed

+22
-0
lines changed

reference/fleet/certificates-rotation.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,8 @@ In some scenarioes you may want to rotate your configured certificate authoritie
1414
* [Rotating an {{es}} CA for connections from {{fleet-server}}](#certificates-rotation-fs-es)
1515
* [Rotating an {{es}} CA for connections from {{agent}}](#certificates-rotation-agent-es)
1616

17+
For important notes about current limitations (such as restart requirements and unsupported features), refer to [Limitations](#limitations).
18+
1719

1820
## Rotating a {{fleet-server}} CA [certificates-rotation-agent-fs]
1921

@@ -193,3 +195,23 @@ To rotate a CA certificate on {{es}} for connections from {{agent}}:
193195
:alt: Screen capture of the Edit Output UI: Elasticsearch CA trusted fingerprint
194196
:screenshot:
195197
:::
198+
199+
## Limitations
200+
201+
Keep the following in mind when rotating certificates and certificate authorities (CAs):
202+
203+
* **Agent restart required**
204+
205+
Elastic Agent does not support hot reloading of updated certificates or CA files. You must restart the agent to apply changes.
206+
207+
* **Directory loading not supported**
208+
209+
Unlike Beats, Elastic Agent does not support passing a directory of CAs (for example, `--capath`) or monitoring a directory for changes. You must reference a specific file.
210+
211+
* **Rotation without re-enrollment**
212+
213+
When rotating a CA, you can avoid agent re-enrollment by including both the old and new CAs in the configured CA file, restarting the agent, and then removing the old CA after the switch.
214+
215+
* **Mutual TLS (`--fleet-server-client-auth=required`)**
216+
217+
If mTLS is enabled, you must apply the same overlap approach (adding a new CA before removing the old) on both client and server. The rotation process itself is otherwise unchanged.

0 commit comments

Comments
 (0)