Steps for Production Environments
To enable access control without downtime or interrupting services, use transitional modes to temporarily support applications and users that do not have accounts.
Procedure
-
Update all applications to provide credentials and ensure that they use the latest DSE-compatible driver.
When using
authentication.transitional_mode, you can provide a blank username and password to log in with theanonymousrole.When authentication and authorization are disabled, the credentials portion of the connection request is ignored. After authentication is enabled all connections must provide credentials.
-
Change the replication factor for the security keyspaces, see Configuring the security keyspaces replication factors.
-
Run a full repair of the
system_authanddse_auth keyspace. -
On each node, enable authentication and authorization in transitional mode:
-
Set authentication_options and transitional_mode to permissive.
-
Set authorization_options and auth_transitional_mode to
normal.
-
-
Turn on logging to allow verification that applications can authenticate. See Setting up database auditing.
-
Enable JMX authentication, see Controlling access to JMX MBeans.
-
Perform a rolling restart.
The transactional nodes are vulnerable to malicious activity following the restart. Anybody can access the system using the default
cassandraaccount with passwordcassandra. DataStax recommends isolating the cluster until after disabling thecassandraaccount. -
After the restarts are complete, use
cqlshto replace thecassandradefault account, see Adding a superuser login.Using the default
cassandraaccount may impact performance. All requests including login execute with consistency levelQUORUM. DataStax recommends using this account only to create yourrootaccount. -
Switch to the new
rootaccount and configure roles and assign permissions, see Setting up logins and users. -
Use the
auditlogs, or theKDClogs when using Kerberos, to verify that all applications can access the transactional nodes and have the permissions required to execute requests. See Log formats. -
In the
dse.yamlfile, setauthentication_optionsandauthorization_optionstransitional_modetodisabled. -
Perform a rolling restart.