Abilita autenticazione Cassandra

Per impostazione predefinita, Cassandra viene installato senza autenticazione abilitata. Ciò significa che chiunque abbia accesso al tuo server Cassandra può eseguire query sul database Cassandra senza alcuna autenticazione. Puoi attivare l'autenticazione dopo aver installato Edge o durante il processo di installazione.

Se decidi di attivare l'autenticazione su Cassandra senza fornire le tue credenziali, vengono utilizzate le seguenti credenziali predefinite:

  • username = 'cassandra'
  • password = 'cassandra'

Puoi utilizzare questo account utente, impostare una password diversa per questo account utente o creare un nuovo utente Cassandra. Aggiungi, rimuovi e modifica gli utenti utilizzando le istruzioni Cassandra CREATE/ALTER/DROP USER.

Per saperne di più, consulta i 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 attivare 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 attivare 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à quindi Cassandra con l'autenticazione abilitata e con le credenziali cassandra:cassandra predefinite.

Una volta completata l'installazione iniziale, puoi seguire uno o più dei seguenti passaggi:

  • Crea un utente alternativo da utilizzare per l'autenticazione di Cassandra seguendo la procedura descritta qui.
  • Cambia la password dell'utente Cassandra predefinito seguendo i passaggi descritti qui.
  • Installa i componenti Edge che utilizzano Cassandra per utilizzare le credenziali impostate in precedenza.

Componenti Edge che si connettono a Cassandra

I seguenti componenti Edge accedono a Cassandra:

  • Server di gestione
  • Processori di messaggi
  • Router
  • Server Qpid
  • Server Postgres

Installa i componenti Edge quando l'autenticazione Cassandra è abilitata

Se l'autenticazione Cassandra è abilitata 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 l'installazione. Tuttavia, se hai già installato il server di gestione, i processori di messaggi, i router, i server Qpid o i server Postgres, devi anche aggiornare questi componenti per utilizzare le nuove credenziali, come descritto nella sezione successiva.

Aggiorna i componenti Edge che si connettono a Cassandra

Utilizza la seguente procedura per aggiornare tutti i componenti Edge che comunicano con Cassandra con le nuove credenziali. Tieni presente che devi eseguire questo passaggio prima di aggiornare effettivamente le credenziali di Cassandra:

  1. 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

    Se vuoi, puoi passare al comando un file contenente il nuovo nome utente e la nuova password:

    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.

  2. 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 (edge-postgres-server)

    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 il seguente comando:

    /opt/apigee/apigee-service/bin/apigee-service edge-router store_cassandra_credentials -u cassandra -p cassandra

    Abilita l'autenticazione Cassandra dopo l'installazione

    Le sezioni seguenti spiegano come attivare l'autenticazione Cassandra dopo l'installazione.

    Abilita l'autenticazione Cassandra in una configurazione di un singolo data center

    Per una configurazione di Apigee basata su un singolo data center in cui è già installato Cassandra, puoi:

    Nota: l'utente "Cassandra" è un utente speciale in Cassandra. L'autenticazione con questo utente richiede la coerenza QUORUM. Consulta la sezione Informazioni sui livelli di coerenza di Cassandra.

    Abilita l'autenticazione Cassandra quando sono presenti più data center

    Quando espandi i data center, segui i passaggi di uno dei seguenti scenari, a seconda di quello che corrisponde alla tua configurazione.

    Scenario 1: il data center esistente ha l'autenticazione Cassandra abilitata

    Se l'autenticazione Cassandra è già abilitata in un data center esistente con le credenziali cassandra:cassandra predefinite, segui questi passaggi:

    1. Configura un nuovo data center con le credenziali Cassandra:Cassandra predefinite e CASS_AUTH=y. Consulta Attiva l'autenticazione Cassandra per la prima volta.
    2. Installa i componenti Edge nel nuovo data center utilizzando le credenziali predefinite di Cassandra.

    Se l'autenticazione Cassandra è già abilitata nel data center esistente con credenziali non predefinite, segui i passaggi riportati di seguito:

    1. Configura un nuovo data center con le credenziali Cassandra:Cassandra predefinite e CASS_AUTH=y. Consulta Attiva l'autenticazione Cassandra per la prima volta.
    2. Segui i passaggi descritti in Attiva l'autenticazione Cassandra per la prima volta per riutilizzare la credenziale di un data center esistente (se quello esistente utilizza una credenziale non predefinita).
    3. Installa i componenti Edge nel nuovo data center utilizzando credenziali Cassandra non predefinite.

    Scenario 2: l'autenticazione Cassandra non è abilitata nel data center esistente

    Se l'autenticazione Cassandra non è abilitata, segui questi passaggi:

    1. Configura un nuovo data center senza autenticazione Cassandra.
    2. Segui i passaggi descritti in Attiva l'autenticazione Cassandra per la prima volta per attivare l'autenticazione Cassandra nel cluster (dopo l'espansione).
    3. Aggiorna i componenti Edge che si connettono a Cassandra seguendo i passaggi descritti qui.

    Abilita l'autenticazione Cassandra per la prima volta

    Utilizza la seguente procedura per attivare l'autenticazione Cassandra per la prima volta o per creare un nuovo nome utente e una nuova password Cassandra:

    1. 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.
    2. Accedi al primo nodo Cassandra ed esegui questo comando: 
      apigee-service apigee-cassandra enable_cassandra_authentication -f CONFIG

      Se vuoi, puoi passare le proprietà come argomenti del comando allo script, 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 Cassandra predefinite, il comando precedente attiva l'autenticazione Cassandra e riavvia Cassandra.
      • Per le credenziali non predefinite, il comando modifica anche il fattore di replica, crea un super utente ed esegue una riparazione sullo spazio delle chiavi system_auth.
    3. Ripeti i passaggi 1 e 2 su tutti i nodi Cassandra uno alla volta.

    Modifica le credenziali di Cassandra dopo l'installazione di Cassandra

    Per modificare le credenziali di Cassandra dopo l'installazione:

    1. Accedi a un nodo Cassandra utilizzando lo strumento cqlsh e le credenziali predefinite. Devi solo cambiare la password su un nodo e questa verrà trasmessa a tutti i nodi Cassandra nell'anello: 
      /opt/apigee/apigee-cassandra/bin/cqlsh cassIP 9042 -u cassandra -p cassandra

      Dove:

      1. cassIP è l'indirizzo IP del nodo Cassandra.
      2. 9042 è la porta Cassandra predefinita.
      3. L'utente predefinito è cassandra.
      4. La password predefinita è cassandra. Se hai modificato la password in precedenza, utilizza la password corrente. Se la password contiene caratteri speciali, racchiudila tra virgolette singole.
    2. Esegui questo comando al prompt cqlsh> per aggiornare la password: 
      ALTER USER cassandra WITH PASSWORD 'NEW_PASSWORD';
    3. Esci dallo strumento cqlsh, come mostrato nell'esempio seguente: 
      exit
    4. 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 e poi installa i componenti: 
      CASS_USERNAME=cassandra
CASS_PASSWORD=NEW_PASSWORD
    5. Se hai già installato il server di gestione, i processori di messaggi, i router, i server Qpid o i server Postgres, consulta la sezione Reimpostazione delle password di Edge per la procedura di aggiornamento di questi componenti per l'utilizzo della nuova password.