Włącz uwierzytelnianie Cassandra

Domyślnie Cassandra instaluje się bez uwierzytelniania. Oznacza to, że każdy może uzyskać dostęp do Cassandra. Możesz włączyć uwierzytelnianie po zainstalowaniu przeglądarki Edge lub w ramach procesu instalacji.

Użytkowników możesz dodawać, usuwać i modyfikować za pomocą instrukcji Cassandra CREATE/ALTER/DROP USER. Więcej informacji znajdziesz w artykule Komendy w oprogramowaniu Cassandra SQL Shell.

  • Pamiętaj, aby zaktualizować nazwę użytkownika i hasło do funkcjonalnej Cassandra w pliku konfiguracji, którego używasz do instalowania lub aktualizowania komponentów Edge. Pozwoli to wyeliminować lub zminimalizować wszelkie zakłócenia podczas operacji na krawędzi.
  • Włączanie uwierzytelniania Cassandra podczas instalacji

    Możesz włączyć uwierzytelnianie Cassandra w momencie instalacji.

    Aby włączyć uwierzytelnianie Cassandra w momencie instalacji, dodaj właściwość CASS_AUTH do pliku konfiguracyjnego we wszystkich węzłach Cassandra:

    CASS_AUTH=y # The default value is n.

    Dostęp do systemu Cassandra mają te komponenty Edge:

    • Serwer zarządzania
    • Procesory wiadomości
    • Routery
    • serwery Qpid.
    • Serwery Postgres

    Podczas instalowania tych komponentów musisz ustawić nazwę użytkownika i hasło w pliku konfiguracji:

    CASS_USERNAME=cassandra_username
    CASS_PASSWORD=cassandra_password

    Po zainstalowaniu Cassandra możesz zmienić jej poświadczenia. Jeśli jednak masz już zainstalowane serwer zarządzania, procesory wiadomości, routery, serwery Qpid lub serwery Postgres, musisz też zaktualizować te komponenty, aby używać nowych danych logowania.

    Aby zmienić dane logowania do Cassandra po zainstalowaniu Cassandra:

    1. Zaloguj się w dowolnym węźle Cassandra za pomocą narzędzia cqlsh i domyślnych danych logowania. Wystarczy zmienić hasło na jednym węźle, a zostanie ono rozgłaszane do wszystkich węzłów Cassandra w pierścieniu:
      /opt/apigee/apigee-cassandra/bin/cqlsh cassIP 9042 -u cassandra_username -p cassandra_password

      Gdzie:

      1. cassIP to adres IP węzła Cassandra.
      2. 9042 to domyślny port Cassandra.
    2. Aby zaktualizować hasło, uruchom to polecenie w poziomie cqlsh>:
      ALTER USER cassandra_username/var> WITH PASSWORD 'new_cassandra_password';
    3. Zamknij narzędzie cqlsh, jak pokazano w tym przykładzie:
      exit
    4. Jeśli nie masz jeszcze zainstalowanych serwerów Management Server, Message Processors, Routers, Qpid i Postgres, skonfiguruj te właściwości w pliku konfiguracyjnym, a następnie zainstaluj te komponenty:
      CASS_USERNAME=cassandra_username
      CASS_PASSWORD=new_cassandra_password
    5. Jeśli masz już zainstalowane serwery Management, Message Processor, Router, Qpid lub Postgres, zapoznaj się z artykułem Resetowanie haseł Edge, aby dowiedzieć się, jak zaktualizować te komponenty, aby używać nowego hasła.

    Włączanie uwierzytelniania Cassandra po instalacji

    Aby włączyć uwierzytelnianie po instalacji:

    Aktualizowanie komponentów Edge, które łączą się z Cassandra

    Aby zaktualizować wszystkie komponenty Edge, które komunikują się z Cassandra, o pomoc nowych danych logowania, wykonaj podane niżej czynności. Pamiętaj, aby wykonać ten krok przed zaktualizowaniem danych logowania do Cassandra:

    1. Na węźle serwera zarządzania uruchom to polecenie:
      /opt/apigee/apigee-service/bin/apigee-service edge-management-server
        store_cassandra_credentials -u cassandra_username -p cassandra_password

      Opcjonalnie możesz przekazać do polecenia plik zawierający nową nazwę użytkownika i hasło:

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

      Gdzie configFile zawiera te informacje:

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

      To polecenie automatycznie uruchamia ponownie serwer zarządzania.

    2. W przypadku każdej z tych usług powtórz krok 1:
      • Wszystkie procesory komunikatów
      • Wszystkie routery
      • Wszystkie serwery Qpid (edge-qpid-server)
      • Serwery Postgres (edge-postgres-server)

      Powtarzając krok 1 w przypadku każdej usługi, w powyższym poleceniu zastąp edge-management-server nazwą odpowiedniej usługi. Jeśli na przykład wykonujesz krok dotyczący usługi Router, użyj tego polecenia:

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

    Włączanie uwierzytelniania

    Aby włączyć uwierzytelnianie Cassandra i ustawić nazwę użytkownika oraz hasło, wykonaj te czynności:

    1. Utwórz plik konfiguracji bez wyświetlania komunikatów z podaną niżej treścią:
      # 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_username # Default value is cassandra - don't use for production
      # Cassandra Password. If CASS_USERNAME does not exist, create SUPERUSER with this as password
      CASS_PASSWORD=cassandra_password # Default value is cassandra - don't use for production
      # 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 changed details of the default cassandra user(‘cassandra’)
      CASS_EXISTING_USERNAME=existing_cassandra_username
      # Password of an existing C* user. Only needed if you have disabled or change password of the default cassandra user(‘cassandra’)
      CASS_EXISTING_PASSWORD=existing_cassandra_password
      # Cassandra port
      CASS_PORT=9042 # The default port is 9042.
    2. Zaloguj się na pierwszym węźle Cassandra i uruchom to polecenie:

      apigee-service apigee-cassandra enable_cassandra_authentication -f CONFIG

      Opcjonalnie możesz przekazać właściwości jako argumenty polecenia do skryptu, jak w tym przykładzie:

      CASS_AUTH=y HOSTIP=$(hostname -i) CASS_PORT=9042 CASS_EXISTING_USERNAME=existing_cassandra_username CASS_EXISTING_PASSWORD=existing_cassandra_password CASS_USERNAME=cassandra_username CASS_PASSWORD=cassandra_password  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

      Uwagi:

      • W przypadku domyślnych danych logowania do Cassandra powyższa komenda umożliwia uwierzytelnianie w Cassandra i uruchamia ponowne uruchamianie Cassandra.
      • W przypadku niestandardowych danych logowania polecenie zmienia też współczynnik replikacji, tworzy konto superużytkownika i przeprowadza naprawę w kontekście system_auth keyspace.
    3. Powtórz kroki 1 i 2 na wszystkich węzłach Cassandra.