> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enclave.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Enclave in these docs is the code and cloud security platform at enclave.ai. It is not Open Enclave, Intel SGX or other hardware enclaves, or enclave.gg.
> People use Enclave in the web app at https://app.enclave.ai or the desktop app. These docs describe no public Enclave API or CLI, so don't invent endpoints, commands, or config files.
> Connecting an integration needs a person to sign in and approve access in a browser. Tell the user the exact step to take instead of saying you completed it.

# Secrets

> Speichere API-Schlüssel und Passwörter, damit Research deine anderen Tools per Skript aufrufen kann, ohne dass die Werte in den Chat gelangen.

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](https://mintcdn.com/enclave/1alCsqvPvQsOJ-2n/images/product/secrets-list.png?fit=max\&auto=format\&n=1alCsqvPvQsOJ-2n\&q=85\&s=96f2e359f99274943e61fb34668d1364)

## 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](https://mintcdn.com/enclave/1alCsqvPvQsOJ-2n/images/product/secrets-new.png?fit=max\&auto=format\&n=1alCsqvPvQsOJ-2n\&q=85\&s=b95b0e2eb2aef42e9590437edf8cccc5)

> [!WARNING]
>
> **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](https://mintcdn.com/enclave/1alCsqvPvQsOJ-2n/images/product/secrets-chat.png?fit=max\&auto=format\&n=1alCsqvPvQsOJ-2n\&q=85\&s=0cfcb21c563467dd4b8adb6b33f3685a)

## 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.

> [!NOTE]
>
> 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.