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

# Secrets

> Wiederverwendbare Account-Secrets speichern und deren Verwendung verfolgen

export const Screenshot = ({lightSrc, darkSrc, alt, caption, maxWidth = "880px"}) => {
  return <div style={{
    margin: "1rem auto",
    maxWidth,
    width: "100%"
  }}>
      <Frame>
        <img className="block dark:hidden" src={lightSrc} alt={alt} />
        <img className="hidden dark:block" src={darkSrc} alt={alt} />
      </Frame>
      {caption ? <p style={{
    marginTop: "0.5rem",
    fontSize: "0.875rem",
    color: "inherit",
    opacity: 0.8
  }}>
          {caption}
        </p> : null}
    </div>;
};

Secrets ermöglichen es dir, wiederverwendbare Zugangsdaten für das aktuelle Account zu zentralisieren, anstatt rohe Werte in unterstützten Konfigurationen zu wiederholen.

**Zugang:** Gehe zu **Einstellungen → Entwickler → Secrets**.

<Screenshot light="/images/accounts__secrets_DE-light.png" dark="/images/accounts__secrets_DE-dark.png" alt="Secrets-Inventarseite mit gespeicherten Secrets und Verwendungsinformationen" />

## Wo Secrets verwendet werden

Das aktuelle Produkt verwendet gespeicherte Secrets an mehreren Stellen, darunter:

* Cal.com-Integrations-Zugangsdaten
* SIP-Trunk-Authentifizierungspasswörter
* MCP-Server-Header und Query-Parameter
* Benutzerdefinierte Aktionen und andere agentenseitige authentifizierte Aufrufe

Die Secrets-Seite ist damit der sicherste Ort, um gemeinsam genutzte Zugangsdaten zu rotieren, ohne jede Funktion einzeln durchsuchen zu müssen.

## Secret erstellen

<Steps>
  <Step title="Secrets öffnen">
    Zu **Einstellungen → Entwickler → Secrets** navigieren.
  </Step>

  <Step title="Neues Secret erstellen">
    Auf **Neues Secret** klicken.
  </Step>

  <Step title="Name und Wert festlegen">
    Einen eindeutigen Namen eingeben und den Secret-Wert einfügen.
  </Step>

  <Step title="Aktivierungsstatus wählen">
    **Aktiviert** eingeschaltet lassen für aktive Nutzung, oder ausschalten, um den Wert vor dem Rollout zu speichern.
  </Step>

  <Step title="Speichern">
    Formular absenden, um das Secret zum Inventar hinzuzufügen.
  </Step>
</Steps>

<Tip>
  Namen verwenden, die Anbieter, Zweck und Umgebung identifizieren, zum Beispiel `calcom-prod-api-key` oder `crm-staging-webhook-token`.
</Tip>

## Inventar und Status

Die Inventartabelle zeigt:

* **Name**
* **Status**
* **Verwendungsanzahl**
* **Zuletzt verwendet**

Aktuelle Status:

| Status          | Bedeutung                                                                              |
| --------------- | -------------------------------------------------------------------------------------- |
| **Aktiv**       | Das Secret ist aktiviert und für unterstützte Referenzen bereit                        |
| **Deaktiviert** | Das Secret bleibt gespeichert, sollte aber für aktive Workflows nicht verwendet werden |
| **Fehlend**     | Ein referenzierter Secret-Wert ist nicht verfügbar und muss beachtet werden            |

Wenn ein Secret keine aktiven Referenzen hat, zeigt die aufgeklappte Zeile **Noch keine aktiven Referenzen**.

## Bearbeiten, Deaktivieren und Rotieren

* Ein Secret bearbeiten, um es umzubenennen oder den gespeicherten Wert zu ersetzen.
* Beim Bearbeiten eines bestehenden Secrets kann das Wertfeld leer gelassen werden, um den aktuellen Wert beizubehalten.
* Ein Secret deaktivieren, wenn neue Nutzungen pausiert werden sollen, ohne den Eintrag zu löschen.
* Verwendungsreferenzen vor der Rotation überprüfen, um zu wissen, welche nachgelagerten Abläufe betroffen sind.

## Löschverhalten

Ein Secret kann nur gelöscht werden, wenn es nicht in Verwendung ist.

Wenn ein Secret noch aktive Referenzen hat, blockiert die Plattform das Löschen, bis diese Referenzen entfernt oder aktualisiert wurden.

## Best Practices

<AccordionGroup>
  <Accordion title="Ein Secret pro Integrationskontext erstellen" icon="key">
    Produktions-, Staging- und Sandbox-Zugangsdaten getrennt halten, damit sie unabhängig voneinander rotiert oder deaktiviert werden können.
  </Accordion>

  <Accordion title="Secrets für die Suche benennen" icon="tag">
    Stabile, aussagekräftige Namen wie `calcom-prod-api-key` gegenüber generischen Bezeichnungen wie `API-Schlüssel` oder `Token` bevorzugen.
  </Accordion>

  <Accordion title="Nach Offenlegung oder Eigentümerwechsel rotieren" icon="rotate">
    Werte sofort ersetzen, wenn ein Verdacht auf einen Leak besteht oder das verwaltende System wechselt.
  </Accordion>

  <Accordion title="Ungenutzte Secrets regelmäßig überprüfen" icon="clipboard-list">
    Veraltete Zugangsdaten entfernen, sobald bestätigt ist, dass sie nicht mehr referenziert werden.
  </Accordion>
</AccordionGroup>

## Nächste Schritte

<CardGroup cols={2}>
  <Card title="Integrationen" icon="plug" href="/de/accounts/integrations">
    Drittanbieterdienste für unterstützte Workflows verbinden
  </Card>

  <Card title="Webhooks" icon="webhook" href="/de/accounts/webhooks">
    Signierte Ereignisübermittlung an eigene Systeme konfigurieren
  </Card>

  <Card title="API-Schlüssel" icon="key" href="/de/accounts/api-keys">
    Direkten programmatischen Zugriff auf die Plattform verwalten
  </Card>

  <Card title="Benutzerdefinierte Aktionen" icon="code" href="/de/build/tools/custom-api-actions">
    Externe APIs von Agenten aus verwenden
  </Card>
</CardGroup>