You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@ozone.apache.org by "jojochuang (via GitHub)" <gi...@apache.org> on 2026/10/12 17:19:37 UTC

[PR] HDDS-16347. Document HTTP SPNEGO _HOST resolution for operators [ozone]

jojochuang opened a new pull request, #11495:
URL: https://github.com/apache/ozone/pull/11495

   ## Summary
   
   Adds operator documentation for [HDDS-16347](https://issues.apache.org/jira/browse/HDDS-16347): how Ozone expands `_HOST` in HTTP Kerberos principals from **advertised** `*-address` settings (not `*-bind-host`), including IPv6 bind and S3 web admin notes.
   
   Updates `hadoop-hdds/docs/content/security/SecuringOzoneHTTP.md` (site: [Kerberos SPNEGO HTTP auth](https://ozone.apache.org/docs/next/administrator-guide/configuration/security/https/)).
   
   ## Jira
   
   This is a **documentation follow-up** to HDDS-16347. If the project prefers a separate doc ticket, please file one and we can retitle this PR to that key.
   
   ## Test plan
   
   - [ ] Docs build / review rendered markdown
   - [ ] Cross-check with https://github.com/apache/ozone/pull/11464
   
   
   Made with [Cursor](https://cursor.com)


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: issues-unsubscribe@ozone.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@ozone.apache.org
For additional commands, e-mail: issues-help@ozone.apache.org


Re: [PR] HDDS-16945. Document HTTP SPNEGO _HOST resolution for operators [ozone]

Posted by "jojochuang (via GitHub)" <gi...@apache.org>.
jojochuang closed pull request #11495: HDDS-16945. Document HTTP SPNEGO _HOST resolution for operators
URL: https://github.com/apache/ozone/pull/11495


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: issues-unsubscribe@ozone.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@ozone.apache.org
For additional commands, e-mail: issues-help@ozone.apache.org


Re: [PR] HDDS-16945. Document HTTP SPNEGO _HOST resolution for operators [ozone]

Posted by "Copilot (via GitHub)" <gi...@apache.org>.
Copilot commented on code in PR #11495:
URL: https://github.com/apache/ozone/pull/11495#discussion_r4250757180


##########
hadoop-hdds/docs/content/security/SecuringOzoneHTTP.md:
##########
@@ -54,6 +54,33 @@ ozone.http.filter.initializers | org.apache.hadoop.security.AuthenticationFilter
 After that, individual component needs to configure properly to completely enable
 SPNEGO or SIMPLE authentication.
 
+### Resolving `_HOST` in the Kerberos principal
+
+`HTTP/_HOST@REALM` in `*.http.auth.kerberos.principal` is expanded at startup. The
+hostname must match your **keytab** and the **host in the browser URL**.
+
+Ozone takes `_HOST` from the **advertised** web address (`ozone.<service>.http-address`
+or `https-address`), **not** from `*-http-bind-host`. Bind host only chooses where
+the process listens (`0.0.0.0`, `::`, a NIC IP, and so on).
+
+| Property (OM example) | Example | Used for `_HOST` |
+|-----------------------|---------|------------------|
+| `ozone.om.http-address` | `om1.example.com:9874` | Yes |
+| `ozone.om.http-bind-host` | `0.0.0.0` or `::` | No |

Review Comment:
   This table is not valid Markdown table syntax due to the double leading `||` on each line. Most Markdown renderers will not recognize it as a table. Use a single leading `|` per row (and keep the separator row aligned) so the docs site renders it correctly.



##########
hadoop-hdds/docs/content/security/SecuringOzoneHTTP.md:
##########
@@ -54,6 +54,33 @@ ozone.http.filter.initializers | org.apache.hadoop.security.AuthenticationFilter
 After that, individual component needs to configure properly to completely enable
 SPNEGO or SIMPLE authentication.
 
+### Resolving `_HOST` in the Kerberos principal
+
+`HTTP/_HOST@REALM` in `*.http.auth.kerberos.principal` is expanded at startup. The
+hostname must match your **keytab** and the **host in the browser URL**.
+
+Ozone takes `_HOST` from the **advertised** web address (`ozone.<service>.http-address`
+or `https-address`), **not** from `*-http-bind-host`. Bind host only chooses where

Review Comment:
   The second property reference `https-address` is ambiguous without the `ozone.<service>.` prefix (unlike `ozone.<service>.http-address` on the previous line). To avoid operator confusion, spell it out consistently as `ozone.<service>.https-address`.



##########
hadoop-hdds/docs/content/security/SecuringOzoneHTTP.md:
##########
@@ -54,6 +54,33 @@ ozone.http.filter.initializers | org.apache.hadoop.security.AuthenticationFilter
 After that, individual component needs to configure properly to completely enable
 SPNEGO or SIMPLE authentication.
 
+### Resolving `_HOST` in the Kerberos principal
+
+`HTTP/_HOST@REALM` in `*.http.auth.kerberos.principal` is expanded at startup. The
+hostname must match your **keytab** and the **host in the browser URL**.
+
+Ozone takes `_HOST` from the **advertised** web address (`ozone.<service>.http-address`
+or `https-address`), **not** from `*-http-bind-host`. Bind host only chooses where
+the process listens (`0.0.0.0`, `::`, a NIC IP, and so on).
+
+| Property (OM example) | Example | Used for `_HOST` |
+|-----------------------|---------|------------------|
+| `ozone.om.http-address` | `om1.example.com:9874` | Yes |
+| `ozone.om.http-bind-host` | `0.0.0.0` or `::` | No |
+
+If `*-address` uses a wildcard host (`0.0.0.0` or `[::]`), Ozone uses this machine's
+**canonical hostname** (same idea as default Hadoop installs).
+
+**Recommended:** set `*-address` to the FQDN in the keytab; keep `*-bind-host` on
+`0.0.0.0` or `::` if needed; open the UI with that FQDN. For **IPv6 bind `::`**, still
+set a non-wildcard FQDN in `*-address`. S3 web admin (and Kerberos `/secret/*` when
+enabled) follows `ozone.s3g.webadmin.http-address` / `https-address` the same way.
+
+**SPNEGO fails:** check `klist -k -t <keytab>` against `*-address` and the browser URL

Review Comment:
   In Markdown/HTML rendering, `<keytab>` may be treated as an HTML tag and disappear from the rendered output. Replace it with a non-angle-bracket placeholder (e.g., a path like `/path/to/keytab`) or escape the angle brackets so operators see the intended command.



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: issues-unsubscribe@ozone.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@ozone.apache.org
For additional commands, e-mail: issues-help@ozone.apache.org


Re: [PR] HDDS-16945. Document HTTP SPNEGO _HOST resolution for operators [ozone]

Posted by "jojochuang (via GitHub)" <gi...@apache.org>.
jojochuang commented on PR #11495:
URL: https://github.com/apache/ozone/pull/11495#issuecomment-6129164695

   Closing: operator docs for HDDS-16347 belong on apache/ozone-site (Docusaurus), not in the ozone code repo. See the replacement PR on apache/ozone-site (HDDS-16945).


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: issues-unsubscribe@ozone.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@ozone.apache.org
For additional commands, e-mail: issues-help@ozone.apache.org