Как включить аутентификацию Cassandra

По умолчанию Cassandra устанавливается без включенной аутентификации. Это означает, что любой пользователь может получить доступ к Cassandra. Вы можете включить аутентификацию после установки Edge или в процессе установки.

Вы можете добавлять, удалять и изменять пользователей с помощью операторов Cassandra CREATE/ALTER/DROP USER. Дополнительную информацию можно найти в статье Команды оболочки SQL Cassandra.

  • Не забудьте обновить функциональное имя пользователя и пароль Cassandra в файле конфигурации, который вы используете для установки или обновления компонентов Edge. Это позволит избежать сбоев при работе на периферии или свести их к минимуму.

    • Как включить аутентификацию Cassandra во время установки

    Вы можете включить аутентификацию Cassandra во время установки.

    Чтобы включить аутентификацию Cassandra во время установки, добавьте свойство CASS_AUTH в файл конфигурации для всех узлов Cassandra:

    CASS_AUTH=y # The default value is n.

    Следующие компоненты Edge обращаются к Cassandra:

    • Сервер управления
    • Процессоры сообщений
    • Маршрутизаторы
    • Серверы Qpid
    • Серверы Postgres

    При установке этих компонентов необходимо задать имя пользователя и пароль в файле конфигурации:

    CASS_USERNAME=cassandra_username
CASS_PASSWORD=cassandra_password

    Учетные данные Cassandra можно изменить после установки Cassandra. Однако если вы уже установили сервер управления, процессоры сообщений, маршрутизаторы, серверы Qpid или серверы Postgres, вам также необходимо обновить эти компоненты, чтобы использовать новые учетные данные.

    Чтобы изменить учетные данные Cassandra после установки Cassandra:

    1. Войдите в любой узел Cassandra, используя инструмент cqlsh и учетные данные по умолчанию. Вам нужно изменить пароль только на одном узле, и он будет передан всем узлам Cassandra в кольце: 
      /opt/apigee/apigee-cassandra/bin/cqlsh cassIP 9042 -u cassandra_username -p cassandra_password

      Где:

      1. cassIP – IP-адрес узла Cassandra.
      2. 9042 – порт Cassandra по умолчанию.
    2. Чтобы изменить пароль, введите следующую команду в командной строке cqlsh>: 
      ALTER USER cassandra_username/var> WITH PASSWORD 'new_cassandra_password';
    3. Выйдите из инструмента cqlsh, как показано в следующем примере: 
      exit
    4. Если вы ещё не установили сервер управления, процессоры сообщений, маршрутизаторы, серверы Qpid или серверы Postgres, задайте следующие свойства в файле конфигурации, а затем установите эти компоненты: 
      CASS_USERNAME=cassandra_username
CASS_PASSWORD=new_cassandra_password
    5. Если вы уже установили сервер управления, процессоры сообщений, маршрутизаторы, серверы Qpid или серверы Postgres, ознакомьтесь с разделом Как сбросить пароли Edge, чтобы узнать, как обновить эти компоненты и использовать новый пароль.

    Как включить аутентификацию Cassandra после установки

    Чтобы включить аутентификацию после установки:

    Как обновить компоненты Edge, подключенные к Cassandra

    Чтобы обновить учетные данные для всех компонентов Edge, которые взаимодействуют с Cassandra, выполните следующие действия: Обратите внимание, что этот шаг выполняется до обновления учетных данных Cassandra:

    1. На узле сервера управления выполните следующую команду: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-server
  store_cassandra_credentials -u cassandra_username -p cassandra_password

      При необходимости можно передать команде файл, содержащий новое имя пользователя и пароль:

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

      где configFile содержит следующие элементы:

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

      Эта команда автоматически перезапускает сервер управления.

    2. Для каждого из следующих сервисов повторите шаг 1:
      • Все процессоры сообщений
      • Все маршрутизаторы
      • Все серверы Qpid (edge-qpid-server)
      • Серверы Postgres (edge-postgres-server)

      Повторяя шаг 1 для каждого сервиса, замените edge-management-server в команде выше на название нужного сервиса. Например, если вы выполняете шаг для сервиса маршрутизатора, используйте следующую команду:

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

    Включить аутентификацию

    Чтобы включить аутентификацию Cassandra и задать имя пользователя и пароль, выполните следующие действия:

    1. Создайте файл конфигурации в тихом режиме со следующим содержимым: 
      # 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. Войдите в первый узел Cassandra и выполните следующую команду:

      apigee-service apigee-cassandra enable_cassandra_authentication -f CONFIG

      Вы также можете передать свойства в скрипт в качестве аргументов команды, как показано в следующем примере: 

      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

      Примечания

      • Если используются учетные данные Cassandra по умолчанию, приведенная выше команда включает аутентификацию Cassandra и перезапускает Cassandra.
      • Для учетных данных, отличных от учетных данных по умолчанию, команда также изменяет коэффициент репликации, создает суперадминистратора и выполняет восстановление на system_auth keyspace.
    3. Повторите шаги 1 и 2 на всех узлах Cassandra.