DC/OS Apache NiFi Service encryption, authentication and authorization


DC/OS Apache NiFi Security

The DC/OS Apache NiFi service supports Apache NiFi’s native transport encryption, authentication, and authorization mechanisms. The service provides automation and orchestration to simplify the use of these important features.

A good overview of these features can be found in the Apache NiFi Administration Guide.

Transport Encryption and SSL Authentication

With transport encryption enabled, the DC/OS NiFi Service will automatically deploy all nodes with the correct configuration to encrypt communication via SSL. The nodes will communicate securely between themselves using SSL. SSL authentication requires that all NiFi nodes present a valid certificate. From this certificate, their identity can be derived for communicating between nodes.

DC/OS NiFi Service uses the CN of the SSL certificate as the principal for a given node.

Example: CN=nifi-0-node.demonifi, O=“Mesosphere, Inc”, L=San Francisco, ST=CA, C=US.

The service uses the DC/OS CA to generate the SSL artifacts to secure the service. Any client that trusts the DC/OS CA will consider the service’s certificates valid.

Note: Transport encryption must be enabled in order to use SSL authentication for authentication, but is optional for Kerberos authentication.


Configure Transport Encryption

See the Guide to Configuring DC/OS Access for NiFi.

Set up the service account

Grant the service account the correct permissions.

In DC/OS 1.10, the required permission is dcos:superuser full:

curl -k -v $(dcos config show core.dcos_url)/ca/dcos-ca.crt -o ../dcos-ca.crt
export LC_ALL=C.UTF-8
export LANG=C.UTF-8
dcos package install dcos-enterprise-cli
dcos security org service-accounts keypair nifi-private-key.pem nifi-public-key.pem
dcos security org service-accounts create -p nifi-public-key.pem -d "dcos_nifi" <service name>
dcos security secrets create-sa-secret --strict nifi-private-key.pem <service name> <service name secret>
dcos security org users grant <service name> dcos:superuser full --description "grant permission to superuser"

where <service name> is the name of the service to be installed.

Install the service

Install the DC/OS NiFi Service, including the following options in addition to your own:

 "service": {
    "service_account": "<your service account name>",
    "service_account_secret": "<full path of service secret>",
    "security": {
       "tls_ssl": {
          "enabled": true

Transport encryption for clients

With Transport Encryption enabled, service clients will need to be configured to use the DC/OS CA bundle to verify the connections they make to the service. Consult your client’s documentation for trusting a CA and configure your client appropriately.


DC/OS NiFi Service supports two authentication mechanisms, SSL and Kerberos. The two are supported independently and may not be combined. If both SSL and Kerberos authentication are enabled, the service will use Kerberos authentication.

Note: Kerberos authentication can be combined with transport encryption.

CA based authentication between nodes

DC/OS NiFi Service requires certificated based authentication between nodes.

DC/OS NiFi Service uses the CN of the SSL certificate as the principal for a given node.

Example: CN=nifi-0-node.demonifi, O=“Mesosphere, Inc”, L=San Francisco, ST=CA, C=US.

Kerberos authentication for end users

Kerberos authentication relies on a central authority to verify that NiFi users’ clients are who they say they are. DC/OS NiFi Service integrates with your existing Kerberos infrastructure to verify the identity of clients.


  • The hostname and port of a Key Distribution Center (KDC) reachable from your DC/OS cluster
  • Sufficient access to the KDC to create Kerberos principals
  • Sufficient access to the KDC to retrieve a keytab for the generated principals
  • The DC/OS Enterprise CLI
  • DC/OS Superuser permissions

Configure Kerberos authentication

1. Create principals

The DC/OS NiFi Service requires a Kerberos principal for the service principal and user principal. Each principal must be of the form

 nifinode@<service realm>
 nifiadmin@<service realm>

2. Place service keytab in DC/OS Secret Store

The DC/OS NiFi Service uses a keytab containing the service and user principals (service keytab). After creating the principals as described above, generate the service keytab, making sure to include all the node principals. This will be stored as a secret in the DC/OS Secret Store by name __dcos_base64__secret_name. The DC/OS security modules will handle decoding the file when it is used by the service. More details here.

Documentation for adding a file to the secret store can be found here.

Note: Secrets access is controlled by DC/OS Spaces, which function like namespaces. Any secret in the same DC/OS Space as the service will be accessible by the service.

3. Install the service

Install the DC/OS NiFi Service with the following options in addition to your own: shell { "service": { "security": { "kerberos": { "enabled": true, "kdc": { "hostname": "<kdc host>", "port": <kdc port> }, "primary": "<service primary default nifi>", "realm": "<realm>", "keytab_secret": "<path to keytab secret>", "service_principal": "nifinode@<service realm>", "user_principal": "nifiadmin@<service realm>" } } } }