Se usó la API de Cloud Translation para traducir esta página.

Habilitar la autenticación de Cassandra

De forma predeterminada, Cassandra se instala sin habilitar la autenticación. Eso significa que cualquier persona puede acceder a Cassandra. Puedes habilitar la autenticación después de instalar Edge o como parte del proceso de instalación.

Puedes agregar, quitar y modificar usuarios mediante las instrucciones CREATE/ALTER/DROP USER de Cassandra. Para obtener más información, consulta Comandos de shell de Cassandra SQL.

Habilitar la autenticación de Cassandra durante la instalación

Puedes habilitar la autenticación de Cassandra en el momento de la instalación.

Para habilitar la autenticación de Cassandra en el momento de la instalación, incluye la propiedad CASS_AUTH en el archivo de configuración de todos los nodos de Cassandra:

CASS_AUTH=y # The default value is n.

Los siguientes componentes de Edge acceden a Cassandra:

Servidor de administración
Procesadores de mensajes
Routers
Servidores Qpid
Servidores de Postgres

Cuando instalas estos componentes, debes establecer un nombre de usuario y una contraseña en el archivo de configuración:

CASS_USERNAME=cassandra_username
CASS_PASSWORD=cassandra_password

Nota: Si bien puedes usar el nombre de usuario ('cassandra') y la contraseña ('cassandra') predeterminados, Apigee recomienda elegir un nombre de usuario y contraseña diferentes para la producción.

Puedes cambiar las credenciales de Cassandra después de instalarlo. Sin embargo, si ya instalaste el servidor de administración, los procesadores de mensajes, los routers, los servidores Qpid o los servidores Postgres, también debes actualizar esos componentes para usar las credenciales nuevas.

Para cambiar las credenciales de Cassandra después de instalarlo, haz lo siguiente:

Accede a cualquier nodo de Cassandra con la herramienta de cqlsh y las credenciales predeterminadas. Solo tienes que cambiar la contraseña en un nodo, y se transmitirá a todos los nodos de Cassandra en el anillo:
```
/opt/apigee/apigee-cassandra/bin/cqlsh cassIP 9042 -u cassandra_username -p cassandra_password
```
Aquí:
1. cassIP es la dirección IP del nodo de Cassandra.
2. 9042 es el puerto de Cassandra predeterminado.
Ejecuta el siguiente comando en el mensaje de cqlsh> para actualizar la contraseña:
```
ALTER USER cassandra_username/var> WITH PASSWORD 'new_cassandra_password';
```
Sal de la herramienta cqlsh, como se muestra en el siguiente ejemplo:
```
exit
```
Si aún no instalaste el servidor de administración, los procesadores de mensajes, los routers, los servidores Qpid o los servidores Postgres, configura las siguientes propiedades en el archivo de configuración y, luego, instala esos componentes:
```
CASS_USERNAME=cassandra_username
CASS_PASSWORD=new_cassandra_password
```
Si ya instalaste el servidor de administración, los procesadores de mensajes, los routers, los servidores Qpid o los servidores Postgres, consulta Restablece contraseñas perimetrales para conocer el procedimiento a fin de actualizar esos componentes y usar la contraseña nueva.

Habilitar la autenticación de Cassandra posterior a la instalación

Para habilitar la autenticación después de una instalación, sigue estos pasos:

Actualiza todos los componentes de Edge que se conectan a Cassandra con el nombre de usuario y la contraseña de Cassandra.
Habilita la autenticación en todos los nodos de Cassandra y establece el nombre de usuario y la contraseña de Cassandra en cualquier nodo. Solo tienes que cambiar las credenciales en un nodo de Cassandra y estas se transmitirán a todos los nodos de Cassandra del anillo.

Actualiza los componentes de Edge que se conectan a Cassandra

Usa el siguiente procedimiento para actualizar todos los componentes de Edge que se comunican con Cassandra con las credenciales nuevas. Ten en cuenta que debes realizar este paso antes de actualizar las credenciales de Cassandra:

En el nodo del servidor de administración, ejecuta el siguiente comando:

/opt/apigee/apigee-service/bin/apigee-service edge-management-server
  store_cassandra_credentials -u cassandra_username -p cassandra_password

De manera opcional, puedes pasar un archivo al comando que contiene el nombre de usuario y la contraseña nuevos:

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

En el ejemplo anterior, configFile contiene lo siguiente:

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

Este comando reinicia automáticamente el servidor de administración.

Para cada uno de los siguientes servicios, repite el paso 1:
- Todos los procesadores de mensajes
- Todos los routers
- Todos los servidores de Qpid (edge-qpid-server)
- Servidores de Postgres (edge-postgres-server)
Cuando repitas el paso 1 para cada servicio, reemplaza edge-management-server en el comando anterior con el nombre del servicio adecuado. Por ejemplo, cuando ejecutes el paso para un servicio de router, usa el siguiente comando:
```
/opt/apigee/apigee-service/bin/apigee-service edge-router
  store_cassandra_credentials -u cassandra -p cassandra
```

Habilitar autenticación

Usa el siguiente procedimiento para habilitar la autenticación de Cassandra y configurar el nombre de usuario y la contraseña:

Crea un archivo de configuración silencioso con el contenido que se muestra a continuación:

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

Accede al primer nodo de Cassandra y ejecuta el siguiente comando:
```
apigee-service apigee-cassandra enable_cassandra_authentication -f CONFIG
```
De manera opcional, puedes pasar las propiedades como argumentos de comando a la secuencia de comandos, como se muestra en el siguiente ejemplo:
```
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
```
Notas:
- Para las credenciales predeterminadas de Cassandra, el comando anterior habilita la autenticación de Cassandra y lo reinicia.
- Para las credenciales no predeterminadas, el comando también altera el factor de replicación, crea un superusuario y ejecuta una reparación en system_auth keyspace.
Repite los pasos 1 y 2 en todos los nodos de Cassandra.