Skip to content

ECE: Clarify HTTPS requirement for Cloud UI browser access (port 12443)#6983

Open
magdalena-alicja-michalska wants to merge 2 commits into
mainfrom
fix/ece-https-only-admin-console
Open

ECE: Clarify HTTPS requirement for Cloud UI browser access (port 12443)#6983
magdalena-alicja-michalska wants to merge 2 commits into
mainfrom
fix/ece-https-only-admin-console

Conversation

@magdalena-alicja-michalska

Copy link
Copy Markdown

Summary

Starting with ECE 3.7.0, browser access to the Cloud UI requires HTTPS on port 12443. HTTP on port 12400 remains functional for programmatic API access (e.g., curl) but browsers cannot render the UI over HTTP due to a Content-Security-Policy: upgrade-insecure-requests directive.

This was an undocumented change that has caused customer confusion (e.g., elastic/sdh-control-plane#13040).

Changes

log-into-cloud-ui.md:

  • Removed the http://<FIRST_HOST>:12400 URL
  • Added a note explaining that HTTPS on port 12443 is required for browser access since ECE 3.7.0

ece-networking-prereq.md:

  • Updated the Cloud UI port row to clarify 12443 is required and 12400 is optional (API only)
  • Added a note explaining the HTTPS requirement for browser access

Context

  • The CSP directive was introduced in ECE 3.7.0 as a side effect of a library migration (elastic/cloud#117047)
  • The behavior was acknowledged and kept by the team (elastic/cp-hosted-team#2423) but never documented
  • Related engineering issue: elastic/cloud#131038
  • Companion PR for install output: elastic/cloud#156490

Test plan

  • Verify docs build without errors
  • Review wording with @platform-docs team
  • Confirm admonition renders correctly

Made with Cursor

@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

github-actions Bot commented Jun 18, 2026

Copy link
Copy Markdown
Contributor

@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.

| 3 | Proxy | 9300, 9343 | {{es}} transport client. 9300 is plain text and 9343 is with TLS, also required by load balancers<br> |
| 3 | Proxy | 9400, 9443 | {{es}} Cross Cluster Search and Cross Cluster Replication with TLS authentication (9400) or API key authentication (9443), also required by load balancers. Can be blocked if [CCR/CCS](../../remote-clusters/ece-enable-ccs.md) is not used.<br> |
| 7 | Coordinator | 12400/12443 | Cloud UI console to API (HTTP/HTTPS)<br> |
| 7 | Coordinator | 12443 (required), 12400 (optional) | Cloud UI console (HTTPS required for browser access, HTTP for API only)<br> |

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

why is 12400 marked as optional? for programmatic access?

@shainaraskas shainaraskas left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

apart from yoel's comment, this lgtm. however, we should make equivalent changes to the 3.x docs over here because it's a big blocker (the user on 3.8 might be using these docs), and consider backporting to 3.7 - should be able to just use the edit button, but let me know if you need help

https://www.elastic.co/guide/en/cloud-enterprise/3.8/ece-networking-prereq.html

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.

3 participants