elastic / elastic/docs-content
Update CCS privileges step to cover both API key and TLS auth models
- Dominant language
- No language data
- Stars
- 47
- Forks
- 261
- Avg merge
- 3d 12h
- Merged PRs (30d)
- 116
Description
The step in [solutions/security/detect-and-alert/cross-cluster-search-detection-rules.md](https://www.elastic.co/docs/solutions/security/detect-and-alert/cross-cluster-search-detection-rules#set-up-ccs-rules) (PR: https://github.com/elastic/docs-content/pull/6934#discussion_r3423454453) will link to the TLS CCS privileges section as soon as https://github.com/elastic/docs-content/pull/6934 is merged.
The text around the step describes TLS certificate authentication only. For API key authentication (which is the recommended method) roles are created on the local cluster only using remote_indices privileges; no remote cluster role is required.
Request:
- Update the step that starts "On both the local and remote clusters, create a role for {{ccs}} privileges …" to cover both authentication models. Specifically:
- For API key authentication: state that roles/users are created on the local cluster only and use remote_indices privileges (link to remote-clusters API key page).
- For TLS certificate authentication: keep the existing instruction that roles must be created on both clusters and link to the TLS cert subsection.
- Make the step explicit about which [security model](https://www.elastic.co/docs/deploy-manage/remote-clusters#security-models-and-connection-modes) each substep applies to, and include direct links to the relevant sections.
Notes:
- The current minimal fix (linking directly to the TLS cert subsection) is fine for now, but we should implement the fuller change so the step is accurate for both auth models and avoids confusing readers (especially in light of the TLS method being deprecated).
- This is a documentation/content change only; no product changes required.
Contributor guide
No contributing guide indexed for this repository
Assessment
This issue has not been assessed yet.