Zum Hauptinhalt springen
Dieser Leitfaden erläutert die grundlegenden Bausteine der Truthlocks-Plattform. Das Verständnis dieser Konzepte ist für eine effektive Integration unerlässlich.

Mandanten

Ein Mandant ist die oberste Organisationseinheit in Truthlocks. Jeder Mandant repräsentiert einen eigenen Kunden oder eine Organisation mit vollständiger Datenisolation.

Mandantenfähigkeitskontrollen

  • Datenisolation: Die Daten jedes Mandanten sind auf Datenbankebene vollständig isoliert
  • Ressourcenlimits: Ratenbegrenzungen und Kontingente werden pro Mandant durchgesetzt
  • API-Schlüssel-Bereich: API-Schlüssel sind an einen einzelnen Mandanten gebunden und können nicht auf Daten anderer Mandanten zugreifen.
  • Audit-Trennung: Audit-Protokolle sind nach Mandanten partitioniert.

Aussteller

Ein Aussteller ist eine Entität, die Bestätigungen erstellen und signieren kann. Aussteller repräsentieren Organisationen, Institutionen oder Dienste, die Ansprüche über Subjekte erheben.

Identität

Jeder Aussteller hat eine verifizierte Domain (z. B. acme.edu), die seine Identität festlegt. reale Identität.

Kryptografische Schlüssel

Aussteller registrieren Ed25519-öffentliche Schlüssel, die zur Überprüfung von Bestätigungsunterschriften verwendet werden.

Vertrauensstatus

Neue Aussteller werden sofort nach der Erstellung aktiviert. Höhere Vertrauensstufen erfordern eine Anwendungsprüfung: AKTIV → AUSGESETZT.

Vertrauensstufe

BASIC, VERIFIED oder PREMIUM basierend auf der Tiefe der Identitätsprüfung.

Aussteller-Lebenszyklus

Neue Aussteller werden sofort mit dem Vertrauensniveau Basic aktiviert. Es ist keine manuelle Genehmigung erforderlich, um mit der Prägung von Bestätigungen zu beginnen. Um auf eine höhere Vertrauensstufe (Verifizierte Organisation, Regierungseinheit oder Akkreditierte Institution) aufzusteigen, reichen Sie einen Ausstellerantrag zur Überprüfung ein.

Bestätigungen

Eine Bestätigung ist ein kryptografisch signierter Anspruch, der von einem Aussteller über ein Subjekt gemacht wird. Bestätigungen sind das Kernprimitiv des Truthlocks-Systems.

Attestierungsstruktur

Attestierungseigenschaften

Verbraucherschutz

Ein Verbraucherschutz ist eine Bestätigung, die über den vereinfachten consumer mint-Flow erstellt wird und für einzelne Ersteller konzipiert ist. Sie hashen Ihre Datei clientseitig (SHA-256) und übermitteln den Hash zusammen mit Metadaten wie Titel, Kategorie und Inhaltstyp. Truthlocks stellt Ihre Signaturidentität bei der ersten Verwendung automatisch bereit. Die Antwort des Verbraucher-Mint enthält: Jeder Schutz generiert eine öffentliche Nachweisseite. Jeder kann die Metadaten der Nachweisseite über GET /v1/public/proof/{attestation_id} abrufen – keine Authentifizierung erforderlich. Dieser Endpunkt ist für das Rendern von Nachweisseiten und das Generieren von Open Graph-Linkvorschauen für geteilte URLs konzipiert. Details finden Sie unter Nachweis-Metadaten-Endpunkt.

Risikosignale

Ein Risikosignal ist eine bewertete Beobachtung aus einer Betrugserkennungsquelle – Geräte-Fingerprinting, IP-Reputation, E-Mail-Verifizierung, Dokumentenanalyse oder Ihre eigene Regel-Engine. Sie können Signale direkt über die API aufnehmen oder Rohdaten von Identitätsereignissen übermitteln und die Plattform diese automatisch in Signale normalisieren lassen. Jedes Signal beinhaltet:

Ereignisnormalisierung

Anstatt Risikosignale manuell zu konstruieren, können Sie Rohdaten von Identitätsereignissen – fehlgeschlagene Anmeldungen, ungültige Signaturen, Deepfake-Verdächtige – an POST /v1/risk/events übermitteln. Die Plattform ordnet jedes Ereignis automatisch einem kanonischen Signaltyp und einem Basis-Risikowert zu. Siehe die API-Referenz zur Normalisierung von Identitätsereignissen. Risikosignale sind vollständig mandantenisoliert unter Verwendung von Row-Level Security und bilden die Grundlage der Anti-Fraud Identity Firewall. Details zur Integration finden Sie im Risikosignal-Leitfaden.

Maschinenagenten

Ein Maschinenagent ist ein KI-Agent, Bot oder automatisierter Dienst, der beim Machine Agent Identity Protocol (MAIP) registriert ist. Jeder Agent erhält eine eindeutige Kennung (maip-agent:<ulid>) und ein Ed25519-Schlüsselpaar zum Signieren von Belegen. Agenten agieren innerhalb von Sitzungen – kurzlebigen, bereichsgebundenen Ausführungskontexten mit automatischem Ablauf. Jede Aktion, die ein Agent ausführt, erzeugt einen kryptografisch signierten Beleg, der an den vorherigen Beleg gekettet ist, um manipulationssichere Prüfprotokolle zu gewährleisten. Neun Belegtypen decken den gesamten Agentenlebenszyklus ab: Genesis, Delegation, Aktion, Widerruf, Datenbestätigung, Modellbestätigung, Compliance, Wahrheitsanspruch und Verifizierung. Informationen zur Einrichtung finden Sie im Handbuch zur Maschinenidentität und zum Bereichs- und Sitzungsmodell im Handbuch zur Agentenautorisierung.

Proof-Bundles

Ein Proof Bundle ist ein eigenständiges Paket, das alles enthält, was zur Offline-Verifizierung einer Bestätigung erforderlich ist, ohne Truthlocks-Server zu kontaktieren.
Anwendungsfall: Proof-Bundles sind ideal für Szenarien, in denen Prüfer möglicherweise offline oder möchten unabhängig ohne API-Aufrufe verifizieren.

Verifizierungsmodell

Die Truthlocks-Verifizierung prüft mehrere Ebenen, um festzustellen, ob eine Bestätigung vertrauenswürdig sein sollte:
1

Kryptografische Verifizierung

Verifizieren Sie, dass die Ed25519-Signatur mit der Nutzlast übereinstimmt, indem Sie den öffentlichen Schlüssel des Ausstellers verwenden Schlüssel.
2

Statusprüfung

Prüfen Sie, ob die Bestätigung vom Aussteller widerrufen oder ersetzt wurde. Ersetzte Bestätigungen verweisen über superseded_by_attestation_id auf ihren Ersatz.
3

Vertrauensstatus des Ausstellers

Bestätigen Sie, dass der Aussteller den Status AKTIV hat und nicht gesperrt ist.
4

Schlüsselgültigkeit

Verifizieren Sie, dass der Signaturschlüssel zum Zeitpunkt der Attestierungserstellung aktiv war.

Nächste Schritte

Umgebungen

Erfahren Sie mehr über Entwicklungs- und Produktionsumgebungen und deren Konfiguration.

Authentifizierung

Tiefer Einblick in API-Schlüssel, JWT-Tokens und OAuth-Integration.