Producto
CLI

Secret Set

Configurar un secret para los workers

Crea o actualiza un secret encriptado que estara disponible para todos los workers del workspace via plz.env.

Uso

bash
01plazbot workers secret set <key> <value>

Argumentos

ArgumentoDescripcion
<key>Nombre del secret en formato UPPER_SNAKE_CASE.
<value>Valor del secret (se almacena encriptado).

Ejemplo

bash
01# Configurar API key de Stripe
02plazbot workers secret set STRIPE_API_KEY sk_live_abc123
03 
04# Configurar webhook URL de Slack
05plazbot workers secret set SLACK_WEBHOOK_URL https://hooks.slack.com/services/xxx
06 
07# Configurar token de servicio externo
08plazbot workers secret set INVENTORY_API_KEY my-secret-token

Formato del key

El key debe cumplir con el formato UPPER_SNAKE_CASE:

  • Solo letras mayusculas, numeros y guiones bajos.
  • Debe iniciar con una letra mayuscula.
  • Ejemplos validos: STRIPE_API_KEY, SLACK_WEBHOOK, ERP_TOKEN, MP_ACCESS_TOKEN.
  • Ejemplos invalidos: stripe_api_key, my-secret, 123KEY.

Acceso desde workers

Los secrets se acceden dentro de un worker usando plz.env:

typescript
01async run(payload, plz) {
02 const apiKey = plz.env.STRIPE_API_KEY
03 const webhookUrl = plz.env.SLACK_WEBHOOK_URL
04 
05 const res = await fetch(url, {
06 headers: { 'Authorization': `Bearer ${apiKey}` }
07 })
08}

Seguridad

  • Los valores se encriptan con AES-256 antes de almacenarse.
  • Nunca se exponen en texto plano en la interfaz ni en los logs.
  • Se desencriptan solo en runtime dentro del Edge Function.
  • Cada workspace tiene sus propios secrets aislados.

Puedes ver la lista de secrets configurados (sin sus valores) con plazbot workers secret list o desde el tab "Secrets" en el dashboard.

¿Quieres probar la API en vivo? Abre el Playground.