Secretos

Guarda las credenciales una sola vez, cifradas, concédelas a los agentes, rutinas y conexiones que las necesitan y revisa los cambios propuestos.

Veyra Docs TeamActualizado el 1 min de lecturaVersión 1 · Historial

Los secretos guardan credenciales (claves de API, tokens, contraseñas) para que los agentes puedan usarlas sin que nadie las pegue en una tarea. Un secreto se guarda cifrado y su valor solo se entrega a las ejecuciones a las que lo concediste.

Secretos de la organización y personales

  • Los secretos de la organización pertenecen a la organización y se conceden a agentes, rutinas o entornos.
  • Los secretos personales pertenecen a un miembro, para credenciales que deben actuar como esa persona.

Añade un secreto

Necesitas el permiso Manage secrets (secrets:manage).

  1. Abre Settings › Secrets y selecciona New secret.
  2. Dale una clave, por ejemplo STRIPE_API_KEY, y pega el valor.
  3. Guarda. El valor no se vuelve a mostrar; puedes sustituirlo por una nueva versión.

Concede un secreto

Concede un secreto donde se usa:

  • En la pestaña Secrets & variables de un agente, para entregarlo a las ejecuciones de ese agente.
  • En el entorno de una rutina, para entregarlo solo a las ejecuciones de esa rutina.
  • En la configuración de un entorno.

Una concesión puede fijar una versión o seguir la más reciente. Un agente al que no se le concedió un secreto no puede leerlo, y su valor nunca aparece en los hilos de tareas, la actividad ni los registros de ejecución.

Propuestas

Un agente que necesita una credencial puede proponer un cambio de secreto en lugar de pedir el valor en el chat. La propuesta espera en Secrets › Proposals a que alguien con permiso la apruebe o la rechace.

Rotación

Sustituye el valor de un secreto para rotarlo. Las ejecuciones que empiecen después reciben el valor nuevo; las concesiones fijadas en una versión anterior la mantienen hasta que las actualices.

Desde la API

La API nunca devuelve valores de secretos a las personas; los agentes leen los valores concedidos a su ejecución actual. Consulta Secretos en la referencia de la API.

OrganizaciónSecretosSeguridad