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 usar el comando de creación de secretos 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

Acceder a sus secretos

Para acceder a un secreto en su instancia, tiene que añadirlo a su archivo archivo de configuración para exponerlo. Añada 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: nodejs18
    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á en tu instancia cuando ejecutes el depurador de Vonage Cloud Runtime o despliegues tu proyecto. Así que para usar el ejemplo de 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 secrets update:

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

Para actualizar el FOO ejemplo:

vcr secret update --name FOO --value baz

Eliminar secretos

Los secretos pueden eliminarse con vcr secrets remove:

vcr secret remove $NAME

Para quitar el FOO ejemplo:

vcr secret remove 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 en el directorio de su proyecto y añada allí sus secretos 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á los secretos de desarrollo en su actual proceso de shell de terminal, permitiendo que el depurador pueda acceder a ellos.