Zum Hauptinhalt springen
Smart-ID und Mobile-ID ermöglichen es Benutzern, ihre Identität zu verifizieren, indem sie eine Anfrage auf ihrem Telefon bestätigen. Verwenden Sie die Smart-ID API oder die Mobile-ID API, um die Verifizierung direkt aus Ihrer eigenen Anwendung ohne Workflow zu starten. Beide Methoden laufen auch innerhalb des Didit-Workflow-Schritts Ausweisverifizierung ab und liefern ein Wallet-Verifizierungsergebnis mit cryptographic Vertrauensniveau. Für die unten beschriebene gehostete Workflow-Integration nutzen Sie dieselbe Sitzungserstellung und Webhook-Integration wie bei Ihren anderen Didit-Workflows.
Smart-ID und Mobile-ID sind verfügbar. Smart-ID unterstützt Estland, Lettland, Litauen und Belgien. Mobile-ID unterstützt Estland und Litauen. Wählen Sie in der Konsole die Wallets aus, die Ihr Workflow für jedes Land akzeptiert. Die vollständige Liste finden Sie unter Wallet-Abdeckung und Preise.

​
Länder und Voraussetzungen

Die Integration deckt Smart-ID in Estland (EST), Lettland (LVA), Litauen (LTU) und Belgien (BEL) ab. Mobile-ID deckt Estland (EST) und Litauen (LTU) ab; für Lettland wird Mobile-ID nicht angeboten. Diese Ländercodes beschreiben die integrierten Routen, garantieren jedoch nicht, dass jede Route in Ihrer Umgebung aktiviert ist. Für Smart-ID benötigt der Benutzer eine aktive, berechtigte Smart-ID-Identität, den zugehörigen persönlichen Identifikationscode und Zugriff auf die App. Für Mobile-ID benötigt der Benutzer eine aktive Mobile-ID-Identität, den zugehörigen persönlichen Identifikationscode und die verknüpfte Telefonnummer. Geben Sie die Mobile-ID-Telefonnummer im internationalen Format ein: +372 für Estland oder +370 für Litauen. Das ausgewählte Land muss mit der verwendeten Identität übereinstimmen. Keine der beiden Methoden liefert ein Porträtfoto zurück. Wenn Ihr Workflow ein Selfie erfordert, konfigurieren Sie die entsprechenden Schritte für Liveness-Erkennung und Gesichtsabgleich weiterhin separat.

​
Was der Benutzer sieht

  1. Der Benutzer wählt sein Land aus und entscheidet sich für Smart-ID oder Mobile-ID aus den Wallets, die Ihr Workflow akzeptiert.
  2. Die Verifizierungssitzung fragt den persönlichen Identifikationscode ab; bei Mobile-ID zusätzlich die zugehörige Telefonnummer.
  3. Auf der Seite wird ein Abgleichscode angezeigt, während die Authentifizierungsanfrage an das Telefon gesendet wird.
  4. Der Benutzer prüft, ob der Code auf dem Telefon mit dem Code auf der Verifizierungsseite übereinstimmt, und bestätigt die Anfrage anschließend mit seiner PIN auf dem Telefon.
  5. Didit validiert das signierte Identitätsergebnis und setzt den Verifizierungs-Workflow fort.
Das Identitätsformular und der Bildschirm für den Abgleichscode nutzen dasselbe Layout wie die anderen Verifizierungsmethoden. Wenn White-Label-Anpassungen aktiviert sind, übernehmen sie die Farben, die Typografie, das Button-Styling und das Kundenlogo der Sitzung und verbleiben auf der Domain der Sitzung. Das Aktualisieren der Seite stellt den aktiven Abgleichscode wieder her, ohne eine neue Genehmigungsanfrage auszulösen. Der Benutzer gibt seine Wallet-PIN niemals auf der Verifizierungsseite ein. Wenn die Codes nicht übereinstimmen oder der Benutzer die Anfrage nicht initiiert hat, sollte er sie abbrechen. Der Ablauf mit dem Abgleichscode funktioniert in Desktop- und mobilen Browsern und erfordert keinen QR-Code. Die Seite wartet automatisch auf das Ergebnis und bietet eine Option zum Abbrechen. Eine Bestätigung auf dem Telefon muss dennoch Identitäts- und Signaturprüfungen bestehen, bevor Didit die Wallet-Verifizierung als erfolgreich einstuft.

​
Workflow konfigurieren

Öffnen Sie in der Konsole den Knoten Ausweisverifizierung Ihres Workflows, wählen Sie Länder und öffnen Sie das Land, das Sie konfigurieren möchten. Wählen Sie unter Akzeptierte Wallets die verfügbaren Wallets aus und legen Sie das Fehlerverhalten fest. Speichern und veröffentlichen Sie den Workflow, bevor Sie eine neue Sitzung erstellen. Den vollständigen Konsolenpfad finden Sie unter Methoden zur Ausweisverifizierung in der Konsole.
Das Folgende ist ein Konfigurationsfragment für methods, keine vollständige Workflow-Anfrage. Verwenden Sie es nur, wenn in Ihrer Umgebung sowohl smart_id als auch mobile_id für Estland als available markiert sind. Ein nicht verfügbares Wallet führt dazu, dass das Speichern des gesamten Workflows abgelehnt wird.
Das Array providers ist eine Positivliste: Benutzer wählen zwischen den enthaltenen Wallets, und die Reihenfolge im Array legt kein bevorzugtes Wallet fest. Verwenden Sie für Litauen LTU mit denselben Wallet-Bezeichnern, wenn beide verfügbar sind. Verwenden Sie für Lettland oder Belgien LVA oder BEL ausschließlich mit smart_id, vorbehaltlich derselben Verfügbarkeitsprüfung. Nicht aufgeführte Länder behalten ihr bestehendes Standardverhalten zur Dokumentenerfassung bei. Den vollständigen Konfigurationsvertrag finden Sie unter Workflow-Funktionskonfigurationen.

​
Verifiziertes Ergebnis abrufen

Rufen Sie die abgeschlossene Sitzung über die Sitzungsentscheidungs-API oder Ihre Webhook-Integration ab. Eine erfolgreiche Wallet-Prüfung erfasst verification_method: "wallet", assurance: "cryptographic" und wallet_provider: "smart_id" oder "mobile_id". Das Objekt wallet_verification gibt das Wallet, das Ausstellungsland, den Verifizierungszeitpunkt, das Vertrauensniveau und das Ergebnis der Signaturprüfung an. Das Ergebnis der Ausweisverifizierung stellt die normalisierten Felder full_name und date_of_birth bereit. Für diese beiden Wallets enthält wallet_verification.attributes die Werte given_name, family_name, birthdate und personal_code aus der validierten Identität. Das Ausstellungsland kennzeichnet die Identitätsroute; es begründet nicht die Staatsangehörigkeit der Person. Didit gibt das Ergebnis der Signaturprüfung zurück, nicht die zugrunde liegende signierte Assertion. Es wird weder ein Porträtfoto noch eine Wallet-PIN zurückgegeben. In der Konsole zeigt die Karte Credential der Sitzung das Wallet und die verifizierten Nachweise an. Eine erfolgreiche Wallet-Prüfung schließt den Schritt Ausweisverifizierung ab; nachfolgende Prüfungen in Ihrem Workflow bestimmen weiterhin die endgültige Entscheidung der Sitzung. Informationen zu den Feldtypen und zum Unterschied zwischen einem Prüfergebnis und der Gesamtentscheidung der Sitzung finden Sie im Datenmodell der Ausweisverifizierung.

​
Abbruch und Fehler behandeln

Wenn ein Benutzer abbricht, ein Timeout auftritt oder die Authentifizierung nicht abschließen kann, wendet Didit die Einstellung wallet.on_failure des jeweiligen Landes an. fallback_to_document startet die Dokumentenerfassung, wenn sie für dieses Land aktiviert ist. decline lehnt den Schritt der Ausweisverifizierung ab. Wenn die Dokumentenerfassung deaktiviert ist, steht kein Dokumenten-Fallback zur Verfügung. Nur eine abgeschlossene, verifizierte Wallet-Prüfung zieht die Gebühr für die Wallet-Verifizierung nach sich. Abgebrochene, abgelaufene und fehlgeschlagene Wallet-Versuche tun dies nicht. Ein abgeschlossener Dokumenten-Fallback ist eine separate Prüfung gemäß den Preisen für die Dokumentenverifizierung. Die veröffentlichten Tarife finden Sie in der Wallet-Preistabelle; eine Methode ohne veröffentlichten Tarif sollte nicht als kostenlos betrachtet werden.

​
Vor der Produktion testen

Testen Sie jede Wallet und jedes Land, das Sie anbieten möchten, in der Umgebung, in der sie aktiviert sind. Vergewissern Sie sich, dass die richtigen Wallets angezeigt werden, der Abgleichscode sichtbar ist, die Genehmigung den Workflow fortsetzt und das Sitzungsergebnis die erwarteten Wallet-Nachweise enthält. Prüfen Sie außerdem Abbruch, Ablauf und das von Ihnen gewählte Fallback-Verhalten. Sandbox-Simulationen und Staging-Tests unterscheiden sich von der Authentifizierung in der Produktionsumgebung. Eine simulierte Genehmigung ist nützlich, um Ihre Integration zu überprüfen, beweist jedoch nicht, dass sich eine echte Identität in der Produktionsumgebung authentifizieren kann. Bestätigen Sie vor dem Rollout die Verfügbarkeit in der Produktionsumgebung in der Konsole und schließen Sie eine autorisierte Verifizierung auf einem echten Gerät für die geplante Route ab.

​
Weitere Wallets für digitale Identität

Didits Katalog digitaler ID-Wallets umfasst die Verfügbarkeit in der Produktionsumgebung sowie künftige Wallets, darunter das bereits verfügbare Finnish Trust Network und anstehende Integrationen für BankID und die EUDI Wallet. Eine aufgeführte Wallet, ein veröffentlichter Preis oder ein ausgefülltes Onboarding-Formular schaltet die Authentifizierung in der Produktionsumgebung nicht automatisch frei. Nutzen Sie den Katalog und die Konsole Ihrer Umgebung, um zu ermitteln, was Sie heute aktivieren können. Siehe auch Finnish Trust Network für Finnland.
Zuletzt geändert am 7. November 2026