NodeCrypto 도움말

DES Encrypt

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

단일 DES(유효 56비트, 8바이트 키) 암호화 (FIPS 46-3, 레거시)

개요

FIPS 46-3 레거시 단일 DES(Data Encryption Standard) 64비트(8바이트) 파이스텔(Feistel) 블록 암호로 평문을 암호화한다. 8바이트(64비트, 유효 키 56비트 + 패리티 8비트) 키를 사용한다.

단일 DES는 56비트 키 공간이 작아 현대 보안 용도로는 안전하지 않으며, 레거시 프로토콜 분석, 스마트카드/EMV 세션 키 파생 구성 요소, 또는 역사적 테스트 벡터 검증 용도로만 사용해야 한다.

사용 시점

파라미터 설정

파라미터 (ID)타입 및 기본값노출 조건설명 및 옵션
암호 운영 모드
mode		 select
기본값: ECB		 항상 노출 64비트 블록 운용 모드(ECB, CBC, CFB, OFB, CTR)이다. 자세한 내용은 블록 암호 운용 모드를 참고한다.
  • ECB: ECB (Electronic Codebook)
  • CBC: CBC (Cipher Block Chaining)
패딩
padding		 select
기본값: None		 항상 노출 ECB/CBC 모드에서 적용할 8바이트 블록 패딩 방식이다. 자세한 내용은 패딩 스킴을 참고한다.
오류 단일화
errorUnify		 boolean
기본값: false
변수 참조 지원 ($var: bool)		 항상 노출 활성화하면 내장 오류를 지정한 단일 오류 코드·메시지로 대체한다.
단일화 오류 코드
errorUnifyCode		 text
기본값: "" (비움)
변수 참조 지원 ($var: string)		 errorUnify가 true 일 때 오류 통합 활성화 시 사용할 오류 코드이다.
단일화 오류 메시지
errorUnifyMessage		 text
기본값: "" (비움)
변수 참조 지원 ($var: string)		 errorUnify가 true 일 때 오류 통합 활성화 시 사용할 오류 메시지이다.

포트 입출력 명세

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

입력 포트

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

포트 이름포트 ID데이터 타입필수 여부노출 조건설명
Key key Bytes (8B) 필수 항상 노출 8바이트(64비트) DES 키이다.
Plaintext plaintext Bytes 필수 항상 노출 암호화할 평문 바이트 배열(Uint8Array)이다.
IV iv Bytes (8B) 선택 mode가 CBC 일 때 8바이트(64비트) 초기화 벡터이다.

출력 포트

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

포트 이름포트 ID데이터 타입노출 조건설명
Ciphertext ciphertext Bytes 항상 노출 암호화된 바이트 배열(Uint8Array)이다.

오류 케이스

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

오류 코드기본 엔진 메시지발생 조건
INVALID_KEY_LENGTH 키 길이가 올바르지 않는다 Key가 정확히 8바이트가 아닐 때 발생한다.
PLAINTEXT_NOT_BLOCK_ALIGNED NoPad 모드에서는 평문 길이가 블록 크기의 배수여야 한다 ECB/CBC 모드에서 Padding = None인데 평문 길이가 8바이트의 양의 배수가 아닐 때 발생한다.

활용 예시

8바이트 단일 DES-ECB 블록 암호화하기

8바이트 키로 8바이트 평문 블록을 암호화한다.

  1. DES Encrypt의 운용 모드를 ECB, 패딩을 None으로 두고 8바이트 Key와 8바이트 Plaintext를 연결한다.