Base64 to Bytes
Base64 또는 Base64URL 문자열을 바이트 배열로 디코딩한다
개요
RFC 4648 표준 Base64 또는 Base64URL 문자열을 원시 바이트 배열(Uint8Array)로 디코딩한다.
표준(+, /)과 URL 안전(-, _) 문자를 모두 자동으로 인식하며, 말미 = 패딩이 생략된 문자열도 정상적으로 디코딩한다.
사용 시점
- API 응답, JWT 세그먼트, 설정 파일에서 받은 Base64/Base64URL 암호문·키·서명을 원시 바이트로 복원할 때 사용한다.
파라미터 설정
이 노드는 속성창에서 설정할 수 있는 별도의 정적 파라미터가 없으며, 알고리즘 규격과 연결된 포트 값에 의해서만 동작이 결정된다.
포트 입출력 명세
포트 연결 규칙, 데이터 타입별 색상, 가변 포트 생성 방식은 포트 및 연결 문서를 참고한다.
입력 포트
포트 성격: 고정 입력 포트 (총 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 텍스트로 전달된 암호문을 바이트로 바꿔 복호화한다.
- Base64 문자열을 Base64 to Bytes의
Base64 String에 연결하고, 출력된Bytes를 복호화 노드의Ciphertext에 연결한다.