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

# Identité machine (MAIP)

> Enregistrer, autoriser et surveiller les agents IA avec une identité cryptographique et des contraintes comportementales.

# Protocole d'identité machine et d'identité d'agent

Le **Protocole d'identité d'agent machine (MAIP)** fournit des enregistrements d'identité pour les agents IA, les bots et les services automatisés — pour l'enregistrement des agents et l'enregistrement de leurs permissions et activités.

> [!WARNING]
>
> Certaines opérations MAIP enregistrent actuellement les résultats fournis par l'appelant plutôt que de les exécuter ou de les vérifier de manière indépendante. L'extraction de documents et les verdicts d'IA sont simulés ; les garde-fous classent un score soumis ; les gestionnaires d'orchestration et de flux de travail créent des enregistrements de suivi. Plusieurs reçus générés utilisent des marqueurs système au lieu de signatures cryptographiques. Lisez les limitations d'implémentation de l'opération avant de vous fier à sa sortie comme preuve.

## Pourquoi l'identité machine ?

À mesure que les agents IA prolifèrent dans les flux de travail d'entreprise, les organisations sont confrontées à un défi critique : **Comment savoir quel agent a fait quoi, et si cela était autorisé ?**

MAIP résout ce problème avec :

* **Identité d'agent cryptographique** — Chaque agent reçoit un ID unique (`maip-agent:<ulid>`) et des clés de signature
* **Autorisation basée sur la portée** — Des portées de permission granulaires contrôlent ce que chaque agent peut faire
* **Application de la politique d'exécution** — [les politiques MAIP](https://docs.truthlocks.com/fr/guides/maip-policies.md) évaluent les scores de confiance, les portées et la profondeur de délégation avant chaque action sensible
* **Notation de confiance** — L'évaluation comportementale continue produit un score de confiance de 0 à 100
* **Gestion de session** — Contextes d'exécution à durée limitée avec expiration automatique
* **Délégation inter-locataires** — Les agents peuvent déléguer l'autorité au-delà des frontières organisationnelles
* **Interrupteur d'urgence** — Révocation d'urgence instantanée de l'accès de tout agent

## Architecture

```
┌─────────────────────────────────────────────┐
│              Your Application                │
│  ┌─────────┐  ┌─────────┐  ┌─────────────┐  │
│  │ Agent A │  │ Agent B │  │  Agent C    │  │
│  └────┬────┘  └────┬────┘  └──────┬──────┘  │
│       │            │              │          │
│  ┌────▼────────────▼──────────────▼──────┐  │
│  │         MAIP SDK (JS / Go / Py)       │  │
│  └────────────────┬──────────────────────┘  │
└───────────────────┼─────────────────────────┘
                    │ HTTPS
    ┌───────────────▼───────────────┐
    │   Machine Identity Service    │
    │  ┌──────┐ ┌───────┐ ┌──────┐ │
    │  │Agents│ │Scopes │ │Trust │ │
    │  │      │ │       │ │Scores│ │
    │  └──────┘ └───────┘ └──────┘ │
    └───────────────────────────────┘
```

## Essayez-le dans le playground

Chaque point de terminaison MAIP dispose d'un environnement de test API interactif intégré à la documentation. Vous pouvez créer des requêtes, basculer entre les environnements [Sandbox et Production](https://docs.truthlocks.com/fr/environments.md#try-it-in-the-api-playground) et les envoyer directement — aucun outil séparé n'est nécessaire.

Tous les points de terminaison MAIP sont couverts, couvrant dix groupes d'API : [Agents de machine](https://docs.truthlocks.com/fr/api-reference/machine-identity/agents/register.md), [Sessions et outils d'agent](https://docs.truthlocks.com/fr/api-reference/machine-identity/sessions/create.md), [Confiance et témoins](https://docs.truthlocks.com/fr/api-reference/machine-identity/trust-scores/get.md), [Politiques MAIP](https://docs.truthlocks.com/fr/api-reference/machine-identity/policies/list.md), [Revendications de vérité et documents](https://docs.truthlocks.com/fr/api-reference/machine-identity/truth-claims/create.md), [Conformité et anomalies](https://docs.truthlocks.com/fr/api-reference/machine-identity/compliance/create-check.md), [Ensembles de données et modèles](https://docs.truthlocks.com/fr/api-reference/machine-identity/datasets/attest.md), [Orchestrations et workflows](https://docs.truthlocks.com/fr/api-reference/machine-identity/orchestrations/execute.md), [Garde-fous et délégation](https://docs.truthlocks.com/fr/api-reference/machine-identity/guardrails/check.md), et [Observabilité](https://docs.truthlocks.com/fr/api-reference/machine-identity/observability/events.md).

Le terrain de jeu prend en charge l'authentification `X-API-Key` et Bearer JWT. Utilisez `X-API-Key` pour des tests rapides et Bearer JWT lorsque vous devez vous authentifier avec un jeton de session d'un agent en cours d'exécution.

> [!TIP]
>
> Ouvrez n'importe quel point de terminaison dans la référence de l'API [Agents machine](https://docs.truthlocks.com/fr/api-reference/machine-identity/agents/register.md) et cliquez sur **Envoyer** pour l'essayer en direct contre le Sandbox.

## Démarrage rapide

### 1. Enregistrer un agent

```bash cURL theme={null}
curl -X POST https://api.truthlocks.com/v1/agents \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "order-processor",
    "type": "autonomous",
    "scopes": ["receipts:write", "attestations:read"],
    "metadata": {
      "framework": "langchain",
      "model": "gpt-4o",
      "owner": "platform-team"
    }
  }'
```

```javascript JavaScript theme={null}
import { TruthlocksMAIP } from "@truthlocks/sdk";

const maip = new TruthlocksMAIP({ apiKey: process.env.TL_API_KEY });

const agent = await maip.agents.register({
  name: "order-processor",
  type: "autonomous",
  scopes: ["receipts:write", "attestations:read"],
  metadata: {
    framework: "langchain",
    model: "gpt-4o",
    owner: "platform-team",
  },
});
```

### 2. Créer 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"],
    "ttl_seconds": 3600,
    "ip_allowlist": ["10.0.0.0/8"]
  }'
```

### 3. Exécuter avec la notation de confiance

Chaque action entreprise par l'agent est enregistrée et notée. Le score de confiance est mis à jour en permanence :

```bash theme={null}
# Check current trust score
curl https://api.truthlocks.com/v1/trust-scores/maip-agent:01JXXXX \
  -H "X-API-Key: $API_KEY"
```

Réponse :

```json theme={null}
{
  "agent_id": "maip-agent:01JXXXX",
  "score": 87,
  "factors": {
    "behavioral_compliance": 92,
    "scope_adherence": 95,
    "anomaly_score": 12,
    "peer_attestations": 78
  },
  "trend": "stable",
  "computed_at": "2026-04-06T12:00:00Z"
}
```

### 4. Interrupteur d'urgence

Révoquez instantanément tout accès d'agent:

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/agents/maip-agent:01JXXXX/kill \
  -H "X-API-Key: $API_KEY" \
  -d '{ "reason": "Anomalous behavior detected", "revoke_sessions": true }'
```

## Concepts fondamentaux

### Types d'agents

| Type | Description | Cas d'utilisation |
| - | - | - |
| `autonomous` | Prise de décision entièrement autonome | Bots de trading, moteurs de workflow |
| `supervised` | Nécessite une approbation humaine pour les actions critiques | Modération de contenu, conformité |
| `delegated` | Agit au nom d'un autre agent ou utilisateur | Comptes de service, proxys |
| `system` | Agent au niveau de l'infrastructure | Surveillance, vérifications de santé |

### Portées

Les portées suivent un modèle `resource:action` :

* `agents:read` / `agents:write` — Gestion des agents
* `receipts:write` — Émettre des reçus d'action
* `attestations:read` — Lire les données d'attestation
* `trust-scores:read` — Accéder aux scores de confiance
* `delegations:offer` / `delegations:accept` — Délégation inter-locataires
* `compliance:write` — Exécuter des contrôles de conformité
* `orchestrations:execute` — Exécuter des workflows multi-agents

### Composants du score de confiance

| Facteur | Poids | Description |
| - | - | - |
| Conformité comportementale | 35% | Actions dans le cadre déclaré |
| Adhésion à la portée | 25 % | Aucune tentative d'accès hors portée |
| Score d'anomalie | 20% | Déviation par rapport aux schémas historiques |
| Attestations de pairs | 10 % | Autres agents se portant garants du comportement |
| Hygiène de session | 10 % | Création/terminaison de session appropriée |

## Facturation et quotas

Les fonctionnalités d'identité machine sont mesurées selon votre plan. Quatre compteurs d'utilisation MAIP sont suivis à chaque cycle de facturation :

| Métrique | Ce qu'elle compte | Développeur | Entreprise | Grande entreprise |
| :- | :- | :- | :- | :- |
| `maip.agents` | Agents machine enregistrés | 2 | 50 | Dépend du plan |
| `maip.sessions` | Sessions d'agent créées par mois | 100 | 10 000 | Dépend du plan |
| `maip.trust_computes` | Calculs de score de confiance à la demande | 50 | 5 000 | Dépend du plan |
| `maip.compliance_checks` | Demandes de vérification de conformité | 10 | 500 | Dépend du plan |

Surveillez votre consommation avec l'[API d'utilisation](https://docs.truthlocks.com/fr/api-reference/billing/usage.md) ou dans la console sous **Paramètres > Facturation > Utilisation** dans la section **MAIP**.

> [!NOTE]
>
> Consultez l'[aperçu de la facturation](https://docs.truthlocks.com/fr/billing/overview.md#metered-products) pour la liste complète des 16 produits mesurés. Mettez à niveau votre plan sur [console.truthlocks.com/billing](https://console.truthlocks.com/billing) pour augmenter les limites.

## Intégrations d'éditeurs et de pipelines

MAIP s'intègre aux outils que votre équipe utilise déjà. Chaque intégration génère automatiquement des reçus cryptographiques.

| Catégorie | Intégrations |
| :- | :- |
| **Plugins d'éditeur** | [VS Code](https://docs.truthlocks.com/fr/guides/maip-integrations.md#vs-code-extension), [JetBrains](https://docs.truthlocks.com/fr/guides/maip-integrations.md#jetbrains-plugin), [Neovim](https://docs.truthlocks.com/fr/guides/maip-integrations.md#neovim-plugin) (Telescope, statusline, auto-receipt on save) |
| **Assistants IA** | [Serveur MCP](https://docs.truthlocks.com/fr/guides/maip-integrations.md#mcp-server) — 20 outils pour les assistants de codage IA pour interroger les agents, les reçus et les scores de confiance |
| **Pipelines de données** | [Bibliothèque de flux d'événements et connecteur Kafka](https://docs.truthlocks.com/fr/guides/maip-integrations.md#event-streaming) — les adaptateurs de fournisseur nécessitent des clients concrets ; la passerelle autonome n'est pas prête |
| **CI/CD** | [Action GitHub](https://docs.truthlocks.com/fr/guides/maip-integrations.md#github-action) — reçus pour les commits, les PR, les versions et les artefacts de build |
| **Frameworks IA** | LangChain, LlamaIndex, CrewAI, AutoGen, OpenAI, Anthropic, AWS Bedrock |
| **Outils d'équipe** | Slack, Linear, Notion |

Consultez le [guide d'intégration MAIP](https://docs.truthlocks.com/fr/guides/maip-integrations.md) pour les instructions de configuration et les exemples de code.

## Prochaines étapes

> [card] [Autorisation de l'agent](https://docs.truthlocks.com/guides/agent-authorization.md)
>
> Approfondissement de l'autorisation basée sur la portée et de la gestion des sessions.

> [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)
>
> Comprendre et configurer l'évaluation continue de la confiance.

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

> [card] [Orchestration IA](https://docs.truthlocks.com/guides/ai-orchestration.md)
>
> Exécution de flux de travail multi-agents avec des garde-fous de sécurité.

> [card] [Intégrations MAIP](https://docs.truthlocks.com/guides/maip-integrations.md)
>
> Connectez les agents à Slack, GitHub, VS Code, Neovim, LangChain, et plus encore.


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