Per impostazione predefinita, Cassandra esegue l'installazione senza autenticazione abilitata. Ciò significa che chiunque abbia accesso al tuo server Cassandra può eseguire query sul database Cassandra senza alcuna autenticazione. Puoi abilitare l'autenticazione dopo aver installato Edge o durante il processo di installazione.
Se decidi di attivare l'autenticazione su Cassandra senza fornire credenziali personali, questa utilizza le seguenti credenziali predefinite:
- nome utente = 'cassandra'
- password = 'cassandra'
Puoi utilizzare questo account utente, impostare una password diversa per l'account utente o creare un nuovo utente Cassandra. Aggiungi, rimuovi e modifica utenti utilizzando le istruzioni
CREATE/ALTER/DROP USER
di Cassandra.
Per maggiori informazioni, consulta l'articolo sui comandi della shell SQL di Cassandra.
Abilita l'autenticazione Cassandra durante l'installazione
Puoi attivare l'autenticazione Cassandra al momento dell'installazione. Tuttavia, anche se puoi abilitare l'autenticazione quando installi Cassandra, devi sempre utilizzare il nome utente e la password predefiniti di cassandra (‘cassandra’:’cassandra’
) durante l'installazione.
Se vuoi utilizzare credenziali Cassandra non predefinite, devi riattivare l'autenticazione Cassandra dopo l'installazione seguendo i passaggi elencati
qui.
Se vuoi abilitare l'autenticazione Cassandra durante una nuova installazione di Cassandra, includi le proprietà riportate di seguito nel file di configurazione per tutti i nodi Cassandra:
CASS_AUTH=y CASS_USERNAME=cassandra CASS_PASSWORD=cassandra
L'installazione configurerà Cassandra con l'autenticazione abilitata e con le credenziali di cassandra:cassandra
predefinite.
Al termine dell'installazione iniziale, puoi seguire uno o più dei seguenti passaggi:
- Crea un utente alternativo da utilizzare per l'autenticazione Cassandra seguendo la procedura qui.
- Cambia la password dell'utente Cassandra predefinito seguendo la procedura indicata qui.
- Installa i componenti Edge che utilizzano Cassandra per utilizzare le credenziali impostate sopra.
Componenti Edge che si connettono a Cassandra
I seguenti componenti di Edge accedono a Cassandra:
- Server di gestione
- Processori di messaggi
- Router
- Server Qpid
- Server Postgres
Installa i componenti Edge quando è abilitata l'autenticazione Cassandra
Se hai abilitato l'autenticazione Cassandra quando installi questi componenti Edge per la prima volta, devi fornire le seguenti impostazioni nel file di configurazione silenziosa:
CASS_AUTH=Y CASS_USERNAME=<valid username in Cassandra> CASS_PASSWORD=<password for the above username>
Puoi modificare le credenziali di Cassandra dopo aver installato Cassandra. Tuttavia, se hai già installato server di gestione, processori di messaggi, router, server Qpid o server Postgres, devi anche aggiornare questi componenti in modo da utilizzare le nuove credenziali, come descritto nella sezione successiva.
Aggiornamento dei componenti Edge che si connettono a Cassandra
Utilizza la procedura seguente per aggiornare tutti i componenti Edge che comunicano con Cassandra utilizzando le nuove credenziali. Tieni presente che devi eseguire questo passaggio prima di aggiornare effettivamente le credenziali Cassandra:
- Sul nodo del server di gestione, esegui questo comando:
/opt/apigee/apigee-service/bin/apigee-service edge-management-server store_cassandra_credentials -u cassandra_username -p cassandra_password
Facoltativamente, puoi passare un file contenente il nuovo nome utente e la nuova password al comando:
apigee-service edge-management-server store_cassandra_credentials -f configFile
dove
configFile
contiene quanto segue:CASS_USERNAME=cassandra_username # Default is cassandra CASS_PASSWORD='cassandra_password' # Default is cassandra; wrap in single quotes if it includes special characters.
Questo comando riavvia automaticamente il server di gestione.
- Ripeti il passaggio 1 per ciascuno dei seguenti servizi:
- Tutti i processori di messaggi
- Tutti i router
- Tutti i server Qpid (edge-qpid-server)
- Server Postgres (server edge-postgres)
Quando ripeti il passaggio 1 per ogni servizio, sostituisci
edge-management-server
nel comando precedente con il nome del servizio appropriato. Ad esempio, quando esegui il passaggio per un servizio Router, utilizza questo comando:/opt/apigee/apigee-service/bin/apigee-service edge-router store_cassandra_credentials -u cassandra -p cassandra
Attiva l'autenticazione Cassandra dopo l'installazione
Nelle sezioni seguenti viene spiegato come attivare l'autenticazione Cassandra dopo l'installazione.
Attiva l'autenticazione Cassandra in una singola configurazione di data center
Per una singola configurazione Apigee basata su data center in cui Cassandra è già installato, puoi:
- Abilita l'autenticazione Cassandra per la prima volta utilizzando l'utente Cassandra predefinito (
cassandra:cassandra
) o creando un super utente completamente nuovo. Per farlo:- Segui i passaggi descritti in Attivare l'autenticazione Cassandra per la prima volta.
- Aggiorna i componenti Edge che si connettono a Cassandra con il nome utente e la password di Cassandra.
- Cambiare la password di un utente Cassandra esistente.
Se hai attivato l'autenticazione Cassandra utilizzando le credenziali Cassandra predefinite
(
cassandra:cassandra
), puoi cambiare la password seguendo questi passaggi:- Cambia la password per un utente Cassandra.
- Aggiorna i componenti Edge che si connettono a Cassandra con il nome utente e la password di Cassandra.
Nota: l'utente "Cassandra" è un utente speciale di Cassandra. L'autenticazione mediante questo utente richiede la coerenza QUORUM. Consulta Informazioni sui livelli di coerenza di Cassandra.
Attiva l'autenticazione Cassandra quando sono presenti più data center
Quando espandi i data center, segui i passaggi in uno dei seguenti scenari, a seconda di quale corrisponde alla tua configurazione.
Scenario 1: un data center esistente ha l'autenticazione Cassandra
Se l'autenticazione Cassandra è già abilitata in un data center esistente con credenziali
cassandra:cassandra
predefinite, segui questi passaggi:- Configura un nuovo data center con le credenziali Cassandra:Cassandra predefinite e CASS_AUTH=y. Vedi Attivare l'autenticazione Cassandra per la prima volta.
- Installa i componenti Edge nel nuovo data center utilizzando le credenziali Cassandra predefinite.
Se l'autenticazione Cassandra è già abilitata in un data center esistente con credenziali non predefinite, segui questi passaggi:
- Configura un nuovo data center con le credenziali Cassandra:Cassandra predefinite e CASS_AUTH=y. Vedi Attivare l'autenticazione Cassandra per la prima volta.
- Segui i passaggi per abilitare l'autenticazione Cassandra per la prima volta per riutilizzare le credenziali di un data center esistente (se quello esistente utilizza una credenziale non predefinita).
- Installa i componenti Edge nel nuovo data center utilizzando le credenziali Cassandra non predefinite.
Scenario 2: un data center esistente non ha l'autenticazione Cassandra abilitata
Se l'autenticazione cassandra non è abilitata, segui questi passaggi:
- Configura un nuovo data center senza l'autenticazione Cassandra.
- Segui i passaggi per abilitare l'autenticazione Cassandra per la prima volta per abilitare l'autenticazione Cassandra nel cluster (dopo l'espansione).
- Aggiorna i componenti Edge che si connettono a Cassandra seguendo i passaggi qui.
Attivare l'autenticazione Cassandra per la prima volta
Utilizza la procedura seguente per abilitare l'autenticazione Cassandra per la prima volta o per creare nuovi nome utente e password Cassandra:
- Crea un file di configurazione invisibile all'utente con i contenuti mostrati di seguito:
# Specify IP address or DNS name of cassandra node IP1=192.168.1.1 IP2=192.168.1.2 IP3=192.168.1.3 # Must resolve to IP address or DNS name of host HOSTIP=$(hostname -i) # Set to ‘y’ to enable Cassandra authentication. CASS_AUTH=y # Possible values are ‘y/n’ # Cassandra username. If it does not exist, this user would be created as a SUPERUSER CASS_USERNAME=cassandra # Default value is cassandra # Cassandra Password. If CASS_USERNAME does not exist, create SUPERUSER with this as password CASS_PASSWORD=cassandra # Default value is cassandra # Space-separated IP/DNS names of the Cassandra hosts CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1" # Username of an existing C* user. Only needed if you have disabled or change details of the default cassandra user(‘cassandra’) CASS_EXISTING_USERNAME=cassandra # The default username is cassandra # Password of an existing C* user. Only needed if you have disabled or change password of the default cassandra user(‘cassandra’) CASS_EXISTING_PASSWORD=cassandra # The default password is cassandra # Cassandra port CASS_PORT=9042 # The default port is 9042.
- Accedi al primo nodo Cassandra ed esegui questo comando:
apigee-service apigee-cassandra enable_cassandra_authentication -f CONFIG
Facoltativamente, puoi passare allo script le proprietà come argomenti del comando, come mostrato nell'esempio seguente:
CASS_AUTH=y HOSTIP=$(hostname -i) CASS_PORT=9042 CASS_EXISTING_USERNAME=cassandra CASS_EXISTING_PASSWORD=cassandra CASS_USERNAME=cassandra CASS_PASSWORD=cassandra CASS_HOSTS="192.168.1.1:1,1 192.168.1.2:1,1 192.168.1.3:1,1" apigee-service apigee-cassandra enable_cassandra_authentication
Note:
- Per le credenziali predefinite di Cassandra, il comando riportato sopra abilita l'autenticazione Cassandra e riavvia quest'ultima.
- Per le credenziali non predefinite, il comando modifica anche il fattore di replica, crea un super user ed esegue una riparazione nello spazio delle chiavi system_auth.
- Ripeti i passaggi 1 e 2 su tutti i nodi Cassandra uno alla volta.
Modificare le credenziali di Cassandra dopo l'installazione di Cassandra
Per modificare le credenziali di Cassandra dopo l'installazione di Cassandra:
- Accedi a qualsiasi nodo Cassandra utilizzando lo strumento
cqlsh
e le credenziali predefinite. Devi modificare la password su un solo nodo, che verrà trasmessa a tutti i nodi Cassandra nell'anello:/opt/apigee/apigee-cassandra/bin/cqlsh cassIP 9042 -u cassandra -p cassandra
Dove:
- cassIP è l'indirizzo IP del nodo Cassandra.
- 9042 è la porta Cassandra predefinita.
- L'utente predefinito è
cassandra
. - La password predefinita è
cassandra
. Se hai modificato la password in precedenza, utilizza la password attuale. Se la password contiene caratteri speciali, racchiudila tra virgolette singole.
- Esegui questo comando alla richiesta di
cqlsh>
per aggiornare la password:ALTER USER cassandra WITH PASSWORD 'NEW_PASSWORD';
- Esci dallo strumento
cqlsh
, come illustrato nell'esempio seguente:exit
- Se non hai ancora installato il server di gestione, i processori di messaggi, i router, i server Qpid o i server Postgres, imposta le seguenti proprietà nel file di configurazione, quindi installa questi componenti:
CASS_USERNAME=cassandra CASS_PASSWORD=NEW_PASSWORD
- Se hai già installato server di gestione, processori di messaggi, router, server Qpid o server Postgres, consulta Reimpostazione delle password perimetrali per la procedura per aggiornare questi componenti in modo da utilizzare la nuova password.