Edge para nube privada v. 4.17.09
De forma predeterminada, Cassandra se instala sin la autenticación habilitada. Esto 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.
Si decides habilitar la autenticación en Cassandra, se usarán las siguientes credenciales predeterminadas:
- username = 'cassandra'
- password = 'cassandra'
Puedes usar esta cuenta, establecer una contraseña diferente para esta cuenta o crear un usuario de Cassandra nuevo. Agrega, quita y modifica usuarios con las declaraciones CREATE/ALTER/DROP USER de Cassandra.
Para obtener más información, consulta Comandos de shell de Cassandra SQL.
Habilita la autenticación de Cassandra durante la instalación
Puedes habilitar la autenticación de Cassandra durante la instalación. Sin embargo, si bien puedes habilitar la autenticación cuando instalas Cassandra, no puedes cambiar el nombre de usuario ni la contraseña predeterminados. Debes realizar ese paso de forma manual después de que se complete la instalación de Cassandra.
Nota: Usa este procedimiento cuando instales Cassandra con las opciones "-p c", "-p ds", "-p sa", "-p aio", "-p asa" y "-p ebp".
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
- Message Processors
- Routers
- Servidores de Qpid
- Servidores de Postgres
- Pila de BaaS
Por lo tanto, cuando instales estos componentes, debes establecer las siguientes propiedades en el archivo de configuración para especificar las credenciales de Cassandra:
CASS_USERNAME=cassandra CASS_PASSWORD=cassandra
Puedes cambiar las credenciales de Cassandra después de instalar Cassandra. Sin embargo, si ya instalaste el servidor de administración, los Message Processors, los routers, los servidores de Qpid, los servidores de Postgres o la pila de BaaS, también debes actualizar esos componentes para usar las credenciales nuevas.
Para cambiar las credenciales de Cassandra después de instalar Cassandra, sigue estos pasos:
- Accede a cualquier nodo de Cassandra con la herramienta cqlsh y las credenciales predeterminadas. Solo
debes 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 -p cassandra
Donde:- cassIP es la dirección IP del nodo de Cassandra.
- 9042 es el puerto predeterminado de Cassandra.
- El usuario predeterminado es cassandra.
- La contraseña predeterminada es cassandra. Si cambiaste la contraseña anteriormente, usa la contraseña actual.
- Ejecuta el siguiente comando en el mensaje cqlsh> para actualizar la contraseña:
cqlsh> ALTER USER cassandra WITH PASSWORD 'NEW_PASSWORD'; - Sal de la herramienta cqlsh:
cqlsh> exit - Si aún no instalaste el servidor de administración, los Message Processors, los routers, los servidores de Qpid, los servidores de Postgres o la pila de BaaS, establece las siguientes propiedades en el archivo de configuración y, luego, instala esos componentes:
CASS_USERNAME=cassandra
CASS_PASSWORD=NEW_PASSWORD - Si ya instalaste el servidor de administración, los Message Processors, los routers, los servidores de Qpid, los servidores de Postgres o la pila de BaaS, consulta Restablece las contraseñas de Edge para conocer el procedimiento de actualización de esos componentes para usar la contraseña nueva.
Habilita la autenticación de Cassandra después de la instalación
Para habilitar la autenticació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.
- En todos los nodos de Cassandra, habilita la autenticación.
- Establece el nombre de usuario y la contraseña de Cassandra en cualquier nodo. Solo debes cambiar las credenciales en un nodo de Cassandra y se transmitirán a todos los nodos de Cassandra en el anillo.
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 CASS_USERNAME -p CASS_PASSWORD
De manera opcional, puedes pasar un archivo al comando que contenga el nombre de usuario y la contraseña nuevos:
> apigee-service edge-management-server store_cassandra_credentials -f configFile
Donde configFile contiene lo siguiente:
CASS_USERNAME=cassandra
CASS_PASSWORD=CASS_PASSWROD
Este comando reinicia automáticamente el servidor de administración. - Repite el paso 1 en los siguientes dispositivos:
- Todos los Message Processors
- Todos los routers
- Todos los servidores de Qpid (edge-qpid-server)
- Servidores de Postgres (edge-postgres-server)
- En el nodo de la pila de BaaS para la versión 4.16.05.04 y posteriores:
- Ejecuta el siguiente comando para generar una contraseña encriptada:
> /opt/apigee/apigee-service/bin/apigee-service baas-usergrid secure_password
Este comando te solicita la contraseña de texto sin formato y muestra la contraseña encriptada en el siguiente formato:
SECURE:ae1b6dedbf6b26aaab8bee815a910737c1c15b55f3505c239e43bc09f8050 - Configura los siguientes tokens en /opt/apigee/customer/application/usergrid.properties.
Si ese archivo no existe, créalo:
usergrid-deployment_cassandra.username=cassandra
usergrid-deployment_cassandra.password=SECURE:ae1b6dedbf6b26aaab8bee815a910737c1c15b55f3505c239e43bc09f8050
En este ejemplo, se usa el nombre de usuario predeterminado para Cassandra. Si cambiaste el nombre de usuario, establece el valor de usergrid-deployment_cassandra.username según corresponda.
Asegúrate de incluir el prefijo "SECURE:" en la contraseña. De lo contrario, la pila de BaaS interpreta el valor como no encriptado.
Nota: Cada nodo de la pila de BaaS tiene su propia clave única que se usa para encriptar la contraseña. Por lo tanto, debes generar el valor encriptado en cada nodo de la pila de BaaS por separado. - Cambia la propiedad del archivo usergrid.properties al usuario "apigee":
> chown apigee:apigee /opt/apigee/customer/application/usergrid.properties - Configura el nodo de Stack:
> /opt/apigee/apigee-service/bin/apigee-service baas-usergrid configure - Reinicia la pila de BaaS:
> /opt/apigee/apigee-service/bin/apigee-service baas-usergrid restart - Repite estos pasos para todos los nodos de BaaS Stack.
- Ejecuta el siguiente comando para generar una contraseña encriptada:
Usa el siguiente procedimiento para habilitar la autenticación de Cassandra y establecer el nombre de usuario y la contraseña:
- Accede al primer nodo de Cassandra.
- Ejecuta el siguiente comando:
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra enable_cassandra_authentication -e y
Este comando habilita la autenticación y reinicia Cassandra.
- Repite los pasos 1 y 2 en todos los nodos de Cassandra.
- Accede a cualquier nodo de Cassandra con la herramienta de
cqlshy las credenciales predeterminadas. Solo tienes que cambiar la contraseña en un nodo de Cassandra y se transmitirá a todos los nodos de Cassandra del anillo:/opt/apigee/apigee-cassandra/bin/cqlsh cassIP 9042 -u cassandra -p cassandra
Dónde
- cassIP es la dirección IP del nodo de Cassandra.
- 9042 es el puerto de Cassandra.
- El usuario predeterminado es
cassandra. - La contraseña predeterminada es
cassandra. Si cambiaste la contraseña anteriormente, usa la contraseña actual.
- Ejecuta el siguiente comando en el mensaje de
cqlsh>para actualizar la contraseña:ALTER USER cassandra WITH PASSWORD 'NEW_PASSWORD';
- Ejecuta el siguiente comando en el mensaje de
cqlsh>para asegurarte de que el espacio de claves esté siempre disponible. Para un solo centro de datos: Para dos centros de datos, haz lo siguiente:ALTER KEYSPACE system_auth WITH replication = {'class': 'NetworkTopologyStrategy', 'dc-1': '3'};ALTER KEYSPACE system_auth WITH replication = {'class': 'NetworkTopologyStrategy', 'dc-1': '3', 'dc-2': '3'}; - Sal de la herramienta
cqlsh:exit
- Ejecuta
nodetool repairpara asegurarte de que el cambio se propague a todos los nodos de Cassandra:/opt/apigee/apigee-cassandra/bin/nodetool repair system_auth