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

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

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

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

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

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

CASS_AUTH=y # The default value is n.

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

  • Сервер управления
  • Message Processor
  • Маршрутизаторы
  • Серверы 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. На узле Management Server выполните следующую команду: 
    /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 в команде выше на название нужного сервиса. Например, при выполнении шага для сервиса Router используйте следующую команду:

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