PQClean 다운로드 - PQClean 소스 코드 다운로드

PQClean

C# 소스 코드

version before round-4 candidates were removed

다운로드

PQ클린

여기에서 각 구성요소의 빌드 상태를 확인하세요.

간단히 말해서 PQClean 은 NIST 포스트 퀀텀 프로젝트에 있는 포스트 퀀텀 체계의 깔끔한 구현을 수집하려는 노력입니다. PQClean의 목표는 다음과 같은 독립 실행형 구현을 제공하는 것입니다.

liboqs와 같은 라이브러리에 쉽게 통합될 수 있습니다.
Open Quantum Safe와 같은 더 높은 수준의 프로토콜 통합 노력으로 효율적으로 업스트림할 수 있습니다.
SUPERCOP과 같은 벤치마킹 프레임워크에 쉽게 통합될 수 있습니다.
pqm4와 같은 임베디드 플랫폼을 대상으로 하는 프레임워크에 쉽게 통합될 수 있습니다.
아키텍처별 최적화 구현에 적합한 시작점입니다.
구현 보안을 평가하기 위한 적절한 출발점이 됩니다. 그리고
공식 검증에 적합한 대상입니다.

PQClean이 목표로 하지 않는 것은

모든 구성표의 통합 라이브러리를 생성하는 빌드 시스템;
구현 벤치마킹 포함 그리고
더 높은 수준의 애플리케이션이나 프로토콜로의 통합을 포함합니다.

첫 번째 주요 목표로 아래 나열된 요구 사항을 충족하는 C 구현을 수집하고 있습니다. 또한 최적화된 구현도 허용하지만 여전히 고품질의 테스트된 코드가 필요합니다.

PQClean에 계획을 추가하는 데 관심이 있는 경우 기여자를 위한 지침도 검토하십시오.

PQ클린페이퍼

PQClean 작업 중에 배운 교훈을 요약하려면 다음을 참조하세요.

Matthias J. Kannwischer, Peter Schwabe, Douglas Stebila 및 Thom Wiggers. “암호화 표준화 프로젝트의 소프트웨어 품질 개선.” In: 보안 표준화 연구 – EuroS&P 워크숍 2022. 2022.

https://eprint.iacr.org/2022/337에서 논문을 찾으세요.

PQClean을 언급할 때 다음 작품을 인용해 주세요.

 @inproceedings { SSR:KSSW22 ,
  author    = { Matthias J. Kannwischer and
               Peter Schwabe and
               Douglas Stebila and
               Thom Wiggers } ,
  title     = { Improving Software Quality in Cryptography Standardization Projects } ,
  booktitle = { {IEEE} European Symposium on Security and Privacy, EuroS{&}P 2022 - Workshops, Genoa, Italy, June 6-10, 2022 } ,
  pages     = { 19--30 } ,
  publisher = { IEEE Computer Society } ,
  address   = { Los Alamitos, CA, USA } ,
  year      = { 2022 } ,
  url       = { https://eprint.iacr.org/2022/337 } ,
  doi       = { 10.1109/EuroSPW55150.2022.00010 } ,
}

PQClean에 포함된 많은 구현은 독창적인 연구 프로젝트 자체에서 비롯되었으며 해당 작성자도 인용되는 것을 높이 평가할 것입니다.

자동으로 확인되는 C 구현 요구사항

이 목록의 항목을 확인하는 작업은 아직 개발 중입니다. 확인된 항목이 작동해야 합니다.

수동으로 확인되는 C 구현에 대한 요구 사항

미니멀리스트 메이크파일
문자열화 매크로 없음
함수의 출력 매개변수 포인터는 왼쪽에 있습니다.
내보낸 모든 기호는 제자리에 네임스페이스가 지정됩니다.
정수 유형은 stdint.h 유형을 사용하여 관련 있는 고정 크기입니다(선택 사항, 권장).
메모리 인덱싱에 사용되는 정수 크기는 size_t 입니다(선택 사항, 권장).
처음에 변수 선언( for (size_t i=... 제외))(선택 사항, 권장)

현재 PQClean에 있는 구성표

다음 구성표의 경우 매개변수 세트 중 하나 이상을 구현했습니다. 이러한 모든 구성표에 대해 깨끗한 C 코드가 있지만 일부의 경우 최적화된 코드도 있습니다.

주요 캡슐화 메커니즘

결선 진출자:

카이버

대체 후보:

HQC
클래식 맥엘리스

서명 방식

향후 표준:

디리튬
매
스핑크스+

대체 후보:

아직 참가자가 없습니다.

이전에 PQClean에서 사용 가능했고 NIST 표준화 노력의 3라운드에서 삭제된 구현을 round2 태그에서 사용할 수 있습니다.

이전에 PQClean에서 사용 가능했고 NIST 표준화 노력의 4라운드에서 삭제된 구현을 round3 태그에서 사용할 수 있습니다.

PQClean에서 사용하는 API

PQClean은 기본적으로 SUPERCOP 및 libpqcrypto에서도 사용되는 NIST 참조 구현에 필요한 것과 동일한 API를 사용합니다. 해당 API와의 유일한 차이점은 다음과 같습니다.

모든 함수는 네임스페이스를 갖습니다.
모든 길이는 unsigned long long 대신 size_t 유형으로 전달됩니다. 그리고
서명은 서명된 메시지를 생성하고 복구하는 대신 서명을 계산하고 확인하는 대부분의 소프트웨어 스택에 사용되는 "전통적인" 접근 방식을 따르는 두 가지 추가 기능을 제공합니다. 특히 해당 함수의 이름과 서명은 다음과 같습니다.

 int PQCLEAN_SCHEME_IMPL_crypto_sign_signature (
    uint8_t * sig , size_t * siglen ,
    const uint8_t * m , size_t mlen ,
    const uint8_t * sk );
int PQCLEAN_SCHEME_IMPL_crypto_sign_verify (
    const uint8_t * sig , size_t siglen ,
    const uint8_t * m , size_t mlen ,
    const uint8_t * pk );

PQClean 구축

위에서 언급했듯이 PQClean은 단일 라이브러리로 구축하기 위한 것이 아닙니다 . 이는 다른 라이브러리에 쉽게 통합될 수 있는 소스 코드 모음입니다. PQClean 저장소에는 다양한 파일을 빌드하는 다양한 테스트 프로그램이 포함되어 있지만 결과 바이너리를 사용하면 안 됩니다.

필수 종속성 목록: gcc or clang, make, python3, python-yaml library, valgrind, astyle (>= 3.0) .

자신의 프로젝트에서 PQClean의 소스 코드 사용

PQClean의 각 구현 디렉터리(예: crypto_kem/kyber768_clean)를 추출하여 자신의 프로젝트에 사용할 수 있습니다. 다음을 수행해야 합니다.

구현 디렉터리의 소스 코드를 프로젝트에 복사합니다.
프로젝트의 빌드 시스템에 파일을 추가합니다.
구현에 사용되는 일반적인 암호화 알고리즘의 인스턴스화를 제공합니다. 여기에는 common/randombytes.h (암호화 난수 생성기) 및 common/sha2.h (SHA-2 해시 함수 제품군), common/aes.h (AES 구현), common/fips202.h ( SHA-3 해시 함수 제품군) 및 common/sp800-185.h (cSHAKE 제품군). common/ 폴더의 구현을 사용할 수 있지만 가장 성능이 뛰어난 구현은 아닐 수 있으며 테스트 목적으로 불필요한 작업(예: 힙 할당)을 수행할 수 있습니다.

#2와 관련하여 프로젝트의 빌드 시스템에 파일을 추가하면 PQClean의 각 구현에는 해당 구현을 위한 파일을 빌드하는 방법을 보여주는 두 개의 makefile 예제가 함께 제공됩니다.

GNU Make, BSD Make 및 기타 가능하게 사용할 수 있는 Makefile 파일입니다.
Visual Studio의 nmake와 함께 사용할 수 있는 Makefile.Microsoft_nmake 파일.

PQClean 배포 소스 코드를 통합하는 프로젝트

다음 프로젝트는 PQClean의 구현을 사용하고 구현 주위에 자체 래퍼를 제공합니다. 그들의 통합 전략은 귀하의 프로젝트에 대한 예가 될 수 있습니다.

QuantCrypt : 사전 컴파일된 PQClean 바이너리를 사용하는 포스트 양자 암호화용 크로스 플랫폼 Python 라이브러리
pqcrypto crate : PQClean 소스 코드에서 래퍼를 자동으로 생성하는 Rust 통합입니다.
mupq : PQClean의 구현을 참조 구현으로 실행하여 마이크로컨트롤러에 최적화된 코드와 비교합니다.
node-pqclean : WebAssembly를 통해 Deno 및 웹 플랫폼은 물론 Node.js를 기본적으로 지원하는 PQClean용 JavaScript 인터페이스입니다.
Open Quantum Safe : Open Quantum Safe 프로젝트는 PQClean의 구현을 liboqs C 라이브러리에 통합한 다음 C++, C#/.NET 및 Python 래퍼는 물론 OpenSSL 및 OpenSSH 포크를 통해 노출합니다.

특허

구현을 포함하는 각 하위 디렉터리에는 특정 구현이 릴리스되는 라이센스를 나타내는 LICENSE 파일이 포함되어 있습니다. common 파일에는 파일 상단에 라이센스 정보가 포함되어 있으며 현재는 공개 도메인이거나 MIT입니다. 이 저장소의 다른 모든 코드는 CC0 조건에 따라 릴리스됩니다.

로컬에서 테스트 실행

PQClean 테스트 프레임워크에 대한 자세한 내용은 https://github.com/PQClean/PQClean/wiki/Test-framework를 참조하세요.

Github Actions((에뮬레이션된) Linux 빌드, MacOS 및 Windows 빌드) 및 Travis CI(Aarch64 빌드)에 대해 광범위한 자동 테스트를 실행하며 대부분의 테스트는 로컬에서도 실행할 수 있습니다. 이렇게 하려면 다음이 설치되어 있는지 확인하세요.