Hybrid KEM Encapsulate

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

하이브리드 X25519 + ML-KEM-768 수신자 공개키로 공유 비밀을 캡슐화한다

개요

수신자의 1,216바이트 하이브리드 공개키(X25519 + ML-KEM-768)에 대해 임시 X25519 키 교환과 ML-KEM-768 캡슐화를 동시에 수행한 뒤, 두 32바이트 공유 비밀을 결합해 SHA-256으로 해시한 32바이트 최종 하이브리드 공유 비밀(Shared Secret)과 1,120바이트 하이브리드 암호문(임시 X25519 공개키 32B || ML-KEM-768 암호문 1,088B)을 출력한다.

사용 시점

Hybrid KEM KeyGen으로 생성된 수신자 공개키에 대해 하이브리드 양자내성 키 캡슐화를 수행할 때 사용한다.

파라미터 설정

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

포트 입출력 명세

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

입력 포트

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

포트 이름	포트 ID	데이터 타입	필수 여부	노출 조건	설명
`Recipient Public Key`	`publicKey`	`Bytes`	필수	항상 노출	수신자의 1,216바이트 하이브리드 공개키(`X25519 32B \|\| ML-KEM-768 1184B`)이다.

출력 포트

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

포트 이름	포트 ID	데이터 타입	노출 조건	설명
`Shared Secret`	`sharedSecret`	`Bytes` (Combined)	항상 노출	파생된 32바이트(256비트) 하이브리드 공유 비밀이다.
`Hybrid Ciphertext`	`ciphertext`	`Bytes`	항상 노출	1,120바이트 하이브리드 캡슐화 암호문(`임시 X25519 공개키 32B \|\| ML-KEM-768 암호문 1088B`)이다.

오류 케이스

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

오류 코드	기본 엔진 메시지	발생 조건
`INVALID_KEY_MATERIAL`	키 길이 또는 형식이 올바르지 않는다	`Hybrid Public Key`가 정확히 1,216바이트가 아니거나 내부 공개키 성분이 유효하지 않을 때 발생한다.

활용 예시

하이브리드 KEM 공유 비밀 캡슐화하기

1,216바이트 하이브리드 공개키로 1,120바이트 암호문과 32바이트 공유 비밀을 만든다.

Hybrid KEM KeyGen의 Hybrid Public Key를 Hybrid KEM Encapsulate에 연결한다.