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 – anPOST /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.

