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

# Secrets verwalten

> Hinterlegen Sie Connector-Zugangsdaten im Vault, legen Sie fest, wer sie nutzen darf, und bearbeiten, ersetzen, deaktivieren oder löschen Sie sie, ohne das Geheimnis offenzulegen.

Sobald der Vault geöffnet ist, können Sie Secrets hinzufügen, festlegen, wer sie nutzen darf, und sie aktuell halten. Jede Änderung wird vor dem Übernehmen geprüft, im Verlauf des Vault protokolliert und per E-Mail an alle Admins Ihrer Organisation gesendet.

> [!NOTE]
>
> Für Änderungen muss der Vault geöffnet sein. Wenn Sie ihn noch nicht geöffnet haben, siehe [Vault öffnen](https://documentation.deepmask.io/de/vault/open-the-vault.md).

## Die Liste der Secrets

Der Vault hat zwei Tabs:

* **Secrets** listet jedes Secret mit Connector, Art, Status, Anzahl verbundener Mitglieder, letzter Nutzung und der Person, die es zuletzt geändert hat. Mit dem Suchfeld und **Filter and sort** filtern Sie nach Connector, Status oder Art der Zugangsdaten.
* **History** listet jede Änderung und jedes Öffnen des Vault in Ihrer Organisation.

Wählen Sie ein Secret, um seine Details zu öffnen.

## Secret hinzufügen

**1. Neues Secret beginnen**

Wählen Sie **Add secret**.

**2. Art wählen**

Wählen Sie **App credentials**, um Zugangsdaten für einen Connector zu speichern, oder **Shared secret**, um Schlüssel-Wert-Paare zu speichern, die zu keinem Connector gehören.

**3. Connector wählen**

Wählen Sie bei App credentials den Connector, den Sie für Ihre Organisation einrichten möchten. Die Seite des Connectors zeigt einen Link **Setup guide**, die angeforderten Scopes und – bei Microsoft – einen Link zur Prüfung der Administratorzustimmung.

**4. Benennen und beschreiben**

Geben Sie einen **Connection name** und optional eine **Description** ein. Mitglieder sehen den Namen, wenn sie eine Organisationsverbindung auswählen. Wählen Sie also einen Namen, der hilft, das richtige Konto oder die richtige Umgebung zu finden, z. B. „Salesforce EU Produktion“.

**5. Zugangsdaten eingeben**

Füllen Sie die Felder für diesen Connector aus (siehe Tabelle unten). Geheimnisse werden nach dem Speichern nie wieder angezeigt – prüfen Sie sie daher sorgfältig.

**6. Speichern**

Wählen Sie **Save**. Das Secret steht sofort allen in der Organisation zur Verfügung. Um es einzuschränken, [legen Sie fest, wer es nutzen darf](#festlegen-wer-ein-secret-nutzen-darf).

### Zugangsdaten je Connector

| Connector | Was Sie eingeben | Hinweise |
| - | - | - |
| Salesforce (Enterprise) | Consumer Key (Client-ID) und Consumer Secret Ihrer Salesforce Connected App | Die Instanz-URL wird bei der Anmeldung jedes Mitglieds ermittelt. Siehe [Salesforce-Einrichtung](https://documentation.deepmask.io/de/salesforce.md). |
| Microsoft (Enterprise) | Client-ID und Mandanten-ID (Tenant ID) Ihrer Microsoft-Entra-App | Kein Client-Geheimnis nötig. Ggf. muss ein Entra-Admin die Zustimmung erteilen. Siehe [Microsoft-Enterprise-Einrichtung](https://documentation.deepmask.io/de/msft-enterprise.md). |
| Bright Data | API-Schlüssel | Alle Mitglieder nutzen den Schlüssel der Organisation. |
| 2slides | API-Schlüssel | Alle Mitglieder nutzen den Schlüssel der Organisation. |
| Custom-MCP-Server | Server-URL plus entweder **API Key** oder Consumer Key und optionales Secret (**Key & Secret**) | Wählen Sie die Option unter **Authentication**. Die URL muss eine öffentliche `http`- oder `https`-Adresse sein. |
| Shared secret | Bis zu 20 Schlüssel-Wert-Paare, z. B. eine Client-ID und ein Client-Geheimnis | Wird noch von keinem Connector genutzt. Für kommende Workflows, Automatisierungen und Agenten vorgesehen. |

> [!NOTE]
>
> Derzeit können Sie ein Secret pro Connector hinzufügen. Ausnahme sind Custom-MCP-Server: ein Secret pro Server, für beliebig viele Server. Namen müssen innerhalb Ihrer Organisation eindeutig sein und dürfen bis zu 80 Zeichen lang sein.

## Details eines Secrets

Ein ausgewähltes Secret zeigt seine Details in drei Tabs.

> [tab] Overview
>
> * **Configuration** zeigt den Connector und die Feldnamen. Werte von Geheimnissen erscheinen immer maskiert.
> * **Access** zeigt, wer das Secret nutzen darf, und bietet **Manage access** zum Ändern.
> * **Availability** deaktiviert oder aktiviert das Secret.
> * **Danger zone** löscht das Secret.

> [tab] Usage
>
> Zeigt, wie viele Mitglieder verbunden sind, wie viele Verbindungen das Secret nutzen und wann es zuletzt erfolgreich verwendet wurde. Die Tabelle **Members** listet jedes verbundene Mitglied mit dem Status **Connected** oder **Reconnect required** sowie den letzten Fehler, falls einer auftrat.
>
> Shared Secrets haben keinen Usage-Tab, da sie noch nicht genutzt werden.

> [tab] History
>
> Listet jede Änderung an diesem Secret: wer sie wann vorgenommen hat und was sich geändert hat.

## Änderungen prüfen und bestätigen

Wenn Sie ein Secret bearbeiten, ersetzen, einschränken, deaktivieren oder löschen, zeigt DeepMask zuerst eine Übersicht der Änderung und ihrer Folgen – etwa wie viele verbundene Mitglieder sich neu verbinden müssen. Wählen Sie **Review change**, prüfen Sie die Zusammenfassung und bestätigen Sie. Solange der Vault geöffnet ist, brauchen Sie keinen weiteren Code.

Ändert ein anderer Admin im selben Moment dasselbe Secret, wird Ihre Änderung abgelehnt, statt seine zu überschreiben. Laden Sie das Secret neu und versuchen Sie es erneut.

## Secret bearbeiten

Wählen Sie **Edit secret**, um Name oder Beschreibung zu ändern. Das hat keine Auswirkung auf verbundene Mitglieder.

## Zugangsdaten ersetzen

Verwenden Sie **Replace credentials**, wenn Sie ein Client-Geheimnis oder einen API-Schlüssel rotieren oder zu einer anderen App wechseln.

**1. Secret öffnen**

Wählen Sie das Secret und dann **Replace credentials**.

**2. Neue Werte eingeben**

Geben Sie die vollständigen neuen Zugangsdaten ein. Felder mit dem Hinweis **Optional · leave empty to keep current** behalten ihren gespeicherten Wert, wenn Sie sie leer lassen.

**3. Auswirkungen prüfen**

Die Übersicht zeigt, ob sich verbundene Mitglieder neu verbinden müssen. Übernehmen Sie anschließend die Änderung.

Ob sich Mitglieder neu verbinden müssen, hängt davon ab, was sich ändert:

| Änderung | Auswirkung auf verbundene Mitglieder |
| - | - |
| Neues Salesforce Consumer Secret, gleicher Consumer Key | Verbindungen funktionieren weiter. |
| Neuer API-Schlüssel für Bright Data, 2slides oder einen Custom-MCP-Server | Verbindungen nutzen den neuen Schlüssel ab der nächsten Verwendung. |
| Neue Client-ID bzw. neuer Consumer Key oder ein anderer Microsoft-Mandant | Mitglieder müssen sich neu verbinden. Ihr Connector zeigt **Neu verbinden**. |

## Festlegen, wer ein Secret nutzen darf

Standardmäßig darf jede Person in der Organisation ein neues Secret nutzen. So schränken Sie es ein:

**1. Zugriffseinstellungen öffnen**

Öffnen Sie das Secret und wählen Sie im Bereich **Access** die Option **Manage access**.

**2. Personen oder Gruppen auswählen**

Wählen Sie **Alle in der Organisation** oder suchen Sie nach Personen und Gruppen und wählen Sie **Hinzufügen**. Mitglieder einer aufgeführten Gruppe dürfen das Secret nutzen, solange sie der Gruppe angehören.

**3. Bestätigen**

Prüfen Sie die Änderung und bestätigen Sie.

Zugriffsregeln gelten für alle, auch für Admins. Ein Admin, der nicht auf der Liste steht, kann das Secret weiterhin verwalten, sich aber nicht darüber verbinden. Ein eingeschränktes Secret ohne Einträge auf der Liste kann von niemandem genutzt werden.

Verliert ein Mitglied den Zugriff – weil Sie es entfernt haben oder es eine aufgeführte Gruppe verlassen hat –, endet seine Verbindung bei der nächsten Anmeldung oder Token-Aktualisierung, und sein Connector fordert eine neue Verbindung an.

## Secret deaktivieren oder aktivieren

Ein deaktiviertes Secret kann nicht mehr über DeepMask genutzt werden, ohne dass etwas gelöscht wird.

1. Öffnen Sie das Secret und gehen Sie zu **Availability**.
2. Wählen Sie **Disable**, prüfen Sie die Änderung und bestätigen Sie.

Bestehende Verbindungen funktionieren ab der nächsten Anmeldung oder Token-Aktualisierung nicht mehr. Ein deaktiviertes Secret wird Mitgliedern beim Hinzufügen eines Connectors nicht angeboten. Um es wieder verfügbar zu machen, wählen Sie **Enable**.

## Secret löschen

> [!WARNING]
>
> Das Löschen eines Secrets lässt sich nicht rückgängig machen. Das Geheimnis wird sofort vernichtet, und alle darüber verbundenen Mitglieder müssen sich neu verbinden – über eine andere Organisationsverbindung oder mit eigenen Zugangsdaten.

1. Öffnen Sie das Secret und gehen Sie zu **Danger zone**.
2. Wählen Sie **Delete** und bestätigen Sie.

Name und Verlauf des Secrets bleiben für Ihre Unterlagen erhalten. Das Löschen in DeepMask **widerruft die Zugangsdaten beim Anbieter nicht**. Wenn Sie sie nicht mehr benötigen, widerrufen Sie das Client-Geheimnis oder den API-Schlüssel zusätzlich in Salesforce, Microsoft Entra, Bright Data, 2slides oder auf Ihrem MCP-Server.

## Benachrichtigungen und Verlauf

* Nach jeder übernommenen Änderung erhalten alle Admins Ihrer Organisation eine E-Mail mit einer Zusammenfassung.
* Der Tab **History** des Vault protokolliert jede Änderung, jedes Öffnen, jeden falschen Code und jede Sperre – jeweils mit dem Admin und dem Zeitpunkt.

> [!TIP]
>
> Meldet eine E-Mail eine Änderung, die niemand in Ihrem Team vorgenommen hat, folgen Sie den Schritten unter [Vault-Sicherheit](https://documentation.deepmask.io/de/vault/security.md#wenn-etwas-nicht-stimmt).


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