Secretos

Los secretos de Vonage Cloud Runtime te permiten almacenar información confidencial para usar en tus proyectos, como claves de API para servicios de terceros. Los secretos se administran a través de la CLI de Vonage Cloud Runtime.

Crear un secreto

Para crear un secreto, puedes utilizar el comando «secrets create» de la CLI de Vonage Cloud Runtime.

vcr secret create --name $NAME --value $VALUE

Así que para crear un secreto FOO con el valor bar:

vcr secret create --name FOO --value bar

También puedes añadir archivos como secretos:

vcr secret create --name $NAME --filename $FILE_PATH

Cómo acceder a tus secretos

Para acceder a un secreto en tu instancia, debes añadirlo a tu archivo de configuración para mostrarlo. Añade un environment a tu archivo de configuración con una lista de los secretos que quieres exponer y un nombre con el que referirte a ellos:

project:
    name: app
instance:
    name: dev
    runtime: nodejs24
    region: aws.euw1
    application-id: fcd08ece-f3c2-4adf-bf84-5ba8a1c86e0e
    capabilities: [voice, messages-v1]
    entrypoint: [node, index.js]
    environment:
        - name: FOO_SECRET
          secret: FOO
        - name: BAZ_SECRET
          secret: BAZ

Ahora que el secreto está en tu archivo de configuración, se inyectarán en tu instancia cuando ejecutes el depurador de Vonage Cloud Runtime o implementes tu proyecto. Así pues, tomando como ejemplo FOO en tu solicitud escribirías:

const fooValue = process.env.FOO_SECRET;

Actualización de secretos

La actualización de secretos funciona de forma similar a la creación de secretos, pero para actualizar se utiliza vcr secret update:

vcr secret update --name $NAME --value $NEW_VALUE

Para actualizar el FOO ejemplo:

vcr secret update --name FOO --value baz

Secretos de los anuncios

Para ver todas las claves secretas almacenadas en tu Account, ejecuta:

vcr secret list

Esto muestra una tabla con los nombres de las claves secretas. Los valores de las claves secretas nunca se muestran.

Eliminar secretos

Los secretos se pueden eliminar utilizando vcr secret remove:

vcr secret remove --name $NAME

Para quitar el FOO ejemplo:

vcr secret remove --name FOO

Trabajar con secretos a nivel local

Cuando depures tu proyecto localmente, no tendrás acceso a los secretos almacenados en la plataforma de Vonage Cloud Runtime. Se recomienda que crees un .env archivo en el directorio de tu proyecto y añade allí tus claves de desarrollo:

export FOO=BAR
export BAZ=BAT
export X=Y

A continuación, antes de empezar a depurar ejecutar:

source .env

Las variables de entorno deben establecerse en el mismo proceso de shell en el que ejecutas el depurador de Vonage Cloud Runtime.

Esto exportará las claves secretas de desarrollo del proceso actual de la terminal, lo que permitirá al depurador acceder a ellas.