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

# RBAC & Berechtigungen

> Rollenbasierte Zugriffskontrolle und Berechtigungsverwaltung.

Truthlocks implementiert rollenbasierte Zugriffskontrolle (RBAC), um zu verwalten, wer welche Aktionen ausführen kann. Dieser Leitfaden erklärt das Berechtigungsmodell.

## Berechtigungsmodell

Das Truthlocks Berechtigungsmodell besteht aus drei Schichten:

**1. Berechtigungen**

Atomare Aktionen wie `attestations:mint` oder `users:read`. Dies sind die
Bausteine.

**2. Rollen**

Sammlungen von Berechtigungen, gruppiert nach Funktion. Rollen wie `admin`,
`issuer` oder `viewer`.

**3. Zuweisungen**

Bindung von Benutzern oder API-Schlüsseln an Rollen. Ein Benutzer kann mehrere Rollen haben.

## Verfügbare Berechtigungen

### Attestierungsberechtigungen

| Berechtigung | Beschreibung |
| - | - |
| `attestations:mint` | Neue Attestierungen erstellen |
| `attestations:read` | Attestierungsdetails anzeigen und Proof-Bundles herunterladen |
| `attestations:revoke` | Bestehende Attestierungen widerrufen |
| `attestations:*` | Alle Bestätigungsberechtigungen |

### Ausstellerberechtigungen

| Berechtigung | Beschreibung |
| - | - |
| `issuers:read` | Ausstellerinformationen und Schlüssel anzeigen |
| `issuers:write` | Aussteller erstellen, Schlüssel registrieren |
| `issuers:*` | Alle Ausstellerberechtigungen |

### Berechtigungen zur Benutzerverwaltung

| Berechtigung | Beschreibung |
| - | - |
| `users:read` | Benutzer und Rollenzuweisungen anzeigen |
| `users:write` | Benutzer einladen, Rollen zuweisen, Benutzer entfernen |
| `api-keys:read` | API-Schlüssel anzeigen (ohne Geheimnisse) |
| `api-keys:write` | API-Schlüssel erstellen und widerrufen |

### Administrative Berechtigungen

| Berechtigung | Beschreibung |
| - | - |
| `audit:read` | Audit-Protokolle abfragen |
| `governance:approve` | Governance-Anfragen genehmigen |
| `governance:suspend` | Aktive Aussteller sperren |
| `*` | Superadmin: alle Berechtigungen |

### Webhook-Berechtigungen

| Berechtigung | Beschreibung |
| - | - |
| `webhooks:read` | Webhook-Endpunkte und Lieferprotokolle anzeigen |
| `webhooks:write` | Endpunkte erstellen, aktualisieren und löschen |
| `webhooks:*` | Alle Webhook-Berechtigungen |

### Governance-Berechtigungen

| Berechtigung | Beschreibung |
| - | - |
| `governance:read` | Governance-Anfragen anzeigen |
| `governance:approve` | Governance-Anfragen genehmigen |
| `governance:suspend` | Aktive Aussteller sperren |
| `governance:*` | Alle Governance-Berechtigungen |

### Berechtigungen für Einstellungen

| Berechtigung | Beschreibung |
| - | - |
| `settings:read` | Mandanten- und Organisationseinstellungen anzeigen |
| `settings:write` | Branding, Domains, E-Mail und andere Einstellungen aktualisieren |
| `settings:*` | Alle Einstellungen-Berechtigungen |

## Systemrollen

Truthlocks stellt automatisch eine Reihe von Systemrollen bereit, wenn Ihr Mandant erstellt wird. Systemrollen können nicht bearbeitet oder gelöscht werden.

| Rolle | Beschreibung | Schlüsselberechtigungen |
| :- | :- | :- |
| **Mandanten-Admin** | Voller Zugriff auf alle Ressourcen innerhalb des Mandanten | `*` (Superadmin) |
| **Org-Admin** | Verwalten Sie die Aussteller, Benutzer und Bestätigungen einer einzelnen Organisation | `issuers:*`, `attestations:*`, `users:*`, `audit:read` |
| **Aussteller-Admin** | Aussteller verwalten und Bestätigungen prägen | `issuers:*`, `attestations:*` |
| **Auditor** | Nur Lesezugriff für Überwachung und Compliance | `attestations:read`, `issuers:read`, `audit:read` |

Sie können Systemrollen auf der Seite **Rollen** in der Konsole anzeigen. Jede Rolle zeigt ihren Namen, ihre Beschreibung und ein **System**-Abzeichen.

## Benutzerdefinierte Rollen

Erstellen Sie benutzerdefinierte Rollen, um Zugriffsberechtigungen zu definieren, die auf die Struktur Ihres Teams zugeschnitten sind. Benutzerdefinierte Rollen sind in allen Plänen verfügbar.

### Erstellen einer benutzerdefinierten Rolle in der Konsole

**1. Seite „Rollen“ öffnen**

Navigieren Sie in der Konsolen-Seitenleiste zu **Rollen**.

**2. Klicken Sie auf „Benutzerdefinierte Rolle erstellen“**

Die Schaltfläche **Benutzerdefinierte Rolle erstellen** öffnet einen Dialog, in dem Sie Folgendes angeben:

* **Rollenname** – ein beschreibender Name für die Rolle (zum Beispiel `Developer` oder `Compliance Officer`).
* **Beschreibung** – eine kurze Erklärung, wofür die Rolle vorgesehen ist.

**3. Die Rolle speichern**

Klicken Sie auf **Rolle erstellen**, um zu speichern. Die neue Rolle erscheint im Abschnitt **Benutzerdefinierte Rollen** der Rollenseite.

### Erstellen einer benutzerdefinierten Rolle über die API

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/roles \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "attestation_minter",
    "description": "Can only mint attestations for specific issuers",
    "permissions": ["attestations:mint", "attestations:read", "issuers:read"],
    "constraints": {
      "issuer_ids": ["issuer-uuid-1", "issuer-uuid-2"]
    }
  }'
```

### Einschränkungen auf Ressourcenebene

Benutzerdefinierte Rollen unterstützen optionale Einschränkungen, die Berechtigungen auf bestimmte Ressourcen beschränken:

```json theme={null}
{
  "name": "regional_auditor",
  "description": "Audit access scoped to EU issuers only",
  "permissions": ["attestations:read", "issuers:read", "audit:read"],
  "constraints": {
    "issuer_ids": ["eu-issuer-uuid-1", "eu-issuer-uuid-2"]
  }
}
```

> [!NOTE]
>
> Ressourcenbezogene Einschränkungen (z. B. Beschränkung auf bestimmte Aussteller) sind
> auf Enterprise-Plänen verfügbar.

## API-Schlüsselbereiche vs. Benutzerrollen

Sowohl API-Schlüssel als auch Benutzer haben Berechtigungen, aber sie funktionieren unterschiedlich:

| Aspekt | API-Schlüsselbereiche | Benutzerrollen |
| - | - | - |
| Zuweisung | Bei Schlüsselerstellung festgelegt, unveränderlich | Kann jederzeit geändert werden |
| Audit-Trail | Aktionen als API-Schlüssel-ID protokolliert | Aktionen als Benutzer-E-Mail protokolliert |
| Mehrfach | Ein Schlüssel = ein Satz von Scopes | Benutzer kann mehrere Rollen haben |
| Anwendungsfall | Server-zu-Server-Integration | Menschliche Benutzer über UI/Dashboard |

## Best Practices

* **Geringstes Privileg:** Gewähren Sie nur die für jede Rolle erforderlichen Berechtigungen
* **Aufgabentrennung:** Geben Sie einer Rolle nicht sowohl `attestations:mint` als auch `governance:approve`
* **Regelmäßige Audits:** Überprüfen Sie die Rollenzuweisungen vierteljährlich
* **API-Schlüssel für die Automatisierung verwenden:** Teilen Sie keine Benutzeranmeldeinformationen für Skripte
* **Benutzerdefinierte Rollen dokumentieren:** Führen Sie Aufzeichnungen darüber, warum benutzerdefinierte Rollen erstellt wurden

## Nächste Schritte

> [card] [Audit-Protokolle](https://docs.truthlocks.com/security/audit.md)
>
> Verfolgen Sie alle berechtigungsbezogenen Ereignisse.

> [card] [Identitäts-API](https://docs.truthlocks.com/api-reference/identity/orgs.md)
>
> Verwalten Sie Benutzer und Rollen programmatisch.


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