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

# Autorisation d'agent

> Autorisation basée sur la portée, gestion de session et invocation d'outils pour les agents IA.

# Autorisation d'agent

Chaque agent IA de la plateforme Truthlocks opère sous un modèle d'autorisation strict. Les agents doivent être enregistrés, se voir attribuer des portées et créer des sessions limitées dans le temps avant de pouvoir entreprendre toute action.

## Flux d'autorisation

```
Register Agent → Assign Scopes → Create Session → Execute Actions → Terminate Session
      │               │                │                │               │
      ▼               ▼                ▼                ▼               ▼
  agent_id        scope_ids       session_token    audit_logged      cleanup
```

> [!TIP]
>
> Tous les points de terminaison d'autorisation d'agent — étendues, sessions et outils — disposent d'un API playground interactif. Ouvrez n'importe quel point de terminaison dans la référence de l'API [Sessions et outils d'agent](https://docs.truthlocks.com/fr/api-reference/machine-identity/sessions/create.md) et cliquez sur **Envoyer** pour l'essayer avec le Sandbox.

## Modèle de portée

Les portées suivent un modèle hiérarchique `resource:action`. Lorsqu'un agent demande une session, il ne peut demander que les portées qui lui ont été attribuées lors de l'enregistrement.

### Définition de portées personnalisées

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/scopes \
  -H "X-API-Key: $API_KEY" \
  -d '{
    "name": "invoices:approve",
    "description": "Approve invoices up to configured threshold",
    "constraints": {
      "max_amount_cents": 500000,
      "require_dual_approval_above": 100000
    }
  }'
```

### Portées intégrées

| Portée | Description |
| - | - |
| `agents:read` | Lister et inspecter les agents |
| `agents:write` | Enregistrer et mettre à jour les agents |
| `receipts:write` | Reçus d'action de frappe |
| `attestations:read` | Lire les données d'attestation |
| `attestations:write` | Créer de nouvelles attestations |
| `trust-scores:read` | Lire les données de score de confiance |
| `trust-scores:compute` | Déclencher le recalcul du score de confiance |
| `delegations:offer` | Offrir une délégation inter-locataire |
| `delegations:accept` | Accepter les offres de délégation |
| `compliance:write` | Créer des vérifications de conformité |
| `orchestrations:execute` | Exécuter des flux de travail multi-agents |
| `datasets:attest` | Attester la provenance des données |
| `models:attest` | Attester la lignée du modèle |

## Gestion de session

Les sessions fournissent des contextes d'exécution limités dans le temps avec expiration automatique et liste blanche d'adresses IP facultative.

### Création d'une session

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/agent-sessions \
  -H "X-API-Key: $API_KEY" \
  -d '{
    "agent_id": "maip-agent:01JXXXX",
    "scopes": ["receipts:write", "attestations:read"],
    "ttl_seconds": 3600,
    "ip_allowlist": ["10.0.0.0/8"],
    "metadata": {
      "task": "process-quarterly-invoices",
      "initiated_by": "user:alice@corp.com"
    }
  }'
```

**Réponse :**

```json theme={null}
{
  "id": "maip-session:01JYYYY",
  "agent_id": "maip-agent:01JXXXX",
  "token": "mst_live_...",
  "scopes": ["receipts:write", "attestations:read"],
  "expires_at": "2026-04-06T13:00:00Z",
  "status": "active"
}
```

### Cycle de vie de la session

| Statut | Description |
| - | - |
| `active` | La session est valide et accepte les requêtes |
| `expired` | TTL écoulé — nettoyage automatique |
| `terminated` | Terminé explicitement par l'utilisateur ou le système |
| `suspended` | Mis en pause en raison de la détection d'anomalies |

### Mettre fin à une session

```bash theme={null}
curl -X DELETE https://api.truthlocks.com/v1/agent-sessions/maip-session:01JYYYY \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "reason": "Task completed" }'
```

## Enregistrement et invocation d'outils

Les agents peuvent enregistrer les outils qu'ils exposent et invoquer les outils enregistrés par d'autres agents (sous réserve de vérifications de portée).

### Enregistrer un outil

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/tools \
  -H "X-API-Key: $API_KEY" \
  -d '{
    "agent_id": "maip-agent:01JXXXX",
    "name": "generate-invoice",
    "description": "Generate PDF invoice from order data",
    "input_schema": {
      "type": "object",
      "properties": {
        "order_id": { "type": "string" },
        "format": { "type": "string", "enum": ["pdf", "html"] }
      },
      "required": ["order_id"]
    }
  }'
```

### Invoquer un outil

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/tools/invoice-generator/invoke \
  -H "X-API-Key: $API_KEY" \
  -d '{
    "session_id": "maip-session:01JYYYY",
    "input": { "order_id": "ord_123", "format": "pdf" }
  }'
```

Chaque invocation d'outil est :

1. **Vérification de la portée** — la session doit avoir la portée requise
2. **Limité en débit** — selon le quota d'invocation d'outils de votre plan
3. **Journalisé pour audit** — entrée/sortie complète enregistrée dans la piste d'audit
4. **Mesuré** — comptabilisé par rapport à vos droits de facturation

## Meilleures pratiques de sécurité

> [!WARNING]
>
> N'intégrez jamais de jetons de session dans le code côté client. Les jetons de session accordent la portée complète de la session et doivent être traités comme des secrets.

1. **Principe du moindre privilège** — Ne demander que les portées nécessaires à la tâche actuelle
2. **Sessions de courte durée** — Utilisez le TTL le plus court possible (par défaut : 1 heure)
3. **Liste blanche d'IP** — Restreindre les sessions aux plages réseau connues
4. **Rotation des identifiants** — Régénérez les clés de signature de l'agent selon un calendrier régulier
5. **Surveiller les scores de confiance** — Définissez des alertes lorsque les scores de confiance tombent en dessous des seuils
6. **Utilisez le coupe-circuit** — Révoquez immédiatement les agents compromis

## Prochaines étapes

> [card] [Politiques MAIP](https://docs.truthlocks.com/guides/maip-policies.md)
>
> Règles d'application en temps réel basées sur les scores de confiance, les portées et la profondeur de délégation.

> [card] [Scores de confiance](https://docs.truthlocks.com/guides/trust-scores.md)
>
> Évaluation continue de la confiance comportementale pour les agents.

> [card] [Délégation inter-locataires](https://docs.truthlocks.com/guides/cross-tenant-delegation.md)
>
> Permettre aux agents d'agir au-delà des frontières organisationnelles.


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