Passer au contenu principal
Les secrets permettent à Research d’utiliser vos autres outils, comme PagerDuty, Grafana ou une API interne. Research écrit un court script, et le script lit le secret comme une variable d’environnement, par exemple $PAGERDUTY_API_KEY. Research ne voit jamais la valeur.
La page Secrets dans Settings avec quatre secrets de l'organisation

​
Ajouter un secret

  1. Ouvrez Settings → Secrets. Choisissez l’onglet Organization ou Personal et cliquez sur New secret.
  2. Saisissez un Name en lettres majuscules, chiffres et tirets bas, comme DATADOG_API_KEY. Les scripts utilisent ce nom.
  3. Collez la Value. La plupart des identifiants sont de type Key-value. Pour un code à deux facteurs, choisissez TOTP et collez le seed de configuration ; les scripts en génèrent le code actuel.
  4. Ajoutez une Note qui indique à quoi sert le secret et à quel hôte il est envoyé. Research lit la note pour choisir le bon secret.
  5. Cliquez sur Create secret.
Le panneau New secret avec un nom, une valeur masquée et une note
Redact value est activé par défaut. Après l’enregistrement, personne ne peut revoir la valeur, et vous ne pouvez pas désactiver le masquage. Vous pouvez toujours remplacer la valeur.
Pour ajouter plusieurs secrets à la fois, cliquez sur Bulk add secrets et collez un NAME=value par ligne, comme dans un fichier .env.

​
Laisser Research demander un secret

Quand Research a besoin d’un identifiant que vous n’avez pas enregistré, il affiche une carte dans le chat. Collez la valeur et cliquez sur Save secret. La valeur va directement dans Secrets, pas dans le chat. Research peut l’utiliser dès sa commande suivante et dans les prochaines sessions.
Une session Research avec une carte qui demande à l'utilisateur d'enregistrer une clé d'API PagerDuty

​
Qui peut utiliser un secret

  • Organization: fonctionne dans les sessions Research de tous les membres et dans les exécutions de workflows. Seuls Owner et Admin peuvent l’ajouter, le modifier ou le supprimer. Les membres voient son nom et sa note, mais pas sa valeur.
  • Personal: fonctionne uniquement dans vos propres sessions Research. Tout le monde peut en ajouter.
Si les deux portent le même nom, votre secret personnel est utilisé.

​
Modifier ou supprimer un secret

Cliquez sur un secret dans la liste pour remplacer sa valeur, modifier sa note ou le supprimer. Les scripts qui utilisent un secret supprimé cessent de fonctionner.
Research n’envoie un secret qu’à l’hôte officiel de l’API du service ou à un hôte que vous indiquez. Il n’affiche jamais la valeur d’un secret, même si vous le demandez.