NodeCrypto 도움말

Hybrid KEM Decapsulate

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

하이브리드 비밀키와 암호문으로 공유 비밀을 역캡슐화한다

개요

수신자의 2,432바이트 하이브리드 비밀키(X25519 + ML-KEM-768)와 1,120바이트 하이브리드 암호문을 사용하여 X25519 ECDH와 ML-KEM-768 역캡슐화를 각각 수행하고, 두 공유 비밀을 결합해 32바이트 최종 하이브리드 공유 비밀(Shared Secret)을 복원한다.

사용 시점

파라미터 설정

이 노드는 속성창에서 설정할 수 있는 별도의 정적 파라미터가 없으며, 알고리즘 규격과 연결된 포트 값에 의해서만 동작이 결정된다.

포트 입출력 명세

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

입력 포트

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

포트 이름포트 ID데이터 타입필수 여부노출 조건설명
Hybrid Secret Key secretKey Bytes 필수 항상 노출 수신자의 2,432바이트 하이브리드 비밀키(X25519 32B || ML-KEM-768 2400B)이다.
Hybrid Ciphertext ciphertext Bytes 필수 항상 노출 1,120바이트 하이브리드 암호문(임시 X25519 공개키 32B || ML-KEM-768 암호문 1088B)이다.

출력 포트

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

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

오류 케이스

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

오류 코드기본 엔진 메시지발생 조건
INVALID_KEY_MATERIAL 키 길이 또는 형식이 올바르지 않는다 Hybrid Secret Key가 2,432바이트가 아니거나 Hybrid Ciphertext가 1,120바이트가 아닐 때 발생한다.

활용 예시

하이브리드 KEM 암호문 역캡슐화하기

2,432바이트 비밀키와 1,120바이트 암호문으로 32바이트 공유 비밀을 복원한다.

  1. Hybrid KEM KeyGen의 Hybrid Secret Key와 Hybrid KEM Encapsulate의 Hybrid Ciphertext를 Hybrid KEM Decapsulate에 연결한다.