Skip to content

HDDS-16759. Document that DB checkpoint endpoints are not authenticated without SPNEGO - #567

Open
smengcl wants to merge 2 commits into
apache:masterfrom
smengcl:HDDS-16759
Open

smengcl wants to merge 2 commits into
apache:masterfrom
smengcl:HDDS-16759

Conversation

@smengcl

@smengcl smengcl commented Oct 7, 2026

Copy link
Copy Markdown
Contributor

Generated-by: Claude Code (Opus 5.5)

What changes were proposed in this pull request?

The OM and SCM web servers authenticate requests only when HTTP Kerberos (SPNEGO) is enabled, which is off by default. The admin check of the DB checkpoint endpoints needs an authenticated caller, so it is applied only with SPNEGO.

This PR adds a paragraph to the "Default authentication" section of the HTTP authentication page that says so, and tells operators of a secure cluster to enable SPNEGO for OM and SCM or restrict network access to their HTTP ports. Only docs/ (Next) is changed.

The matching config descriptions and THREAT_MODEL.md change are in apache/ozone#11439.

What is the link to the Apache Jira?

https://issues.apache.org/jira/browse/HDDS-16759

How was this patch tested?

Ran markdownlint and cspell on the edited page locally. The full site build is left to CI.

🤖 Generated with Claude Code

…ed without SPNEGO

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@smengcl
smengcl marked this pull request as ready for review October 7, 2026 18:28
Copilot AI balanced review requested due to automatic review settings October 7, 2026 18:28

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🟡 Changes recommended

The referenced SCM instructions use incorrect configuration property names.

1 open finding
What changed in this PR

Documents the unauthenticated DB checkpoint risk when SPNEGO is disabled.

Changes:

  • Describes affected OM and SCM endpoints.
  • Recommends SPNEGO or network restrictions.
File Description
docs/​.../​03-https.md Adds checkpoint endpoint security guidance.

🧠 Review effort: Balanced


💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

…names

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@smengcl
smengcl requested a review from jojochuang October 7, 2026 19:05
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.

2 participants