> ## 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 et autorisations

> Contrôle d'accès basé sur les rôles et gestion des permissions.

Truthlocks implémente le contrôle d'accès basé sur les rôles (RBAC) pour gérer qui peut effectuer quelles actions. Ce guide explique le modèle de permissions.

## Modèle d'autorisations

Le modèle de permissions Truthlocks se compose de trois couches :

**1. Autorisations**

Actions atomiques comme `attestations:mint` ou `users:read`. Ce sont les
blocs de construction.

**2. Rôles**

Collections de permissions regroupées par fonction. Rôles comme `admin`,
`issuer`, ou `viewer`.

**3. Affectations**

Liaison des utilisateurs ou des clés API à des rôles. Un utilisateur peut avoir plusieurs rôles.

## Permissions disponibles

### Permissions d'attestation

| Permission | Description |
| - | - |
| `attestations:mint` | Créer de nouvelles attestations |
| `attestations:read` | Afficher les détails de l'attestation et télécharger les paquets de preuves |
| `attestations:revoke` | Révoquer les attestations existantes |
| `attestations:*` | Toutes les permissions d'attestation |

### Permissions de l'émetteur

| Permission | Description |
| - | - |
| `issuers:read` | Afficher les informations et les clés de l'émetteur |
| `issuers:write` | Créer des émetteurs, enregistrer des clés |
| `issuers:*` | Toutes les permissions d'émetteur |

### Permissions de gestion des utilisateurs

| Permission | Description |
| - | - |
| `users:read` | Afficher les utilisateurs et les attributions de rôles |
| `users:write` | Inviter des utilisateurs, attribuer des rôles, supprimer des utilisateurs |
| `api-keys:read` | Afficher les clés API (sans secrets) |
| `api-keys:write` | Créer et révoquer des clés API |

### Permissions administratives

| Permission | Description |
| - | - |
| `audit:read` | Consulter les journaux d'audit |
| `governance:approve` | Approuver les demandes de gouvernance |
| `governance:suspend` | Suspendre les émetteurs actifs |
| `*` | Superadministrateur : toutes les autorisations |

### Permissions de webhook

| Permission | Description |
| - | - |
| `webhooks:read` | Afficher les points de terminaison de webhook et les journaux de livraison |
| `webhooks:write` | Créer, mettre à jour et supprimer des points de terminaison |
| `webhooks:*` | Toutes les permissions de webhook |

### Permissions de gouvernance

| Permission | Description |
| - | - |
| `governance:read` | Afficher les demandes de gouvernance |
| `governance:approve` | Approuver les demandes de gouvernance |
| `governance:suspend` | Suspendre les émetteurs actifs |
| `governance:*` | Toutes les permissions de gouvernance |

### Autorisations des paramètres

| Permission | Description |
| - | - |
| `settings:read` | Afficher les paramètres du locataire et de l'organisation |
| `settings:write` | Mettre à jour l'image de marque, les domaines, les e-mails et d'autres paramètres |
| `settings:*` | Toutes les permissions de paramètres |

## Rôles système

Truthlocks provisionne automatiquement un ensemble de rôles système lors de la création de votre locataire. Les rôles système ne peuvent pas être modifiés ou supprimés.

| Rôle | Description | Permissions clés |
| :- | :- | :- |
| **Administrateur de locataire** | Accès complet à toutes les ressources du locataire | `*` (superadministrateur) |
| **Administrateur d'organisation** | Gérer les émetteurs, les utilisateurs et les attestations d'une seule organisation | `issuers:*`, `attestations:*`, `users:*`, `audit:read` |
| **Administrateur d'émetteur** | Gérer les émetteurs et créer des attestations | `issuers:*`, `attestations:*` |
| **Auditeur** | Accès en lecture seule pour la surveillance et la conformité | `attestations:read`, `issuers:read`, `audit:read` |

Vous pouvez afficher les rôles système depuis la page **Rôles** dans la console. Chaque rôle affiche son nom, sa description et un badge **Système**.

## Rôles personnalisés

Créez des rôles personnalisés pour définir des autorisations d'accès adaptées à la structure de votre équipe. Les rôles personnalisés sont disponibles sur tous les plans.

### Création d'un rôle personnalisé dans la console

**1. Ouvrir la page Rôles**

Naviguez vers **Rôles** dans la barre latérale de la console.

**2. Cliquez sur Créer un rôle personnalisé**

Le bouton **Créer un rôle personnalisé** ouvre une boîte de dialogue où vous fournissez :

* **Nom du rôle** — un nom descriptif pour le rôle (par exemple, `Developer` ou `Compliance Officer`).
* **Description** — une brève explication de l'objectif du rôle.

**3. Enregistrer le rôle**

Cliquez sur **Créer un rôle** pour enregistrer. Le nouveau rôle apparaît dans la section **Rôles personnalisés** de la page Rôles.

### Création d'un rôle personnalisé via l'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"]
    }
  }'
```

### Contraintes au niveau des ressources

Les rôles personnalisés prennent en charge des contraintes facultatives qui limitent les autorisations à des ressources spécifiques :

```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]
>
> Les contraintes au niveau des ressources (telles que la limitation à des émetteurs spécifiques) sont
> disponible sur les plans Entreprise.

## Portées des clés API vs rôles utilisateur

Les clés API et les utilisateurs ont tous deux des autorisations, mais ils fonctionnent différemment :

| Aspect | Portées de clé API | Rôles utilisateur |
| - | - | - |
| Affectation | Définie à la création de la clé, immuable | Peut être modifiée à tout moment |
| Piste d'audit | Actions enregistrées comme ID de clé API | Actions enregistrées comme e-mail d'utilisateur |
| Multiple | Une clé = un ensemble de portées | L'utilisateur peut avoir plusieurs rôles |
| Cas d'utilisation | Intégration serveur à serveur | Utilisateurs humains via UI/tableau de bord |

## Bonnes pratiques

* **Moindre privilège :** N'accordez que les autorisations nécessaires pour chaque rôle
* **Séparation des tâches:** Ne donnez pas à un même rôle à la fois `attestations:mint` et `governance:approve`
* **Audits réguliers:** Examiner les attributions de rôles trimestriellement
* **Utilisez des clés API pour l'automatisation :** Ne partagez pas les identifiants utilisateur pour les scripts
* **Documenter les rôles personnalisés :** Conserver un enregistrement des raisons pour lesquelles les rôles personnalisés ont été créés

## Prochaines étapes

> [card] [Journaux d'audit](https://docs.truthlocks.com/security/audit.md)
>
> Suivez tous les événements liés aux permissions.

> [card] [API d'identité](https://docs.truthlocks.com/api-reference/identity/orgs.md)
>
> Gérez les utilisateurs et les rôles par programmation.


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