Ativar autenticação do Cassandra

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

Se você decidir ativar a autenticação no Cassandra sem fornecer suas próprias credenciais, ele usará as seguintes credenciais padrão:

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

É possível usar essa conta de usuário, definir uma senha diferente para ela ou criar um novo usuário do Cassandra. Adicione, remova e modifique usuários usando as instruções CREATE/ALTER/DROP USER do Cassandra.

Para mais informações, consulte Comandos do shell SQL do Cassandra.

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

É possível ativar a autenticação do Cassandra no momento da instalação. No entanto, embora seja possível ativar a autenticação ao instalar o Cassandra, use sempre o nome de usuário e a senha padrão do cassandra (‘cassandra’:’cassandra’) durante a instalação. Se você quiser usar credenciais não padrão do Cassandra, reative a autenticação do Cassandra após a instalação seguindo as etapas listadas aqui.

Se você quiser ativar a autenticação do Cassandra durante uma nova instalação do Cassandra, inclua as propriedades abaixo no arquivo de configuração de todos os nós do Cassandra:

CASS_AUTH=y
CASS_USERNAME=cassandra
CASS_PASSWORD=cassandra

A instalação vai configurar o Cassandra com a autenticação ativada e as credenciais padrão do cassandra:cassandra.

Depois de concluir a instalação inicial, siga uma ou mais destas etapas:

  • Crie um usuário alternativo para ser usado na autenticação do Cassandra seguindo o procedimento aqui.
  • Siga estas etapas para mudar a senha do usuário padrão do Cassandra.
  • Instale os componentes do Edge que usam o Cassandra para usar as credenciais definidas acima.

Componentes do Edge que se conectam ao Cassandra

Os seguintes componentes do Edge acessam o Cassandra:

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

Instalar componentes do Edge quando a autenticação do Cassandra estiver ativada

Se a autenticação do Cassandra estiver ativada quando você instalar esses componentes do Edge pela primeira vez, forneça as seguintes configurações no arquivo de configuração silenciosa:

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

É possível alterar as credenciais do Cassandra depois de instalá-lo. 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, conforme descrito na próxima seção.

Atualizar componentes do Edge 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. É necessário realizar 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

    Se quiser, transmita um arquivo com o novo nome de usuário e senha para o comando:

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

    Esse comando reinicia automaticamente o servidor de gerenciamento.

  2. Repita a etapa 1 para cada um dos seguintes serviços:
    • 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 de 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 do Cassandra após a instalação

    As seções a seguir explicam como ativar a autenticação do Cassandra após a instalação.

    Ativar a autenticação do Cassandra em uma configuração de data center único

    Para uma configuração da Apigee baseada em um único data center que já tenha o Cassandra instalado, é possível:

    Observação:o usuário "Cassandra" é um usuário especial no Cassandra. A autenticação que usa esse usuário requer consistência QUORUM. Consulte Sobre os níveis de consistência do Cassandra.

    Ativar a autenticação do Cassandra quando houver vários data centers

    Ao expandir os data centers, siga as etapas em um dos seguintes cenários, dependendo de qual corresponde à sua configuração.

    Cenário 1: o data center atual tem a autenticação do Cassandra ativada

    Se a autenticação do Cassandra já estiver ativada em um data center com as credenciais padrão cassandra:cassandra, siga as etapas abaixo:

    1. Configure um novo data center com as credenciais padrão do Cassandra:Cassandra e CASS_AUTH=y. Consulte Ativar a autenticação do Cassandra pela primeira vez.
    2. Instale os componentes do Edge no novo data center usando as credenciais padrão do Cassandra.

    Se a autenticação do Cassandra já estiver ativada no data center atual com credenciais não padrão, siga as etapas abaixo:

    1. Configure um novo data center com as credenciais padrão do Cassandra:Cassandra e CASS_AUTH=y. Consulte Ativar a autenticação do Cassandra pela primeira vez.
    2. Siga as etapas em Ativar a autenticação do Cassandra pela primeira vez para reutilizar a credencial de um data center atual (se o atual estiver usando uma credencial não padrão).
    3. Instale os componentes do Edge no novo data center usando uma credencial do Cassandra que não seja padrão.

    Cenário 2: o data center atual não tem a autenticação do Cassandra ativada

    Se a autenticação do Cassandra não estiver ativada, siga estas etapas:

    1. Configure um novo data center sem autenticação do Cassandra.
    2. Siga as etapas em Ativar a autenticação do Cassandra pela primeira vez para ativar a autenticação do Cassandra em todo o cluster (pós-expansão).
    3. Siga as etapas neste link para atualizar os componentes do Edge que se conectam ao Cassandra.

    Ativar a autenticação do Cassandra pela primeira vez

    Use o procedimento a seguir para ativar a autenticação do Cassandra pela primeira vez ou para criar um novo nome de usuário e senha do Cassandra:

    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 # 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. Faça login no primeiro nó do Cassandra e execute o seguinte comando: 
      apigee-service apigee-cassandra enable_cassandra_authentication -f CONFIG

      Se quiser, transmita as propriedades como argumentos de comando para o script, como mostrado no exemplo a seguir:

      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

      Observações:

      • Para as 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 no keyspace system_auth.
    3. Repita as etapas 1 e 2 em todos os nós do Cassandra, um por um.

    Alterar as credenciais do Cassandra após a instalação do Cassandra

    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. Basta alterar a senha em um nó para que ela seja transmitida a todos os nós do Cassandra no anel: 
      /opt/apigee/apigee-cassandra/bin/cqlsh cassIP 9042 -u cassandra -p cassandra

      Em que:

      1. cassIP é o endereço IP do nó do Cassandra.
      2. 9042 é a porta padrão do Cassandra.
      3. O usuário padrão é cassandra.
      4. A senha padrão é cassandra. Se você mudou a senha anteriormente, use a senha atual. Se a senha tiver caracteres especiais, coloque-a entre aspas simples.
    2. Execute o seguinte comando no prompt cqlsh> para atualizar a senha: 
      ALTER USER cassandra WITH PASSWORD 'NEW_PASSWORD';
    3. Saia da ferramenta cqlsh, como mostra o exemplo a seguir: 
      exit
    4. Se você ainda não instalou o servidor de gerenciamento, os processadores de mensagens, os roteadores, os servidores Qpid ou os servidores Postgres, defina as seguintes propriedades no arquivo de configuração e instale esses componentes: 
      CASS_USERNAME=cassandra
CASS_PASSWORD=NEW_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.