SEED Decrypt

카테고리: 대칭키 암호 · 노드 타입 ID: symmetric-seed-decrypt

KISA 국가표준 SEED 128/256비트 블록 암호 복호화

개요

KISA 국가 표준 128비트 블록 암호 SEED(SEED-128 / SEED-256)로 암호화된 데이터를 복호화하고, AEAD 모드(GCM, CCM)에서는 16바이트 인증 태그를 검증한다.

파라미터 (ID)	타입 및 기본값	노출 조건	설명 및 옵션
암호 운영 모드 `mode`	`select` 기본값: `ECB`	항상 노출	암호화에 사용된 운용 모드(`ECB`, `CBC`, `CFB`, `OFB`, `CTR`, `GCM`, `CCM`)이다. 자세한 내용은 블록 암호 운용 모드를 참고한다. `ECB`: ECB (Electronic Codebook) `CBC`: CBC (Cipher Block Chaining) `GCM`: GCM (AEAD) `CCM`: CCM (AEAD) `CTR`: CTR (Counter Mode)
패딩 `padding`	`select` 기본값: `None`	항상 노출	`ECB`/`CBC` 모드에서 제거할 16바이트 블록 패딩 방식이다. 자세한 내용은 패딩 스킴을 참고한다. `None`: 없음 `ISO7816`: ISO/IEC 9797-1 방법 2 (ISO/IEC 7816-4) `ISO97971M3`: ISO/IEC 9797-1 방법 3 `PKCS7`: PKCS#7 (RFC 5652) `ANSIX923`: ANSI X9.23
오류 단일화 `errorUnify`	`boolean` 기본값: `false` 변수 참조 지원 (`$var`: `bool`)	항상 노출	활성화하면 내장 오류를 지정한 단일 오류 코드·메시지로 대체한다.
단일화 오류 코드 `errorUnifyCode`	`text` 기본값: `""` (비움) 변수 참조 지원 (`$var`: `string`)	`errorUnify`가 `true` 일 때	오류 통합 활성화 시 사용할 오류 코드이다.
단일화 오류 메시지 `errorUnifyMessage`	`text` 기본값: `""` (비움) 변수 참조 지원 (`$var`: `string`)	`errorUnify`가 `true` 일 때	오류 통합 활성화 시 사용할 오류 메시지이다.

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

포트 성격: 고정 입력 포트 (총 6개; 조건부 노출 포트는 아래 표와 같이 파라미터 설정에 따라 전환됨).

포트 이름	포트 ID	데이터 타입	필수 여부	노출 조건	설명
`Key`	`key`	`Bytes` (16/32B)	필수	항상 노출	16바이트(SEED-128) 또는 32바이트(SEED-256) 키이다.
`Ciphertext`	`ciphertext`	`Bytes`	필수	항상 노출	복호화할 SEED 암호문 바이트 배열(`Uint8Array`)이다.
`IV`	`iv`	`Bytes` (16B)	선택	`mode`가 `CBC` 또는 `CTR` 일 때	16바이트 초기화 벡터이다.
`Nonce`	`nonce`	`Bytes` (12B)	선택	`mode`가 `GCM` 또는 `CCM` 일 때	12바이트 AEAD Nonce(`GCM`, `CCM`)이다.
`Auth Tag`	`tag`	`Bytes` (GCM/CCM)	선택	`mode`가 `GCM` 또는 `CCM` 일 때	`GCM`/`CCM` 모드에서 검증할 16바이트 인증 태그(필수)이다.
`AAD`	`aad`	`Bytes` (GCM/CCM)	선택	`mode`가 `GCM` 또는 `CCM` 일 때	선택적 추가 인증 데이터(AAD)이다.

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

포트 이름	포트 ID	데이터 타입	노출 조건	설명
`Plaintext`	`plaintext`	`Bytes`	항상 노출	복호화된 원본 평문 바이트 배열(`Uint8Array`)이다.

실행 중 아래 조건이 발생하면 이 노드는 ERROR 상태가 되며, 출력 포트에 연결된 하위 노드는 실행되지 않는다. 오류 통합(errorUnify)을 활성화하면 아래의 모든 오류 코드가 사용자가 지정한 단일 오류 코드와 메시지로 대체된다.

오류 코드	기본 엔진 메시지	발생 조건
`INVALID_KEY_LENGTH`	키 길이가 올바르지 않는다	`Key` 길이가 16바이트 또는 32바이트가 아닐 때 발생한다.
`INVALID_IV_LENGTH`	IV 길이가 올바르지 않는다	연결된 `IV`가 16바이트가 아닐 때 발생한다.
`CIPHERTEXT_NOT_BLOCK_ALIGNED`	암호문 길이가 블록 크기의 배수가 아니다	`ECB`/`CBC` 모드에서 암호문 길이가 16바이트의 양의 배수가 아닐 때 발생한다.
`INVALID_PADDING`	패딩이 올바르지 않는다	`ECB`/`CBC` 모드에서 패딩 검증에 실패했을 때 발생한다.
`INVALID_NONCE_LENGTH`	Nonce 길이가 올바르지 않는다	연결된 `Nonce`가 12바이트가 아닐 때 발생한다.
`INVALID_TAG_LENGTH`	인증 태그 길이가 올바르지 않는다	연결된 `Auth Tag`가 16바이트가 아닐 때 발생한다.
`AUTH_TAG_MISMATCH`	인증 태그가 일치하지 않는다	`GCM`/`CCM` 인증 태그 검증에 실패했을 때 발생한다.

16바이트 키와 16바이트 IV로 SEED 암호문을 복원한다.

SEED Decrypt에 16바이트 Key, 16바이트 IV, Ciphertext를 연결하여 Plaintext를 확인한다.