n8n 도입 시 JWE 기반 OAuth 2.0 토큰 암호화 지원 호스팅 방식 비교

n8n 2.21.0 버전부터 제공되는 JWE 기반 OAuth 2.0 토큰 암호화 기능은 호스팅 방식에 따라 활성화 방법이 다릅니다. 자체 호스팅 환경과 Cloud 환경의 차이를 확인하여 보안 정책에 맞는 방식을 선택하십시오.

JWE 토큰 암호화 기능 개요

JWE 토큰 암호화는 identity provider(IdP)가 토큰을 JWE로 암호화하여 제공하면, n8n 인스턴스가 이를 복호화하여 토큰 내용을 보호하는 기능입니다.

이 기능은 브라우저, 리버스 프록시, 로그 등 IdP와 n8n 사이의 경로에 노출되는 모든 요소로부터 토큰 내용을 보호합니다.

이 기능을 사용하려면 IdP가 JWE로 토큰을 암호화할 수 있는 기능을 제공해야 합니다.

자체 호스팅(Self-hosted) 인스턴스에서는 N8N_ENV_FEAT_OAUTH2_JWE 환경 변수를 true로 설정하여 직접 기능을 활성화할 수 있습니다.

Cloud 환경에서는 n8n 지원팀에 연락하여 해당 기능을 활성화해 달라고 요청해야 합니다.

JWE 토큰 암호화 기능은 현재 Preview 상태이며, 환경 변수 및 지원 알고리즘이 일반 출시 전까지 변경될 수 있습니다.

n8n을 업그레이드할 때마다 버전 고정 및 OAuth 2.0 자격 증명에 대한 재검증이 필요합니다.

적용 조건과 확인 범위

확인일: 2026-09-23T01:31:57.599236+00:00