NodeCrypto 도움말

ML-KEM Decapsulate

카테고리: 양자내성암호 · 노드 타입 ID: pqc-mlkem-decaps

비밀키와 암호문으로 공유 키를 역캡슐화한다

개요

수신자의 NIST FIPS 203 ML-KEM 비밀키(dk)와 수신한 KEM 암호문(Ciphertext)을 사용하여 32바이트(256비트) 공유 비밀(Shared Secret)을 역캡슐화(복원)한다.

FIPS 203은 후지사키-오카모토(Fujisaki-Okamoto) 변환을 통한 적응적 선택 암호문 공격(IND-CCA2) 방어를 위해 변조된 암호문이 입력될 경우 명시적 오류 대신 비밀키 시드로부터 파생된 결정론적 의사난수 키를 암묵적으로 반환(Implicit Rejection)한다.

사용 시점

파라미터 설정

파라미터 (ID)타입 및 기본값노출 조건설명 및 옵션
변형
variant
select
기본값: 768
항상 노출 이 노드의 변형 설정을 지정한다.
  • 512: ML-KEM-512
  • 768: ML-KEM-768
  • 1024: ML-KEM-1024

포트 입출력 명세

포트 연결 규칙, 데이터 타입별 색상, 가변 포트 생성 방식은 포트 및 연결 문서를 참고한다.

입력 포트

포트 성격: 고정 입력 포트 (총 2개).

포트 이름포트 ID데이터 타입필수 여부노출 조건설명
Secret Key secretKey Bytes 필수 항상 노출 수신자의 ML-KEM 비밀키(1,632 / 2,400 / 3,168바이트)이다.
Ciphertext ciphertext Bytes 필수 항상 노출 발신자로부터 받은 KEM 암호문(768 / 1,088 / 1,568바이트)이다.

출력 포트

포트 성격: 고정 출력 포트 (총 1개).

포트 이름포트 ID데이터 타입노출 조건설명
Recovered Shared Key sharedSecret Bytes (32B) 항상 노출 복원된 32바이트(256비트) 공유 비밀이다.

오류 케이스

실행 중 아래 조건이 발생하면 이 노드는 ERROR 상태가 되며, 출력 포트에 연결된 하위 노드는 실행되지 않는다.

오류 코드기본 엔진 메시지발생 조건
INVALID_KEY_MATERIAL 키 길이 또는 형식이 올바르지 않는다 Secret Key 또는 Ciphertext의 바이트 길이가 선택한 paramSet 규격과 일치하지 않을 때 발생한다.

활용 예시

ML-KEM-768 암호문 역캡슐화하여 공유 비밀 복원하기

비밀키와 암호문으로 발신자와 동일한 32바이트 공유 비밀을 얻는다.

  1. ML-KEM KeyGen (FIPS 203)의 Secret Key와 ML-KEM Encapsulate의 Ciphertext를 ML-KEM Decapsulate에 연결한다.