एम्बेडेड सिस्टम के लिए एक तेज़, पोर्टेबल और हल्का COSE + CBOR कार्यान्वयन। PQC, FIPS 140-3, DO-178, और MISRA C का समर्थन करता है। wolfSSL द्वारा संचालित।
# wolfCOSE
wolfCOSE एक हल्का और तेज़ C लाइब्रेरी है जो मुख्य CBOR और COSE मानकों को लागू करता है, जिसमें क्रिप्टोग्राफी के लिए [wolfSSL](https://github.com/wolfSSL/wolfssl) का समर्थन है।
## समर्थित मानक और RFC
* **मुख्य विनिर्देश:**
* [RFC 8949](https://www.rfc-editor.org/rfc/rfc8949) - संक्षिप्त बाइनरी ऑब्जेक्ट रिप्रेजेंटेशन (CBOR)
* [RFC 9052](https://www.rfc-editor.org/rfc/rfc9052) - CBOR ऑब्जेक्ट साइनिंग और एन्क्रिप्शन (COSE)
* [RFC 9053](https://www.rfc-editor.org/rfc/rfc9053) - COSE एल्गोरिदम
* [RFC 9864](https://www.rfc-editor.org/rfc/rfc9864) - JOSE और COSE के लिए पूर्ण-निर्दिष्ट एल्गोरिदम
* [RFC 9338](https://www.rfc-editor.org/rfc/rfc9338) - COSE काउंटरसिग्नेचर
* **पोस्ट-क्वांटम क्रिप्टोग्राफी:**
* [RFC 9964](https://www.rfc-editor.org/rfc/rfc9964) - COSE के लिए ML-DSA
* [RFC 8778](https://www.rfc-editor.org/rfc/rfc8778) - COSE के लिए HSS/LMS
* **अटेस्टेशन:**
* [RFC 9783](https://www.rfc-editor.org/rfc/rfc9783) - EAT का PSA अटेस्टेशन टोकन प्रोफ़ाइल
## मुख्य विशेषताएँ
* **पूर्ण COSE सूट (RFC 9052):** सभी छह संदेश प्रकारों के लिए पूर्ण समर्थन, जिसमें `COSE_Sign1`, `COSE_Encrypt0`, और `COSE_Mac0` शामिल हैं।
* **V2 काउंटरसिग्नेचर (RFC 9338):** सभी छह टैग किए गए COSE संदेश प्रकारों में पूर्ण और संक्षिप्त इन-प्लेस काउंटरसिग्नेचर।
* **पोस्ट-क्वांटम क्रिप्टोग्राफी:**
* सभी सुरक्षा स्तरों पर ML-DSA (FIPS 204 / RFC 9964)।
* HSS/LMS स्टेटफुल हैश-आधारित साइनिंग (RFC 8778 / CNSA 2.0)।
* **तेज़ प्रदर्शन:** Intel i9-11950H पर, एंड-टू-एंड `COSE_Sign1` ES256 के साथ 66,538 sign/s और 26,437 verify/s तक पहुँचता है, और ML-DSA-44 के साथ 21,986 sign/s और 53,686 verify/s। [प्रदर्शन और फुटप्रिंट विवरण](https://www.wolfssl.com/documentation/manuals/wolfcose/Footprint.html) और [wolfCOSE बनाम द फील्ड](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 अटेस्टेशन:** प्रतिनिधि HSM साइनिंग समर्थन के साथ EAT / PSA टोकन जारी करना और सत्यापन।
* **41 क्रिप्टोग्राफिक एल्गोरिदम:** साइनिंग, एन्क्रिप्शन, MAC, और कुंजी वितरण में व्यापक एल्गोरिदम कवरेज।
* **एम्बेडेड-फर्स्ट डिज़ाइन:** शून्य डायनामिक मेमोरी आवंटन (कोई हीप नहीं, शून्य `.data`/`.bss`)। कॉलर-आपूर्ति बफ़र्स पर सीमित स्टैक उपयोग के साथ संचालित होता है।
* **FIPS 140-3 पथ:** अपनी एकमात्र क्रिप्टोग्राफिक निर्भरता के रूप में wolfCrypt (FIPS प्रमाणपत्र #4718) का उपयोग करता है।
* **STM32 एकीकृत:** STM32CubeMX / IDE के लिए ड्रॉप-इन STM32Cube पैक (`I-CUBE-wolfCOSE`) उपलब्ध ([विवरण](https://www.wolfssl.com/documentation/manuals/wolfcose/STM32Cube.html))।
## समर्थित एल्गोरिदम
* **डिजिटल हस्ताक्षर:**
* **क्लासिकल:** `ESP256`, `ESP384`, `ESP512`, `Ed25519`, `Ed448`, `PS256`, `PS384`, `PS512`
* **पोस्ट-क्वांटम:** `ML-DSA-44`, `ML-DSA-65`, `ML-DSA-87`
* **स्टेटफुल हैश-आधारित:** `HSS-LMS`
* **एन्क्रिप्शन (AEAD):**
* `AES-GCM` (128 / 192 / 256)
* `AES-CCM` (वेरिएंट)
* `ChaCha20-Poly1305`
* **संदेश प्रमाणीकरण (MAC):**
* `HMAC-SHA256`, `HMAC-SHA384`, `HMAC-SHA512`
* `AES-MAC`
* **कुंजी वितरण:**
* `Direct`
* `AES Key Wrap`
* `ECDH-ES + HKDF`
## COSE संदेश प्रकार (RFC 9052)
wolfCOSE ने सभी RFC 9052 संदेशों को सिंगल-एक्टर और मल्टी-एक्टर दोनों वेरिएंट में लागू किया है:
| संदेश | RFC 9052 | API | उद्देश्य |
|---|---|---|---|
| `COSE_Sign1` | Sec. 4.2 | `wc_CoseSign1_Sign` / `wc_CoseSign1_Verify` | सिंगल-साइनर हस्ताक्षर |
| `COSE_Sign` | Sec. 4.1 | `wc_CoseSign_Sign` / `wc_CoseSign_Verify` | **मल्टी-साइनर** (एक ही पेलोड पर स्वतंत्र हस्ताक्षर) |
| `COSE_Encrypt0` | Sec. 5.2 | `wc_CoseEncrypt0_Encrypt` / `wc_CoseEncrypt0_Decrypt` | सिंगल-रिसिपिएंट AEAD |
| `COSE_Encrypt` | Sec. 5.1 | `wc_CoseEncrypt_Encrypt` / `wc_CoseEncrypt_Decrypt` | **मल्टी-रिसिपिएंट** (एक सिफरटेक्स्ट, Direct / AES-KW / ECDH-ES के माध्यम से कई प्राप्तकर्ता) |
| `COSE_Mac0` | Sec. 6.2 | `wc_CoseMac0_Create` / `wc_CoseMac0_Verify` | सिंगल-रिसिपिएंट MAC |
| `COSE_Mac` | Sec. 6.1 | `wc_CoseMac_Create` / `wc_CoseMac_Verify` | **मल्टी-रिसिपिएंट** MAC (साझा MAC कुंजी, प्राप्तकर्ताओं को वितरित) |
| `COSE_Key` / `COSE_KeySet` | Sec. 7 | `wc_CoseKey_Encode` / `wc_CoseKey_Decode` | सभी कुंजी प्रकारों के लिए कुंजी सीरियलाइज़ेशन |
RFC 9338 काउंटरसिग्नेचर इस तालिका में किसी भी टैग किए गए संदेश से जोड़े जा सकते हैं। एक जोड़ने के लिए `wc_Cose_AddCounterSignature()` या `wc_Cose_AddCounterSignature0()` का उपयोग करें, फिर संबंधित `wc_Cose_VerifyCounterSignature*()` API के साथ स्वतंत्र रूप से सत्यापित करें।
## निर्भरताएँ (wolfSSL)
wolfCOSE को अपने क्रिप्टो बैकएंड के रूप में [wolfSSL](https://www.wolfssl.com/) की आवश्यकता है।
**न्यूनतम समर्थित संस्करण: v5.8.0-stable**। कुछ वैकल्पिक एल्गोरिदम के लिए नए रिलीज़ की आवश्यकता होती है; फीचर-विशिष्ट निर्भरता सीमाओं और बिल्ड निर्देशों के लिए [Getting Started](https://www.wolfssl.com/documentation/manuals/wolfcose/Getting-Started.html#prerequisites) देखें। HSS/LMS (RFC 8778) के लिए v5.9.2-stable या बाद का संस्करण आवश्यक है।
आपको जिन एल्गोरिदम की आवश्यकता है, उनके आधार पर बिल्ड कॉन्फ़िगरेशन चुनें।
### न्यूनतम बिल्ड (ECC + AES-GCM)
यह आपको COSE Sign1 (ESP256/384/512) और 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
```
**सक्षम एल्गोरिदम:** ESP256, ESP384, ESP512, AES-GCM-128/192/256
छोटे wolfCrypt फुटप्रिंट के लिए, TLS स्टैक को हटाने और उन एल्गोरिदम को अक्षम करने के लिए `--enable-cryptonly` जोड़ें जिनका Sign1 + Encrypt0 बिल्ड कभी उपयोग नहीं करता:
```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
```
MCU पर wolfCOSE और wolfCrypt को और अधिक अनुकूलित करने के लिए [Tuning for Size](https://www.wolfssl.com/documentation/manuals/wolfcose/Macros.html#tuning-for-size) और [Tuning for Speed](https://www.wolfssl.com/documentation/manuals/wolfcose/Macros.html#tuning-for-speed) देखें।
### न्यूनतम बिल्ड (केवल पोस्ट-क्वांटम / ML-DSA)
ML-DSA-44/65/87 के साथ शुद्ध पोस्ट-क्वांटम साइनिंग के लिए:
```bash
cd wolfssl
./autogen.sh
./configure --enable-cryptonly --enable-mldsa
make && sudo make install
sudo ldconfig
```
**सक्षम एल्गोरिदम:** ML-DSA-44, ML-DSA-65, ML-DSA-87
(SHAKE-128/256 स्वचालित रूप से `--enable-mldsa` द्वारा शामिल किए जाते हैं। `wc_MlDsaKey` API के लिए v5.9.1-stable से नए wolfSSL की आवश्यकता है।)
### पूर्ण बिल्ड (सभी एल्गोरिदम)
```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
```
## बिल्ड
```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
```
### बिल्ड लक्ष्य
| लक्ष्य | विवरण |
|--------|-------------|
| `make all` | `libwolfcose.a` बनाएँ (केवल कोर लाइब्रेरी) |
| `make shared` | `libwolfcose.so` बनाएँ |
| `make test` | CBOR और COSE यूनिट टेस्ट बनाएँ + चलाएँ |
| `make pkg-config-test` | wolfSSL पैकेज डिस्कवरी और ओवरराइड सत्यापित करें |
| `make eat-psa-test` | स्पष्ट पूर्ण RFC 9783 PSA/EAT अनुरूपता सूट बनाएँ + चलाएँ |
| `make eat-psa-min-buffers-test` | `WOLFCOSE_MIN_BUFFERS` नियंत्रित-लक्ष्य सीमाओं के साथ पूर्ण PSA/EAT सूट चलाएँ |
| `make eat-psa-config-check` | सत्यापित करें कि PSA/EAT डिफ़ॉल्ट रूप से अनुपस्थित है और फीचर-गेट संयोजनों को मान्य करें |
| `make psa-eat-lean-verify` | पूर्ण `#tfm` verify-only PSA/EAT RFC वेक्टर उदाहरण बनाएँ + चलाएँ |
| `make psa-eat-demo` | वर्तमान RFC 9783 डिवाइस-ऑनबोर्डिंग टोकन जारी करें, सत्यापित करें, और मूल्यांकन करें |
| `make tool` | CLI टूल बनाएँ (`tools/wolfcose_tool`) |
| `make tool-test` | सभी 17 एल्गोरिदम के लिए राउंड-ट्रिप स्व-परीक्षण |
| `make demo` | लाइफसाइकल डेमो बनाएँ + चलाएँ (11 एल्गोरिदम) |
| `make clean` | सभी बिल्ड आर्टिफैक्ट हटाएँ |
## त्वरित शुरुआत
### उदाहरण
पूर्ण कार्यशील कोड के लिए `examples/` देखें:
- `sign1_demo.c`, `encrypt0_demo.c`, `mac0_demo.c`: एल्गोरिदम डेमो
- `lifecycle_demo.c`: पूर्ण एज-टू-क्लाउड वर्कफ़्लो
- `comprehensive/`: एल्गोरिदम मैट्रिक्स परीक्षण
- `scenarios/`: फर्मवेयर साइनिंग, अटेस्टेशन, फ्लीट कॉन्फ़िग
- `psa_eat_demo.c`: माप मूल्यांकन के साथ RFC 9783 डिवाइस ऑनबोर्डिंग
- `psa_eat_verify_lean.c`: लीन बिल्ड में RFC 9783 वर्तमान-प्रोफ़ाइल Sign1 सत्यापन
## CI / परीक्षण
प्रत्येक पुश और PR पर चलता है:
- **बिल्ड + टेस्ट**: Ubuntu, macOS, GCC 10-14, Clang 14-18
- **व्यापक परीक्षण**: ~240 एल्गोरिदम संयोजन परीक्षण
- **स्टैटिक विश्लेषण**: cppcheck, Clang analyzer, GCC `-fanalyzer`
- **MISRA C 2012**: cppcheck `--addon=misra` सभी wolfCOSE कोड पथों की जाँच करता है
- **MISRA C 2023**: सख्त GCC चेतावनियाँ और clang-tidy (`bugprone-*`, `cert-*`, `clang-analyzer-*`, `misc-*`)
- **Coverity Scan**: रात्रिकालीन दोष विश्लेषण
- **आंतरिक स्टैटिक विश्लेषण:** Fenrir wolfssl उन्नत स्टैटिक विश्लेषण उपकरण
- **कोड कवरेज**: प्रत्येक wolfCOSE स्रोत फ़ाइल के लिए 100% लाइन कवरेज लागू
```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>
## दस्तावेज़ीकरण
आधिकारिक wolfCOSE मैनुअल [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): बिल्ड निर्देश और पहले कदम
- [Message Types](https://www.wolfssl.com/documentation/manuals/wolfcose/Message-Types.html): सभी छह RFC 9052 संदेश (Sign1, Sign, Encrypt0, Encrypt, Mac0, Mac) और कोड नमूनों के साथ RFC 9338 काउंटरसिग्नेचर
- [Algorithms](https://www.wolfssl.com/documentation/manuals/wolfcose/Algorithms.html): COSE IDs के साथ 41 समर्थित एल्गोरिदम की पूरी सूची
- [API Reference](https://www.wolfssl.com/documentation/manuals/wolfcose/API-Reference.html): फ़ंक्शन हस्ताक्षर, डेटा संरचनाएँ, त्रुटि कोड
- [Macros](https://www.wolfssl.com/documentation/manuals/wolfcose/Macros.html): कंपाइल-टाइम कॉन्फ़िगरेशन, आकार ट्यूनिंग, और ECDSA नॉन्स नीति
- [PSA-EAT](https://www.wolfssl.com/documentation/manuals/wolfcose/PSA-EAT.html): RFC 9783 PSA टोकन प्रोफ़ाइल, API, मैक्रो, और सुरक्षा मार्गदर्शन
- [Footprint](https://www.wolfssl.com/documentation/manuals/wolfcose/Footprint.html): आकार और गति संख्याएँ, डेस्कटॉप और डिवाइस पर
- [Testing](https://www.wolfssl.com/documentation/manuals/wolfcose/Testing.html): टेस्ट इंफ्रास्ट्रक्चर, कवरेज, और विफलता इंजेक्शन
- [MISRA Compliance](https://www.wolfssl.com/documentation/manuals/wolfcose/MISRA-Compliance.html): MISRA C:2012 और C:2023 अनुपालन स्थिति और विचलन तर्क
- [Project Structure](https://www.wolfssl.com/documentation/manuals/wolfcose/Project-Structure.html): स्रोत फ़ाइल लेआउट
- [STM32Cube](https://www.wolfssl.com/documentation/manuals/wolfcose/STM32Cube.html): डिवाइस पर wolfCOSE को STM32Cube पैक के रूप में इंस्टॉल और चलाएँ
मैनुअल स्रोत [`docs/`](https://github.com/wolfssl/wolfcose/blob/main/docs) में हैं; `mkdocs.yml` नेविगेशन को परिभाषित करता है और साझा [`wolfSSL/documentation`](https://github.com/wolfSSL/documentation) टूलींग HTML और PDF बनाती है। स्थानीय पूर्वावलोकन और परिवर्तन वेबसाइट तक कैसे पहुँचते हैं, इसके लिए [docs/dev/DOCS-BUILD.md](https://github.com/wolfssl/wolfcose/blob/main/docs/dev/DOCS-BUILD.md) देखें।
## रिलीज़ नोट्स
वर्तमान रिलीज़ **2.0.0** है। यह मानकीकृत HSS/LMS हस्ताक्षर (RFC 8778), COSE काउंटरसिग्नेचर (RFC 9338), PSA/EAT अटेस्टेशन (RFC 9783), RFC 9864 हस्ताक्षर IDs, प्रतिनिधि साइनिंग, विस्तारित कुंजी और CBOR API, प्रायोगिक COSE-HPKE, और व्यापक हार्डनिंग जोड़ता है, सभी शून्य डायनामिक आवंटन के साथ। पूर्ण रिलीज़ नोट्स के लिए [ChangeLog.md](https://github.com/wolfssl/wolfcose/blob/main/ChangeLog.md) देखें।
wolfCOSE 2.0.0 को wolfSSL की विकास और QA प्रक्रिया (देखें https://www.wolfssl.com/about/wolfssl-software-development-process-quality-assurance) के अनुसार विकसित किया गया है और इसने गुणवत्ता मानदंडों को सफलतापूर्वक पार कर लिया है।
## लाइसेंस
wolfCOSE [GPLv3](https://www.gnu.org/licenses/gpl-3.0.html) के अंतर्गत लाइसेंस प्राप्त मुफ्त सॉफ़्टवेयर है; पूर्ण पाठ के लिए [LICENSE](https://github.com/wolfssl/wolfcose/blob/main/LICENSE) देखें।
Copyright (C) 2026 wolfSSL Inc.
## समर्थन
व्यावसायिक लाइसेंसिंग, पेशेवर समर्थन अनुबंध, या wolfCOSE को अपने उत्पादन वातावरण में ले जाने पर चर्चा करने के लिए, [wolfSSL](https://www.wolfssl.com/contact/) से संपर्क करें।