Seminar KERI – KERIpy, KERIA und Signify-TS Implementierung

Die Protokollspezifikation wird erst durch eine sauber getrennte Implementierung beherrschbar. KERIpy stellt Kernmechanismen bereit, KERIA übernimmt agentenbasierte Dienste und Signify-TS bindet Web- beziehungsweise TypeScript-Anwendungen an den Agenten an.

Inhaltsübersicht

• Seminarprofil
• Zielgruppe
• Lernziele
• Seminarinhalte
• Praxisanteile
• Voraussetzungen

Seminarprofil

Der Kurs ist als Labor aufgebaut. Eine Beispielanwendung erzeugt Identitäten, nutzt Witnesses, entdeckt Gegenstellen, tauscht Nachrichten aus und verarbeitet Credentials. Alle Schritte werden mit Logging, Tests und Fehlerfällen abgesichert.

Zielgruppe

Python- und TypeScript-Entwickler, Solution Architects, DevOps Engineers, technische Tester und Integrationsverantwortliche.

Lernziele

• KERIpy-, KERIA- und Signify-TS-Komponenten korrekt aufsetzen
• Agenten- und Client-AIDs erzeugen und verwalten
• Witnessing, Discovery und Exchange-Nachrichten integrieren
• ACDC-Issuance und Presentation in eine Anwendung einbinden
• Tests, Observability, Security und Deployment vorbereiten

Seminarinhalte

Schritt 1: Laborumgebung reproduzierbar aufbauen

Laufzeit, Abhängigkeiten, Container, Datenspeicher, Ports und Logs werden eingerichtet. Versionen werden festgeschrieben und Reset-, Seed- und Cleanup-Verfahren dokumentiert.

• Abhängigkeiten pinnen
• Konfiguration und Secrets trennen
• Health Checks und Startreihenfolge definieren

Schritt 2: KERIpy-Kernobjekte verwenden

Habitat, Keystore, Event Database und Parser werden über geeignete APIs beziehungsweise Werkzeuge angesprochen. Inception, Signatur und Key-State-Abfrage werden zunächst ohne Agentenschicht nachvollzogen.

• AID erzeugen
• KEL lesen und validieren
• Fehler in Events und Signaturen diagnostizieren

Schritt 3: KERIA-Agentenmodell einrichten

Ein Agent wird bootstrapped und dem Client zugeordnet. Admin-, Boot- und Protokollschnittstellen werden als getrennte Vertrauensgrenzen behandelt.

• Agent initialisieren
• Client-Authentisierung prüfen
• Mandantentrennung und Datenpfade dokumentieren

Schritt 4: Signify-TS-Client anbinden

Die Web- beziehungsweise Node-Anwendung stellt eine sichere Session zum Agenten her, erzeugt AIDs und verfolgt asynchrone Operationen. Fehler, Timeouts und Wiederholungen werden systematisch behandelt.

• Client-Konfiguration kapseln
• Operationen pollen oder abonnieren
• Secrets und lokale Schlüsselanteile schützen

Schritt 5: Witnesses und OOBIs integrieren

Witness-Pools werden konfiguriert, Receipts geprüft und Gegenstellen über Out-of-Band-Informationen entdeckt. Änderungen an Witnesses und Endpoints werden kontrolliert ausgerollt.

• Witness-Schwellen validieren
• OOBI-Auflösung und Authentizität prüfen
• Ausfälle und veraltete Endpoints behandeln

Schritt 6: Exchanges und Messaging umsetzen

KERI-Exchange-Nachrichten werden erzeugt, signiert, geroutet und verarbeitet. Die Anwendung trennt Protokollnachricht, Geschäftsprozess und persistierten Zustandsautomaten.

• Routen whitelisten
• Replay-Schutz und Idempotenz umsetzen
• eingehende Nachrichten sicher dispatchen

Schritt 7: ACDC-Credentials integrieren

Schema, Registry, Credential-Issuance und Verifikation werden in den Agenten- und Client-Workflow eingebaut. Der Kurs berücksichtigt Source Chains und Statusprüfung.

• Schema und Registry referenzieren
• Credential ausgeben und annehmen
• Verifier-Pipeline implementieren

Schritt 8: IPEX-Prozesse implementieren

Apply, Offer, Agree, Grant, Admit und Spurn werden mit persistierten Zuständen und Benutzerentscheidungen verbunden. Die Anwendung verhindert, dass unvollständige oder doppelte Exchanges Fachaktionen auslösen.

• Zustandsübergänge absichern
• Disclosure-Umfang kontrollieren
• Abbruch und Wiederaufnahme testen

Schritt 9: Automatisierte Tests erstellen

Unit-, Komponenten-, Integrations- und Interoperabilitätstests decken Key Events, Witnesses, Exchanges, Credentials und Fehlerfälle ab. Golden Samples werden kontrolliert versioniert.

• isolierte Keystores verwenden
• Netzwerk- und Timingfehler simulieren
• Regressionen in Serialisierung erkennen

Schritt 10: Deployment und Betrieb vorbereiten

Persistenz, Backups, Skalierung, Logschutz, Metriken, Rate Limits, Secret Rotation, Upgrades und Disaster Recovery werden für eine produktionsnahe Bereitstellung geplant.

• Stateful-Komponenten identifizieren
• Restore- und Replay-Tests durchführen
• Sicherheits- und Betriebscheckliste abschließen

Praxisanteile

• KERI-Labor mit Agent, Client und Witness-Pool starten
• AID-Lifecycle über Signify-TS steuern
• Exchange- und Credential-Flow implementieren
• Fehlerfälle automatisiert testen
• Deployment- und Betriebsdesign dokumentieren

Voraussetzungen

Gute Python- oder TypeScript-Kenntnisse, REST-APIs, Container, JSON und KERI-Grundlagen. Eigener administrierbarer Entwicklungsrechner ist erforderlich.