Bytes to Base64
바이트 배열을 Base64 / Base64URL 문자열로 인코딩한다
개요
원시 바이트 배열(Uint8Array)을 RFC 4648 표준 Base64(+, /) 또는 URL·파일명에 안전한 Base64URL(-, _) 문자열로 인코딩한다.
말미의 = 패딩 문자 포함 여부를 선택할 수 있어 JWT 토큰, JWK 키, 웹훅 페이로드, PEM 본문 생성에 모두 활용할 수 있다.
사용 시점
- 이진 암호문이나 공개키를 JSON, HTTP 헤더, URL 쿼리 파라미터에 넣기 위해 텍스트로 인코딩할 때 사용한다.
- JWT/JWS 세그먼트처럼 패딩 없는 Base64URL 문자열을 만들 때 사용한다.
파라미터 설정
| 파라미터 (ID) | 타입 및 기본값 | 노출 조건 | 설명 및 옵션 |
|---|---|---|---|
Base64 변형variant |
select기본값: standard |
항상 노출 | 표준 Base64 알파벳(standard)과 URL 안전 알파벳(url) 중 선택한다.
|
패딩(=) 포함padding |
boolean기본값: true |
항상 노출 | 출력 문자열 길이를 4의 배수로 맞추는 말미 = 패딩 문자를 붙일지(true) 생략할지(false) 결정한다. |
포트 입출력 명세
포트 연결 규칙, 데이터 타입별 색상, 가변 포트 생성 방식은 포트 및 연결 문서를 참고한다.
입력 포트
포트 성격: 고정 입력 포트 (총 1개).
| 포트 이름 | 포트 ID | 데이터 타입 | 필수 여부 | 노출 조건 | 설명 |
|---|---|---|---|---|---|
Bytes In |
bytes |
Bytes |
필수 | 항상 노출 | 인코딩할 원시 바이트 배열(Uint8Array)이다. |
출력 포트
포트 성격: 고정 출력 포트 (총 1개).
| 포트 이름 | 포트 ID | 데이터 타입 | 노출 조건 | 설명 |
|---|---|---|---|---|
Base64 Out |
string |
String |
항상 노출 | Base64 문자열 |
오류 케이스
이 노드는 런타임 실패 케이스가 없으며(errorProfile: none), 타입이 맞는 모든 입력에 대해 항상 성공한다.
활용 예시
JWT/웹 전송용 패딩 없는 Base64URL 인코딩하기
바이트 배열을 URL 안전 Base64 문자열로 변환한다.
- Bytes to Base64에서 변형(Variant)을
url로, 패딩(=) 포함을false로 설정하고 바이트 입력을 연결한다.