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

Administra la autenticación de IAM

En esta página, se proporcionan instrucciones sobre las tareas comunes de la función de autenticación de IAM para Memorystore para Valkey. Para obtener más detalles sobre la función, consulta Acerca de la autenticación de IAM.

Crea una instancia con autenticación de IAM

Para crear una instancia de Memorystore para Valkey que use la autenticación de IAM, ejecuta el comando create:

gcloud beta memorystore instances create INSTANCE_ID --region=REGION_ID --network=NETWORK --node-type=NODE_TYPE --shard-count=SHARD_COUNT --auth-mode=iam-auth

Reemplaza lo siguiente:

INSTANCE_ID es el ID de la instancia de Memorystore para Valkey que creas. El ID de tu instancia debe tener entre 1 y 63 caracteres y solo debe usar letras minúsculas, números o guiones. Debe empezar con una letra minúscula y terminar con una letra o un número.
REGION_ID es la región en la que deseas que se coloque la instancia.
NETWORK es la red que se usa para crear tu instancia. Debe usar el formato projects/NETWORK_PROJECT_ID/global/networks/NETWORK_ID. El ID de red que se usa aquí debe coincidir con el que usa la política de conexión de servicios. De lo contrario, la operación create fallará. Para obtener más detalles, consulta Herramientas de redes.
NODE_TYPE es el tipo de nodo que elegiste. Los valores aceptados son los siguientes:
- shared-core-nano
- standard-small
- highmem-medium
- highmem-xlarge
Para obtener más detalles sobre los tipos de nodos y la configuración de instancias, consulta Especificación de instancias y nodos.
SHARD_COUNT determina la cantidad de fragmentos en tu instancia. El recuento de fragmentos determina la capacidad de memoria total para almacenar datos de instancias. Para obtener más detalles sobre la especificación de instancias, consulta Especificación de instancias y nodos.

Otorga permisos para la autenticación de IAM

Para otorgar acceso de IAM, otorga al principal el rol roles/memorystore.dbConnectionUser con las instrucciones para otorgar roles de IAM.

De forma predeterminada, otorgarle el rol roles/memorystore.dbConnectionUser a un principal le permite acceder a todas las instancias de tu proyecto.

Crea un rol de administrador de IAM limitado para una instancia

Te recomendamos que crees un rol que pueda modificar los permisos de IAM de la conexión de instancias sin otorgar acceso de administrador de IAM completo. Para ello, crea un administrador de IAM limitado para el rol roles/memorystore.dbConnectionUser. Para obtener más detalles, consulta Crea administradores de IAM limitados.

Cómo conectarse a una instancia que usa la autenticación de IAM

Si aún no tienes una VM de Compute Engine que use la misma red autorizada que tu instancia de Valkey, crea una y conéctate a ella siguiendo la Guía de inicio rápido para usar una VM de Linux.
Para conectarte a tu instancia, debes habilitar los siguientes alcances de acceso y APIs para tu proyecto:
- Alcance de la API de Cloud Platform. Para obtener instrucciones sobre cómo habilitar este permiso, consulta Cómo conectar la cuenta de servicio y actualizar el permiso de acceso. Para obtener una descripción de las prácticas recomendadas para este permiso de acceso, consulta Prácticas recomendadas para los permisos.
- API de Memorystore para Valkey. Para obtener un vínculo que te permita habilitar la API, haz clic en el siguiente botón:
  Memorystore para Valkey
Para instalar valkey-cli en la VM de Compute Engine, sigue las instrucciones que se indican en Cómo instalar Valkey.
Ejecuta el siguiente comando para obtener un token de acceso para tu usuario de IAM:
```
gcloud auth print-access-token
```
Nota: Los tokens de acceso vencerán en una hora. Para obtener más información, consulta el período del token de acceso de IAM.
Conéctate al extremo de detección de tu instancia:
```
valkey-cli -h NETWORK_ADDRESS -p PORT -a ACCESS_TOKEN -c
```
Reemplaza lo siguiente:
- NETWORK_ADDRESS es la dirección de red de la instancia. Para ver la dirección de red, consulta Cómo ver la información de la instancia.
- PORT es el número de puerto de la instancia. Para ver el número de puerto, consulta Cómo ver la información de la instancia.
- ACCESS_TOKEN es el token de acceso de IAM que se recuperó en pasos anteriores.
Nota: Las conexiones autenticadas son válidas por 12 horas. Para obtener más información, consulta Período de autenticación.
Ejecuta el comando CLUSTER SHARDS para ver la topología de tu nodo. Anota una de las direcciones IP y los números de puerto del nodo.
Ejecuta el siguiente comando para conectarte al nodo que elegiste:
```
valkey-cli -h NODE_IP_ADDRESS -p NODE_PORT -a ACCESS_TOKEN -c
```
Reemplaza lo siguiente:
- NODE_IP_ADDRESS es la dirección IP del nodo que encontraste en el paso anterior.
- NODE_PORT es el número de puerto del nodo que encontraste en el paso anterior.
Ejecuta un comando SET y GET de Valkey para verificar que estableciste una conexión autenticada al nodo de tu instancia.
Una vez que termines de probar tu conexión con la instancia de Valkey, debes considerar borrar la VM de Compute Engine que usaste para conectarte a la instancia de Valkey. Esto te ayuda a evitar que se generen cargos en tu cuenta de Facturación de Cloud.
Ejecuta el siguiente comando para usar valkey-cli y autenticar y conectarte a tu instancia. Para ello, reemplaza las variables por los valores adecuados:
```
valkey-cli -h NETWORK_ADDRESS -p PORT -a ACCESS_TOKEN -c
```
Reemplaza lo siguiente:
- NETWORK_ADDRESS es la dirección de red de la instancia. Para ver la dirección de red, consulta Cómo ver la información de la instancia.
- PORT es el número de puerto de la instancia. Para ver el número de puerto, consulta Cómo ver la información de la instancia.
- ACCESS_TOKEN es el token de acceso de IAM que se recuperó en pasos anteriores.
Nota: Las conexiones autenticadas son válidas por 12 horas. Para obtener más información, consulta Período de autenticación.
Ejecuta un comando SET y GET de Valkey para verificar que estableciste una conexión autenticada a tu instancia.
Una vez que termines de probar tu conexión con la instancia de Valkey, debes considerar borrar la VM de Compute Engine que usaste para conectarte a la instancia de Valkey. Esto te ayuda a evitar que se generen cargos en tu cuenta de Facturación de Cloud.

Automatiza la recuperación de tokens de acceso

Te recomendamos que automatices la recuperación de tokens de acceso en tu aplicación, ya que no se pueden codificar fácilmente debido a su vida útil corta.

(Opcional) Si aún no lo hiciste, crea una cuenta de servicio para tu aplicación (consulta Cómo crear y administrar una cuenta de servicio).
```
gcloud iam service-accounts create SA_NAME \
    --description="DESCRIPTION" \
    --display-name="DISPLAY_NAME"
```
Reemplaza lo siguiente:
- SA_NAME es el nombre de la cuenta de servicio.
- DESCRIPTION es una descripción opcional de la cuenta de servicio.
- DISPLAY_NAME es un nombre de cuenta de servicio que se mostrará en la consola de Google Cloud.
Otorga permiso memorystore.dbConnectionUser a tu cuenta de servicio en tu proyecto.
```
gcloud projects add-iam-policy-binding PROJECT_ID \
--member="serviceAccount:SA_NAME@PROJECT_ID.iam.gserviceaccount.com" \
--role="memorystore.dbConnectionUser"
```
Reemplaza lo siguiente:
- PROJECT_ID es el ID del proyecto.
- SA_NAME es el nombre de la cuenta de servicio.
- ROLE_NAME es un nombre de rol, como roles/compute.osLogin.
Autentica tu aplicación como la cuenta de servicio determinada. Consulta Cuentas de servicio para obtener más información.

Si quieres ver muestras de código que muestran cómo puedes autenticar tu aplicación con bibliotecas cliente populares, consulta Muestras de código de la biblioteca cliente de autenticación de IAM.

Ejemplo de código para conectarse a una instancia que usa la autenticación de IAM

Para ver una muestra de código compatible con Valkey sobre cómo configurar una biblioteca cliente para conectarse a una instancia que usa la autenticación de IAM, consulta Muestra de código de la biblioteca cliente de Authentication de IAM.