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

# Support-Zugriffssitzungen

> Wie der Truthlocks-Kundensupport mit zeitlich begrenzten, bereichsbezogenen Identitätswechselsitzungen auf Ihren Mandanten zugreift.

Wenn Sie den Truthlocks-Support kontaktieren und die Fehlerbehebung den Zugriff auf Ihren Mandanten erfordert, verwenden die Supportmitarbeiter **Impersonation-Sitzungen** – zeitlich begrenzte, auf den Umfang beschränkte Sitzungen, die vollständig in Ihrem Audit-Log aufgezeichnet werden.

## Funktionsweise

**1. Support erstellt eine Sitzung**

Ein Supportmitarbeiter erstellt eine Imitationssitzung, die Ihre
Mandanten, die erforderlichen Berechtigungsumfänge, eine TTL und einen Grund für den Zugriff.
Sitzungen können optional auf eine bestimmte Organisation innerhalb Ihres
Mandant.

**2. Sitzung ist zeitlich begrenzt**

Jede Sitzung hat eine konfigurierbare Gültigkeitsdauer (TTL) zwischen 1 und 60 Minuten.
Minuten (Standardwert 15 Minuten). Wenn die TTL abläuft, wird der Zugriff widerrufen
sofort – keine manuelle Aktion erforderlich.

**3. Aktionen werden aufgezeichnet**

Jede HTTP-Anfrage, die der Supportmitarbeiter während der Sitzung stellt, wird
in einem dedizierten Zugriffsprotokoll mit Methode, Pfad, Statuscode,
und Anforderungs-ID. Diese Ereignisse erscheinen auch in Ihrem Mandanten
[Audit-Protokoll](https://docs.truthlocks.com/de/security/audit.md).

## Sitzungseigenschaften

| Eigenschaft | Beschreibung |
| :- | :- |
| **Mandant** | Der Mandant, für den die Sitzung Zugriff gewährt. |
| **Organisation** | *(optional)* Eine bestimmte Organisation innerhalb des Mandanten. Wenn festgelegt, ist der Zugriff nur auf die Daten dieser Organisation beschränkt. |
| **Scopes** | Die für die Sitzung gewährten Berechtigungen. Standardmäßig `read_only`, wenn keine angegeben sind. |
| **TTL** | Gültigkeitsdauer in Minuten (1–60, Standard 15). |
| **Grund** | Eine für Menschen lesbare Erklärung, warum die Sitzung erstellt wurde (mindestens 10 Zeichen). |
| **Status** | `ACTIVE` (in Verwendung), `EXPIRED` (TTL erreicht) oder `REVOKED` (manuell beendet). |
| **IP-Adresse** | Die IP-Adresse des Supportmitarbeiters, der die Sitzung erstellt hat. |
| **User-Agent** | Der Browser oder Client, der vom Support-Personal verwendet wird. |
| **Ausgestellt am** | Wann die Sitzung erstellt wurde. |
| **Läuft ab um** | Wann die Sitzung basierend auf der TTL automatisch abläuft. |

## Sitzungslebenszyklus

* **Aktiv** – die Sitzung wird verwendet und das Support-Mitarbeiter hat Zugriff auf die gewährten Bereiche.
* **Abgelaufen** – die TTL wurde erreicht und der Zugriff wird automatisch widerrufen.
* **Widerrufen** – ein Plattformadministrator hat die Sitzung vorzeitig beendet. Die Identität des Administrators und ein optionaler Widerrufsgrund werden aufgezeichnet.

## Überprüfung der Support-Aktivitäten

### Audit-Protokoll

Alle Aktivitäten der Support-Sitzung erscheinen im [Audit-Protokoll](https://docs.truthlocks.com/de/security/audit.md) Ihres Mandanten. Filtern Sie nach der Ereigniskategorie `support_session`, um genau zu sehen, worauf wann zugegriffen wurde.

```bash theme={null}
curl "https://api.truthlocks.com/v1/audit?category=support_session" \
  -H "X-API-Key: tl_live_..."
```

Jedes Audit-Ereignis enthält die Sitzungs-ID, die Identität des Mitarbeiters, die durchgeführte Aktion und einen Zeitstempel.

### Zugriffsprotokolle pro Sitzung

Sie können auch ein detailliertes Zugriffsprotokoll für eine bestimmte Sitzung abrufen. Jeder Eintrag zeichnet die HTTP-Methode, den Anforderungspfad, den Antwortstatuscode und eine eindeutige Anforderungs-ID auf.

```json theme={null}
[
  {
    "method": "GET",
    "path": "/v1/attestations",
    "status_code": 200,
    "request_id": "req_abc123",
    "timestamp": "2026-03-26T14:30:00Z"
  }
]
```

## Sicherheitskontrollen

> [card] Gezielter Zugriff
>
> Sitzungen sind auf bestimmte Berechtigungsumfänge und optional auf eine
> einzelne Organisation. Der Support kann nicht auf Ressourcen außerhalb der gewährten
> Bereiche.

> [card] Zeitlich begrenzt
>
> Jede Sitzung läuft automatisch basierend auf ihrer TTL (1–60 Minuten) ab.
> Es gibt keine dauerhaften Support-Zugriffsberechtigungen.

> [card] Vollständiger Audit-Trail
>
> Jede HTTP-Anfrage wird im Zugriffsprotokoll der Sitzung mit dem
> IP-Adresse und des User-Agents des Mitarbeiters zugreifen.

> [card] Widerrufbar
>
> Aktive Sitzungen können jederzeit von einem Plattformadministrator widerrufen werden,
> mit optionalem Grund.

## Verwandt

> [card] [Audit-Protokolle](https://docs.truthlocks.com/security/audit.md)
>
> Zeigen Sie die Audit-Ereignisse Ihres Mandanten an und exportieren Sie sie.

> [card] [RBAC](https://docs.truthlocks.com/security/rbac.md)
>
> Verstehen Sie Rollen und Berechtigungsumfänge.


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