Habilitar la autenticación de Cassandra

Edge para la nube privada v4.18.01

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.

Si decides habilitar la autenticación en Cassandra, utiliza las siguientes credenciales predeterminadas:

  • nombre de usuario = 'Cassandra'
  • contraseña = 'cassandra'

Puedes usar la cuenta, establecer una contraseña diferente o crear un usuario nuevo de Cassandra. Agrega, quita y modifica usuarios con 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 como tiempo de instalación. Sin embargo, aunque puedes habilitar la autenticación cuando instalas Cassandra, no puedes cambiar el nombre de usuario y 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 para 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
  • Pila de BaaS

Por lo tanto, cuando instales estos componentes, deberás 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 instalarlo. Sin embargo, si ya instalaste el servidor de administración, los procesadores de mensajes, los routers, los servidores Qpid, los servidores Postgres o la pila BaaS, también debes actualizar esos componentes para usar las credenciales nuevas.

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

  1. Acceda a cualquier nodo de Cassandra con la herramienta cqlsh y las credenciales predeterminadas. Solo debes cambiar la contraseña en un nodo, que se transmitirá a todos los nodos de Cassandra en el anillo:
    >/opt/apigee/apigee-cassandra/bin/cqlsh cassIP 9042 -u cassandra -p cassandra
    ?Dónde:
    1. cassIP es la dirección IP del nodo de Cassandra.
    2. 9042 es el puerto de Cassandra predeterminado.
    3. El usuario predeterminado es cassandra.
    4. La contraseña predeterminada es cassandra. Si ya cambiaste la contraseña, usa la actual.
  2. Ejecuta el siguiente comando como símbolo del sistema cqlsh> para actualizar la contraseña:
    cqlsh> ALTER USER cassandra WITH PASSWORD 'NEW_PASSWORD';
  3. Sal de la herramienta cqlsh:
    cqlsh> exit
  4. Si aún no instalaste el servidor de administración, los procesadores de mensajes, los routers, los servidores Qpid, los servidores Postgres o la pila BaaS, configura las siguientes propiedades en el archivo de configuración y, luego, instala esos componentes:
    CASS_USERNAME=cassandra
    CASS_PASSWORD=NEW_PASSWORD
  5. Si ya instalaste el servidor de administración, los procesadores de mensajes, los routers, los servidores Qpid, los servidores Postgres o la pila BaaS, consulta Restablece contraseñas perimetrales a fin de conocer el procedimiento para 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, 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.
  • Configurar 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.

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:

  1. En el nodo del servidor de administración, ejecuta el siguiente comando:
    > /opt/apigee/apigee-service/bin/apigee-service perimetral-management-server store_cassandra_credentials -u CASS_USERNAME -p CASS_PASSWORD

    De forma opcional, puedes pasar un archivo al comando que contiene el nombre de usuario y contraseña nuevos:
    > apigee-service Edge-and-management store_config





    configFile
  2. Repite el paso 1 en las siguientes instancias:
    • Todos los procesadores de mensajes
    • Todos los routers
    • Todos los servidores de Qpid (edge-qpid-server)
    • Servidores de Postgres (edge-postgres-server)
  3. En el nodo de pila de BaaS para la versión 4.16.05.04 y posteriores, haz lo siguiente:
    1. 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 con el formato:
      SECURE:ae1b6dedbf6b26aaab8bee815a9
    2. 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:ae1b6dedbf6b26aaab8bee815a910737c1c15b55f3505c239e4

      Si cambiaste el nombre de usuario, configura el valor de usergrid-deployment_cassandra.username según corresponda.

      Asegúrate de incluir el prefijo “SEGURE:” en la contraseña. De lo contrario, la pila BaaS interpretará el valor como no encriptado.

      Nota: Cada nodo de 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 pila de BaaS por separado.
    3. Cambia la propiedad del archivo usergrid.properties al usuario “apigee”:
      > chown apigee:apigee /opt/apigee/customer/application/usergrid.properties
    4. Configura el nodo de pila:
      >/opt/apigee/apigee-service/bin/apigee-service baas-usergrid configurar
    5. Reinicia la pila de BaaS:
      >/opt/apigee/apigee-service/bin/apigee-service baas-usergrid restart
    6. Repite estos pasos para todos los asentos de pila de BaaS.

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

  1. Accede al primer nodo de Cassandra.
  2. 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.

  3. Repite los pasos 1 y 2 en todos los nodos de Cassandra.
  4. 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 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

    Ubicación

    • 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 ya cambiaste la contraseña, usa la actual.
  5. Ejecuta el siguiente comando en el mensaje de cqlsh> para actualizar la contraseña:
    ALTER USER cassandra WITH PASSWORD 'NEW_PASSWORD';
  6. Ejecuta el siguiente comando en el mensaje cqlsh> para asegurarte de que el espacio de claves esté siempre disponible. Para un solo centro de datos:
    ALTER KEYSPACE system_auth WITH replication = {'class': 'NetworkTopologyStrategy', 'dc-1': '3'};
    Para dos centros de datos:
    ALTER KEYSPACE system_auth WITH replication = {'class': 'NetworkTopologyStrategy', 'dc-1': '3', 'dc-2': '3'};
  7. Sal de la herramienta cqlsh:
    exit
  8. Ejecuta nodetool repair para asegurarte de que el cambio se propague a todos los nodos de Cassandra:
    /opt/apigee/apigee-cassandra/bin/nodetool repair system_auth