Guardar un secreto

Crea o actualiza un secreto encriptado del workspace. Todos los workers lo leen como plz.env.<KEY>. Si la clave ya existe, su valor se reemplaza. Los valores nunca se vuelven a mostrar.

bash

01plazbot workers secret set <key> [value] [options]

Parámetros

Parámetro	Flag	Requerido	Descripción
Clave	`<key>`	Sí	Nombre en `UPPER_SNAKE_CASE`: letras mayúsculas, dígitos y guiones bajos, empezando por letra (`^[A-Z][A-Z0-9_]*$`). Ej: `STRIPE_API_KEY`.
Valor	`[value]`	No	Valor del secreto. Si lo omites, el CLI lo pide con entrada oculta o lo lee de stdin.
JSON	`--json`	No	Imprime `{"key","saved"}` como JSON. Nunca incluye el valor.

Ejemplos

bash

01# Pedir el valor con entrada oculta
02plazbot workers secret set STRIPE_API_KEY
03 
04# Leer el valor de stdin (recomendado en scripts y CI)
05echo "$STRIPE_KEY" | plazbot workers secret set STRIPE_API_KEY
06 
07# Leer el valor de un archivo
08plazbot workers secret set GOOGLE_CREDENTIALS < ./service-account.json
09 
10# Pasar el valor en línea (queda en el historial de la shell)
11plazbot workers secret set API_BASE_URL https://api.example.com

Pasar el valor como argumento lo deja en el historial de tu shell y en la lista de procesos. Prefiere el prompt oculto o stdin: echo "$STRIPE_KEY" | plazbot workers secret set STRIPE_API_KEY. Al leer de stdin se quita el salto de línea final que agrega echo.

Resultado

text

01✔ Value for STRIPE_API_KEY: ********************
02✔ Secret "STRIPE_API_KEY" saved
03  Available in your workers as plz.env.STRIPE_API_KEY

Si pasaste el valor como argumento, se añade el aviso Tip: omit the value (or pipe it through stdin) to keep it out of your shell history.

Salida JSON

json

01{ "key": "STRIPE_API_KEY", "saved": true }

Con --json el valor debe llegar como argumento o por stdin; no se muestra el prompt.

Uso desde un worker

typescript

01async handler(input, plz) {
02  const res = await plz.fetch('https://api.stripe.com/v1/customers', {
03    headers: { Authorization: `Bearer ${plz.env.STRIPE_API_KEY}` },
04  })
05  // ...
06}

Cada workspace tiene sus propios secretos. Para ver cuáles existen usa plazbot workers secret list.

Errores comunes

Mensaje	Causa	Solución
`Invalid secret name "<key>". Use UPPER_SNAKE_CASE: ...`	La clave no cumple el formato.	Usa mayúsculas, dígitos y `_`, empezando por letra: `STRIPE_API_KEY`.
`No secret value received on stdin.`	Sin terminal y sin valor por stdin.	`echo "$VALUE" \| plazbot workers secret set <KEY>`.
`The secret value is required in --json mode.`	Usaste `--json` sin valor ni stdin.	Pasa el valor por stdin.
`The secret value cannot be empty.`	El valor está vacío o solo tiene espacios.	Envía un valor no vacío.
`You are not signed in.`	No hay sesión.	Ejecuta `plazbot login`.