Eine schnelle, portable und leichtgewichtige Implementierung von COSE + CBOR für eingebettete Systeme. Unterstützt PQC, FIPS 140-3, DO-178 und MISRA C. Basiert auf wolfSSL.
# wolfCOSE
wolfCOSE ist eine leichtgewichtige und schnelle C-Bibliothek, die die Kernstandards CBOR und COSE implementiert und für die Kryptographie auf [wolfSSL](https://github.com/wolfSSL/wolfssl) aufbaut.
## Unterstützte Standards & RFCs
* **Kernspezifikationen:**
* [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) - COSE-Algorithmen
* [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
* **Post-Quanten-Kryptographie:**
* [RFC 9964](https://www.rfc-editor.org/rfc/rfc9964) - ML-DSA für COSE
* [RFC 8778](https://www.rfc-editor.org/rfc/rfc8778) - HSS/LMS für COSE
* **Attestierung:**
* [RFC 9783](https://www.rfc-editor.org/rfc/rfc9783) - PSA Attestation Token Profile of EAT
## Hauptmerkmale
* **Vollständige COSE-Suite (RFC 9052):** Vollständige Unterstützung aller sechs Nachrichtentypen, einschließlich `COSE_Sign1`, `COSE_Encrypt0` und `COSE_Mac0`.
* **V2-Countersignaturen (RFC 9338):** Vollständige und abgekürzte In-Place-Countersignaturen über alle sechs getaggten COSE-Nachrichtentypen hinweg.
* **Post-Quanten-Kryptographie:**
* ML-DSA (FIPS 204 / RFC 9964) auf allen Sicherheitsstufen.
* HSS/LMS zustandsbehaftete hashbasierte Signierung (RFC 8778 / CNSA 2.0).
* **Hohe Performance:** Auf einem Intel i9-11950H erreicht End-to-End `COSE_Sign1` 66.538 Sign/s und 26.437 Verify/s mit ES256 sowie 21.986 Sign/s und 53.686 Verify/s mit ML-DSA-44. Siehe die [Details zu Performance und Footprint](https://www.wolfssl.com/documentation/manuals/wolfcose/Footprint.html) und [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/).
* **PSA-Attestierung:** EAT-/PSA-Token-Ausstellung und -Verifikation mit Unterstützung für delegierte HSM-Signierung.
* **41 kryptographische Algorithmen:** Breite Algorithmusabdeckung über Signierung, Verschlüsselung, MAC und Schlüsselverteilung.
* **Embedded-First-Design:** Keine dynamische Speicherallokation (kein Heap, kein `.data`/`.bss`). Arbeitet mit vom Aufrufer bereitgestellten Puffern bei begrenzter Stack-Nutzung.
* **FIPS 140-3-Pfad:** Verwendet wolfCrypt (FIPS-Zertifikat #4718) als einzige kryptographische Abhängigkeit.
* **STM32-Integration:** Drop-in-STM32Cube-Pack (`I-CUBE-wolfCOSE`) für STM32CubeMX / IDE verfügbar ([Details](https://www.wolfssl.com/documentation/manuals/wolfcose/STM32Cube.html)).
## Unterstützte Algorithmen
* **Digitale Signaturen:**
* **Klassisch:** `ESP256`, `ESP384`, `ESP512`, `Ed25519`, `Ed448`, `PS256`, `PS384`, `PS512`
* **Post-Quanten:** `ML-DSA-44`, `ML-DSA-65`, `ML-DSA-87`
* **Zustandsbehaftet hashbasiert:** `HSS-LMS`
* **Verschlüsselung (AEAD):**
* `AES-GCM` (128 / 192 / 256)
* `AES-CCM` (Varianten)
* `ChaCha20-Poly1305`
* **Nachrichtenauthentifizierung (MAC):**
* `HMAC-SHA256`, `HMAC-SHA384`, `HMAC-SHA512`
* `AES-MAC`
* **Schlüsselverteilung:**
* `Direct`
* `AES Key Wrap`
* `ECDH-ES + HKDF`
## COSE-Nachrichtentypen (RFC 9052)
wolfCOSE hat alle RFC 9052-Nachrichten sowohl als Single-Actor- als auch als Multi-Actor-Varianten implementiert:
| Nachricht | RFC 9052 | API | Zweck |
|---|---|---|---|
| `COSE_Sign1` | Abschn. 4.2 | `wc_CoseSign1_Sign` / `wc_CoseSign1_Verify` | Signatur mit einem Unterzeichner |
| `COSE_Sign` | Abschn. 4.1 | `wc_CoseSign_Sign` / `wc_CoseSign_Verify` | **Multi-Signer** (unabhängige Signaturen über dieselbe Nutzlast) |
| `COSE_Encrypt0` | Abschn. 5.2 | `wc_CoseEncrypt0_Encrypt` / `wc_CoseEncrypt0_Decrypt` | AEAD mit einem Empfänger |
| `COSE_Encrypt` | Abschn. 5.1 | `wc_CoseEncrypt_Encrypt` / `wc_CoseEncrypt_Decrypt` | **Multi-Empfänger** (ein Chiffrat, viele Empfänger über Direct / AES-KW / ECDH-ES) |
| `COSE_Mac0` | Abschn. 6.2 | `wc_CoseMac0_Create` / `wc_CoseMac0_Verify` | MAC mit einem Empfänger |
| `COSE_Mac` | Abschn. 6.1 | `wc_CoseMac_Create` / `wc_CoseMac_Verify` | **Multi-Empfänger**-MAC (gemeinsamer MAC-Schlüssel, an Empfänger verteilt) |
| `COSE_Key` / `COSE_KeySet` | Abschn. 7 | `wc_CoseKey_Encode` / `wc_CoseKey_Decode` | Schlüsselserialisierung für alle Schlüsseltypen |
RFC 9338-Countersignaturen können an jede getaggte Nachricht in dieser
Tabelle angehängt werden. Verwenden Sie `wc_Cose_AddCounterSignature()` oder
`wc_Cose_AddCounterSignature0()`, um eine hinzuzufügen, und verifizieren Sie sie dann unabhängig mit
der entsprechenden `wc_Cose_VerifyCounterSignature*()`-API.
## Abhängigkeiten (wolfSSL)
wolfCOSE benötigt [wolfSSL](https://www.wolfssl.com/) als Krypto-Backend.
**Mindestens unterstützte Version: v5.8.0-stable**. Einige optionale Algorithmen benötigen
neuere Releases; siehe [Getting Started](https://www.wolfssl.com/documentation/manuals/wolfcose/Getting-Started.html#prerequisites) für
merkmalspezifische Abhängigkeitsuntergrenzen und Build-Anweisungen. HSS/LMS (RFC 8778)
erfordert v5.9.2-stable oder neuer.
Wählen Sie eine Build-Konfiguration basierend auf den Algorithmen, die Sie benötigen.
### Minimaler Build (ECC + AES-GCM)
Dies liefert Ihnen COSE Sign1 (ESP256/384/512) und 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
```
**Aktivierte Algorithmen:** ESP256, ESP384, ESP512, AES-GCM-128/192/256
Für einen kleineren wolfCrypt-Footprint fügen Sie `--enable-cryptonly` hinzu, um den TLS-
Stack zu entfernen und die Algorithmen zu deaktivieren, die ein Sign1 + Encrypt0-Build nie verwendet:
```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
```
Siehe [Tuning for Size](https://www.wolfssl.com/documentation/manuals/wolfcose/Macros.html#tuning-for-size) und [Tuning for Speed](https://www.wolfssl.com/documentation/manuals/wolfcose/Macros.html#tuning-for-speed)
für weitere Optimierungen von wolfCOSE und wolfCrypt auf MCUs.
### Minimaler Build (nur Post-Quanten / ML-DSA)
Für reine Post-Quanten-Signierung mit ML-DSA-44/65/87:
```bash
cd wolfssl
./autogen.sh
./configure --enable-cryptonly --enable-mldsa
make && sudo make install
sudo ldconfig
```
**Aktivierte Algorithmen:** ML-DSA-44, ML-DSA-65, ML-DSA-87
(SHAKE-128/256 werden automatisch durch `--enable-mldsa` eingebunden. Die
`wc_MlDsaKey`-API erfordert wolfSSL neuer als v5.9.1-stable.)
### Vollständiger Build (alle Algorithmen)
```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
```
## Build
```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
```
### Build-Ziele
| Ziel | Beschreibung |
|--------|-------------|
| `make all` | Baut `libwolfcose.a` (nur Kernbibliothek) |
| `make shared` | Baut `libwolfcose.so` |
| `make test` | Baut + führt CBOR- und COSE-Unit-Tests aus |
| `make pkg-config-test` | Überprüft die wolfSSL-Paketerkennung und -Überschreibungen |
| `make eat-psa-test` | Baut + führt die explizite vollständige RFC 9783 PSA/EAT-Konformitätssuite aus |
| `make eat-psa-min-buffers-test` | Führt die vollständige PSA/EAT-Suite mit `WOLFCOSE_MIN_BUFFERS`-Limits für eingeschränkte Ziele aus |
| `make eat-psa-config-check` | Überprüft, dass PSA/EAT standardmäßig fehlt, und validiert Feature-Gate-Kombinationen |
| `make psa-eat-lean-verify` | Baut + führt das vollständige `#tfm` Verify-Only-PSA/EAT-RFC-Vektorbeispiel aus |
| `make psa-eat-demo` | Stellt ein aktuelles RFC 9783 Device-Onboarding-Token aus, verifiziert und bewertet es |
| `make tool` | Baut das CLI-Tool (`tools/wolfcose_tool`) |
| `make tool-test` | Round-Trip-Selbsttest für alle 17 Algorithmen |
| `make demo` | Baut + führt die Lifecycle-Demo aus (11 Algorithmen) |
| `make clean` | Entfernt alle Build-Artefakte |
## Schnellstart
### Beispiele
Siehe `examples/` für vollständigen funktionierenden Code:
- `sign1_demo.c`, `encrypt0_demo.c`, `mac0_demo.c`: Algorithmus-Demos
- `lifecycle_demo.c`: vollständiger Edge-to-Cloud-Workflow
- `comprehensive/`: Algorithmus-Matrix-Tests
- `scenarios/`: Firmware-Signierung, Attestierung, Flottenkonfiguration
- `psa_eat_demo.c`: RFC 9783 Device-Onboarding mit Measurement-Appraisal
- `psa_eat_verify_lean.c`: RFC 9783 Current-Profile-Sign1-Verifikation in einem Lean-Build
## CI / Testing
Läuft bei jedem Push und PR:
- **Build + Test**: Ubuntu, macOS, GCC 10-14, Clang 14-18
- **Umfassende Tests**: ~240 Algorithmuskombinationstests
- **Statische Analyse**: cppcheck, Clang Analyzer, GCC `-fanalyzer`
- **MISRA C 2012**: cppcheck `--addon=misra` prüft alle wolfCOSE-Codepfade
- **MISRA C 2023**: strikte GCC-Warnungen und clang-tidy (`bugprone-*`, `cert-*`, `clang-analyzer-*`, `misc-*`)
- **Coverity Scan**: nächtliche Defektanalyse
- **Interne statische Analyse:** Fenrir wolfssl erweiterte statische Analysetools
- **Code Coverage**: 100 % Zeilenabdeckung für jede wolfCOSE-Quelldatei erzwungen
```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>
## Dokumentation
Das offizielle wolfCOSE-Handbuch ist veröffentlicht unter
[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): Build-Anweisungen und erste Schritte
- [Message Types](https://www.wolfssl.com/documentation/manuals/wolfcose/Message-Types.html): Alle sechs RFC 9052-Nachrichten (Sign1, Sign, Encrypt0, Encrypt, Mac0, Mac) und RFC 9338-Countersignaturen mit Codebeispielen
- [Algorithms](https://www.wolfssl.com/documentation/manuals/wolfcose/Algorithms.html): Vollständige Liste der 41 unterstützten Algorithmen mit COSE-IDs
- [API Reference](https://www.wolfssl.com/documentation/manuals/wolfcose/API-Reference.html): Funktionssignaturen, Datenstrukturen, Fehlercodes
- [Macros](https://www.wolfssl.com/documentation/manuals/wolfcose/Macros.html): Compile-Time-Konfiguration, Größenoptimierung und ECDSA-Nonce-Richtlinie
- [PSA-EAT](https://www.wolfssl.com/documentation/manuals/wolfcose/PSA-EAT.html): RFC 9783 PSA-Token-Profile, APIs, Makros und Sicherheitshinweise
- [Footprint](https://www.wolfssl.com/documentation/manuals/wolfcose/Footprint.html): Größen- und Geschwindigkeitszahlen, Desktop und auf dem Gerät
- [Testing](https://www.wolfssl.com/documentation/manuals/wolfcose/Testing.html): Testinfrastruktur, Coverage und Fehlerinjektion
- [MISRA Compliance](https://www.wolfssl.com/documentation/manuals/wolfcose/MISRA-Compliance.html): MISRA C:2012- und C:2023-Konformitätsstatus und Begründung für Abweichungen
- [Project Structure](https://www.wolfssl.com/documentation/manuals/wolfcose/Project-Structure.html): Layout der Quelldateien
- [STM32Cube](https://www.wolfssl.com/documentation/manuals/wolfcose/STM32Cube.html): wolfCOSE als STM32Cube-Pack auf dem Gerät installieren und ausführen
Die Handbuchquellen liegen in [`docs/`](https://github.com/wolfssl/wolfcose/blob/main/docs); `mkdocs.yml` definiert die Navigation
und die gemeinsamen [`wolfSSL/documentation`](https://github.com/wolfSSL/documentation)
Tools bauen das HTML und PDF. Siehe [docs/dev/DOCS-BUILD.md](https://github.com/wolfssl/wolfcose/blob/main/docs/dev/DOCS-BUILD.md)
für lokale Vorschauen und wie Änderungen auf die Website gelangen.
## Versionshinweise
Die aktuelle Version ist **2.0.0**. Sie fügt standardisierte HSS/LMS-Signaturen (RFC 8778), COSE-Countersignaturen (RFC 9338), PSA/EAT-Attestierung (RFC 9783), RFC 9864-Signatur-IDs, delegierte Signierung, erweiterte Schlüssel- und CBOR-APIs, experimentelles COSE-HPKE und umfangreiche Härtung hinzu, alles ohne dynamische Allokation. Siehe [ChangeLog.md](https://github.com/wolfssl/wolfcose/blob/main/ChangeLog.md) für die vollständigen Versionshinweise.
wolfCOSE 2.0.0 wurde gemäß dem Entwicklungs- und QA-Prozess von wolfSSL entwickelt (siehe https://www.wolfssl.com/about/wolfssl-software-development-process-quality-assurance) und hat die Qualitätskriterien erfolgreich bestanden.
## Lizenz
wolfCOSE ist freie Software, lizenziert unter [GPLv3](https://www.gnu.org/licenses/gpl-3.0.html); siehe [LICENSE](https://github.com/wolfssl/wolfcose/blob/main/LICENSE) für den vollständigen Text.
Copyright (C) 2026 wolfSSL Inc.
## Support
Für kommerzielle Lizenzierung, professionelle Supportverträge oder um zu besprechen, wie Sie wolfCOSE in Ihre Produktionsumgebung integrieren können, kontaktieren Sie [wolfSSL](https://www.wolfssl.com/contact/).