Zum Hauptinhalt springen
Mit Secrets kann Research deine anderen Tools nutzen, etwa PagerDuty, Grafana oder eine interne API. Research schreibt ein kurzes Skript, und das Skript liest das Secret als Umgebungsvariable, zum Beispiel $PAGERDUTY_API_KEY. Research sieht den Wert nie.
Die Seite Secrets in Settings mit vier Secrets der Organisation

​
Ein Secret hinzufügen

  1. Öffne Settings → Secrets. Wähle den Tab Organization oder Personal und klicke auf New secret.
  2. Gib einen Name aus Großbuchstaben, Ziffern und Unterstrichen ein, etwa DATADOG_API_KEY. Skripte verwenden diesen Namen.
  3. Füge den Value ein. Die meisten Zugangsdaten sind Key-value. Für einen Zwei-Faktor-Code wähle TOTP und füge den Einrichtungs-Seed ein; Skripte erzeugen daraus den aktuellen Code.
  4. Füge eine Note hinzu, die sagt, wofür das Secret dient und an welchen Host es gesendet wird. Research liest die Notiz, um das richtige Secret zu wählen.
  5. Klicke auf Create secret.
Das Panel New secret mit einem Namen, einem verborgenen Wert und einer Notiz
Redact value ist standardmäßig eingeschaltet. Nach dem Speichern kann niemand den Wert wieder ansehen, und du kannst das Verbergen nicht ausschalten. Den Wert kannst du trotzdem ersetzen.
Um mehrere Secrets auf einmal hinzuzufügen, klicke auf Bulk add secrets und füge ein NAME=value pro Zeile ein, wie in einer .env-Datei.

​
Research nach einem Secret fragen lassen

Wenn Research Zugangsdaten braucht, die du nicht gespeichert hast, zeigt es eine Karte im Chat. Füge den Wert ein und klicke auf Save secret. Der Wert geht direkt an Secrets, nicht in den Chat. Research kann ihn ab dem nächsten Befehl und in künftigen Sitzungen verwenden.
Eine Research-Sitzung mit einer Karte, die den Nutzer bittet, einen PagerDuty-API-Schlüssel zu speichern

​
Wer ein Secret nutzen kann

  • Organization: funktioniert in den Research-Sitzungen aller Mitglieder und in Workflow-Läufen. Nur Owner und Admin können es hinzufügen, bearbeiten oder löschen. Mitglieder sehen Namen und Notiz, aber nicht den Wert.
  • Personal: funktioniert nur in deinen eigenen Research-Sitzungen. Jeder kann eines hinzufügen.
Haben beide denselben Namen, wird dein persönliches Secret verwendet.

​
Ein Secret bearbeiten oder löschen

Klicke in der Liste auf ein Secret, um seinen Wert zu ersetzen, seine Notiz zu ändern oder es zu löschen. Skripte, die ein gelöschtes Secret verwenden, funktionieren nicht mehr.
Research sendet ein Secret nur an den offiziellen API-Host des Dienstes oder an einen Host, den du nennst. Es gibt den Wert eines Secrets nie aus, auch nicht, wenn du darum bittest.