Une implémentation COSE + CBOR rapide, portable et légère pour les systèmes embarqués. Prend en charge PQC, FIPS 140-3, DO-178 et MISRA C. Propulsé par wolfSSL.
# wolfCOSE
wolfCOSE est une bibliothèque C légère et rapide implémentant les normes fondamentales CBOR et COSE, s'appuyant sur [wolfSSL](https://github.com/wolfSSL/wolfssl) pour la cryptographie.
## Normes et RFC prises en charge
* **Spécifications principales :**
* [RFC 8949](https://www.rfc-editor.org/rfc/rfc8949) - Concise Binary Object Representation (CBOR)
* [RFC 9052](https://www.rfc-editor.org/rfc/rfc9052) - CBOR Object Signing and Encryption (COSE)
* [RFC 9053](https://www.rfc-editor.org/rfc/rfc9053) - Algorithmes COSE
* [RFC 9864](https://www.rfc-editor.org/rfc/rfc9864) - Fully-Specified Algorithms for JOSE and COSE
* [RFC 9338](https://www.rfc-editor.org/rfc/rfc9338) - COSE Countersignatures
* **Cryptographie post-quantique :**
* [RFC 9964](https://www.rfc-editor.org/rfc/rfc9964) - ML-DSA pour COSE
* [RFC 8778](https://www.rfc-editor.org/rfc/rfc8778) - HSS/LMS pour COSE
* **Attestation :**
* [RFC 9783](https://www.rfc-editor.org/rfc/rfc9783) - PSA Attestation Token Profile of EAT
## Fonctionnalités principales
* **Suite COSE complète (RFC 9052) :** Prise en charge complète des six types de messages, notamment `COSE_Sign1`, `COSE_Encrypt0` et `COSE_Mac0`.
* **Contre-signatures V2 (RFC 9338) :** Contre-signatures in-place complètes et abrégées sur les six types de messages COSE balisés.
* **Cryptographie post-quantique :**
* ML-DSA (FIPS 204 / RFC 9964) à tous les niveaux de sécurité.
* Signature à base de hachage avec état HSS/LMS (RFC 8778 / CNSA 2.0).
* **Performances élevées :** Sur un Intel i9-11950H, le `COSE_Sign1` de bout en bout atteint 66 538 sign/s et 26 437 verify/s avec ES256, et 21 986 sign/s et 53 686 verify/s avec ML-DSA-44. Voir les [détails de performance et d'empreinte](https://www.wolfssl.com/documentation/manuals/wolfcose/Footprint.html) et [wolfCOSE vs. The Field](https://www.wolfssl.com/wolfcose-vs-the-field-the-smallest-and-fastest-cose-library-now-with-post-quantum-ml-dsa-at-the-same-cost/).
* **Attestation PSA :** Émission et vérification de jetons EAT / PSA avec prise en charge de la signature déléguée par HSM.
* **41 algorithmes cryptographiques :** Large couverture algorithmique pour la signature, le chiffrement, le MAC et la distribution de clés.
* **Conception orientée embarqué :** Aucune allocation dynamique de mémoire (pas de tas, zéro `.data`/`.bss`). Fonctionne sur des tampons fournis par l'appelant avec une utilisation de pile bornée.
* **Voie FIPS 140-3 :** Utilise wolfCrypt (certificat FIPS n° 4718) comme unique dépendance cryptographique.
* **Intégration STM32 :** Pack STM32Cube prêt à l'emploi (`I-CUBE-wolfCOSE`) disponible pour STM32CubeMX / IDE ([Détails](https://www.wolfssl.com/documentation/manuals/wolfcose/STM32Cube.html)).
## Algorithmes pris en charge
* **Signatures numériques :**
* **Classiques :** `ESP256`, `ESP384`, `ESP512`, `Ed25519`, `Ed448`, `PS256`, `PS384`, `PS512`
* **Post-quantiques :** `ML-DSA-44`, `ML-DSA-65`, `ML-DSA-87`
* **À base de hachage avec état :** `HSS-LMS`
* **Chiffrement (AEAD) :**
* `AES-GCM` (128 / 192 / 256)
* `AES-CCM` (variantes)
* `ChaCha20-Poly1305`
* **Authentification de message (MAC) :**
* `HMAC-SHA256`, `HMAC-SHA384`, `HMAC-SHA512`
* `AES-MAC`
* **Distribution de clés :**
* `Direct`
* `AES Key Wrap`
* `ECDH-ES + HKDF`
## Types de messages COSE (RFC 9052)
wolfCOSE a implémenté tous les messages de la RFC 9052, dans leurs variantes mono-acteur et multi-acteur :
| Message | RFC 9052 | API | Objectif |
|---|---|---|---|
| `COSE_Sign1` | Sec. 4.2 | `wc_CoseSign1_Sign` / `wc_CoseSign1_Verify` | Signature à signataire unique |
| `COSE_Sign` | Sec. 4.1 | `wc_CoseSign_Sign` / `wc_CoseSign_Verify` | **Multi-signataires** (signatures indépendantes sur la même charge utile) |
| `COSE_Encrypt0` | Sec. 5.2 | `wc_CoseEncrypt0_Encrypt` / `wc_CoseEncrypt0_Decrypt` | AEAD à destinataire unique |
| `COSE_Encrypt` | Sec. 5.1 | `wc_CoseEncrypt_Encrypt` / `wc_CoseEncrypt_Decrypt` | **Multi-destinataires** (un seul texte chiffré, plusieurs destinataires via Direct / AES-KW / ECDH-ES) |
| `COSE_Mac0` | Sec. 6.2 | `wc_CoseMac0_Create` / `wc_CoseMac0_Verify` | MAC à destinataire unique |
| `COSE_Mac` | Sec. 6.1 | `wc_CoseMac_Create` / `wc_CoseMac_Verify` | MAC **multi-destinataires** (clé MAC partagée, distribuée aux destinataires) |
| `COSE_Key` / `COSE_KeySet` | Sec. 7 | `wc_CoseKey_Encode` / `wc_CoseKey_Decode` | Sérialisation de clés pour tous les types de clés |
Les contre-signatures de la RFC 9338 peuvent être attachées à n'importe quel
message balisé de ce tableau. Utilisez `wc_Cose_AddCounterSignature()` ou
`wc_Cose_AddCounterSignature0()` pour en ajouter une, puis vérifiez-la
indépendamment avec l'API `wc_Cose_VerifyCounterSignature*()` correspondante.
## Dépendances (wolfSSL)
wolfCOSE nécessite [wolfSSL](https://www.wolfssl.com/) comme backend
cryptographique. **Version minimale prise en charge : v5.8.0-stable**. Certains
algorithmes optionnels nécessitent des versions plus récentes ; voir
[Getting Started](https://www.wolfssl.com/documentation/manuals/wolfcose/Getting-Started.html#prerequisites) pour
les seuils de dépendance spécifiques aux fonctionnalités et les instructions de
compilation. HSS/LMS (RFC 8778) nécessite v5.9.2-stable ou une version ultérieure.
Choisissez une configuration de compilation en fonction des algorithmes dont vous avez besoin.
### Compilation minimale (ECC + AES-GCM)
Cela vous donne COSE Sign1 (ESP256/384/512) et Encrypt0 (AES-GCM) :
```bash
cd wolfssl
./autogen.sh
./configure --enable-ecc --enable-aesgcm \
--enable-sha384 --enable-sha512 --enable-keygen
make && sudo make install
sudo ldconfig
```
**Algorithmes activés :** ESP256, ESP384, ESP512, AES-GCM-128/192/256
Pour une empreinte wolfCrypt plus réduite, ajoutez `--enable-cryptonly` afin de
supprimer la pile TLS et de désactiver les algorithmes qu'une compilation
Sign1 + Encrypt0 n'utilise jamais :
```bash
./configure --enable-cryptonly --enable-ecc --enable-aesgcm \
--enable-sha384 --enable-sha512 --enable-keygen \
--enable-lowresource \
--disable-dh --disable-rsa --disable-aescbc \
--disable-sha --disable-md5 --disable-chacha --disable-poly1305 \
--disable-errorstrings
```
Voir [Tuning for Size](https://www.wolfssl.com/documentation/manuals/wolfcose/Macros.html#tuning-for-size) et [Tuning for Speed](https://www.wolfssl.com/documentation/manuals/wolfcose/Macros.html#tuning-for-speed)
pour réduire davantage wolfCOSE et wolfCrypt sur les MCU.
### Compilation minimale (post-quantique / ML-DSA uniquement)
Pour une signature purement post-quantique avec ML-DSA-44/65/87 :
```bash
cd wolfssl
./autogen.sh
./configure --enable-cryptonly --enable-mldsa
make && sudo make install
sudo ldconfig
```
**Algorithmes activés :** ML-DSA-44, ML-DSA-65, ML-DSA-87
(SHAKE-128/256 sont tirés automatiquement par `--enable-mldsa`. L'API
`wc_MlDsaKey` nécessite une version de wolfSSL plus récente que v5.9.1-stable.)
### Compilation complète (tous les algorithmes)
```bash
cd wolfssl
./autogen.sh
./configure --enable-ecc --enable-ed25519 --enable-ed448 \
--enable-curve25519 --enable-aesgcm --enable-aesccm \
--enable-sha384 --enable-sha512 --enable-keygen \
--enable-rsapss --enable-chacha --enable-poly1305 \
--enable-mldsa --enable-lms \
--enable-hkdf --enable-aeskeywrap
make && sudo make install
sudo ldconfig
```
## Compilation
```bash
# Core library (libwolfcose.a)
make
# Run unit tests
make test
# Build and run CLI tool round-trip tests (all algorithms)
make tool-test
# Run lifecycle demo (11 algorithms)
make demo
```
### Cibles de compilation
| Cible | Description |
|--------|-------------|
| `make all` | Compile `libwolfcose.a` (bibliothèque principale uniquement) |
| `make shared` | Compile `libwolfcose.so` |
| `make test` | Compile + exécute les tests unitaires CBOR et COSE |
| `make pkg-config-test` | Vérifie la découverte du paquet wolfSSL et les surcharges |
| `make eat-psa-test` | Compile + exécute la suite de conformité complète explicite RFC 9783 PSA/EAT |
| `make eat-psa-min-buffers-test` | Exécute la suite PSA/EAT complète avec les limites de cible contrainte `WOLFCOSE_MIN_BUFFERS` |
| `make eat-psa-config-check` | Vérifie que PSA/EAT est absent par défaut et valide les combinaisons de fonctionnalités |
| `make psa-eat-lean-verify` | Compile + exécute l'exemple complet de vecteur RFC `#tfm` PSA/EAT en vérification seule |
| `make psa-eat-demo` | Émet, vérifie et évalue un jeton d'onboarding d'appareil RFC 9783 actuel |
| `make tool` | Compile l'outil CLI (`tools/wolfcose_tool`) |
| `make tool-test` | Auto-test aller-retour pour les 17 algorithmes |
| `make demo` | Compile + exécute la démo de cycle de vie (11 algorithmes) |
| `make clean` | Supprime tous les artefacts de compilation |
## Démarrage rapide
### Exemples
Voir `examples/` pour du code complet fonctionnel :
- `sign1_demo.c`, `encrypt0_demo.c`, `mac0_demo.c` : démos d'algorithmes
- `lifecycle_demo.c` : flux de travail complet de l'edge au cloud
- `comprehensive/` : tests de matrice d'algorithmes
- `scenarios/` : signature de firmware, attestation, configuration de flotte
- `psa_eat_demo.c` : onboarding d'appareil RFC 9783 avec évaluation des mesures
- `psa_eat_verify_lean.c` : vérification Sign1 du profil actuel RFC 9783 dans une compilation allégée
## CI / Tests
Exécutés à chaque push et PR :
- **Compilation + Tests** : Ubuntu, macOS, GCC 10-14, Clang 14-18
- **Tests complets** : ~240 tests de combinaisons d'algorithmes
- **Analyse statique** : cppcheck, analyseur Clang, GCC `-fanalyzer`
- **MISRA C 2012** : cppcheck `--addon=misra` vérifiant tous les chemins de code wolfCOSE
- **MISRA C 2023** : avertissements GCC stricts et clang-tidy (`bugprone-*`, `cert-*`, `clang-analyzer-*`, `misc-*`)
- **Coverity Scan** : analyse nocturne des défauts
- **Analyse statique interne :** outils d'analyse statique avancée Fenrir wolfssl
- **Couverture de code** : couverture de lignes de 100 % imposée pour chaque fichier source wolfCOSE
```bash
make coverage # Run tests with gcov
make coverage-force-failure # Include crypto failure path testing
```
<a href="https://scan.coverity.com/projects/wolfcose">
<img alt="Coverity Scan Build Status"
src="https://scan.coverity.com/projects/32918/badge.svg"/>
</a>
<a href="https://github.com/wolfSSL/wolfCOSE/actions">
<img alt="CI Status"
src="https://img.shields.io/github/actions/workflow/status/wolfSSL/wolfCOSE/build-test.yml?label=CI&logo=github"/>
</a>
## Documentation
Le manuel officiel de wolfCOSE est publié à l'adresse
[wolfssl.com/documentation/manuals/wolfcose](https://www.wolfssl.com/documentation/manuals/wolfcose/index.html) :
- [Getting Started](https://www.wolfssl.com/documentation/manuals/wolfcose/Getting-Started.html) : instructions de compilation et premiers pas
- [Message Types](https://www.wolfssl.com/documentation/manuals/wolfcose/Message-Types.html) : les six messages RFC 9052 (Sign1, Sign, Encrypt0, Encrypt, Mac0, Mac) et les contre-signatures RFC 9338 avec exemples de code
- [Algorithms](https://www.wolfssl.com/documentation/manuals/wolfcose/Algorithms.html) : liste complète des 41 algorithmes pris en charge avec les identifiants COSE
- [API Reference](https://www.wolfssl.com/documentation/manuals/wolfcose/API-Reference.html) : signatures de fonctions, structures de données, codes d'erreur
- [Macros](https://www.wolfssl.com/documentation/manuals/wolfcose/Macros.html) : configuration à la compilation, optimisation de la taille et politique de nonce ECDSA
- [PSA-EAT](https://www.wolfssl.com/documentation/manuals/wolfcose/PSA-EAT.html) : profils de jetons PSA RFC 9783, API, macros et recommandations de sécurité
- [Footprint](https://www.wolfssl.com/documentation/manuals/wolfcose/Footprint.html) : chiffres de taille et de vitesse, sur poste de travail et sur appareil
- [Testing](https://www.wolfssl.com/documentation/manuals/wolfcose/Testing.html) : infrastructure de test, couverture et injection de pannes
- [MISRA Compliance](https://www.wolfssl.com/documentation/manuals/wolfcose/MISRA-Compliance.html) : statut de conformité MISRA C:2012 et C:2023 et justification des déviations
- [Project Structure](https://www.wolfssl.com/documentation/manuals/wolfcose/Project-Structure.html) : organisation des fichiers sources
- [STM32Cube](https://www.wolfssl.com/documentation/manuals/wolfcose/STM32Cube.html) : installer et exécuter wolfCOSE en tant que pack STM32Cube sur appareil
Les sources du manuel se trouvent dans [`docs/`](https://github.com/wolfssl/wolfcose/blob/main/docs) ; `mkdocs.yml` définit la
navigation et l'outillage partagé [`wolfSSL/documentation`](https://github.com/wolfSSL/documentation)
génère le HTML et le PDF. Voir [docs/dev/DOCS-BUILD.md](https://github.com/wolfssl/wolfcose/blob/main/docs/dev/DOCS-BUILD.md)
pour les aperçus locaux et la manière dont les modifications parviennent au site web.
## Notes de version
La version actuelle est la **2.0.0**. Elle ajoute les signatures HSS/LMS normalisées (RFC 8778), les contre-signatures COSE (RFC 9338), l'attestation PSA/EAT (RFC 9783), les identifiants de signature RFC 9864, la signature déléguée, des API étendues pour les clés et CBOR, COSE-HPKE expérimental, ainsi qu'un durcissement approfondi, le tout sans allocation dynamique. Voir [ChangeLog.md](https://github.com/wolfssl/wolfcose/blob/main/ChangeLog.md) pour les notes de version complètes.
wolfCOSE 2.0.0 a été développé conformément au processus de développement et d'assurance qualité de wolfSSL (voir https://www.wolfssl.com/about/wolfssl-software-development-process-quality-assurance) et a passé avec succès les critères de qualité.
## Licence
wolfCOSE est un logiciel libre sous licence [GPLv3](https://www.gnu.org/licenses/gpl-3.0.html) ; voir [LICENSE](https://github.com/wolfssl/wolfcose/blob/main/LICENSE) pour le texte complet.
Copyright (C) 2026 wolfSSL Inc.
## Support
Pour une licence commerciale, des contrats de support professionnel, ou pour discuter de l'intégration de wolfCOSE dans votre environnement de production, contactez [wolfSSL](https://www.wolfssl.com/contact/).