NodeCrypto 도움말

Base64 to Bytes

카테고리: 데이터 변환 & 인코딩 · 노드 타입 ID: converter-base64-to-bytes

Base64 또는 Base64URL 문자열을 바이트 배열로 디코딩한다

개요

RFC 4648 표준 Base64 또는 Base64URL 문자열을 원시 바이트 배열(Uint8Array)로 디코딩한다.

표준(+, /)과 URL 안전(-, _) 문자를 모두 자동으로 인식하며, 말미 = 패딩이 생략된 문자열도 정상적으로 디코딩한다.

사용 시점

파라미터 설정

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

포트 입출력 명세

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

입력 포트

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

포트 이름포트 ID데이터 타입필수 여부노출 조건설명
Base64 In string String 필수 항상 노출 Base64 문자열

출력 포트

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

포트 이름포트 ID데이터 타입노출 조건설명
Bytes Out bytes Bytes 항상 노출 디코딩된 원시 바이트 배열(Uint8Array)이다.

오류 케이스

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

오류 코드기본 엔진 메시지발생 조건
INVALID_BASE64_INPUT Base64 문자열이 올바르지 않는다 Base64/Base64URL 알파벳이 아닌 문자가 포함되어 있거나 패딩 제거 후 글자 수를 4로 나눈 나머지가 1일 때 발생한다.

활용 예시

Base64 암호문을 디코딩해 복호화 노드로 전달하기

Base64 텍스트로 전달된 암호문을 바이트로 바꿔 복호화한다.

  1. Base64 문자열을 Base64 to Bytes의 Base64 String에 연결하고, 출력된 Bytes를 복호화 노드의 Ciphertext에 연결한다.