임베디드 시스템을 위한 빠르고, 이식성이 뛰어나며, 가벼운 COSE + CBOR 구현체입니다. PQC, FIPS 140-3, DO-178 및 MISRA C를 지원합니다. wolfSSL 기반입니다.
wolfCOSE는 핵심 CBOR 및 COSE 표준을 구현한 경량 고속 C 라이브러리로, 암호화를 위해 wolfSSL을 기반으로 합니다.
COSE_Sign1, COSE_Encrypt0, COSE_Mac0을 포함한 6가지 메시지 유형 모두를 완벽하게 지원합니다.COSE_Sign1은 ES256으로 66,538 sign/s 및 26,437 verify/s에 도달하며, ML-DSA-44로 21,986 sign/s 및 53,686 verify/s를 기록합니다. 성능 및 풋프린트 세부 정보와 wolfCOSE vs. The Field를 참조하세요..data/.bss 제로). 호출자가 제공한 버퍼에서 동작하며 스택 사용량이 제한적입니다.I-CUBE-wolfCOSE) 제공 (세부 정보).ESP256, ESP384, ESP512, Ed25519, Ed448, PS256, PS384, PS512ML-DSA-44, ML-DSA-65, ML-DSA-87HSS-LMSAES-GCM (128 / 192 / 256)AES-CCM (변형)ChaCha20-Poly1305HMAC-SHA256, HMAC-SHA384, HMAC-SHA512AES-MACDirectAES Key WrapECDH-ES + HKDFwolfCOSE는 모든 RFC 9052 메시지의 단일 액터 및 다중 액터 변형을 모두 구현했습니다:
| Message | RFC 9052 | API | Purpose |
|---|---|---|---|
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로 독립적으로 검증하세요.
wolfCOSE는 암호화 백엔드로 wolfSSL을 필요로 합니다. 최소 지원 버전: v5.8.0-stable. 일부 선택적 알고리즘은 더 최신 릴리스를 필요로 합니다. 기능별 의존성 하한 및 빌드 지침은 시작하기를 참조하세요. HSS/LMS (RFC 8778)는 v5.9.2-stable 이상이 필요합니다.
필요한 알고리즘에 따라 빌드 구성을 선택하세요.
COSE Sign1 (ESP256/384/512) 및 Encrypt0 (AES-GCM)을 사용할 수 있습니다:
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 풋프린트를 원한다면 --enable-cryptonly를 추가하여 TLS
스택을 제거하고 Sign1 + Encrypt0 빌드에서 절대 사용하지 않는 알고리즘을
비활성화하세요:
./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를 더욱 압축하는 방법은 크기 최적화 및 속도 최적화를 참조하세요.
ML-DSA-44/65/87을 사용한 순수 양자 내성 서명의 경우:
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이 필요합니다.)
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
# 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
| Target | Description |
|---|---|
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 검증 전용 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 검증모든 푸시 및 PR에서 실행됩니다:
-fanalyzer--addon=misrabugprone-*, cert-*, clang-analyzer-*, misc-*)make coverage # Run tests with gcov
make coverage-force-failure # Include crypto failure path testing