ValueSet

카테고리: 입출력 데이터 · 노드 타입 ID: input-value-set

값 세트: 각 행이 출력 포트이며 값은 고정값, 난수, 또는 행 자신의 입력 포트에서 가져온 값이다

개요

이름과 타입이 지정된 여러 행(예: Key, IV, Plaintext, Expected)을 하나의 구조화된 ValueSet으로 묶는다. 각 행은 독립된 출력 포트로 값을 내보내는 동시에 전체 행이 Set 번들 출력 포트로 함께 패키징된다.

각 행은 고정(Fixed) 상수, 난수(Random) 생성기, 또는 해당 행 전용 동적 입력 포트에서 값을 받는 포트(Port) 모드 중 하나로 동작할 수 있다.

완전한 암호화 테스트 벡터(예: NIST KAT 벡터 A, 벡터 B, 벡터 C)를 정리하고 Switch 노드로 한 번에 전환하며 시험할 때 사용한다.
여러 파이프라인 신호를 하나의 Set 와이어로 묶어 깔끔하게 전달할 때 사용한다.

ValueSet은 노드 카드와 속성창의 행 테이블 에디터로 설정한다. 각 행마다 다음 항목을 지정한다:

행 이름(Row Name): 출력 포트(및 Port 모드일 때의 대응 입력 포트)에 표시할 레이블(예: Key, IV, Plaintext).
데이터 타입(Data Type): Bytes, String, Int, Bool 중 선택.
값 공급원(Source Mode):
- Fixed: 행 에디터에 입력한 상수 리터럴(16진수 바이트, 텍스트, 정수, 불리언)을 사용한다.
- Random: 지정한 길이 또는 범위의 암호학적 난수를 생성한다.
- Port: 노드의 왼쪽에 이 행과 같은 이름·타입의 입력 포트를 노출하여 상위 노드의 출력을 받아 전달한다.

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

항목	명세
포트 성격	가변 입력 포트(행의 공급원이 `Port`일 때 생성)
캔버스 초기 기본값	0개(기본 행 `out_1`은 `Fixed` 모드로 시작하므로 입력 포트가 없다).
포트 개수 범위	입력 포트 0개 이상(`Port` 모드로 설정된 행마다 정확히 1개).
허용 데이터 타입	`Bytes`, `String`, `Int`, `Bool`(해당 행의 타입과 일치).
포트 추가 및 관리	ValueSet 에디터에서 행의 공급원 모드를 `Port`로 바꾸면 대응하는 입력 포트가 생기고, `Fixed`나 `Random`으로 바꾸면 사라진다.
평가 및 순서 규칙	입력 포트는 ValueSet 테이블에서 `Port` 모드 행이 나타나는 위→아래 순서대로 정렬된다.

항목	명세
포트 성격	가변 행 출력 포트 + 고정 `Set` 번들 출력 포트 1개
캔버스 초기 기본값	행 출력 포트 1개(`Value 1`, ID `out_1`, 타입 `Bytes`) + 고정 `Set` 출력 포트 1개(ID `set`, 타입 `Set`).
포트 개수 범위	행 출력 포트 1개 이상 + 고정 `Set` 출력 포트 1개.
허용 데이터 타입	행 출력 포트: `Bytes`, `String`, `Int`, `Bool`. 번들 포트 `set`: `Set`.
포트 추가 및 관리	노드 카드나 속성창에서 행을 추가·삭제·이름 변경·순서 변경하면 개별 출력 포트와 `Set` 번들 스키마가 즉시 갱신된다.
평가 및 순서 규칙	개별 행 출력 포트가 테이블 순서대로 먼저 배치되고, 마지막에 `Set` 번들 포트가 위치한다.

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

포트 이름	포트 ID	데이터 타입	노출 조건	설명
`Set`	`set`	`Set`	항상 노출	모든 행의 값을 순서와 타입이 보존된 하나의 `Set` 번들로 묶어 내보낸다. Switch 노드의 입력 포트에 연결할 수 있다.

이 노드는 런타임 실패 케이스가 없으며(errorProfile: none), 타입이 맞는 모든 입력에 대해 항상 성공한다.

서로 다른 두 개의 AES-128 키/평문 세트를 준비하고 Switch 노드로 전환한다.

ValueSet 노드 두 개(Vector 1, Vector 2)를 배치하고 각각 Key(Bytes), IV(Bytes), Plaintext(Bytes) 세 행을 구성한다.
두 노드의 Set 출력 포트를 Switch 노드의 Set 1과 Set 2 입력에 연결한다.
Switch 노드가 선택한 세트의 개별 Key, IV, Plaintext 출력 포트를 암호화 파이프라인에 연결한다.