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

# Maschinenidentität (MAIP)

> KI-Agenten mit kryptografischer Identität und Verhaltensbeschränkungen registrieren, autorisieren und überwachen.

# Machine Identity & Agent Identity Protocol

Das **Machine Agent Identity Protocol (MAIP)** stellt Identitätsdatensätze für KI-Agenten, Bots und automatisierte Dienste bereit – zur Registrierung von Agenten und zur Aufzeichnung ihrer Berechtigungen und Aktivitäten.

> [!WARNING]
>
> Einige MAIP-Operationen zeichnen derzeit vom Aufrufer bereitgestellte Ergebnisse auf, anstatt sie unabhängig auszuführen oder zu überprüfen. Dokumentenextraktion und KI-Urteile werden simuliert; Schutzmaßnahmen klassifizieren eine übermittelte Punktzahl; Orchestrierungs- und Workflow-Handler erstellen Tracking-Datensätze. Mehrere generierte Belege verwenden Systemmarker anstelle kryptografischer Signaturen. Lesen Sie die Implementierungsbeschränkungen des Vorgangs, bevor Sie sich auf seine Ausgabe als Beweis verlassen.

## Warum Maschinenidentität?

Während KI-Agenten in Unternehmens-Workflows immer häufiger eingesetzt werden, stehen Unternehmen vor einer entscheidenden Herausforderung: **Woher wissen Sie, welcher Agent was getan hat und ob er dazu berechtigt war?**

MAIP löst dies mit:

* **Kryptografische Agentenidentität** – Jeder Agent erhält eine eindeutige ID (`maip-agent:<ulid>`) und Signaturschlüssel.
* **Bereichsbasierte Autorisierung** – Fein granulare Berechtigungsbereiche steuern, was jeder Agent tun kann
* **Laufzeitrichtliniendurchsetzung** – [MAIP-Richtlinien](https://docs.truthlocks.com/de/guides/maip-policies.md) bewerten Vertrauenswerte, Bereiche und Delegierungstiefe vor jeder sensiblen Aktion
* **Vertrauensbewertung** – Kontinuierliche Verhaltensbewertung erzeugt einen Vertrauenswert von 0-100
* **Sitzungsverwaltung** – Zeitlich begrenzte Ausführungskontexte mit automatischer Ablaufzeit
* **Mandantenübergreifende Delegation** – Agenten können Befugnisse über Organisationsgrenzen hinweg delegieren.
* **Kill Switch** – Sofortiger Notfallwiderruf des Zugriffs eines beliebigen Agenten

## Architektur

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

## Im Playground ausprobieren

Jeder MAIP-Endpunkt verfügt über einen interaktiven API-Spielplatz, der in die Dokumentation integriert ist. Sie können Anfragen erstellen, zwischen [Sandbox- und Produktionsumgebungen](https://docs.truthlocks.com/de/environments.md#try-it-in-the-api-playground) wechseln und diese direkt senden – kein separates Tool erforderlich.

Alle MAIP-Endpunkte sind abgedeckt und umfassen zehn API-Gruppen: [Maschinenagenten](https://docs.truthlocks.com/de/api-reference/machine-identity/agents/register.md), [Agentensitzungen & Tools](https://docs.truthlocks.com/de/api-reference/machine-identity/sessions/create.md), [Vertrauen & Zeugen](https://docs.truthlocks.com/de/api-reference/machine-identity/trust-scores/get.md), [MAIP-Richtlinien](https://docs.truthlocks.com/de/api-reference/machine-identity/policies/list.md), [Wahrheitsansprüche & Dokumente](https://docs.truthlocks.com/de/api-reference/machine-identity/truth-claims/create.md), [Compliance & Anomalien](https://docs.truthlocks.com/de/api-reference/machine-identity/compliance/create-check.md), [Datensätze & Modelle](https://docs.truthlocks.com/de/api-reference/machine-identity/datasets/attest.md), [Orchestrierungen & Workflows](https://docs.truthlocks.com/de/api-reference/machine-identity/orchestrations/execute.md), [Schutzmaßnahmen & Delegation](https://docs.truthlocks.com/de/api-reference/machine-identity/guardrails/check.md) und [Beobachtbarkeit](https://docs.truthlocks.com/de/api-reference/machine-identity/observability/events.md).

Der Playground unterstützt sowohl `X-API-Key` als auch Bearer JWT-Authentifizierung. Verwenden Sie `X-API-Key` für schnelle Tests und Bearer JWT, wenn Sie sich mit einem Sitzungstoken eines laufenden Agenten authentifizieren müssen.

> [!TIP]
>
> Öffnen Sie einen beliebigen Endpunkt in der [Machine Agents](https://docs.truthlocks.com/de/api-reference/machine-identity/agents/register.md) API-Referenz und klicken Sie auf **Senden**, um ihn live gegen die Sandbox zu testen.

## Schnellstart

### 1. Agent registrieren

```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. Eine Sitzung erstellen

```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. Ausführen mit Trust Scoring

Jede Aktion, die der Agent ausführt, wird protokolliert und bewertet. Der Vertrauens-Score wird kontinuierlich aktualisiert:

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

Antwort:

```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. Not-Aus-Schalter

Widerrufen Sie sofort den gesamten Agenten-Zugriff:

```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 }'
```

## Kernkonzepte

### Agententypen

| Typ | Beschreibung | Anwendungsfall |
| - | - | - |
| `autonomous` | Vollständig autonome Entscheidungsfindung | Handelsbots, Workflow-Engines |
| `supervised` | Erfordert menschliche Genehmigung für kritische Aktionen | Inhaltsmoderation, Compliance |
| `delegated` | Handelt im Namen eines anderen Agenten oder Benutzers | Dienstkonten, Proxys |
| `system` | Agent auf Infrastrukturebene | Überwachung, Gesundheitsprüfungen |

### Bereiche

Bereiche folgen einem `resource:action` Muster:

* `agents:read` / `agents:write` – Agentenverwaltung
* `receipts:write` – Aktionsbelege ausstellen
* `attestations:read` – Bestätigungsdaten lesen
* `trust-scores:read` – Vertrauenswerte abrufen
* `delegations:offer` / `delegations:accept` – Mandantenübergreifende Delegation
* `compliance:write` – Compliance-Prüfungen durchführen
* `orchestrations:execute` – Multi-Agenten-Workflows ausführen

### Trust Score Komponenten

| Faktor | Gewicht | Beschreibung |
| - | - | - |
| Verhaltenskonformität | 35 % | Aktionen innerhalb des deklarierten Umfangs |
| Umfangs-Einhaltung | 25 % | Keine Zugriffsversuche außerhalb des Umfangs |
| Anomalie-Score | 20% | Abweichung von historischen Mustern |
| Peer-Bestätigungen | 10% | Andere Agenten bürgen für Verhalten |
| Sitzungshygiene | 10 % | Korrekte Sitzungserstellung/-beendigung |

## Abrechnung & Kontingente

Funktionen der Maschinenidentität werden gemäß Ihrem Plan abgerechnet. Vier MAIP-Nutzungszähler werden in jedem Abrechnungszyklus verfolgt:

| Metrik | Was sie zählt | Entwickler | Business | Enterprise |
| :- | :- | :- | :- | :- |
| `maip.agents` | Registrierte Maschinenagenten | 2 | 50 | Planabhängig |
| `maip.sessions` | Agent-Sitzungen pro Monat erstellt | 100 | 10.000 | Planabhängig |
| `maip.trust_computes` | On-Demand-Vertrauensbewertungsberechnungen | 50 | 5.000 | Planabhängig |
| `maip.compliance_checks` | Compliance-Verifizierungsanfragen | 10 | 500 | Planabhängig |

Überwachen Sie Ihren Verbrauch mit der [Nutzungs-API](https://docs.truthlocks.com/de/api-reference/billing/usage.md) oder in der Konsole unter **Einstellungen > Abrechnung > Nutzung** im Abschnitt **MAIP**.

> [!NOTE]
>
> Eine vollständige Liste der 16 kostenpflichtigen Produkte finden Sie in der [Abrechnungsübersicht](https://docs.truthlocks.com/de/billing/overview.md#metered-products). Aktualisieren Sie Ihren Plan unter [console.truthlocks.com/billing](https://console.truthlocks.com/billing) , um die Limits zu erhöhen.

## Editor- und Pipeline-Integrationen

MAIP integriert sich in die Tools, die Ihr Team bereits verwendet. Jede Integration generiert automatisch kryptografische Belege.

| Kategorie | Integrationen |
| :- | :- |
| **Editor-Plugins** | [VS Code](https://docs.truthlocks.com/de/guides/maip-integrations.md#vs-code-extension), [JetBrains](https://docs.truthlocks.com/de/guides/maip-integrations.md#jetbrains-plugin), [Neovim](https://docs.truthlocks.com/de/guides/maip-integrations.md#neovim-plugin) (Telescope, Statuszeile, automatische Quittung beim Speichern) |
| **KI-Assistenten** | [MCP Server](https://docs.truthlocks.com/de/guides/maip-integrations.md#mcp-server) — 20 Tools für KI-Codierungsassistenten zum Abfragen von Agenten, Belegen und Vertrauenswerten |
| **Datenpipelines** | [Event-Stream-Bibliothek und Kafka-Konnektor](https://docs.truthlocks.com/de/guides/maip-integrations.md#event-streaming) – Anbieteradapter erfordern konkrete Clients; eigenständiges Gateway ist nicht bereit |
| **CI/CD** | [GitHub Action](https://docs.truthlocks.com/de/guides/maip-integrations.md#github-action) — Belege für Commits, PRs, Releases und Build-Artefakte |
| **KI-Frameworks** | LangChain, LlamaIndex, CrewAI, AutoGen, OpenAI, Anthropic, AWS Bedrock |
| **Team-Tools** | Slack, Linear, Notion |

Anweisungen zur Einrichtung und Codebeispiele finden Sie im [MAIP-Integrationshandbuch](https://docs.truthlocks.com/de/guides/maip-integrations.md).

## Nächste Schritte

> [card] [Agentenautorisierung](https://docs.truthlocks.com/guides/agent-authorization.md)
>
> Tiefer Einblick in die bereichsbasierte Autorisierung und Sitzungsverwaltung.

> [card] [MAIP-Richtlinien](https://docs.truthlocks.com/guides/maip-policies.md)
>
> Laufzeit-Durchsetzungsregeln basierend auf Vertrauenswerten, Scopes und Delegationstiefe.

> [card] [Vertrauenswerte](https://docs.truthlocks.com/guides/trust-scores.md)
>
> Kontinuierliche Vertrauensbewertung verstehen und konfigurieren.

> [card] [Tenant-übergreifende Delegation](https://docs.truthlocks.com/guides/cross-tenant-delegation.md)
>
> Ermöglichen Sie Agenten, organisationsübergreifend zu agieren.

> [card] [KI-Orchestrierung](https://docs.truthlocks.com/guides/ai-orchestration.md)
>
> Multi-Agenten-Workflow-Ausführung mit Sicherheitsvorkehrungen.

> [card] [MAIP-Integrationen](https://docs.truthlocks.com/guides/maip-integrations.md)
>
> Verbinden Sie Agenten mit Slack, GitHub, VS Code, Neovim, LangChain und mehr.


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