MAIP-Integrationen
Das Machine Agent Identity Protocol (MAIP) wird mit Integrationen geliefert, die Agentenidentität, Belege und Vertrauensbewertung in Ihre bestehenden Workflows bringen. Lokale Nachweise, das Einreichen von gehosteten Belegen und die Signaturverifikation sind separate Vorgänge. Konfigurieren und testen Sie die von Ihnen verwendete Integration; die Installation allein erstellt keinen vollständigen Audit-Trail.Voraussetzungen: Sie benötigen ein Truthlocks-Konto mit einem API-Schlüssel und mindestens einem registrierten Agenten. Informationen zur Registrierung Ihres ersten Agenten finden Sie im Leitfaden zur Maschinenidentität.
Entwicklertools
VS Code-Erweiterung
Ein Seitenbereich zum Durchsuchen von Belegen, zum Generieren von Belegen aus Ihrem Editor und zum Anzeigen von Vertrauensdaten. Installieren Sie es vom Visual Studio Marketplace. Was es tut:- MAIP-Belege über die Seitenleiste durchsuchen und suchen
- Belege für Codeänderungen direkt aus dem Editor generieren
- Vertrauenswerte von Agenten und Belegketten anzeigen
- Öffnen Sie VS Code und gehen Sie zur Erweiterungsansicht (
Ctrl+Shift+X/Cmd+Shift+X). - Suchen Sie nach „Truthlocks MAIP“.
- Klicken Sie auf Installieren.
JetBrains-Plugin
MAIP-Integration für IntelliJ, PyCharm und WebStorm mit den gleichen Funktionen zum Durchsuchen und Generieren von Belegen wie die VS Code-Erweiterung.Neovim-Plugin
Installieren Sie das veröffentlichtetruthlocks/maip.nvim Plugin, mit curl verfügbar in Ihrem PATH:
:MAIPListAgents, :MAIPCreateReceipt, :MAIPListReceipts,
:MAIPVerifyReceipt, :MAIPShowTrust und :MAIPDashboard. Metadaten der Quittung sind
keine verifizierte Signatur. Automatische Commit-Belege sind Opt-in und beachten unterstützte
abgeschlossene Commit-Ereignisse; es gibt in dieser Version keine auto_receipt Speicheroption.
Siehe die versionierte README für Telescope
Konfiguration und die aktuellen interaktiven Testgrenzen.
MCP-Server
Installieren Sie die ausführbare Datei auf dem Computer, auf dem Ihr MCP-Host läuft:maip_list_agents, maip_list_receipts und maip_verify_receipt. Eine positive Signatur
Ergebnis erfordert valid: true, signature_verified: true und verdict: "VALID".
Die Transparenzprüfung ist ein separates Ergebnis. Schreibvorgänge werden nicht automatisch wiederholt.
Teamzusammenarbeit
Slack-, Linear- und Notion-Integrationen erfordern eine eigene echte Anwendung/einen eigenen Arbeitsbereich Anmeldeinformationen zusätzlich zur Truthlocks-Authentifizierung. Ihre vollständige Anbieter-zu-Beleg- die Annahme noch aussteht. Behandeln Sie die Verfügbarkeit der Quelle, lokale Tests oder eine Truthlocks API-Schlüssel als Nachweis, dass ein externer Arbeitsbereich verbunden ist. Lesen Sie die README-Datei des Quellpakets für Anbieterberechtigungen und -konfiguration: Slack, Linear, Notion. Verwenden Sie einen dedizierten Test-Arbeitsbereich, bevor Sie die Verarbeitung realer Ereignisse aktivieren.Slack-Einrichtung und -Validierung
Slack ist eine Quellinstallation, kein veröffentlichtes@truthlocks/maip-slack npm-Paket.
Die Bot-Authentifizierung und eine autorisierte Testnachrichtenübermittlung wurden vom Anbieter bestanden
Prüfungen. Vollständige Slash-Befehle für persönliche Benutzer und gehostete Ereignis-Workflows bleiben unter
Validierung. Folgen Sie dem Slack README
für den überprüften Build und alle erforderlichen Einstellungen.
Binden Sie die App an SLACK_TEAM_ID und explizite persönliche SLACK_ALLOWED_USER_IDS.
Verwenden Sie MAIP_AGENT_ID von einem bestehenden registrierten Truthlocks-Agenten zur Erstellung;
eine Slack-Mitglieder-ID ist keine Maschinenidentität. Geben Sie einen Sandbox-Schlüssel und
https://sandbox-api.truthlocks.com/v1 während der Auswertung. Befehle werden registriert
in den Slack-App-Einstellungen. Sowohl HTTP als auch Socket Mode bieten /webhook/maip, aber
Hosting des Listeners abonniert Truthlocks-Ereignisse nicht automatisch.
Delegationsgenehmigungen bleiben in der authentifizierten Console Überprüfung. Lokaler Replay-Schutz
ist prozesslokal; die Produktionslieferung erfordert eine dauerhafte Upstream-Verfolgung.
Notion-Einrichtung und -Validierung
Notion ist ein privates Quellpaket, keine npm-Installation. Echte QA-Akzeptanz eine Unterseite und Datenbankschemata erstellt, einen vorhandenen Arbeitsbereichsbeleg eingefügt, die Synchronisierung wiederholt, ohne diese Seite zu duplizieren, und die Anbieter-Rücklesung überprüft. Kontinuierliche gehostete Automatisierung und dauerhafte Wiederherstellung befinden sich noch in der Validierung. Verbinden Sie nur die gewünschte Seite über das Menü ••• → Verbindungen von Notion. Folgen Sie den Notion README um Datenbanken einmal zu initialisieren und ihre IDs wiederzuverwenden. Verwenden SieWEBHOOK_SECRET mit dem
versionierter HMAC/Zeitstempel-Vertrag; unsignierte Anfragen werden abgelehnt. Empfangsstatus
ist Metadaten, daher überprüft ein abgeschlossener Beleg nicht automatisch die Notion
Verifiziert-Feld. Verwenden Sie die explizite Signaturverifizierung separat.
CI/CD
Die Eingaben der MAIP-Aktion sindmaip-api-url, maip-api-key und maip-agent-id.
Die älteren Namen api-key und agent-id sind keine deklarierten Eingaben. Für eine überprüfte
Quell-Checkout mit seinem erstellten dist/index.js, einem explizit ausgelösten QA-Workflow
können diesen Schritt verwenden:
KI-Modell-Konnektoren
Python-Wrapper erfassen Ereignisse, die über die konfigurierte Integration ausgegeben werden. Lokale Hashes sind keine Serversignaturen. Anbieteranmeldeinformationen, Truthlocks-Anmeldeinformationen und gehostete Übermittlungen werden separat konfiguriert; überprüfen Sie die von Ihnen gesendeten Metadaten und gehen Sie nicht davon aus, dass das Hashing Datenschutzpflichten aufhebt.Unterstützte Frameworks
Vollständiges lokales LangChain-Beispiel (keine gehostete Anfrage):
payload_hash beschreibt lokale Beweise. Für die gehostete Einreichung verwenden Sie MAIPClient.create_receipt
und überprüfen Sie den zurückgegebenen Server receipt_id; die LangChain README
enthält das Beispiel für die asynchrone Übermittlung. Für asynchrone automatische Hooks, leeren und
Schließen Sie den Wrapper und überprüfen Sie die Übermittlungsergebnisse vor dem Herunterfahren. Aufrufe außerhalb des
konfigurierten Wrappers werden nicht beobachtet.
Daten- und ML-Pipelines
Kafka-Konnektor
Der Go-Konnektor übermittelt Nachrichten-Fingerabdrücke als MAIPdata.attestation Belege
mit einem bestehenden Agenten. Sein HTTP-Client verwendet /v1/agent-receipts, bewahrt teilweise
Batch-Ergebnisse und erfordert eine bestätigte Signatur für eine erfolgreiche Verifizierung.
Installieren Sie github.com/truthlocks/kafka-maip-connector@v0.1.0 mit go get.
Siehe das Release- und vollständige Beispiel.
Der API-Schlüssel wählt den Arbeitsbereich und die Umgebung aus; eine vom Aufrufer bereitgestellte Mandanten-ID tut dies
Autorisierung nicht überschreiben. Nachrichtenbytes und Roh-Nachrichtenschlüssel werden nicht hochgeladen.
Die Producer/Consumer-Wrapper puffern Belege im Speicher. Broker-Zustellung und -Empfang
Lieferung sind separate Vorgänge; ein erfolgreicher Kafka-Schreibvorgang garantiert keine
Beleg wurde aufbewahrt. Erforderliche Audit-Lieferung benötigt eine dauerhafte Anwendungs-Outbox
und explizite Fehlerbehandlung. Konsultieren Sie die Freigabebelege vor der Produktionsnutzung.
Ereignis-Streaming
Installieren Sie Go event-stream v0.1.0:MLflow, DVC und Delta Lake
Installieren Siemlflow-maip, dvc-maip oder delta-lake-maip für die entsprechenden Metadaten
Builder. Diese Pakete erzeugen lokale strukturierte Beweise; die Installation eines Pakets führt nicht dazu,
jede Framework-Operation zu einem signierten gehosteten Beleg machen. Es gibt keine unterstützte
truthlocks_mlflow.TruthlocksPlugin.enable API entsprechend dem älteren Beispiel.
Verwenden Sie die vollständigen lokalen und gehosteten Beispiele in den Quell-READMEs:
MLflow,
DVC,
Delta Lake.
Anbieter-Metadaten und Artefakt-URIs überprüfen Artefakt-Bytes oder
beweisen, dass ein externer Vorgang stattgefunden hat. Die gehostete Signaturprüfung tut dies nicht
Transparenz-Log-Aufnahme herstellen, es sei denn, diese separate Prüfung ist erfolgreich.
Docker
Container-Quelldateien belegen nicht, dass ein öffentliches Image veröffentlicht wurde oder Akzeptanz bestanden. Die zuvor aufgelistetentruthlocks/*:latest Bilder und kombinierten
Compose-Beispiel wurde nicht als funktionierende Bereitstellung verifiziert und ist kein
unterstützter Schnellstart. Leiten Sie die Verfügbarkeit von Bildern nicht aus diesen historischen Namen ab.
Verwenden Sie die veröffentlichte Paketversion und deren README für jede Integration. Beim Erstellen
einen Container aus überprüfter Quelle, pinnen Sie diese Revision und Abhängigkeiten, liefern Sie Geheimnisse
über Ihre Laufzeit und testen Sie die tatsächliche Anbieterverbindung. Slack zusätzlich
erfordert seine echten Anwendungsanmeldeinformationen; ein Truthlocks API-Schlüssel allein ist nicht ausreichend.
Das eigenständige Event-Stream-Gateway bleibt wie oben beschrieben nicht verfügbar.
Nächste Schritte
Maschinenidentität
Registrieren Sie Ihren ersten Agenten und verstehen Sie das MAIP-Protokoll.
Agentenautorisierung
Konfigurieren Sie Bereiche, Sitzungen und Tool-Zugriff für Ihre Agenten.
Downloads
Veröffentlichte CLI-, SDK- und IDE-Versionen sowie deren Installationsanweisungen finden.
Integrations-Hub
Alle Integrationen nach Kategorie durchsuchen.

