NodeCrypto 도움말

RSA Decrypt

카테고리: 비대칭키 & 타원곡선 · 노드 타입 ID: asymmetric-rsa-decrypt

개인키로 RSA-OAEP 암호문을 복호화한다 (RFC 8017)

개요

수신자의 RSA 개인키와 PKCS#1 v2.2(RFC 8017) 표준 RSAES-OAEP 스킴을 사용하여 암호문을 복호화하고 OAEP 패딩 및 레이블 해시를 검증한다.

사용 시점

파라미터 설정

파라미터 (ID)타입 및 기본값노출 조건설명 및 옵션
해시 알고리즘 (OAEP 및 MGF1)
hash
select
기본값: SHA-256
항상 노출 이 노드의 해시 알고리즘 (OAEP 및 MGF1) 설정을 지정한다.
  • SHA-256: SHA-256 (표준)
  • SHA-512: SHA-512 (고보안)
  • SHA-384: SHA-384
  • SHA-1: SHA-1 (레거시)

포트 입출력 명세

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

입력 포트

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

포트 이름포트 ID데이터 타입필수 여부노출 조건설명
Private Key privateKey Any (PEM/DER) 필수 항상 노출 RSA 개인키 바이트 배열(PKCS#8/PKCS#1 PEM 또는 DER 자동 인식)이다.
Ciphertext Data ciphertext Bytes 필수 항상 노출 복호화할 $k$바이트 RSA-OAEP 암호문 바이트 배열이다.
OAEP Label label Bytes 선택 항상 노출 암호화 시 사용한 선택적 OAEP 레이블 바이트 배열이다.

출력 포트

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

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

오류 케이스

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

오류 코드기본 엔진 메시지발생 조건
INVALID_KEY_FORMAT RSA 키 형식이 올바르지 않는다 Private Key를 유효한 RSA 개인키로 파싱할 수 없을 때 발생한다.
RSA_DECRYPTION_FAILED RSA 복호화에 실패했다 (키 또는 암호문 불일치) 키 불일치, 해시 알고리즘/레이블 불일치, 또는 암호문 손상으로 OAEP 패딩 검증에 실패했을 때 발생한다.

활용 예시

RSA-OAEP 암호문 복호화하기

개인키로 256바이트 암호문을 복호화해 원본 메시지를 얻는다.

  1. RSA Encrypt의 Ciphertext와 대응하는 Private Key를 RSA Decrypt(SHA-256)에 연결한다.