Edge para nuvem privada v. 4.17.01
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 instalar o Edge ou como parte do processo de instalação.
Se você decidir ativar a autenticação no Cassandra, ele usará as seguintes credenciais padrão:
- nome de usuário = 'cassandra'
- senha = 'cassandra'
É possível usar essa conta, definir uma senha diferente para a conta ou criar um novo usuário do Cassandra. adicionar, remover e modificar usuários usando as instruções CREATE/ALTER/DROP USER do Cassandra.
Para mais informações, consulte http://www.datastax.com/documentation/cql/3.0/cql/cql_reference/cqlCommandsTOC.html (em inglês).
Ativar a autenticação do Cassandra durante a instalação
É possível ativar a autenticação do Cassandra como tempo de instalação. No entanto, embora você possa ativar a autenticação ao instalar o Cassandra, não é possível alterar o nome de usuário e a senha padrão. É necessário executar essa etapa manualmente após a conclusão da instalação do Cassandra.
Observação: use este procedimento ao instalar o Cassandra com as opções "-p c", "-p ds", "-p sa", "-p aio", "-p asa" e "-p ebp".
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
- Pilha BaaS
Portanto, ao instalar esses componentes, é preciso definir as seguintes propriedades no arquivo de configuração para especificar as credenciais do Cassandra:
CASS_USERNAME=cassandra CASS_PASSWORD=cassandra
É possível alterar as credenciais do Cassandra depois de instalar o aplicativo. No entanto, se você já instalou o servidor de gerenciamento, os processadores de mensagens, os roteadores, os servidores Qpid, os servidores Postgres ou a pilha BaaS, também é necessário atualizar esses componentes para usar as novas credenciais.
Para alterar as credenciais do Cassandra após a instalação do Cassandra:
- Faça login em qualquer nó do Cassandra usando a ferramenta cqlsh e as credenciais padrão. Você só precisa alterar 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 -p cassandra
Onde:- cassIP é o endereço IP do nó do Cassandra.
- 9042 é a porta padrão do Cassandra.
- O usuário padrão é cassandra.
- A senha padrão é cassandra. Se você mudou a senha anteriormente, use a atual.
- Execute o seguinte comando como o prompt cqlsh> para atualizar a senha:
cqlsh> ALTER USER cassandra WITH PASSWORD 'NEW_PASSWORD'; - Saia da ferramenta cqlsh:
cqlsh> exit - Se você ainda não instalou o servidor de gerenciamento, os processadores de mensagens,
os roteadores, os servidores Qpid, os servidores Postgres ou a pilha BaaS, defina as seguintes propriedades no
arquivo de configuração e instale esses componentes:
CASS_USERNAME=cassandra
CASS_PASSWORD=NEW_PASSWORD - Se você já instalou o servidor de gerenciamento, os processadores de mensagens, os roteadores, os servidores Qpid, os servidores Postgres ou a pilha BaaS, consulte Como redefinir senhas de borda para ver o procedimento de atualização desses componentes para usar a nova senha.
Ativar pós-instalação da autenticação do Cassandra
Para ativar a autenticação:
- Atualize todos os componentes do Edge que se conectam ao Cassandra com o nome de usuário e a senha do Cassandra.
- Ative a autenticação em todos os nós do Cassandra.
- Defina o nome de usuário e a senha do Cassandra em qualquer nó. Você só precisa alterar as credenciais em um nó do Cassandra, e elas serão transmitidas para todos os nós do Cassandra no anel.
Use o procedimento a seguir para atualizar todos os componentes do Edge que se comunicam com o Cassandra com as novas credenciais. Observe que você faz esta etapa antes de atualizar as credenciais do Cassandra:
- No nó do Servidor de gerenciamento, execute o seguinte comando:
> /opt/apigee/apigee-service/bin/apigee-service edge-management-server store_cassandra_credentials -u CASS_USERNAME -p CASS_PASSWORD
Reinicia um arquivo para o comando que contém o novo nome de usuário e senha:
> apigee-service EDGE-management-server store_cassandra_credentials -u CASS_USERNAME -p CASS_PASSWORD
Reinicialização
configFile - Repita a etapa 1 em:
- Todos os processadores de mensagens
- Todos os roteadores
- Todos os servidores Qpid (edge-qpid-server)
- Servidores Postgres (edge-postgres-server)
- No nó da pilha BaaS para a versão 4.16.05.04 e mais recentes:
- Execute o seguinte comando para gerar uma senha criptografada:
> /opt/apigee/apigee-service/bin/apigee-service baas-usergrid secure_password
Este comando solicita a senha em texto simples e retorna a senha criptografada no formato:
SECURE:ae1b6dedbf6b26aaab81c7135a93f9 - Defina os tokens a seguir em /opt/apigee/customer/application/usergrid.properties.
Se esse arquivo não existir, crie-o:
usergrid-deployment_cassandra.username=cassandra
usergrid-deployment_cassandra.password=SECURE:ae1b6dedbf6b26aaab8bee815a910737c1c15b55f3505b239e43
Se você alterou o nome de usuário, defina o valor de usergrid-deployment_cassandra.username corretamente.
Inclua o prefixo "SECURE:" na senha. Caso contrário, a pilha BaaS vai interpretar o valor como não criptografado.
Observação: cada nó da pilha BaaS tem a própria chave exclusiva usada para criptografar a senha. Portanto, você precisa gerar o valor criptografado em cada nó da pilha BaaS separadamente. - Mude a propriedade do arquivo usergrid.properties para o
usuário "apigee":
> chown apigee:apigee /opt/apigee/customer/application/usergrid.properties - Configure o nó "Stack":
> /opt/apigee/apigee-service/bin/apigee-service baas-usergrid configurar - Reinicie a pilha BaaS:
> /opt/apigee/apigee-service/bin/apigee-service baas-usergrid restart - Repita essas etapas para todas as confirmações da pilha BaaS.
- Execute o seguinte comando para gerar uma senha criptografada:
Use o procedimento a seguir para ativar a autenticação do Cassandra e definir o nome de usuário e a senha:
- Faça login no primeiro nó do Cassandra.
- Execute este comando:
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra enable_cassandra_authentication -e y
Esse comando ativa a autenticação e reinicia o Cassandra.
- Repita as etapas 1 e 2 em todos os nós do Cassandra.
- 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ó do Cassandra, e ela será transmitida para todos os nós do Cassandra no anel:/opt/apigee/apigee-cassandra/bin/cqlsh cassIP 9042 -u cassandra -p cassandra
Onde
- cassIP é o endereço IP do nó do Cassandra.
- 9042 é a porta do Cassandra.
- O usuário padrão é
cassandra
. - A senha padrão é
cassandra
. Se você mudou a senha anteriormente, use a atual.
- Execute o seguinte comando no prompt
cqlsh>
para atualizar a senha:ALTER USER cassandra WITH PASSWORD 'NEW_PASSWORD';
- Execute o seguinte comando no prompt
cqlsh>
para garantir que o keyspace esteja sempre disponível. Para um único data center:ALTER KEYSPACE system_auth WITH replication = {'class': 'NetworkTopologyStrategy', 'dc-1': '3'};
Para dois data centers:ALTER KEYSPACE system_auth WITH replication = {'class': 'NetworkTopologyStrategy', 'dc-1': '3', 'dc-2': '3'};
- Saia da ferramenta
cqlsh
:exit
- Execute
nodetool repair
para garantir que a mudança seja propagada para todos os nós do Cassandra:/opt/apigee/apigee-cassandra/bin/nodetool repair system_auth