Secrets

Stockez les identifiants une seule fois, chiffrés, accordez-les aux agents, routines et connexions qui en ont besoin, et examinez les modifications proposées.

Veyra Docs TeamMis à jour le 1 min de lectureVersion 1 · Historique

Les secrets conservent des identifiants (clés d'API, jetons, mots de passe) pour que les agents puissent s'en servir sans que personne ne les colle dans une tâche. Un secret est stocké chiffré, et sa valeur n'est transmise qu'aux exécutions auxquelles vous l'avez accordé.

Secrets d'organisation et secrets personnels

  • Les secrets d'organisation appartiennent à l'organisation et sont accordés à des agents, des routines ou des environnements.
  • Les secrets personnels appartiennent à un membre, pour des identifiants qui doivent agir au nom de cette personne.

Ajouter un secret

Il vous faut l'autorisation Manage secrets (secrets:manage).

  1. Ouvrez Settings › Secrets et sélectionnez New secret.
  2. Donnez-lui une clé, par exemple STRIPE_API_KEY, et collez la valeur.
  3. Enregistrez. La valeur n'est plus jamais affichée ; vous pouvez la remplacer par une nouvelle version.

Accorder un secret

Accordez un secret là où il sert :

  • Dans l'onglet Secrets & variables d'un agent, pour le transmettre aux exécutions de cet agent.
  • Dans l'environnement d'une routine, pour ne le transmettre qu'aux exécutions de cette routine.
  • Dans la configuration d'un environnement.

Un accès peut être figé sur une version ou suivre la plus récente. Un agent auquel un secret n'a pas été accordé ne peut pas le lire, et sa valeur n'apparaît jamais dans les fils des tâches, l'activité ou les journaux d'exécution.

Propositions

Un agent qui a besoin d'un identifiant peut proposer une modification de secret au lieu d'en demander la valeur dans la discussion. La proposition attend dans Secrets › Proposals qu'une personne autorisée l'approuve ou la refuse.

Rotation

Remplacez la valeur d'un secret pour le faire tourner. Les exécutions qui démarrent ensuite reçoivent la nouvelle valeur ; les accès figés sur une ancienne version la conservent jusqu'à leur mise à jour.

Depuis l'API

L'API ne renvoie jamais la valeur des secrets aux personnes ; les agents lisent les valeurs accordées à leur exécution en cours. Voir Secrets dans la référence de l'API.

OrganisationSecretsSécurité