Mit der Credential Manager Holder API kann Ihre Android-Inhaber-App (auch „Wallet“ genannt) digitale Berechtigungsnachweise verwalten und Prüfern präsentieren.
Formate für Berechtigungsnachweise
Anmeldedaten können in Inhaber-Apps in verschiedenen Formaten gespeichert werden. Diese Formate sind Spezifikationen dafür, wie ein Ausweisdokument dargestellt werden soll. Jedes Format enthält die folgenden Informationen zum Ausweisdokument:
- Typ: Die Kategorie, z. B. Universitätsabschluss oder Führerschein.
- Eigenschaften: Attribute wie Vor- und Nachname.
Codierung: Die Art und Weise, wie der Ausweis strukturiert ist, z. B. SD-JWT oder mdoc.
Gültigkeit: Methode zur kryptografischen Überprüfung der Authentizität des Ausweises.
Die Codierung und Validierung unterscheiden sich je nach Format geringfügig, aber funktional sind sie gleich.
Die Registry unterstützt zwei Formate:
- SD-JWT: Entspricht der IETF-Spezifikation für SD-JWT-basierte überprüfbare Anmeldedaten (SD-JWT VC).
- Mobile Dokumente oder mdocs: Entspricht der Spezifikation ISO/IEC 18013-5:2021.
Ein Prüfer kann bei Verwendung des Credential Managers eine OpenID4VP-Anfrage für SD-JWT und mdocs stellen. Die Wahl hängt vom Anwendungsfall und der Branche ab.
Registrierung von Metadaten für Anmeldedaten
Der Credential Manager speichert die Anmeldedaten eines Inhabers nicht direkt, sondern die Metadaten der Anmeldedaten. Eine Inhaber-App muss zuerst die Metadaten der Anmeldedaten mit RegistryManager im Credential Manager registrieren. Bei diesem Registrierungsprozess wird ein Registry-Eintrag erstellt, der zwei wichtige Zwecke erfüllt:
- Abgleich: Registrierte Ausweis-Metadaten werden mit zukünftigen Prüfanfragen abgeglichen.
- Anzeige: Dem Nutzer werden auf der Benutzeroberfläche zur Auswahl der Anmeldedaten benutzerdefinierte UI-Elemente angezeigt.
Verwenden Sie die Klasse OpenId4VpRegistry, um Ihre digitalen Ausweise zu registrieren, da sie sowohl mdoc- als auch SD-JWT-Ausweisformate unterstützt. Prüfer senden OpenID4VP-Anfragen, um diese Berechtigungsnachweise anzufordern.
Methoden zur Ausstellung von Berechtigungsnachweisen
Die Ausstellung von Berechtigungsnachweisen kann auf zwei Arten ausgelöst werden:
- Vom Aussteller initiierter Ablauf: Der Nutzer löst eine Anfrage zum Ausstellen einer VDC über eine App oder Website des Ausstellers aus. Beispielsweise kann eine Website ihren Nutzern die Option „Reisepass zu Wallet hinzufügen“ anbieten. Der Aussteller ruft die Credential Manager Issuance API auf, um eine OpenID4VCI-Anfrage für ein Angebot von Anmeldedaten zu stellen. Um solche Anfragen zu verarbeiten, muss ein Inhaber zuerst den Credential Manager einbinden, um seine Metadaten zu registrieren. Der Credential Manager zeigt relevante Optionen an, die der Nutzer auswählen kann. Nachdem der Nutzer eine Inhaberoption ausgewählt hat, wird die Inhaber-App aufgerufen und kann die erforderlichen Schritte zum Abschließen der Ausstellung ausführen.
- Vom Inhaber initiierter Ablauf: Der Nutzer fordert das Hinzufügen eines digitalen Ausweises über seine Inhaber-App an. Ein Inhaber kann beispielsweise die Schaltfläche „Reisepass hinzufügen“ anbieten. In diesem Fall verwaltet der Inhaber die Liste der unterstützten Aussteller und die Metadaten. Für diese Funktion ist keine Integration in den Android Credential Manager erforderlich.