Blog
Mise à jour produit n° 25
Bonjour à tous,
Avec la dernière version, nous avons ajouté la prise en charge du code PIN de transaction pré-authentification dans le Wallet API, ajouté des endpoints d'onboarding pour les IACA et les Document Signers pour la délivrance de mDL dans l'Issuer API, introduit une nouvelle politique de statut et bien plus encore.
Community Stack (v0.15.0/0.15.1)
Vous trouverez ci-dessous toutes les fonctionnalités disponibles via la v0.15.0/0.15.1 de l'identity lib. Consultez le journal des modifications complet ici et ici. Vous souhaitez en savoir plus sur l'identity lib en général ? Regardez notre vidéo d'introduction.
Fonctionnalités
Wallet API
Prise en charge du code PIN de transaction dans le flux de pré-authentification
La délivrance d'attestations accepte désormais un paramètre facultatif pinOrTxCode lors de l'appel à POST /exchange/useOfferRequest. Fournissez un PIN ou un code de transaction de l'émetteur lorsqu'il est requis.
Extension de la gestion de la connexion OIDC Microsoft Entra ID
Le Wallet API tente désormais d'échanger un code d'autorisation contre un id_token lorsqu'un JWT ne peut pas être validé, ce qui améliore la compatibilité avec les fournisseurs renvoyant des jetons opaques. Une journalisation de traçage a été ajoutée autour des routes de connexion OIDC et des flux d'authentification pour faciliter le débogage. Les modifications de configuration nécessitent que publicBaseUrl soit défini dans oidc.conf ; keycloakUserApi est désormais facultatif.
Prise en charge de la signature de JWS+Json aplatis
Le endpoint /keys/{keyId}/sign du Wallet API comprend désormais les charges utiles Flattened JWS JSON. Plus d'informations dans cette PR ici.
Wallet UI
Affichage des attestations
Le rendu visuel des cartes d'attestation a été mis à jour pour afficher les logos des émetteurs et prendre en charge les images d'arrière-plan.
Gestion de plusieurs attestations correspondantes
Lorsque plusieurs attestations du même type correspondent à une demande de présentation, le portefeuille web les regroupe désormais et invite les utilisateurs à en choisir une.
Logique de suppression des attestations
La suppression d'une attestation depuis le portefeuille web la supprime définitivement par défaut (utilise permanent=true).
Issuer API
Onboarding des IACA et des Document Signers pour la délivrance de mDL
De nouveaux endpoints d'onboarding permettent de générer un certificat auto-signé d'Issuing Authority Certification Authority (lien doc) et de délivrer des certificats Document Signer liés à une IACA (lien doc).
Personnalisation graphique des attestations
Les capacités de personnalisation graphique des attestations ont été étendues. Les métadonnées de l'émetteur peuvent désormais spécifier une secondary_image facultative en plus des champs logo et arrière-plan existants. Exemple de métadonnées.
Verifier API
Politique de statut
Une politique de statut flexible pour valider les types de statut courants comme la révocation ou la suspension, mais aussi des motifs personnalisés basés sur les standards BitstringStatusList, StatusList2021, RevocationList2020 et TokenStatusList. En savoir plus ici.
Correctifs et améliorations
Mises à jour de l'environnement EBSI
La résolution DID fonctionne désormais avec les registres de conformité et de pilote. Mise à jour pour gérer les objets descripteurs imbriqués dans la vérification de présentation. Lien vers la PR ici et ici.
Wallet UI
L'interface du portefeuille tronque désormais les noms d'utilisateur longs avec des points de suspension et affiche le nom complet au survol. Cela évite les problèmes de mise en page lorsque le nom d'utilisateur est anormalement long. Lien vers la PR.
Amélioration de l'analyse des Presentation Definitions
Les attestations contenant des tableaux sont désormais correctement mises en correspondance lorsque le filtre spécifie un type chaîne de caractères. Lien vers la PR.
Gestion des présentations SD-JWT VC
Le vérificateur peut désormais traiter les présentations contenant des attestations SD‑JWT directement ou intégrées dans des W3C VP. Lien vers la PR.
EBSI - Impossible de signer la réponse IDToken
Amélioration de la résolution des clés : la signature d'un message accepte désormais un ID de clé, un DID ou un ID de méthode de vérification. Les signatures incluent désormais l'en-tête de type JWT par défaut et prennent en charge les données JWS JSON partiellement formées. Lien vers la PR.
Prise en charge de plusieurs clés pour la résolution DID
Les bibliothèques de résolution DID et le vérificateur gèrent désormais les documents DID contenant plusieurs clés. La vérification des attestations SD‑JWT et des signatures JWS générales itère sur chaque clé résolue, ce qui améliore la compatibilité avec les documents DID à plusieurs clés. Lien vers la PR.
Analyse du format d'attestation SD-JWT
La bibliothèque gère désormais les valeurs credential_format contenant des espaces (par exemple, vc sd-jwt) en plus de la représentation standard vc+sd-jwt. Lien vers la PR.
Implémentation de la spécification BitstringStatusList pour l'encodage des listes
La bibliothèque de vérification distingue désormais correctement les listes de statuts Base64‑URL régulières et multibase. Lien vers la PR
Docs / Docker Compose
Extension de la documentation de la mDoc Lib
Des indications détaillées sur l'encodage du statut de révocation avec les listes IETF Status ou Identifier, de nouveaux exemples pour NFC, BLE et Wi-Fi Aware afin de créer et d'analyser les structures DeviceEngagement, ainsi que des instructions étendues pour signer des documents et intégrer les données de révocation. Retrouvez la documentation ici.
Docker Compose
Les images Docker référencent désormais les paramètres de version et de dépôt depuis le fichier .env, ce qui vous permet de modifier les sources d'images et les noms d'hôtes sans éditer docker-compose.yaml. Assurez-vous de définir les nouvelles variables IMAGE_PREFIX, SERVICE_HOST et de version (VERSION_OPA, VERSION_VAULT, VERSION_VC_REPO) lors de l'exécution des services. Lien vers la PR
Changements incompatibles
SD-JWT VC Lib
Tout code appelant SDJwtVC.sign(...), SDJwtVC.doSign(...) ou SDJwtVC.defaultPayloadProperties(...) doit désormais fournir le paramètre status sous forme de JsonObject? au lieu de String?.
Enterprise Stack (v0.7.0)
Vous trouverez ci-dessous toutes les fonctionnalités disponibles via la v0.7.0 de l'enterprise stack. Vous souhaitez en savoir plus sur l'enterprise stack en général ? Regardez notre vidéo d'introduction.
Fonctionnalités
Holder Policies pour les flux de portefeuille silencieux
Utilisez les holder policies pour permettre aux utilisateurs de définir des règles de partage granulaires pour les attestations, garantissant un partage de données fondé sur le consentement lors des flux de délivrance et de vérification silencieux. En savoir plus ici.
Nouvelle politique de statut dans le Verifier Service
Une politique de statut flexible pour valider les types de statut courants comme la révocation ou la suspension, mais aussi des motifs personnalisés basés sur les standards BitstringStatusList, StatusList2021, RevocationList2020 et TokenStatusList. En savoir plus ici.
Prise en charge des sessions de délivrance sans expiration
L'Issuer Service API permet désormais de créer des sessions de délivrance sans expiration. Lorsque vous appelez POST /issuer-service-api/credentials/issue, vous pouvez configurer la session pour qu'elle reste active indéfiniment en incluant le paramètre expiresInSeconds : -1. Si vous préférez une session d'une durée déterminée, vous pouvez spécifier la durée souhaitée en secondes via le paramètre expiresInSeconds. Par défaut, si ce paramètre est omis, la session expire au bout de cinq minutes.
Délivrance de mDL simplifiée
La demande de délivrance de mDL ne requiert plus le champ trustedRootCAs. Les exemples OpenAPI ont également été mis à jour.
Extension de la personnalisation graphique des attestations
Les émetteurs peuvent désormais fournir une image secondaire pour les informations de personnalisation graphique de l'attestation lors de la configuration d'un service d'émetteur. Consultez un exemple mis à jour dans la documentation SWAGGER ici. Nom de l'exemple -> Create Issuer with credential branding information
Mises à jour de l'Enterprise UI
- La gestion de la configuration des services au format JSON a été implémentée pour les services suivants : DID registry, KMS, Status, Credential Store, DID Store, Verifier et Wallet.
- Amélioration de la gestion des Authorization Request lors de la présentation d'attestations via l'interface du wallet service.
Correctifs
Chargement des informations d'affichage SD-JWT VC
Lorsque vous délivrez une attestation SD-JWT VC via le endpoint credentials/issue du service d'émetteur, les informations d'affichage sont désormais correctement récupérées depuis la configuration du service d'émetteur. Cela se produit si vous ne fournissez aucune information d'affichage directement dans votre demande de délivrance.
Application des clés dans le Wallet Service
Le flux de présentation du portefeuille n'impose plus que les clés du détenteur soient de type secp256r1. Les applications peuvent désormais présenter des attestations non‑MDOC avec d'autres types de clés.
Docs
Documentation OpenAPI améliorée
Chaque endpoint dispose désormais de descriptions plus claires, et les spécifications OpenID4VCI incluent standardVersion comme paramètre de chemin. Ces mises à jour garantissent que les clients générés à partir de api.json reflètent fidèlement le comportement de l'API.
Coups de cœur de la communauté
Série de vidéos pratiques
- Comment présenter des attestations SD-JWT VC depuis un portefeuille d'identité
- Comment présenter des attestations W3C depuis un portefeuille d'identité
- Comment recevoir des attestations SD-JWT VC dans un portefeuille d'identité
- Comment recevoir des attestations W3C dans un portefeuille d'identité
Tutoriel Community Stack
Dans notre dernier tutoriel vidéo, apprenez à construire un cas d'usage d'identité numérique de bout en bout avec le walt.id Community Stack en configurant un portefeuille custodial, en délivrant et en stockant une attestation de diplôme universitaire conforme à W3C, et en la vérifiant de manière sécurisée grâce aux API Issuer, Wallet et Verifier ;
Liste des fonctionnalités et feuille de route
Vue d'ensemble - fonctionnalités produit actuelles et à venir
PS: Si vous aimez travailler avec nos outils, pensez à nous laisser une ⭐ sur GitHub