Cassandra-Authentifizierung aktivieren

Standardmäßig wird Cassandra ohne aktivierte Authentifizierung installiert. Das bedeutet, dass jeder, der Zugriff auf Ihren Cassandra-Server hat, die Cassandra-Datenbank ohne Authentifizierung abfragen kann. Sie können die Authentifizierung nach der Installation von Edge oder im Rahmen des Installationsvorgangs aktivieren.

Wenn Sie die Authentifizierung in Cassandra aktivieren, ohne eigene Anmeldedaten anzugeben, werden die folgenden Standardanmeldedaten verwendet:

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

Sie können dieses Nutzerkonto verwenden, ein anderes Passwort für dieses Nutzerkonto festlegen oder einen neuen Cassandra-Nutzer erstellen. Nutzer mit den Cassandra-Anweisungen CREATE/ALTER/DROP USER hinzufügen, entfernen und ändern.

Weitere Informationen finden Sie unter Cassandra-SQL-Shell-Befehle.

Cassandra-Authentifizierung während der Installation aktivieren

Sie können die Cassandra-Authentifizierung bei der Installation aktivieren. Sie können die Authentifizierung zwar bei der Installation von Cassandra aktivieren, sollten aber während der Installation immer den Standardnutzernamen und das Standardpasswort für Cassandra (‘cassandra’:’cassandra’) verwenden. Wenn Sie andere als die Standard-Cassandra-Anmeldedaten verwenden möchten, müssen Sie die Cassandra-Authentifizierung nach der Installation wieder aktivieren. Folgen Sie dazu den hier aufgeführten Schritten.

Wenn Sie die Cassandra-Authentifizierung während einer neuen Cassandra-Installation aktivieren möchten, fügen Sie die folgenden Attribute in die Konfigurationsdatei für alle Cassandra-Knoten ein:

CASS_AUTH=y
CASS_USERNAME=cassandra
CASS_PASSWORD=cassandra

Bei der Installation wird Cassandra dann mit aktivierter Authentifizierung und den Standardanmeldedaten cassandra:cassandra eingerichtet.

Nach der Erstinstallation können Sie einen oder mehrere der folgenden Schritte ausführen:

Edge-Komponenten, die eine Verbindung zu Cassandra herstellen

Die folgenden Edge-Komponenten greifen auf Cassandra zu:

  • Verwaltungsserver
  • Message Processors
  • Router
  • Qpid-Server
  • Postgres-Server

Edge-Komponenten installieren, wenn die Cassandra-Authentifizierung aktiviert ist

Wenn Sie die Cassandra-Authentifizierung aktiviert haben, wenn Sie diese Edge-Komponenten zum ersten Mal installieren, müssen Sie die folgenden Einstellungen in der Konfigurationsdatei für die unbeaufsichtigte Installation angeben:

CASS_AUTH=Y
CASS_USERNAME=<valid username in Cassandra>
CASS_PASSWORD=<password for the above username>

Sie können die Cassandra-Anmeldedaten nach der Installation von Cassandra ändern. Wenn Sie jedoch bereits den Management Server, Message Processors, Router, Qpid-Server oder Postgres-Server installiert haben, müssen Sie diese Komponenten ebenfalls aktualisieren, um die neuen Anmeldedaten zu verwenden, wie im nächsten Abschnitt beschrieben.

Edge-Komponenten aktualisieren, die eine Verbindung zu Cassandra herstellen

Gehen Sie so vor, um alle Edge-Komponenten, die mit Cassandra kommunizieren, mit den neuen Anmeldedaten zu aktualisieren. Beachten Sie, dass Sie diesen Schritt ausführen müssen, bevor Sie die Cassandra-Anmeldedaten aktualisieren:

  1. Führen Sie auf dem Management Server-Knoten den folgenden Befehl aus: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server store_cassandra_credentials -u cassandra_username -p cassandra_password

    Optional können Sie eine Datei mit dem neuen Nutzernamen und Passwort an den Befehl übergeben:

    apigee-service edge-management-server store_cassandra_credentials  -f configFile

    Dabei enthält configFile Folgendes:

    CASS_USERNAME=cassandra_username # Default is cassandra
CASS_PASSWORD='cassandra_password' # Default is cassandra; wrap in single quotes if it includes special characters.

    Mit diesem Befehl wird der Management Server automatisch neu gestartet.

  2. Wiederholen Sie Schritt 1 für jeden der folgenden Dienste:
    • Alle Message Processors
    • Alle Router
    • Alle Qpid-Server (edge-qpid-server)
    • Postgres-Server (edge-postgres-server)

    Wenn Sie Schritt 1 für jeden Dienst wiederholen, ersetzen Sie edge-management-server im obigen Befehl durch den entsprechenden Dienstnamen. Wenn Sie den Schritt beispielsweise für einen Router-Dienst ausführen, verwenden Sie den folgenden Befehl:

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

    Cassandra-Authentifizierung nach der Installation aktivieren

    In den folgenden Abschnitten wird erläutert, wie Sie die Cassandra-Authentifizierung nach der Installation aktivieren.

    Cassandra-Authentifizierung in einer einzelnen Rechenzentrumseinrichtung aktivieren

    Für eine auf einem einzelnen Rechenzentrum basierende Apigee-Einrichtung, in der Cassandra bereits installiert ist, können Sie Folgendes tun:

    Hinweis: Der Nutzer „Cassandra“ ist ein spezieller Nutzer in Cassandra. Für die Authentifizierung mit diesem Nutzer ist die QUORUM-Konsistenz erforderlich. Weitere Informationen finden Sie unter Cassandra-Konsistenzstufen.

    Cassandra-Authentifizierung aktivieren, wenn mehrere Rechenzentren vorhanden sind

    Wenn Sie Rechenzentren erweitern, folgen Sie den Schritten in einem der folgenden Szenarien, je nachdem, welches Ihrer Einrichtung entspricht.

    Szenario 1: Im vorhandenen Rechenzentrum ist die Cassandra-Authentifizierung aktiviert

    Wenn die Cassandra-Authentifizierung bereits in einem vorhandenen Rechenzentrum mit den Standardanmeldedaten cassandra:cassandra aktiviert ist, führen Sie die folgenden Schritte aus:

    1. Richten Sie ein neues Rechenzentrum mit den Standardanmeldedaten für Cassandra:Cassandra und CASS_AUTH=y ein. Weitere Informationen finden Sie unter Cassandra-Authentifizierung zum ersten Mal aktivieren.
    2. Installieren Sie Edge-Komponenten im neuen Rechenzentrum mit den Standard-Cassandra-Anmeldedaten.

    Wenn die Cassandra-Authentifizierung bereits im vorhandenen Rechenzentrum mit nicht standardmäßigen Anmeldedaten aktiviert ist, führen Sie die folgenden Schritte aus:

    1. Richten Sie ein neues Rechenzentrum mit den Standardanmeldedaten „Cassandra:Cassandra“ und „CASS_AUTH=y“ ein. Weitere Informationen finden Sie unter Cassandra-Authentifizierung zum ersten Mal aktivieren.
    2. Folgen Sie der Anleitung unter Cassandra-Authentifizierung zum ersten Mal aktivieren, um die Anmeldedaten aus einem vorhandenen Rechenzentrum wiederzuverwenden (wenn das vorhandene Rechenzentrum keine Standardanmeldedaten verwendet).
    3. Installieren Sie Edge-Komponenten im neuen Rechenzentrum mit nicht standardmäßigen Cassandra-Anmeldedaten.

    Szenario 2: Im vorhandenen Rechenzentrum ist die Cassandra-Authentifizierung nicht aktiviert

    Wenn die Cassandra-Authentifizierung nicht aktiviert ist, führen Sie die folgenden Schritte aus:

    1. Richten Sie ein neues Rechenzentrum ohne Cassandra-Authentifizierung ein.
    2. Folgen Sie der Anleitung unter Cassandra-Authentifizierung zum ersten Mal aktivieren, um die Cassandra-Authentifizierung im gesamten Cluster (nach der Erweiterung) zu aktivieren.
    3. Aktualisieren Sie die Edge-Komponenten, die eine Verbindung zu Cassandra herstellen, indem Sie die hier beschriebenen Schritte ausführen.

    Cassandra-Authentifizierung zum ersten Mal aktivieren

    Gehen Sie so vor, um die Cassandra-Authentifizierung zum ersten Mal zu aktivieren oder einen neuen Cassandra-Nutzernamen und ein neues Passwort zu erstellen:

    1. Erstellen Sie eine Konfigurationsdatei für die unbeaufsichtigte Installation mit dem unten gezeigten Inhalt: 
      # 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. Melden Sie sich beim ersten Cassandra-Knoten an und führen Sie den folgenden Befehl aus: 
      apigee-service apigee-cassandra enable_cassandra_authentication -f CONFIG

      Optional können Sie die Attribute als Befehlsargumente an das Skript übergeben, wie im folgenden Beispiel gezeigt:

      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

      Hinweise:

      • Bei Standard-Cassandra-Anmeldedaten wird mit dem obigen Befehl die Cassandra-Authentifizierung aktiviert und Cassandra neu gestartet.
      • Bei nicht standardmäßigen Anmeldedaten ändert der Befehl auch den Replikationsfaktor, erstellt einen Superuser und führt eine Reparatur am Schlüsselraum „system_auth“ durch.
    3. Wiederholen Sie die Schritte 1 und 2 nacheinander auf allen Cassandra-Knoten.

    Cassandra-Anmeldedaten nach der Installation von Cassandra ändern

    So ändern Sie die Cassandra-Anmeldedaten nach der Installation von Cassandra:

    1. Melden Sie sich mit dem cqlsh-Tool und den Standardanmeldedaten bei einem beliebigen Cassandra-Knoten an. Sie müssen das Passwort nur auf einem Knoten ändern. Es wird dann an alle Cassandra-Knoten im Ring übertragen: 
      /opt/apigee/apigee-cassandra/bin/cqlsh cassIP 9042 -u cassandra -p cassandra

      Wobei:

      1. cassIP ist die IP-Adresse des Cassandra-Knotens.
      2. 9042 ist der Standard-Cassandra-Port.
      3. Der Standardnutzer ist cassandra.
      4. Das Standardpasswort ist cassandra. Wenn Sie das Passwort zuvor geändert haben, verwenden Sie das aktuelle Passwort. Wenn das Passwort Sonderzeichen enthält, setzen Sie es in einfache Anführungszeichen.
    2. Führen Sie den folgenden Befehl an der cqlsh>-Eingabeaufforderung aus, um das Passwort zu aktualisieren: 
      ALTER USER cassandra WITH PASSWORD 'NEW_PASSWORD';
    3. Schließen Sie das cqlsh-Tool, wie im folgenden Beispiel gezeigt: 
      exit
    4. Wenn Sie den Management Server, die Message Processors, Router, Qpid-Server oder Postgres-Server noch nicht installiert haben, legen Sie die folgenden Attribute in der Konfigurationsdatei fest und installieren Sie dann diese Komponenten: 
      CASS_USERNAME=cassandra
CASS_PASSWORD=NEW_PASSWORD
    5. Wenn Sie den Management Server, Message Processor, Router, Qpid-Server oder Postgres-Server bereits installiert haben, finden Sie unter Edge-Passwörter zurücksetzen eine Anleitung, wie Sie diese Komponenten aktualisieren, um das neue Passwort zu verwenden.