하루보탬

n8n 보안 강화를 위한 공개 API 및 API Playground 비활성화 설정 방법

하루보탬 편집팀

보안 강화를 위한 핵심 설정: n8n은 사용하지 않는 경우 보안을 위해 공개 REST API를 비활성화할 것을 권장합니다. N8N_PUBLIC_API_DISABLED 및 N8N_PUBLIC_API_SWAGGERUI_DISABLED 변수를 통해 제어합니다.

n8n 설치 시 보안을 강화하기 위해 사용하지 않는 공개 REST API와 API Playground를 환경 변수를 통해 비활성화할 수 있습니다.

공개 API 및 Playground 비활성화의 목적

n8n 공개 REST API는 GUI에서 수행할 수 있는 많은 작업을 프로그램 방식으로 수행할 수 있게 해줍니다.

이 API를 사용할 계획이 없다면 n8n 설치의 보안을 향상시키기 위해 비활성화를 권장합니다.

비활성화 대상별 설정 비교: 공개 REST API: N8N_PUBLIC_API_DISABLED=true 설정 시 비활성화. API Playground: N8N_PUBLIC_API_SWAGGERUI_DISABLED=true 설정 시 비활성화.
비활성화 대상별 설정 비교 — 공식 자료를 정리한 자체 제작 도해입니다.
설명 도해 · 하루보탬 Studio

근거: Disable the public API

공개 REST API 비활성화 설정

공개 REST API를 비활성화하려면 N8N_PUBLIC_API_DISABLED 환경 변수를 true로 설정합니다.

예를 들어, export N8N_PUBLIC_API_DISABLED=true 명령을 사용하여 설정할 수 있습니다.

비활성화 설정 단계: 1. 환경 변수 정의 확인 2. 해당 환경 변수 값을 true로 설정 3. n8n 시스템에 적용
비활성화 설정 단계 — 공식 자료를 정리한 자체 제작 도해입니다.
설명 도해 · 하루보탬 Studio

근거: Disable the public API

API Playground 비활성화 설정

API Playground를 비활성화하려면 N8N_PUBLIC_API_SWAGGERUI_DISABLED 환경 변수를 true로 설정합니다.

예를 들어, export N8N_PUBLIC_API_SWAGGERUI_DISABLED=true 명령을 사용하여 설정할 수 있습니다.

확인되지 않은 사항: Cloud, 자체호스팅, 요금제 및 버전별 지원 범위는 미확인. 실제 계정 설정 및 보안 점검 결과는 미확인.
확인되지 않은 사항 — 공식 자료를 정리한 자체 제작 도해입니다.
설명 도해 · 하루보탬 Studio
다음 단계 안내: 설치 환경에 맞는 환경 변수를 설정하여 보안을 강화하십시오. 필요한 경우 공식 문서를 참조하여 상세 설정을 확인하십시오.
다음 단계 안내 — 공식 자료를 정리한 자체 제작 도해입니다.
설명 도해 · 하루보탬 Studio

근거: Disable the public API

적용 조건과 확인 범위
  • Cloud·자체호스팅·요금제 및 버전별 지원 범위와 제한을 구분한다.
  • 실제 계정 설정·보안 점검·운영 비용은 검증하지 않았다.
  • Cloud, 자체호스팅, 요금제 및 버전별 지원 범위와 제한은 구분되지 않음
  • 실제 계정 설정, 보안 점검, 운영 비용은 검증되지 않음

확인일: 2026-09-22T20:22:16.931556+00:00