NodeCrypto 도움말

Bytes to Base64

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

바이트 배열을 Base64 / Base64URL 문자열로 인코딩한다

개요

원시 바이트 배열(Uint8Array)을 RFC 4648 표준 Base64(+, /) 또는 URL·파일명에 안전한 Base64URL(-, _) 문자열로 인코딩한다.

말미의 = 패딩 문자 포함 여부를 선택할 수 있어 JWT 토큰, JWK 키, 웹훅 페이로드, PEM 본문 생성에 모두 활용할 수 있다.

사용 시점

파라미터 설정

파라미터 (ID)타입 및 기본값노출 조건설명 및 옵션
Base64 변형
variant
select
기본값: standard
항상 노출 표준 Base64 알파벳(standard)과 URL 안전 알파벳(url) 중 선택한다.
  • standard: RFC 4648 §4 표준 Base64 알파벳(A-Z, a-z, 0-9, +, /).
  • url_safe: URL 안전 (-_)
패딩(=) 포함
padding
boolean
기본값: true
변수 참조 지원 ($var: bool)
항상 노출 출력 문자열 길이를 4의 배수로 맞추는 말미 = 패딩 문자를 붙일지(true) 생략할지(false) 결정한다.

포트 입출력 명세

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

입력 포트

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

포트 이름포트 ID데이터 타입필수 여부노출 조건설명
Bytes In bytes Bytes 필수 항상 노출 인코딩할 원시 바이트 배열(Uint8Array)이다.

출력 포트

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

포트 이름포트 ID데이터 타입노출 조건설명
Base64 Out string String 항상 노출 Base64 문자열

오류 케이스

이 노드는 런타임 실패 케이스가 없으며(errorProfile: none), 타입이 맞는 모든 입력에 대해 항상 성공한다.

활용 예시

JWT/웹 전송용 패딩 없는 Base64URL 인코딩하기

바이트 배열을 URL 안전 Base64 문자열로 변환한다.

  1. Bytes to Base64에서 변형(Variant)을 url로, 패딩(=) 포함을 false로 설정하고 바이트 입력을 연결한다.