Skip to content

Document how to configure advanced SSL/TLS settings for the Fleet Server integration - #7657

Open
vishaangelova wants to merge 4 commits into
mainfrom
3573-fleet-server-advanced-ssl-configs
Open

Document how to configure advanced SSL/TLS settings for the Fleet Server integration#7657
vishaangelova wants to merge 4 commits into
mainfrom
3573-fleet-server-advanced-ssl-configs

Conversation

@vishaangelova

@vishaangelova vishaangelova commented Jul 30, 2026

Copy link
Copy Markdown
Member

Summary

Documents how to configure the Fleet Server input's SSL/TLS settings (cipher_suites, supported_protocols, and other server.ssl options) using the Fleet Server integration policy's advanced YAML, adds a connectivity-risk warning, and clarifies that these settings have no elastic-agent install CLI flags.

Resolves #3573

Changes

  • reference/fleet/secure-connections.md (primary): New "Configure advanced SSL/TLS settings for Fleet Server" section explaining that supported_protocols and cipher_suites aren't exposed as UI fields or install flags and must be set using a server.ssl block in the Fleet Server integration policy's Custom fleet-server configurations (Advanced options).

    Includes the UI procedure, a YAML example, default behavior, a link to the full settings reference, and a connectivity-risk warning. Also adds a note in the CLI section clarifying no install flags exist for these settings.

  • reference/fleet/fleet-server-scalability.md: Adds a pointer from the "Advanced Fleet Server options" section to the new section.

  • reference/fleet/elastic-agent-ssl-configuration.md: Adds a note at the server SSL options that these settings also apply to the Fleet Server input under server.ssl, linking to the new section.

Verification

Content was verified against the codebase in the kibana, integrations, fleet-server, and elastic-agent-libs repos:

  • Kibana's Fleet Server host SSL model and policy compilation emit only cert/CA/key/client-auth (no cipher/protocol fields).
  • The integrations fleet_server package exposes a custom YAML var that passes server.ssl through verbatim.
  • fleet-server's server.ssl maps to tlscommon.ServerConfig, and the default supported_protocols (TLSv1.2, TLSv1.3) and cipher suite list match the documented reference values.

Generative AI disclosure

  1. Did you use a generative AI (GenAI) tool to assist in creating this contribution?
  • Yes
  • No
  1. If you answered "Yes" to the previous question, please specify the tool(s) and model(s) used (e.g., Google Gemini, OpenAI ChatGPT-4, etc.).

Tool(s) and model(s) used: Cursor / Claude Opus 4.8 High

@github-actions

Copy link
Copy Markdown
Contributor

Elastic Docs AI PR menu

Check the box to run an AI review for this pull request.

  • Review docs changes (docs-review). Status: not started.

Powered by GitHub Agentic Workflows and docs-actions. For more information, reach out to the docs team.

@github-actions

Copy link
Copy Markdown
Contributor

✅ Elastic Docs Style Checker (Vale)

No issues found on modified lines!


The Vale linter checks documentation changes against the Elastic Docs style guide. To use Vale locally or report issues, refer to Elastic style guide for Vale.

@github-actions

github-actions Bot commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

Co-authored-by: Cursor <cursoragent@cursor.com>
@vishaangelova
vishaangelova force-pushed the 3573-fleet-server-advanced-ssl-configs branch from c5d911f to a167fd8 Compare July 30, 2026 13:29
@vishaangelova
vishaangelova marked this pull request as ready for review July 30, 2026 13:31
@vishaangelova
vishaangelova requested a review from a team as a code owner July 30, 2026 13:31
@vishaangelova

Copy link
Copy Markdown
Member Author

Hey @ebeahan, could you direct me to an SME who can review the changes in this PR? Thank you! 🙏

@vishaangelova vishaangelova changed the title Document how to configure advanced SSL/TLS settings for Fleet Server Document how to configure advanced SSL/TLS settings for the Fleet Server integration Jul 30, 2026
Comment thread reference/fleet/elastic-agent-ssl-configuration.md Outdated
Comment thread reference/fleet/secure-connections.md Outdated
Co-authored-by: Cursor <cursoragent@cursor.com>
Add section headings for the common, client, and server SSL option
groups, clarify the intro that explains when each group applies, fix a
typo, and point the secure-connections cross-link at the new anchor.

Co-authored-by: Cursor <cursoragent@cursor.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Fleet Server] Document how to change SSL/TLS settings of Fleet Server input

3 participants