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

# Sessions d'accès au support

> Comment le support client de Truthlocks accède à votre locataire avec des sessions d'usurpation d'identité à durée limitée et délimitées.

Lorsque vous contactez le support Truthlocks et que le dépannage nécessite un accès à votre locataire, le personnel de support utilise des **sessions d'usurpation d'identité** — des sessions à durée limitée et à portée restreinte qui sont entièrement enregistrées dans votre journal d'audit.

## Comment ça marche

**1. Le support crée une session**

Un membre du personnel de support crée une session d'usurpation d'identité spécifiant votre
locataire, les étendues d'autorisation requises, un TTL et une raison d'accès.
Les sessions peuvent être facultativement limitées à une organisation spécifique au sein de votre
locataire.

**2. La session est limitée dans le temps**

Chaque session a une durée de vie configurable (TTL) entre 1 et 60
minutes (par défaut 15 minutes). Lorsque le TTL expire, l'accès est révoqué
immédiatement — aucune action manuelle requise.

**3. Les actions sont enregistrées**

Chaque requête HTTP effectuée par le membre du personnel de support pendant la session est
enregistré dans un journal d'accès dédié avec la méthode, le chemin, le code de statut,
et l'ID de la requête. Ces événements apparaissent également dans votre locataire
[journal d'audit](https://docs.truthlocks.com/fr/security/audit.md).

## Propriétés de la session

| Propriété | Description |
| :- | :- |
| **Locataire** | Le locataire auquel la session accorde l'accès. |
| **Organisation** | *(facultatif)* Une organisation spécifique au sein du locataire. Lorsque défini, l'accès est restreint aux données de cette organisation uniquement. |
| **Portées** | Les autorisations accordées pour la session. Par défaut, `read_only` si aucune n'est spécifiée. |
| **TTL** | Durée de vie en minutes (1 à 60, par défaut 15). |
| **Raison** | Une explication lisible par l'homme de la raison pour laquelle la session a été créée (minimum 10 caractères). |
| **Statut** | `ACTIVE` (en cours d'utilisation), `EXPIRED` (TTL atteint) ou `REVOKED` (terminé manuellement). |
| **Adresse IP** | L'adresse IP du membre du personnel de support qui a créé la session. |
| **User-Agent** | Le navigateur ou le client utilisé par le personnel de support. |
| **Émis le** | Quand la session a été créée. |
| **Expire le** | Quand la session expire automatiquement, basée sur le TTL. |

## Cycle de vie de la session

* **Actif** — la session est utilisée et le membre du personnel de support a accès aux portées accordées.
* **Expiré** — le TTL a été atteint et l'accès est automatiquement révoqué.
* **Révoqué** — un administrateur de la plateforme a mis fin à la session prématurément. L'identité de l'administrateur et une raison de révocation facultative sont enregistrées.

## Examen de l'activité de support

### Journal d'audit

Toute l'activité de la session de support apparaît dans le [journal d'audit](https://docs.truthlocks.com/fr/security/audit.md) de votre locataire. Filtrez par la catégorie d'événement `support_session` pour voir exactement ce qui a été accédé et quand.

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

Chaque événement d'audit comprend l'ID de session, l'identité du membre du personnel, l'action effectuée et un horodatage.

### Journaux d'accès par session

Vous pouvez également récupérer un journal d'accès détaillé pour une session spécifique. Chaque entrée enregistre la méthode HTTP, le chemin de la requête, le code de statut de la réponse et un ID de requête unique.

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

## Contrôles de sécurité

> [card] Accès ciblé
>
> Les sessions sont restreintes à des portées de permission spécifiques et, facultativement, à un
> organisation unique. Le support ne peut pas accéder aux ressources en dehors des
> portées.

> [card] Limité dans le temps
>
> Chaque session expire automatiquement en fonction de son TTL (1 à 60 minutes).
> Il n'y a pas d'octrois d'accès de support permanents.

> [card] Piste d'audit complète
>
> Chaque requête HTTP est enregistrée dans le journal d'accès de la session avec le
> l'adresse IP et l'User-Agent du membre du personnel.

> [card] Révoquable
>
> Les sessions actives peuvent être révoquées à tout moment par un administrateur de plateforme,
> avec une raison facultative.

## Lié

> [card] [Journaux d'audit](https://docs.truthlocks.com/security/audit.md)
>
> Affichez et exportez les événements d'audit de votre locataire.

> [card] [RBAC](https://docs.truthlocks.com/security/rbac.md)
>
> Comprendre les rôles et les portées de permission.


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