Securing HTTP
This document describes how to configure Ozone HTTP web-consoles to require user authentication.
Default authentication
By default Ozone HTTP web-consoles (OM, SCM, S3G, Recon, Datanode) allow access without authentication based on the following default configurations.
| Property | Value |
|---|---|
| ozone.security.http.kerberos.enabled | false |
| ozone.http.filter.initializers |
If you have an SPNEGO enabled Ozone cluster and want to disable it for all Ozone services, just make sure the two key mentioned are configured as above.
Kerberos based SPNEGO authentication
However, they can be configured to require Kerberos authentication using HTTP SPNEGO protocol (supported by browsers like Firefox and Chrome). To achieve that, the following keys must be configured first.
| Property | Value |
|---|---|
| hadoop.security.authentication | kerberos |
| ozone.security.http.kerberos.enabled | true |
| ozone.http.filter.initializers | org.apache.hadoop.security.AuthenticationFilterInitializer |
After that, individual component needs to configure properly to completely enable SPNEGO or SIMPLE authentication.
Enable SPNEGO authentication for OM HTTP
| Property | Value |
|---|---|
| ozone.om.http.auth.type | kerberos |
| ozone.om.http.auth.kerberos.principal | HTTP/_HOST@REALM |
| ozone.om.http.auth.kerberos.keytab | /path/to/HTTP.keytab |
Enable SPNEGO authentication for S3G HTTP
| Property | Value |
|---|---|
| ozone.s3g.http.auth.type | kerberos |
| ozone.s3g.http.auth.kerberos.principal | HTTP/_HOST@REALM |
| ozone.s3g.http.auth.kerberos.keytab | /path/to/HTTP.keytab |
Enable SPNEGO authentication for RECON HTTP
| Property | Value |
|---|---|
| ozone.recon.http.auth.type | kerberos |
| ozone.recon.http.auth.kerberos.principal | HTTP/_HOST@REALM |
| ozone.recon.http.auth.kerberos.keytab | /path/to/HTTP.keytab |
Enable SPNEGO authentication for SCM HTTP
| Property | Value |
|---|---|
| hdds.scm.http.auth.type | kerberos |
| hdds.scm.http.auth.kerberos.principal | HTTP/_HOST@REALM |
| hdds.scm.http.auth.kerberos.keytab | /path/to/HTTP.keytab |
Enable SPNEGO authentication for DATANODE HTTP
| Property | Value |
|---|---|
| hdds.datanode.http.auth.type | kerberos |
| hdds.datanode.http.auth.kerberos.principal | HTTP/_HOST@REALM |
| hdds.datanode.http.auth.kerberos.keytab | /path/to/HTTP.keytab |
Note: Ozone datanode does not have a default webpage, which prevents you from accessing “/” or “/index.html”. But it does provide standard servlet like jmx/conf/jstack via HTTP.
In addition, Ozone HTTP web-console support the equivalent of Hadoop’s Pseudo/Simple authentication. If this option is enabled, the user name must be specified in the first browser interaction using the user.name query string parameter. e.g., http://scm:9876/?user.name=scmadmin.
Enable SIMPLE authentication for OM HTTP
| Property | Value |
|---|---|
| ozone.om.http.auth.type | simple |
| ozone.om.http.auth.simple.anonymous.allowed | false |
If you don’t want to specify the user.name in the query string parameter, change ozone.om.http.auth.simple.anonymous.allowed to true.
Enable SIMPLE authentication for S3G HTTP
| Property | Value |
|---|---|
| ozone.s3g.http.auth.type | simple |
| ozone.s3g.http.auth.simple.anonymous.allowed | false |
If you don’t want to specify the user.name in the query string parameter, change ozone.s3g.http.auth.simple.anonymous.allowed to true.
Enable SIMPLE authentication for RECON HTTP
| Property | Value |
|---|---|
| ozone.recon.http.auth.type | simple |
| ozone.recon.http.auth.simple.anonymous.allowed | false |
If you don’t want to specify the user.name in the query string parameter, change ozone.recon.http.auth.simple.anonymous.allowed to true.
Enable SIMPLE authentication for SCM HTTP
| Property | Value |
|---|---|
| hdds.scm.http.auth.type | simple |
| hdds.scm.http.auth.simple.anonymous.allowed | false |
If you don’t want to specify the user.name in the query string parameter, change hdds.scm.http.auth.simple.anonymous.allowed to true.
Enable SIMPLE authentication for DATANODE HTTP
| Property | Value |
|---|---|
| hdds.datanode.http.auth.type | simple |
| hdds.datanode.http.auth.simple.anonymous.allowed | false |
If you don’t want to specify the user.name in the query string parameter, change hdds.datanode.http.auth.simple.anonymous.allowed to true.
Next >>