Blog
Mise à jour produit n° 34
Key Attestation, délivrance par lots dans Wallet2, PAR obligatoire et plus encore
TL;DR
- Nouvelle version – Key Attestation, délivrance par lots dans Wallet2, PAR obligatoire, et plus encore
- walt.id Verifier x Google Wallet – Démo illustrant la demande d'une attestation numérique depuis Google Wallet
Community Stack (1.2.0)
Voici les points forts disponibles dans la version 1.2.0 de la bibliothèque d'identité. Consultez le journal des modifications complet de la version 1.2.0 ici. Vous souhaitez en savoir plus sur la bibliothèque d'identité en général ? Regardez notre vidéo de présentation.
1.2.0
Fonctionnalités
Exiger des Key Attestations dans Issuer2
Issuer2 peut désormais vérifier une key attestation transportée dans une preuve JWT ou envoyée comme preuve d'attestation autonome. Configurez l'attesteur de confiance une seule fois dans keyAttestationConfig avec une JWK publique ou des certificats CA X.509 de confiance, puis utilisez key_attestations_required pour rendre une attestation obligatoire pour une configuration d'attestation. L'attestation de client OAuth reste une configuration distincte.
Délivrance par lots dans Wallet2
Choisissez les attestations proposées à recevoir et demandez plusieurs copies d'une même attestation, chacune liée à sa propre clé du détenteur. Les copies d'une même attestation sont envoyées dans une seule Credential Request avec plusieurs preuves JWT, tandis que les différentes attestations restent des demandes distinctes. Sans sélection, Wallet2 reçoit toujours chaque attestation accordée une fois, avec une seule liaison au détenteur.
Imposer les Pushed Authorization Requests (PAR) dans Issuer2
Définissez enforcePushedAuthorizationRequests sur true dans issuer-service.conf : les portefeuilles doivent alors envoyer les paramètres d'autorisation au point de terminaison PAR avant d'ouvrir le point de terminaison d'autorisation. Les demandes d'autorisation directes sont rejetées. La valeur par défaut est false, de sorte que les émetteurs existants continuent d'autoriser les deux.
Choisir la clé de signature des métadonnées signées dans Issuer2
Choisissez la clé et la chaîne de certificats qu'Issuer2 utilise pour signer ses métadonnées de Credential Issuer. La même configuration signedMetadata signe désormais aussi les métadonnées du serveur d'autorisation OAuth. Si vous l'omettez, Issuer2 continue de signer les métadonnées de Credential Issuer avec sa clé de jeton.
Correctifs et améliorations
- Verifier2 accepte une IETF Token Status List signée par le même certificat feuille x5c que l'attestation, en plus des émetteurs DID et https correspondants. #2272
- Verifier2 réutilise une liste de statuts récupérée tant que son
Cache-Control: max-ageest encore valide. #2327 - Les attestations W3C dont le
@contextmélange des URL et des objets JSON-LD intégrés, comme les attestations Gaia-X, n'échouent plus à l'import ni lors de la délivrance selon le VC Data Model 2.0. #2344 - Les
type_valuesDCQL correspondent désormais aux types W3C après l'expansion du@contextJSON-LD : une requête portant sur un IRI étendu correspond à un type compact tel quegx:LegalPerson. Les valeurs compactes commeVerifiableCredentialcorrespondent toujours. #2345 - Wallet2 accepte à nouveau les attestations
jwt_vc_json-ldetjwt_vc. Les attestations W3C sécurisées par JWT restent stockées sousjwt_vc_json. #2378 - Une présentation est signée avec la clé du détenteur stockée sur cette attestation. L'envoi d'une autre clé échoue avant que le vérificateur ne voie la preuve, tandis qu'une même demande OpenID4VP peut toujours demander plusieurs attestations liées à des clés différentes. #2336
- Les réponses d'attestation d'Issuer2 sont marquées
Cache-Control: no-store, et les portefeuilles iOS contournent le cache HTTP de Foundation pour les réponses d'attestation. #2299 - Les horodatages des demandes d'autorisation et d'attestation sont toujours encodés, de sorte que
requestedAtn'est plus perdu par une comparaison d'horloge au même tick. #2371 - Les exemples Swagger d'Issuer2 pour les offres à code de transaction et à remplacement à l'exécution correspondent au JSON accepté par l'API. #2334
- Les signatures de certificats X.509 et de CSR PKCS#10 sont interprétées avec l'algorithme que l'objet déclare. #2322
- Un trust store peut contenir plusieurs CA ayant le même DN de sujet et des clés différentes. La validation de chemin sélectionne la CA par clé, et les certificats ne sont plus stockés uniquement par numéro de série. #2349
ktor-authnzutilise une seule connexion Valkey pour les stores de session et de jetons. Les échecs de connexion LDAP et Web3 renvoient 401 et les tentatives de connexion échouées sont soumises à une limitation de débit. Les jetons opaques expirent avec leur session, un code TOTP déjà utilisé est refusé pendant sa fenêtre de validité, et les nouveaux comptes OIDC reçoivent un identifiant de compte aléatoire au lieu desub. #2310- La réouverture d'un portefeuille mobile réinitialise les résolveurs DID, de sorte qu'une demande de présentation DID signée fonctionne après un redémarrage du processus. #2314
- Lorsqu'une erreur de présentation ne peut pas être signalée de manière sûre, l'erreur OpenID4VP d'origine est conservée au lieu d'être remplacée par l'échec du signalement. #2317
- Les versions TestFlight des démos de portefeuille natives et Compose ne sont plus arrêtées par le système à la mise en veille pour avoir détenu un verrou de mémoire partagée SQLCipher. #2346
- Une vérification de signature biométrique Android remplacée est annulée hors du thread principal, de sorte que la recréation d'activité ne ferme plus un appel HTTP en cours. #2341
- Le portefeuille web Compose peut cibler l'Enterprise Wallet API avec
WALLET_API_FLAVORetWALLET_API2_PUBLIC_URL. L'API open source reste la valeur par défaut. #2335 - Les portefeuilles de démonstration Compose et iOS natifs peuvent joindre une key attestation de test pour les émetteurs de test ITB et EUDI connus. Ceci est réservé à la démo. #2351
Enterprise Stack (1.2.0)
Voici les nouveaux points forts disponibles dans la version 1.2.0 de l'Enterprise Stack. Consultez le journal des modifications complet de la version 1.2.0 ici. Vous souhaitez en savoir plus sur l'Enterprise Stack en général ? Regardez notre vidéo de présentation.
1.2.0
Fonctionnalités
Exiger des Key Attestations dans Issuer2
Issuer2 peut désormais vérifier une key attestation transportée dans une preuve JWT ou envoyée comme preuve d'attestation autonome, et une configuration d'attestation peut en exiger une avec key_attestations_required. Configurez l'attesteur de confiance dans keyAttestationConfig sous forme de JWK publique, de certificats racine X.509 de confiance ou de clé de vérification KMS.
Délivrance par lots dans Wallet2
Un seul appel de réception peut sélectionner les configurations d'attestation proposées et demander plusieurs copies, chacune liée à sa propre clé du détenteur. Les copies d'une même attestation sont envoyées dans une seule Credential Request avec plusieurs preuves JWT, tandis que les différentes configurations restent des demandes distinctes. Une seule liaison au détenteur reste la valeur par défaut.
Imposer les Pushed Authorization Requests (PAR) dans Issuer2
Définissez requirePushedAuthorizationRequests sur true lorsque vous créez ou mettez à jour un service Issuer2 : les portefeuilles doivent alors d'abord envoyer les paramètres d'autorisation au point de terminaison d'autorisation poussée. Les demandes d'autorisation directes sont rejetées avec invalid_request. La valeur par défaut est false, de sorte que les émetteurs existants continuent d'autoriser les deux.
Choisir la clé de signature des métadonnées signées dans Issuer2
Choisissez la clé qui signe les métadonnées de Credential Issuer avec signedMetadata : une JWK intégrée, une clé PEM intégrée avec une chaîne de certificats, ou une clé KMS, éventuellement avec des certificats x5c issus du magasin de certificats X.509. La même configuration signe désormais aussi les métadonnées du serveur d'autorisation OAuth. Si vous l'omettez, Issuer2 continue de signer les métadonnées de Credential Issuer avec tokenKeyId.
Mode maintenance pour les organisations et les locataires
Rendez une organisation, ou un seul locataire, en lecture seule pendant une fenêtre limitée dans le temps, les lectures continuant de fonctionner. Une fenêtre dure 1 jour par défaut et 30 jours au maximum, et vous pouvez y mettre fin plus tôt. Le mode est désactivé sauf si la fonctionnalité maintenance est activée, et les comptes disposant de organization-management-maintenance-override, que la permission all inclut, peuvent continuer à écrire.
Durée de vie et renouvellement des listes de statuts dans le Credential Status Service
Définissez ttl en secondes sur une configuration d'IETF Token Status List. Le jeton publié l'utilise, les objets dans S3, Azure Blob Storage et Google Cloud Storage portent un Cache-Control: public, max-age correspondant, et Verifier2 réutilise une liste téléchargée jusqu'à son expiration. La création d'une entrée de statut renvoie désormais statusListRef, la liste qui contient le nouvel index, et après un renouvellement automatique, les mises à jour d'index ultérieures doivent utiliser cette liste.
Correctifs et améliorations
- La réception pré-autorisée de Wallet2 sur DocumentDB n'échoue plus avec une erreur de stockage après que l'émetteur a déjà renvoyé l'attestation.
- Les réceptions simultanées dans un même portefeuille Wallet2 réessaient une écriture d'attestation en conflit au lieu de faire échouer une délivrance déjà réussie.
- Une présentation est signée avec la clé du détenteur à laquelle l'attestation a été délivrée. Une clé différente est rejetée avant l'envoi.
- La révocation ou la lecture d'un index de statut après un renouvellement automatique fonctionne désormais sur la liste qui contient cet index, et non sur la liste de base qui a alloué les entrées précédentes.
- Verifier2 accepte une liste de statuts IETF externe dont la feuille
x5ccorrespond à l'attestation. Les listes hébergées par ce déploiement restent également autorisées. - Les réponses d'attestation d'Issuer2, y compris les échecs survenant avant l'écriture de la réponse, envoient
Cache-Control: no-store. - La suppression d'une organisation retire également ses alias d'hôte, les entrées de rôle sur les comptes, les événements et l'état OAuth d'Issuer2. Les comptes sont conservés et la chaîne d'audit eIDAS est maintenue.
- L'attribution d'un rôle à un utilisateur ou à une clé d'API exige toutes les permissions que ce rôle accorde. La suppression d'une règle de refus exige la permission qu'elle retirait, tandis que la suppression d'une autorisation ne l'exige pas.
- La réception Wallet2 définit par défaut
clientIdsur l'identifiant de client de portefeuille utilisé par la bibliothèque de portefeuille, de sorte qu'un échange de code d'autorisation n'échoue plus avec une incohérence de client. - Les exemples OpenAPI d'Issuer2 correspondent aux corps de requête que l'API accepte.
- Le listage des comptes de locataire vérifie que le chemin du locataire se trouve bien dans l'organisation authentifiée.
- La liste des organisations de l'administration respecte les paramètres de pagination annoncés et rejette les paramètres invalides.
- Les mises à jour de configuration d'organisation et de locataire valident les identifiants d'organisation et les références au registre DID et renvoient les erreurs documentées.
- Un bug de planification de migration découvert lors de la documentation de PostgreSQL est corrigé, et les champs de profil de base de données que l'API n'a jamais lus sont signalés comme inutilisés. Le comportement des profils est par ailleurs inchangé.
walt.id Verifier x Google Wallet
Cette démo illustre l'interopérabilité entre la Verifier API de walt.id et Google Wallet.
Tutoriel de bout en bout sur l'identité numérique
Un tutoriel pratique de bout en bout avec le Community Stack de walt.id, qui montre comment l'émetteur, le portefeuille et le vérificateur collaborent pour délivrer, conserver et vérifier des attestations numériques. Vous démarrerez la stack avec Docker Compose, délivrerez une attestation W3C Open Badge Credential via OID4VCI, puis la demanderez et la vérifierez avec OID4VP et les Verification Policies.
PS: si vous aimez travailler avec nos outils, pensez à nous laisser une ⭐ sur GitHub