Ativar autenticação do Cassandra

Por padrão, o Cassandra é instalado sem a autenticação ativada. Isso significa que qualquer pessoa pode acessar o Cassandra. É possível ativar a autenticação após a instalação do Edge ou como parte do processo de instalação.

É possível adicionar, remover e modificar usuários usando as instruções CREATE/ALTER/DROP USER do Cassandra. Para mais informações, consulte Comandos do shell do CASSANDRA SQL.

  • Atualize o nome de usuário e a senha do Cassandra funcional no arquivo de configuração usado para instalar ou fazer upgrade dos componentes do Edge. Isso elimina ou minimiza qualquer interrupção durante as operações de borda.

    • Ativar a autenticação do Cassandra durante a instalação

    É possível ativar a autenticação do Cassandra no momento da instalação.

    Para ativar a autenticação do Cassandra no momento da instalação, inclua a propriedade CASS_AUTH no arquivo de configuração de todos os nós do Cassandra:

    CASS_AUTH=y # The default value is n.

    Os seguintes componentes do Edge acessam o Cassandra:

    • Servidor de gerenciamento
    • Processadores de mensagens
    • Roteadores
    • Servidores Qpid
    • Servidores Postgres

    Ao instalar esses componentes, você precisa definir um nome de usuário e uma senha no arquivo de configuração:

    CASS_USERNAME=cassandra_username
CASS_PASSWORD=cassandra_password

    Você pode mudar as credenciais do Cassandra depois de instalar o Cassandra. No entanto, se você já tiver instalado o servidor de gerenciamento, os processadores de mensagens, os roteadores, os servidores Qpid ou os servidores Postgres, também será necessário atualizar esses componentes para usar as novas credenciais.

    Para mudar as credenciais do Cassandra após a instalação:

    1. Faça login em qualquer nó do Cassandra usando a ferramenta cqlsh e as credenciais padrão. Você só precisa mudar a senha em um nó, e ela será transmitida para todos os nós do Cassandra no anel: 
      /opt/apigee/apigee-cassandra/bin/cqlsh cassIP 9042 -u cassandra_username -p cassandra_password

      Em que:

      1. cassIP é o endereço IP do nó do Cassandra.
      2. 9042 é a porta padrão do Cassandra.
    2. Execute o comando abaixo no prompt cqlsh> para atualizar a senha: 
      ALTER USER cassandra_username/var> WITH PASSWORD 'new_cassandra_password';
    3. Saia da ferramenta cqlsh, conforme mostrado no exemplo a seguir: 
      exit
    4. Se você ainda não tiver instalado o servidor de gerenciamento, os processadores de mensagens, os roteadores, os servidores Qpid ou os servidores Postgres, defina as propriedades a seguir no arquivo de configuração e instale esses componentes: 
      CASS_USERNAME=cassandra_username
CASS_PASSWORD=new_cassandra_password
    5. Se você já tiver instalado o servidor de gerenciamento, os processadores de mensagens, os roteadores, os servidores Qpid ou os servidores Postgres, consulte Como redefinir senhas do Edge para saber como atualizar esses componentes para usar a nova senha.

    Ativar a autenticação do Cassandra após a instalação

    Para ativar a autenticação após uma instalação:

    Atualizar componentes de borda que se conectam ao Cassandra

    Use o procedimento a seguir para atualizar todos os componentes do Edge que se comunicam com o Cassandra com as novas credenciais. Siga esta etapa antes de atualizar as credenciais do Cassandra:

    1. No nó do servidor de gerenciamento, execute o seguinte comando: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-server
  store_cassandra_credentials -u cassandra_username -p cassandra_password

      Você também pode transmitir um arquivo para o comando com o novo nome de usuário e a senha:

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

      Em que configFile contém o seguinte:

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

      Esse comando reinicia automaticamente o servidor de gerenciamento.

    2. Repita a etapa 1 para cada um dos serviços a seguir:
      • Todos os processadores de mensagens
      • Todos os roteadores
      • Todos os servidores Qpid (edge-qpid-server)
      • Servidores Postgres (edge-postgres-server)

      Ao repetir a etapa 1 para cada serviço, substitua edge-management-server no comando acima pelo nome do serviço apropriado. Por exemplo, ao executar a etapa para um serviço de roteador, use o seguinte comando:

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

    Ativar a autenticação

    Use o procedimento a seguir para ativar a autenticação do Cassandra e definir o nome de usuário e a senha:

    1. Crie um arquivo de configuração silenciosa com o conteúdo mostrado abaixo: 
      # 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. Faça login no primeiro nó do Cassandra e execute o seguinte comando:

      apigee-service apigee-cassandra enable_cassandra_authentication -f CONFIG

      Opcionalmente, é possível transmitir as propriedades como argumentos de comando para o script, conforme mostrado no exemplo a seguir: 

      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

      Observações:

      • Para credenciais padrão do Cassandra, o comando acima ativa a autenticação do Cassandra e reinicia o Cassandra.
      • Para credenciais não padrão, o comando também altera o fator de replicação, cria um superusuário e executa um reparo em system_auth keyspace.
    3. Repita as etapas 1 e 2 em todos os nós do Cassandra.