InfoGrab DocsInfoGrab Docs

변경 로그

요약

모든 n8n 릴리스는 플랫폼을 한 걸음씩 발전시킵니다. 릴리스별 전체 세부 내역은 GitHub의 Releases 페이지를 참고하세요. 이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요. 이제 관련 있는 노드들을 이름이 지정된 하나의 Canvas Group으로 묶고 접어서 더 깔끔한 화면을 만들 수 있습니다.

모든 n8n 릴리스는 플랫폼을 한 걸음씩 발전시킵니다. 변경 로그는 n8n 위에서 무언가를 구축하는 기술 팀에게 가장 중요한 변화를 알리는 공간입니다. 새로운 기능, 워크플로 실행 방식에 대한 더 많은 제어, 그리고 워크플로가 실제로 무엇을 하는지에 대한 더 명확한 가시성이 여기에 담깁니다. 각 항목은 해당 기능이 배포된 버전과 연결되어 있으며 최신순으로 정렬되고, 그 자체로 완결되도록 작성되어 팀이 기다려 온 단 하나의 업데이트를 손쉽게 공유할 수 있습니다.

Note

릴리스별 전체 세부 내역은 GitHub의 Releases 페이지를 참고하세요. 이 변경 로그는 안정 버전 n8n 2.x 릴리스부터를 다루며, 1.x0.x 릴리스 노트는 아카이브로 보존되어 있습니다.

참고

이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.

n8n 2.28 — Canvas Groups로 대규모 워크플로 정리#

릴리스: 2026-06-29

이제 관련 있는 노드들을 이름이 지정된 하나의 Canvas Group으로 묶고 접어서 더 깔끔한 화면을 만들 수 있습니다. 워크플로의 한 부분을 처리하는 노드들을 그룹으로 묶고 이름을 붙인 뒤, 접어서 필요할 때까지 세부 내용을 숨겨 두세요. 캔버스 전체에 흩어져 있던 대규모 워크플로가 한눈에 읽히는 몇 개의 이름표 붙은 블록으로 줄어들어, 동료가 만든 워크플로나 몇 달 만에 여는 워크플로에서도 훨씬 빠르게 방향을 잡을 수 있습니다.

Three connected nodes selected on the canvas, with the Group nodes action and its Ctrl/Cmd + G shortcut shown above the selection.

연결된 노드 묶음을 선택한 다음, Group nodes 버튼이나 Ctrl/Cmd + G로 그룹화하세요.

그룹을 만들려면 상자를 드래그하거나 Ctrl/Cmd를 누른 채 각 노드를 클릭하여 연결된 노드 묶음을 선택한 다음, Ctrl/Cmd + G를 누르거나 툴바에서 Group nodes 아이콘을 선택합니다. n8n이 그룹을 생성하고 이름 입력 필드를 강조 표시하므로 곧바로 이름을 지정할 수 있습니다. 토글 아이콘으로 그룹을 접거나 펼칠 수 있고, Ctrl/Cmd + Shift + G로 언제든지 그룹을 해제할 수 있으며 이때 노드는 캔버스에 그대로 남습니다.

Canvas Group은 워크플로와 함께 저장되므로 워크플로를 여는 누구나 동일한 구조를 보게 됩니다. 그룹이 접혀 있는지 펼쳐져 있는지는 브라우저에 저장되는 개인 설정이므로, 다시 돌아왔을 때 동료가 보는 화면은 바꾸지 않으면서 본인의 화면 상태는 그대로 유지됩니다. 어떤 노드를 하나의 그룹으로 묶을 수 있는지는 몇 가지 규칙으로 결정됩니다. 트리거는 그룹 바깥에 있어야 하고, 노드들은 하나의 연결된 체인을 이뤄야 하며, AI 노드는 자신의 서브 노드(챗 모델, 메모리, 도구)를 같은 그룹 안에 유지합니다.

자세한 내용은 Canvas Groups 문서를 참고하세요.

n8n 2.27 — 워크플로를 패키지로 인스턴스 간 이동#

릴리스: 2026-06-16

이제 워크플로를 이식 가능한 .n8np 패키지로 묶어, Public API 또는 동일한 엔드포인트를 감싸는 CLI 명령 세트를 통해 n8n 인스턴스 간에 옮길 수 있습니다. 워크플로 JSON을 손으로 복사하는 방식은 일회성 이동에는 늘 유효했습니다. 패키지는 이 작업을 반복 가능하고 자동화 가능하게 만들어, 여러 워크플로를 자격 증명 스텁 및 의존성을 기술하는 manifest.json과 함께 단일 파일에 담아 옮깁니다.

임포트는 사전에 검사됩니다. 충돌이나 해결되지 않은 자격 증명이 임포트를 막을 경우, n8n은 마이그레이션을 중간에 멈춘 채 두는 대신 작업을 중단하고 문제 목록을 제시합니다. 각 임포트마다 워크플로를 새 버전으로 가져올지, 첫 충돌에서 실패시킬지, 이미 존재하는 항목을 건너뛸지 선택할 수 있습니다. 자격 증명은 ID로 매칭되며 비밀 값은 절대 패키지에 포함되어 이동하지 않습니다. n8n은 대상 인스턴스에서 매칭할 스텁을 내보내거나, 나중에 채울 빈 자리표시자를 채워 넣습니다.

이를 통해 개발 환경에서 프로덕션으로 워크플로를 승격하거나, 인스턴스를 백업 및 복원하거나, 비밀을 공유하지 않고 워크플로를 동료에게 넘기거나, 인스턴스 간에 마이그레이션하기가 쉬워집니다.

Warning

이 기능은 베타 단계입니다. 패키지 형식과 API는 아직 개발 중이며, 메이저 버전 변경 없이 호환성이 깨지는 변경이 발생할 수 있습니다.

자세한 내용은 n8n Packages 문서를 참고하세요.

n8n 2.22 — 더 간편한 설정으로 MCP 서버에 연결#

릴리스: 2026-05-19

MCP Client 노드와 자격 증명을 수동으로 구성하지 않고도 에이전트를 선별된 MCP 서버에 연결할 수 있습니다. 노드 패널에서 서버를 선택하고 로그인하면 에이전트에서 바로 사용할 수 있습니다.

초기 지원 대상에는 공식 MCP 레지스트리에서 가장 많이 사용되는 서비스 일부(Apify, Linear, monday.com, Notion, PostHog)가 포함되며, 곧 더 많은 서비스로 목록을 확장할 예정입니다.

목록에 없는 MCP 서버에 연결해야 하는 경우, 여전히 MCP Client 노드를 수동 구성으로 사용할 수 있습니다.

Connect to MCP servers with less setup

OpenTelemetry 사용자 지정 텔레메트리 태그#

이제 노드, 워크플로, 프로젝트 수준에서 OpenTelemetry 트레이스에 사용자 지정 span 속성을 붙일 수 있어, 실행 span을 테넌트, 환경, 고객 ID 또는 그 밖의 임의 차원으로 필터링하고 그룹화할 수 있습니다. 속성 값은 표현식을 지원하므로, 하드코딩된 값에 의존하는 대신 런타임에 웹훅 페이로드나 API 응답에서 실시간 데이터를 가져올 수 있습니다. 트레이싱이 활성화된 상태(N8N_OTEL_ENABLED=true)에서 노드 또는 워크플로 설정에서 태그를 구성하세요.

자세한 내용은 문서를 참고하세요.

Note

제공 범위: Enterprise.

n8n 2.20 — Microsoft Agent 365 Trigger 노드#

릴리스: 2026-05-05

Microsoft Agent 365 Trigger 노드#

Microsoft Agent 365 Trigger 노드를 사용하면 Microsoft 365 앱 안에서 팀의 구성원처럼 나타나는 n8n 에이전트를 구축할 수 있습니다. 배포되면 에이전트는 Microsoft 테넌트 내에서 자체 ID를 가지며, 이메일 주소가 부여되어 마치 동료처럼 Teams에서 @멘션하거나, 이메일을 보내거나, SharePoint 권한을 부여할 수 있습니다.

A Microsoft Agent 365 Trigger node with a chat model, memory, and tools across Zendesk, Salesforce, PagerDuty, Datadog, and a sub-workflow.

챗 모델, 메모리, 그리고 Zendesk, Salesforce, PagerDuty, Datadog 및 서브 워크플로에 걸친
도구를 갖춘 Microsoft Agent 365 Trigger 노드.

트리거 노드를 사용해 n8n에서 에이전트를 구축합니다. 시스템 프롬프트를 추가하고 도구로서의 서브 워크플로를 통해 도구, MCP 서버, 기존 워크플로에 대한 접근 권한을 부여하세요. 그런 다음 Microsoft 측에서 에이전트를 설정하면 이메일 주소가 있는 Entra ID 신원이 부여됩니다. Microsoft는 신원, 라이프사이클, 보안, 규정 준수(Entra ID, Purview, Defender를 통해)를 처리하고, n8n은 RBAC, 자격 증명 관리, 실행 로그와 같은 워크플로 수준의 거버넌스를 처리합니다.

이미 개별 노드(Outlook, Teams, SharePoint 등)를 통해 Microsoft 서비스와 n8n을 함께 사용하고 있다면, 해당 워크플로는 이전과 동일하게 계속 작동합니다. Agent 365는 에이전트를 Microsoft 앱 _내부_에 노출시키고 팀 구성원처럼 상호작용하게 하려는 팀을 위한 새로운 방식입니다. 이 노드는 Microsoft 365 테넌트가 필요합니다.

전체 출시 스토리는 n8n 블로그 게시물을 참고하세요.

인사이트 데이터 보존 기간#

이제 셀프 호스팅 인스턴스는 기본적으로 인사이트 데이터를 최대 365일까지 보존할 수 있으며, 설정 가능한 최댓값은 730일입니다. 보존 기간은 새로운 N8N_INSIGHTS_MAX_AGE_DAYS 환경 변수로 제어되며 더 이상 라이선스 로직에 묶여 있지 않습니다. 인사이트 문서를 참고하세요.

n8n 2.19 — IdP 역할 매핑 및 인스턴스 부트스트래핑 (Enterprise)#

릴리스: 2026-04-28

n8n 내부에서의 IdP 역할 매핑#

이제 인스턴스 관리자는 n8n 전용 역할 로직을 IdP에 인코딩하는 대신 n8n 내부에서 그룹-역할 매핑을 정의할 수 있습니다. JIT 프로비저닝이 활성화된 상태에서 관리자는 SAML 속성이나 OIDC 클레임에 대한 표현식을 작성해 로그인 시 인스턴스 및 프로젝트 역할을 자동으로 할당합니다. IdP는 표준 그룹 멤버십 데이터만 전송하면 됩니다. 매핑은 n8n이 처리하며, 역할 할당은 로그인할 때마다 다시 평가되므로 IdP를 변경하지 않아도 접근 권한이 항상 동기화된 상태로 유지됩니다.

Settings → SSO를 열고 User role provisioning에서 Instance roles via SSO 또는 Instance and project roles via SSO를 선택한 다음, 매핑 카드를 "Map rules on your IdP"에서 "Map rules inside n8n"으로 전환하고 $claims 객체를 사용해 각 역할에 대한 사용자를 매칭하는 표현식을 추가하세요. 표현식 기반 매칭은 단순 문자열 매칭으로는 다룰 수 없는 비표준 그룹 구조도 처리합니다.

Note

제공 범위: Enterprise 및 Business.

인스턴스 부트스트래핑#

이제 n8n을 시작 시점에 환경 변수를 통해 완전히 구성할 수 있습니다. 소유자 계정, SSO(OIDC 및 SAML), 보안 정책, 로그 스트리밍 대상은 모두 최초 부팅 시 적용되며 수동 UI 조작이 필요 없습니다. 이 방식으로 관리되는 필드는 UI에서 잠기고 재시작할 때마다 다시 적용됩니다.

이로써 배포 구성이 단일 진실 공급원(single source of truth)이 되어, 사용자가 로그인하기 전에 SSO와 보안 정책을 포함해 완전히 구성된 인스턴스를 단일 Helm 차트나 Docker Compose 파일로 세울 수 있습니다.

Note

제공 범위: Enterprise.

n8n 2.16 — 임베디드 접근 및 실행 데이터 편집(redaction) (Enterprise)#

릴리스: 2026-04-07

임베디드 접근을 위한 토큰 교환 인증#

이제 n8n은 API 키와 함께 두 번째 인증 메커니즘으로 OAuth 2.0 Token Exchange(RFC 8693)를 지원합니다. 두 가지 시나리오를 다룹니다. 사용자가 별도의 로그인 화면 없이 다른 제품 안에서 n8n을 보는 매끄러운 iframe 임베딩과, 시스템이 완전한 감사 귀속과 함께 사용자를 대신해 동작하는 위임 API 접근입니다.

임베딩 시스템은 비대칭 개인 키를 보유하고 사용자 신원 클레임이 담긴 단기 JWT에 서명합니다. n8n은 구성된 공개 키로 서명을 검증하고, 처음 마주치는 사용자를 즉시(just-in-time) 프로비저닝하며, 흐름에 따라 세션 쿠키나 범위 지정 API 토큰을 발급합니다. subject와 actor가 모두 감사 로그에 보존되므로, 모든 동작에 대해 누가 요청했고 누가 수행했는지가 함께 기록됩니다.

Note

제공 범위: Enterprise. N8N_TOKEN_EXCHANGE_TRUSTED_KEYS로 구성한 비대칭 키 쌍이 필요합니다. 역할 기반 범위 지정을 사용합니다.

실행 데이터 편집(redaction)#

이제 인스턴스 및 프로젝트 관리자는 실행 데이터를 편집(redact)할 수 있습니다. 활성화하면 프로덕션 실행의 민감한 데이터는 UI에 절대 표시되지 않으며, reveal 권한을 가진 사용자가 명시적으로 요청하기 전까지는 데이터베이스에서 가져오지도 않습니다. 수동 실행은 완전히 표시되도록 둘 수 있어 개발자가 중단 없이 계속 구축하고 디버깅할 수 있습니다. 모든 reveal은 감사 이벤트로 기록됩니다.

편집은 Workflow settings에서 워크플로별로 구성하며, reveal 접근 권한은 프로젝트 또는 인스턴스 설정을 통해 특정 사용자에게만 부여됩니다. 실행 데이터 편집 문서를 참고하세요.

Note

제공 범위: Enterprise.

Public API 개선#

  • 커뮤니티 패키지. /api/v1/community-packages 아래의 새 엔드포인트를 통해 커뮤니티 패키지를 프로그래밍 방식으로 설치, 목록 조회, 업데이트, 제거할 수 있습니다. 각 작업에는 해당하는 communityPackage:* 범위를 가진 API 키가 필요합니다.
  • 인사이트 범위. 새로운 insights:read API 키 범위로, v2.17에 배포되는 인사이트 요약 엔드포인트의 기반을 마련합니다.

n8n 2.15 — 워크플로를 위한 OpenTelemetry 지원#

릴리스: 2026-03-30

이제 n8n은 워크플로 실행에 대한 OpenTelemetry 트레이스를 방출합니다. 사이드카, 사용자 지정 익스포터, 타이밍 편법 없이 실행이 기존 OpenTelemetry 백엔드의 트레이스가 됩니다. 이미 Jaeger, Datadog, Grafana Tempo, Honeycomb, New Relic, Splunk를 사용하는 팀은 관찰 중인 다른 모든 것과 나란히 n8n을 확인할 수 있습니다.

각 실행은 워크플로 ID, 이름, 실행 ID, 상태, 소요 시간, 노드 수, 프로젝트 정보를 span 속성으로 갖는 루트 트레이스 span으로 나타납니다. 실패한 실행은 span에 오류 세부 정보를 노출하므로, 스택의 나머지를 관찰하는 동일한 도구에서 워크플로 실패를 검색하고 알림을 받을 수 있습니다.

n8n을 임의의 OTLP 호환 컬렉터로 가리키기만 하면 활성화됩니다. 최소 구성은 두 개의 환경 변수입니다.

N8N_OTEL_ENABLED=true
N8N_OTEL_EXPORTER_OTLP_ENDPOINT=http://your-collector:4318

표준 OTel 변수(OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_SERVICE_NAME)도 지원됩니다.

이것은 기반이 되는 T1 기능입니다. 이후 릴리스에서 노드 수준 span(v2.16), span 내 워크플로 버전 ID 및 분산 트레이스 컨텍스트 전파(v2.18~v2.19), AI Agent 텔레메트리(v2.20)로 확장되었습니다.

Note

제공 범위: Free, Pro, Enterprise.

n8n 2.13 — 버전 기록의 시각적 diff#

릴리스: 2026-03-16

버전 기록에 도입된 시각적 diff#

버전 기록을 열고 Compare changes를 클릭한 뒤 두 버전을 선택하면, 캔버스가 변경된 노드를 강조 표시한 채 두 버전을 나란히 렌더링합니다. 각 버전의 변경 횟수 배지는 중요한 편집을 한눈에 파악하는 데 도움이 됩니다.

시각적 diff는 Cloud Pro 이상에서 사용할 수 있습니다.

프로젝트 범위 외부 비밀: 팀 전체 접근 (Enterprise)#

새로운 점:

  • 프로젝트 관리자는 프로젝트 설정에서 자신의 vault 연결을 관리합니다.
  • 인스턴스 관리자가 접근을 활성화하면, 프로젝트 편집자는 자격 증명에서 프로젝트 범위 비밀을 사용할 수 있습니다.
  • 이제 사용자 지정 역할에는 list, read, create, update, delete의 다섯 가지 비밀 범위가 포함됩니다.
  • 비밀을 해석(resolve)하기 위해 인스턴스 관리자/소유자가 더 이상 프로젝트 구성원일 필요가 없습니다.

인스턴스 관리자용: Settings > External Secrets로 이동해 System Roles 토글을 활성화하거나, 더 세밀한 제어를 위해 사용자 지정 역할을 사용하세요.

프로젝트 관리자용: Project Settings > External Secrets로 이동해 프로젝트 수준 연결을 생성하고 관리하세요. 공유된 인스턴스 수준 연결은 읽기 전용으로 표시됩니다.

자세한 내용은 External secrets를 참고하세요.

Note

제공 범위: Enterprise.

push 및 pull 대화상자의 폴더 기반 필터링 (Enterprise)#

이제 push 및 pull 대화상자에는 Status 및 Owner와 함께 Folder 필터가 포함됩니다. 폴더를 선택하면 목록이 해당 폴더와 그 하위 폴더의 워크플로로 좁혀지며, 폴더 수준 체크박스가 있는 계층적 트리로 표시됩니다. 텍스트 검색도 폴더 이름과 일치합니다.

Note

제공 범위: Enterprise. Environments가 구성되어 있어야 합니다.

n8n 2.12 — 외부 비밀 공급자로서의 1Password (Enterprise)#

릴리스: 2026-03-09

이제 n8n은 HashiCorp Vault, AWS Secrets Manager, Azure Key Vault, GCP Secret Manager와 함께 1Password Connect Server를 외부 비밀 공급자로 지원합니다.

비밀은 런타임에 가져와지며 n8n에 절대 저장되지 않습니다. 1Password가 단일 진실 공급원으로 유지됩니다. 여러 필드를 가진 항목은 구조화된 하위 경로로 사용할 수 있습니다: $secrets.<vault>.<item>.<field>.

연결 방법:

  1. 1Password Connect Server를 배포하고 n8n이 읽어야 하는 vault로 범위가 지정된 액세스 토큰을 생성합니다.
  2. n8n에서 Settings > External Secrets로 이동해 1Password를 선택하고 Connect Server URL과 토큰을 입력합니다.

읽기 전용 접근 권한을 가진 셀프 호스팅 1Password Connect Server가 필요합니다.

Note

제공 범위: Enterprise.

n8n 2.11 — Cloud에서 더 쉬워진 자격 증명 설정#

릴리스: 2026-03-02

Cloud에서 더 쉬워진 자격 증명 설정#

이제 n8n Cloud에서 자격 증명을 설정하기가 훨씬 간단해졌습니다. 지원되는 서비스라면 Connect 버튼을 클릭하고 서비스에 인증하기만 하면 바로 사용할 수 있습니다. Slack, Firecrawl, HubSpot, GitHub, Google Calendar, PagerDuty, Apify 등에 대한 수동 설정을 건너뛰세요.

Setting up Slack credentials with managed OAuth

관리형 OAuth로 Slack 자격 증명 설정하기

유의할 점:

  • 자체 OAuth 구성을 사용하고 싶다면, 인증 모드 드롭다운에서 언제든지 수동 설정으로 전환할 수 있습니다.
  • 이 기능은 n8n이 사용자를 대신해 OAuth 앱을 관리하는 n8n Cloud에서만 제공됩니다.

사용자 지정 역할: Assignments 탭 (Enterprise)#

이제 인스턴스 관리자는 각 사용자 지정 역할에 전용 Assignments 탭을 갖게 되어, 해당 역할이 할당된 모든 사용자와 그들이 속한 프로젝트, 그리고 관리로 바로 이동하는 링크를 확인할 수 있습니다. 더 이상 프로젝트를 하나하나 탐색할 필요가 없습니다.

프로젝트 범위 외부 비밀: 인스턴스 관리자 설정 (Enterprise)#

이제 인스턴스 관리자는 특정 프로젝트로 범위가 지정된 vault 연결을 생성할 수 있습니다. 해당 연결의 비밀은 인스턴스 전체가 아니라 그 프로젝트의 자격 증명 안에서만 나타납니다. 인스턴스 수준 연결은 영향을 받지 않습니다. 자세한 내용은 External secrets를 참고하세요.

별도 권한 범위로 분리된 워크플로 실행 (Enterprise)#

이제 workflow:execute사용자 지정 프로젝트 역할에서 편집 및 게시와 분리된 별개의 범위입니다. 사용자에게 워크플로를 수정할 수 없으면서 실행 권한만 부여할 수 있어, 민감한 워크플로에서 흔히 요구되는 규정 준수 요건을 충족합니다.

Note

제공 범위: 사용자 지정 역할과 프로젝트 범위 외부 비밀은 n8n Enterprise에서 제공됩니다.

n8n 2.8 — 개인 공간 정책 및 더 세밀한 거버넌스 (Enterprise)#

릴리스: 2026-02-09 – 2026-02-13 (2.8.0–2.8.3)

개인 공간 정책#

2.8.3에서 릴리스됨 (2026-02-13).

새로운 Security & policies 설정 섹션은 인스턴스의 보안 요건을 강제하는 중앙 공간을 제공합니다. 기존의 2단계 인증 강제에 더해, 이제 관리자는 사용자가 자신의 개인 공간에서 무엇을 할 수 있는지 제어할 수 있습니다.

사용 가능한 정책은 다음과 같습니다.

  • 공유: 사용자가 개인 공간에서 워크플로와 자격 증명을 공유할 수 있는지 제어합니다.
  • 워크플로 게시: 사용자가 개인 공간에서 워크플로를 게시할 수 있는지 제어합니다.

이 릴리스는 사용자 지정 프로젝트 역할을 포함한 최근의 권한 모델 업데이트를 기반으로 정책 주도 거버넌스를 더 잘 지원합니다.

The new Security & policies settings section

새로운 Security & policies 설정 섹션

사용자 지정 역할: 향상된 발견성 및 권한 가시성#

2.8.3에서 릴리스됨 (2026-02-13).

이제 프로젝트 역할 선택기는 기본 제공 시스템 역할과 사용자 지정 역할을 별도 섹션으로 구분하여, 올바른 역할을 더 쉽게 찾고 선택할 수 있습니다. 역할 위에 마우스를 올리면 구성된 권한 요약이 표시되며, 전체 권한 세부 정보를 볼 수 있는 옵션도 제공됩니다.

System roles and custom roles are now displayed in separate sections

이제 시스템 역할과 사용자 지정 역할이 별도 섹션으로 표시됩니다

강화된 외부 비밀 검증#

2.8.0에서 릴리스됨 (2026-02-09).

이제 n8n은 $secrets... 표현식을 사용하는 자격 증명의 저장을 허용하기 전에, 현재 사용자가 참조된 vault에 접근할 수 있는지 검증합니다. 접근 권한이 없으면 저장 작업이 실패합니다. 이로써 추측한 비밀 경로를 통해 비밀 값이 노출되는 것을 방지합니다.

향상된 API 감사 기능#

2.8.0에서 릴리스됨 (2026-02-09).

프로젝트 멤버십과 자격 증명에 대한 가시성을 높이기 위해 API 엔드포인트가 확장되었습니다.

  • GET /projects/{projectId}/users는 할당된 역할을 포함해 프로젝트의 모든 구성원을 반환합니다.
  • GET /credentials는 소속 프로젝트를 포함해 인스턴스 전체 자격 증명의 페이지 매김 목록을 반환합니다.

이로써 UI에서 각 항목을 수동으로 검토하지 않고도 누가 어떤 프로젝트와 자격 증명에 접근할 수 있는지 더 쉽게 감사할 수 있습니다.

더 세밀한 워크플로 권한#

2.8.0에서 릴리스됨 (2026-02-09).

사용자 지정 역할의 워크플로 게시 권한이 workflow:publishworkflow:unpublish라는 두 개의 별도 범위로 분리되었습니다. 이로써 게시 취소를 독립적으로 관리해야 하는 거버넌스 시나리오에서 더 정밀한 접근 제어가 가능해집니다.

Note

제공 범위: 개인 공간 정책, 사용자 지정 역할, 강화된 외부 비밀 검증, 향상된 API 감사 기능은 n8n Enterprise에서 제공됩니다.

n8n 2.6 — AI 도구 호출을 위한 Human-in-the-loop#

릴리스: 2026-01-26

이제 AI Agent가 특정 도구를 실행하기 전에 명시적인 사람의 승인을 요구할 수 있습니다.

AI 도구 호출을 위한 Human-in-the-loop(HITL)은 검토를 도구 수준에서 직접 강제합니다. 게이트가 걸린 도구는 사람이 명시적으로 동작을 승인하지 않는 한 실행될 수 없으므로, 레코드 삭제, 프로덕션 시스템 쓰기, 영향도가 큰 이메일 발송과 같은 고영향 작업에 대한 결정론적 제어권을 갖게 됩니다. 이는 프롬프트 기반 안전장치의 불확실성을 제거하고 확률적인 에이전트 동작으로부터 사용자를 보호합니다.

검토 단계는 표준 n8n 통합을 사용해 구현되므로, 승인은 단일 사용자나 인터페이스에 국한되지 않습니다. 결정은 여러 사람과 시스템에 걸쳐 라우팅될 수 있어, 적절한 담당자가 이미 사용 중인 채널을 통해 승인하도록 강제할 수 있습니다.

할 수 있는 것:

  • MCP Client 도구나 도구로 노출된 서브 워크플로를 포함해, 에이전트가 호출할 수 있는 모든 도구에 대해 명시적인 사람의 승인을 요구합니다.
  • 승인을 선택적으로 적용하여, 일부 도구는 자율적으로 실행되고 다른 도구는 검토를 요구하도록 합니다.
  • 승인을 사용자와 채널에 걸쳐 라우팅합니다(예: Slack에서 시작된 동작을 이메일을 통해 다른 사용자의 승인으로 보냄).
  • 복잡한 워크플로 패턴이나 취약한 프롬프트 로직 없이 고영향 또는 잠재적으로 파괴적인 작업에 대한 안전 검사를 추가합니다.

사용 방법: AI Agent에서 게이트를 걸려는 도구로 이어지는 연결에서 + 아이콘을 클릭하고 Add human review step을 선택합니다. 검토를 처리하는 데 사용할 수 있는 노드와 함께 Tools 패널이 열립니다. 하나를 선택하고 승인자, 메시지, 사용 가능한 동작을 구성하세요.

에이전트가 할 수 있는 일을 제한하지 않으면서 사람의 판단이 필요한 지점을 정밀하게 제어하세요. 자세한 내용은 human-in-the-loop 도구 문서를 참고하세요.

Human in the loop for AI tool calls

n8n 2.5 — Chat 노드: Human-in-the-loop 동작#

릴리스: 2026-01-20

이제 Chat 노드에는 에이전트 워크플로에서의 human-in-the-loop 상호작용을 위한 두 가지 새로운 동작이 포함됩니다.

  • Send a message: 사용자에게 메시지를 보내고 워크플로를 계속 진행합니다.
  • Send a message and wait for response: 메시지를 보내고 사용자가 응답할 때까지 실행을 일시 중지합니다. 사용자는 Chat에서 자유 텍스트로 응답하거나, 노드 구성에 정의된 인라인 승인 버튼을 클릭해 응답할 수 있습니다.

이러한 동작은 결정론적 워크플로 단계로 사용하거나 AI Agent의 도구로 사용할 수 있으며, Chat Trigger를 사용할 때 단일 실행 내에서 다중 턴의 사람 상호작용을 가능하게 합니다.

에이전트 도구로 사용하면 에이전트가 진행하기 전에 명확화를 요청할 수 있어, 사용자 의도를 더 잘 해석하고 지시를 따르는 데 도움이 됩니다. 에이전트는 또한 장시간 실행되는 워크플로 도중 이러한 동작을 사용해 업데이트를 보낼 수도 있습니다.

방법:

  1. Chat Trigger 노드로 워크플로를 트리거합니다. 노드 파라미터에서 Response Mode 옵션을 추가하고 _Using Response Nodes_로 설정합니다.
  2. 워크플로 뒷부분에 Chat 노드를 추가하거나 AI Agent의 도구로 추가합니다. Send a message 또는 Send a message and wait for response 중 하나의 작업을 선택합니다.

유의할 점: AI Agent가 메시지 전송과 입력 대기 중에서 선택하도록 하려면, 각 동작에 하나씩 두 개의 Chat 도구 노드를 추가하세요. Chat Trigger 노드로 트리거되는 AI Agent의 경우, 에이전트가 필요할 때 명확화를 요청할 수 있도록 Send a message and wait for response를 추가하는 것을 권장합니다.

자세한 내용은 Chat 노드 문서를 참고하세요.

Human in the loop for the Chat node

n8n 2.4 — Syslog 로그 스트리밍을 위한 TLS 및 API를 통한 자격 증명 업데이트#

릴리스: 2026-01-12

Syslog 로그 스트리밍을 위한 TLS 지원#

이제 Syslog 로그 스트리밍 대상은 암호화된 연결을 위해 TCP 상의 TLS를 지원합니다. 이로써 암호화된 전송을 요구하는 엔터프라이즈 SIEM 및 관측성 플랫폼으로 안전하게 로그를 스트리밍할 수 있습니다. 이번 릴리스로 로그 스트리밍은 더 넓은 범위의 엔터프라이즈 SIEM 플랫폼과 호환됩니다.

API를 통한 자격 증명 업데이트#

이제 n8n의 public API는 새로운 PATCH /credentials/:id 엔드포인트를 통해 기존 자격 증명을 ID로 업데이트하는 것을 지원합니다. 이전에는 자격 증명을 API로 생성만 할 수 있어, 변경하려면 자격 증명을 삭제하고 다시 생성해야 했습니다.

업데이트 시 모든 자격 증명 데이터를 한 번에 교체하거나(대량 업데이트에 유용), isPartialData: true로 설정해 변경 사항을 기존 데이터와 병합할 수 있습니다. 자동화된 비밀 로테이션이나 구성을 잃지 않고 개별 값을 수정하는 데 이상적입니다.

n8n 2.2 — 더 세밀한 워크플로 권한 및 더 풍부한 감사 이벤트#

릴리스: 2025-12-22

사용자 지정 프로젝트 역할 내의 더 세밀한 워크플로 권한 (Enterprise)#

사용자 지정 프로젝트 역할을 사용하면 프로젝트 수준에서 세밀한 권한을 정의할 수 있습니다. 이번 릴리스에서는 워크플로 편집과 워크플로 게시를 분리하여 워크플로 권한이 한층 더 세분화되었습니다.

이 변경으로 워크플로 구축과 게시를 서로 다른 사용자나 팀이 처리하는 내부 프로세스에 접근 제어를 더 쉽게 맞출 수 있습니다.

Custom Project Roles

사용자 지정 프로젝트 역할

로그 스트리밍: 향상된 관측성을 위한 더 많은 감사 이벤트#

이제 로그 스트리밍에는 운영 및 보안 관련 변경 사항에 대한 가시성을 높이기 위한 추가 감사 이벤트가 포함됩니다.

이번 업데이트는 수동 워크플로 취소 및 워크플로 활성화/비활성화(게시/게시 취소), 변수 라이프사이클 이벤트(생성/업데이트/삭제), 사용자 관리 동작(2FA 활성화/비활성화 포함)에 대한 이벤트를 추가합니다.

워크플로 설정 업데이트도 일반적인 "updated" 이벤트 대신 변경된 특정 파라미터(예: 새 오류 워크플로 선택)와 함께 기록됩니다.

n8n 2.1 — Time Saved 노드#

릴리스: 2025-12-16

이전에는 팀이 실행이 어떤 경로를 거치든 관계없이 각 워크플로에 대해 단일 고정 절약 시간 값만 추적할 수 있었습니다. 새로운 Time Saved 노드를 사용하면 서로 다른 실행 경로가 서로 다른 양의 시간을 절약하는 경우에 더 정밀한 절약 시간 계산이 가능합니다.

이번 릴리스로 다음을 할 수 있습니다.

  • 고정 값 또는 동적 시간 추적 선택: 단순한 워크플로에는 고정 절약 시간 값을 사용하거나, 하나 이상의 Time Saved 노드를 사용해 실제로 거친 실행 경로를 기반으로 절약 시간을 동적으로 계산합니다.
  • 항목별 계산 구성: Time Saved 노드를 사용할 때, 모든 항목에 대해 절약 시간을 한 번 계산할지 아니면 처리된 항목 수만큼 곱할지 선택합니다.
Time saved node in a workflow

워크플로 내의 Time Saved 노드

n8n은 각 워크플로 실행 중에 실행된 모든 Time Saved 노드의 시간을 자동으로 합산하여 인사이트 대시보드에 보고합니다.

총 절약 시간 계산

변경 로그

n8n v2.29
원문 보기
요약

모든 n8n 릴리스는 플랫폼을 한 걸음씩 발전시킵니다. 릴리스별 전체 세부 내역은 GitHub의 Releases 페이지를 참고하세요. 이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요. 이제 관련 있는 노드들을 이름이 지정된 하나의 Canvas Group으로 묶고 접어서 더 깔끔한 화면을 만들 수 있습니다.

모든 n8n 릴리스는 플랫폼을 한 걸음씩 발전시킵니다. 변경 로그는 n8n 위에서 무언가를 구축하는 기술 팀에게 가장 중요한 변화를 알리는 공간입니다. 새로운 기능, 워크플로 실행 방식에 대한 더 많은 제어, 그리고 워크플로가 실제로 무엇을 하는지에 대한 더 명확한 가시성이 여기에 담깁니다. 각 항목은 해당 기능이 배포된 버전과 연결되어 있으며 최신순으로 정렬되고, 그 자체로 완결되도록 작성되어 팀이 기다려 온 단 하나의 업데이트를 손쉽게 공유할 수 있습니다.

Note

릴리스별 전체 세부 내역은 GitHub의 Releases 페이지를 참고하세요. 이 변경 로그는 안정 버전 n8n 2.x 릴리스부터를 다루며, 1.x0.x 릴리스 노트는 아카이브로 보존되어 있습니다.

참고

이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.

n8n 2.28 — Canvas Groups로 대규모 워크플로 정리#

릴리스: 2026-06-29

이제 관련 있는 노드들을 이름이 지정된 하나의 Canvas Group으로 묶고 접어서 더 깔끔한 화면을 만들 수 있습니다. 워크플로의 한 부분을 처리하는 노드들을 그룹으로 묶고 이름을 붙인 뒤, 접어서 필요할 때까지 세부 내용을 숨겨 두세요. 캔버스 전체에 흩어져 있던 대규모 워크플로가 한눈에 읽히는 몇 개의 이름표 붙은 블록으로 줄어들어, 동료가 만든 워크플로나 몇 달 만에 여는 워크플로에서도 훨씬 빠르게 방향을 잡을 수 있습니다.

Three connected nodes selected on the canvas, with the Group nodes action and its Ctrl/Cmd + G shortcut shown above the selection.

연결된 노드 묶음을 선택한 다음, Group nodes 버튼이나 Ctrl/Cmd + G로 그룹화하세요.

그룹을 만들려면 상자를 드래그하거나 Ctrl/Cmd를 누른 채 각 노드를 클릭하여 연결된 노드 묶음을 선택한 다음, Ctrl/Cmd + G를 누르거나 툴바에서 Group nodes 아이콘을 선택합니다. n8n이 그룹을 생성하고 이름 입력 필드를 강조 표시하므로 곧바로 이름을 지정할 수 있습니다. 토글 아이콘으로 그룹을 접거나 펼칠 수 있고, Ctrl/Cmd + Shift + G로 언제든지 그룹을 해제할 수 있으며 이때 노드는 캔버스에 그대로 남습니다.

Canvas Group은 워크플로와 함께 저장되므로 워크플로를 여는 누구나 동일한 구조를 보게 됩니다. 그룹이 접혀 있는지 펼쳐져 있는지는 브라우저에 저장되는 개인 설정이므로, 다시 돌아왔을 때 동료가 보는 화면은 바꾸지 않으면서 본인의 화면 상태는 그대로 유지됩니다. 어떤 노드를 하나의 그룹으로 묶을 수 있는지는 몇 가지 규칙으로 결정됩니다. 트리거는 그룹 바깥에 있어야 하고, 노드들은 하나의 연결된 체인을 이뤄야 하며, AI 노드는 자신의 서브 노드(챗 모델, 메모리, 도구)를 같은 그룹 안에 유지합니다.

자세한 내용은 Canvas Groups 문서를 참고하세요.

n8n 2.27 — 워크플로를 패키지로 인스턴스 간 이동#

릴리스: 2026-06-16

이제 워크플로를 이식 가능한 .n8np 패키지로 묶어, Public API 또는 동일한 엔드포인트를 감싸는 CLI 명령 세트를 통해 n8n 인스턴스 간에 옮길 수 있습니다. 워크플로 JSON을 손으로 복사하는 방식은 일회성 이동에는 늘 유효했습니다. 패키지는 이 작업을 반복 가능하고 자동화 가능하게 만들어, 여러 워크플로를 자격 증명 스텁 및 의존성을 기술하는 manifest.json과 함께 단일 파일에 담아 옮깁니다.

임포트는 사전에 검사됩니다. 충돌이나 해결되지 않은 자격 증명이 임포트를 막을 경우, n8n은 마이그레이션을 중간에 멈춘 채 두는 대신 작업을 중단하고 문제 목록을 제시합니다. 각 임포트마다 워크플로를 새 버전으로 가져올지, 첫 충돌에서 실패시킬지, 이미 존재하는 항목을 건너뛸지 선택할 수 있습니다. 자격 증명은 ID로 매칭되며 비밀 값은 절대 패키지에 포함되어 이동하지 않습니다. n8n은 대상 인스턴스에서 매칭할 스텁을 내보내거나, 나중에 채울 빈 자리표시자를 채워 넣습니다.

이를 통해 개발 환경에서 프로덕션으로 워크플로를 승격하거나, 인스턴스를 백업 및 복원하거나, 비밀을 공유하지 않고 워크플로를 동료에게 넘기거나, 인스턴스 간에 마이그레이션하기가 쉬워집니다.

Warning

이 기능은 베타 단계입니다. 패키지 형식과 API는 아직 개발 중이며, 메이저 버전 변경 없이 호환성이 깨지는 변경이 발생할 수 있습니다.

자세한 내용은 n8n Packages 문서를 참고하세요.

n8n 2.22 — 더 간편한 설정으로 MCP 서버에 연결#

릴리스: 2026-05-19

MCP Client 노드와 자격 증명을 수동으로 구성하지 않고도 에이전트를 선별된 MCP 서버에 연결할 수 있습니다. 노드 패널에서 서버를 선택하고 로그인하면 에이전트에서 바로 사용할 수 있습니다.

초기 지원 대상에는 공식 MCP 레지스트리에서 가장 많이 사용되는 서비스 일부(Apify, Linear, monday.com, Notion, PostHog)가 포함되며, 곧 더 많은 서비스로 목록을 확장할 예정입니다.

목록에 없는 MCP 서버에 연결해야 하는 경우, 여전히 MCP Client 노드를 수동 구성으로 사용할 수 있습니다.

Connect to MCP servers with less setup

OpenTelemetry 사용자 지정 텔레메트리 태그#

이제 노드, 워크플로, 프로젝트 수준에서 OpenTelemetry 트레이스에 사용자 지정 span 속성을 붙일 수 있어, 실행 span을 테넌트, 환경, 고객 ID 또는 그 밖의 임의 차원으로 필터링하고 그룹화할 수 있습니다. 속성 값은 표현식을 지원하므로, 하드코딩된 값에 의존하는 대신 런타임에 웹훅 페이로드나 API 응답에서 실시간 데이터를 가져올 수 있습니다. 트레이싱이 활성화된 상태(N8N_OTEL_ENABLED=true)에서 노드 또는 워크플로 설정에서 태그를 구성하세요.

자세한 내용은 문서를 참고하세요.

Note

제공 범위: Enterprise.

n8n 2.20 — Microsoft Agent 365 Trigger 노드#

릴리스: 2026-05-05

Microsoft Agent 365 Trigger 노드#

Microsoft Agent 365 Trigger 노드를 사용하면 Microsoft 365 앱 안에서 팀의 구성원처럼 나타나는 n8n 에이전트를 구축할 수 있습니다. 배포되면 에이전트는 Microsoft 테넌트 내에서 자체 ID를 가지며, 이메일 주소가 부여되어 마치 동료처럼 Teams에서 @멘션하거나, 이메일을 보내거나, SharePoint 권한을 부여할 수 있습니다.

A Microsoft Agent 365 Trigger node with a chat model, memory, and tools across Zendesk, Salesforce, PagerDuty, Datadog, and a sub-workflow.

챗 모델, 메모리, 그리고 Zendesk, Salesforce, PagerDuty, Datadog 및 서브 워크플로에 걸친
도구를 갖춘 Microsoft Agent 365 Trigger 노드.

트리거 노드를 사용해 n8n에서 에이전트를 구축합니다. 시스템 프롬프트를 추가하고 도구로서의 서브 워크플로를 통해 도구, MCP 서버, 기존 워크플로에 대한 접근 권한을 부여하세요. 그런 다음 Microsoft 측에서 에이전트를 설정하면 이메일 주소가 있는 Entra ID 신원이 부여됩니다. Microsoft는 신원, 라이프사이클, 보안, 규정 준수(Entra ID, Purview, Defender를 통해)를 처리하고, n8n은 RBAC, 자격 증명 관리, 실행 로그와 같은 워크플로 수준의 거버넌스를 처리합니다.

이미 개별 노드(Outlook, Teams, SharePoint 등)를 통해 Microsoft 서비스와 n8n을 함께 사용하고 있다면, 해당 워크플로는 이전과 동일하게 계속 작동합니다. Agent 365는 에이전트를 Microsoft 앱 _내부_에 노출시키고 팀 구성원처럼 상호작용하게 하려는 팀을 위한 새로운 방식입니다. 이 노드는 Microsoft 365 테넌트가 필요합니다.

전체 출시 스토리는 n8n 블로그 게시물을 참고하세요.

인사이트 데이터 보존 기간#

이제 셀프 호스팅 인스턴스는 기본적으로 인사이트 데이터를 최대 365일까지 보존할 수 있으며, 설정 가능한 최댓값은 730일입니다. 보존 기간은 새로운 N8N_INSIGHTS_MAX_AGE_DAYS 환경 변수로 제어되며 더 이상 라이선스 로직에 묶여 있지 않습니다. 인사이트 문서를 참고하세요.

n8n 2.19 — IdP 역할 매핑 및 인스턴스 부트스트래핑 (Enterprise)#

릴리스: 2026-04-28

n8n 내부에서의 IdP 역할 매핑#

이제 인스턴스 관리자는 n8n 전용 역할 로직을 IdP에 인코딩하는 대신 n8n 내부에서 그룹-역할 매핑을 정의할 수 있습니다. JIT 프로비저닝이 활성화된 상태에서 관리자는 SAML 속성이나 OIDC 클레임에 대한 표현식을 작성해 로그인 시 인스턴스 및 프로젝트 역할을 자동으로 할당합니다. IdP는 표준 그룹 멤버십 데이터만 전송하면 됩니다. 매핑은 n8n이 처리하며, 역할 할당은 로그인할 때마다 다시 평가되므로 IdP를 변경하지 않아도 접근 권한이 항상 동기화된 상태로 유지됩니다.

Settings → SSO를 열고 User role provisioning에서 Instance roles via SSO 또는 Instance and project roles via SSO를 선택한 다음, 매핑 카드를 "Map rules on your IdP"에서 "Map rules inside n8n"으로 전환하고 $claims 객체를 사용해 각 역할에 대한 사용자를 매칭하는 표현식을 추가하세요. 표현식 기반 매칭은 단순 문자열 매칭으로는 다룰 수 없는 비표준 그룹 구조도 처리합니다.

Note

제공 범위: Enterprise 및 Business.

인스턴스 부트스트래핑#

이제 n8n을 시작 시점에 환경 변수를 통해 완전히 구성할 수 있습니다. 소유자 계정, SSO(OIDC 및 SAML), 보안 정책, 로그 스트리밍 대상은 모두 최초 부팅 시 적용되며 수동 UI 조작이 필요 없습니다. 이 방식으로 관리되는 필드는 UI에서 잠기고 재시작할 때마다 다시 적용됩니다.

이로써 배포 구성이 단일 진실 공급원(single source of truth)이 되어, 사용자가 로그인하기 전에 SSO와 보안 정책을 포함해 완전히 구성된 인스턴스를 단일 Helm 차트나 Docker Compose 파일로 세울 수 있습니다.

Note

제공 범위: Enterprise.

n8n 2.16 — 임베디드 접근 및 실행 데이터 편집(redaction) (Enterprise)#

릴리스: 2026-04-07

임베디드 접근을 위한 토큰 교환 인증#

이제 n8n은 API 키와 함께 두 번째 인증 메커니즘으로 OAuth 2.0 Token Exchange(RFC 8693)를 지원합니다. 두 가지 시나리오를 다룹니다. 사용자가 별도의 로그인 화면 없이 다른 제품 안에서 n8n을 보는 매끄러운 iframe 임베딩과, 시스템이 완전한 감사 귀속과 함께 사용자를 대신해 동작하는 위임 API 접근입니다.

임베딩 시스템은 비대칭 개인 키를 보유하고 사용자 신원 클레임이 담긴 단기 JWT에 서명합니다. n8n은 구성된 공개 키로 서명을 검증하고, 처음 마주치는 사용자를 즉시(just-in-time) 프로비저닝하며, 흐름에 따라 세션 쿠키나 범위 지정 API 토큰을 발급합니다. subject와 actor가 모두 감사 로그에 보존되므로, 모든 동작에 대해 누가 요청했고 누가 수행했는지가 함께 기록됩니다.

Note

제공 범위: Enterprise. N8N_TOKEN_EXCHANGE_TRUSTED_KEYS로 구성한 비대칭 키 쌍이 필요합니다. 역할 기반 범위 지정을 사용합니다.

실행 데이터 편집(redaction)#

이제 인스턴스 및 프로젝트 관리자는 실행 데이터를 편집(redact)할 수 있습니다. 활성화하면 프로덕션 실행의 민감한 데이터는 UI에 절대 표시되지 않으며, reveal 권한을 가진 사용자가 명시적으로 요청하기 전까지는 데이터베이스에서 가져오지도 않습니다. 수동 실행은 완전히 표시되도록 둘 수 있어 개발자가 중단 없이 계속 구축하고 디버깅할 수 있습니다. 모든 reveal은 감사 이벤트로 기록됩니다.

편집은 Workflow settings에서 워크플로별로 구성하며, reveal 접근 권한은 프로젝트 또는 인스턴스 설정을 통해 특정 사용자에게만 부여됩니다. 실행 데이터 편집 문서를 참고하세요.

Note

제공 범위: Enterprise.

Public API 개선#

  • 커뮤니티 패키지. /api/v1/community-packages 아래의 새 엔드포인트를 통해 커뮤니티 패키지를 프로그래밍 방식으로 설치, 목록 조회, 업데이트, 제거할 수 있습니다. 각 작업에는 해당하는 communityPackage:* 범위를 가진 API 키가 필요합니다.
  • 인사이트 범위. 새로운 insights:read API 키 범위로, v2.17에 배포되는 인사이트 요약 엔드포인트의 기반을 마련합니다.

n8n 2.15 — 워크플로를 위한 OpenTelemetry 지원#

릴리스: 2026-03-30

이제 n8n은 워크플로 실행에 대한 OpenTelemetry 트레이스를 방출합니다. 사이드카, 사용자 지정 익스포터, 타이밍 편법 없이 실행이 기존 OpenTelemetry 백엔드의 트레이스가 됩니다. 이미 Jaeger, Datadog, Grafana Tempo, Honeycomb, New Relic, Splunk를 사용하는 팀은 관찰 중인 다른 모든 것과 나란히 n8n을 확인할 수 있습니다.

각 실행은 워크플로 ID, 이름, 실행 ID, 상태, 소요 시간, 노드 수, 프로젝트 정보를 span 속성으로 갖는 루트 트레이스 span으로 나타납니다. 실패한 실행은 span에 오류 세부 정보를 노출하므로, 스택의 나머지를 관찰하는 동일한 도구에서 워크플로 실패를 검색하고 알림을 받을 수 있습니다.

n8n을 임의의 OTLP 호환 컬렉터로 가리키기만 하면 활성화됩니다. 최소 구성은 두 개의 환경 변수입니다.

N8N_OTEL_ENABLED=true
N8N_OTEL_EXPORTER_OTLP_ENDPOINT=http://your-collector:4318

표준 OTel 변수(OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_SERVICE_NAME)도 지원됩니다.

이것은 기반이 되는 T1 기능입니다. 이후 릴리스에서 노드 수준 span(v2.16), span 내 워크플로 버전 ID 및 분산 트레이스 컨텍스트 전파(v2.18~v2.19), AI Agent 텔레메트리(v2.20)로 확장되었습니다.

Note

제공 범위: Free, Pro, Enterprise.

n8n 2.13 — 버전 기록의 시각적 diff#

릴리스: 2026-03-16

버전 기록에 도입된 시각적 diff#

버전 기록을 열고 Compare changes를 클릭한 뒤 두 버전을 선택하면, 캔버스가 변경된 노드를 강조 표시한 채 두 버전을 나란히 렌더링합니다. 각 버전의 변경 횟수 배지는 중요한 편집을 한눈에 파악하는 데 도움이 됩니다.

시각적 diff는 Cloud Pro 이상에서 사용할 수 있습니다.

프로젝트 범위 외부 비밀: 팀 전체 접근 (Enterprise)#

새로운 점:

  • 프로젝트 관리자는 프로젝트 설정에서 자신의 vault 연결을 관리합니다.
  • 인스턴스 관리자가 접근을 활성화하면, 프로젝트 편집자는 자격 증명에서 프로젝트 범위 비밀을 사용할 수 있습니다.
  • 이제 사용자 지정 역할에는 list, read, create, update, delete의 다섯 가지 비밀 범위가 포함됩니다.
  • 비밀을 해석(resolve)하기 위해 인스턴스 관리자/소유자가 더 이상 프로젝트 구성원일 필요가 없습니다.

인스턴스 관리자용: Settings > External Secrets로 이동해 System Roles 토글을 활성화하거나, 더 세밀한 제어를 위해 사용자 지정 역할을 사용하세요.

프로젝트 관리자용: Project Settings > External Secrets로 이동해 프로젝트 수준 연결을 생성하고 관리하세요. 공유된 인스턴스 수준 연결은 읽기 전용으로 표시됩니다.

자세한 내용은 External secrets를 참고하세요.

Note

제공 범위: Enterprise.

push 및 pull 대화상자의 폴더 기반 필터링 (Enterprise)#

이제 push 및 pull 대화상자에는 Status 및 Owner와 함께 Folder 필터가 포함됩니다. 폴더를 선택하면 목록이 해당 폴더와 그 하위 폴더의 워크플로로 좁혀지며, 폴더 수준 체크박스가 있는 계층적 트리로 표시됩니다. 텍스트 검색도 폴더 이름과 일치합니다.

Note

제공 범위: Enterprise. Environments가 구성되어 있어야 합니다.

n8n 2.12 — 외부 비밀 공급자로서의 1Password (Enterprise)#

릴리스: 2026-03-09

이제 n8n은 HashiCorp Vault, AWS Secrets Manager, Azure Key Vault, GCP Secret Manager와 함께 1Password Connect Server를 외부 비밀 공급자로 지원합니다.

비밀은 런타임에 가져와지며 n8n에 절대 저장되지 않습니다. 1Password가 단일 진실 공급원으로 유지됩니다. 여러 필드를 가진 항목은 구조화된 하위 경로로 사용할 수 있습니다: $secrets.<vault>.<item>.<field>.

연결 방법:

  1. 1Password Connect Server를 배포하고 n8n이 읽어야 하는 vault로 범위가 지정된 액세스 토큰을 생성합니다.
  2. n8n에서 Settings > External Secrets로 이동해 1Password를 선택하고 Connect Server URL과 토큰을 입력합니다.

읽기 전용 접근 권한을 가진 셀프 호스팅 1Password Connect Server가 필요합니다.

Note

제공 범위: Enterprise.

n8n 2.11 — Cloud에서 더 쉬워진 자격 증명 설정#

릴리스: 2026-03-02

Cloud에서 더 쉬워진 자격 증명 설정#

이제 n8n Cloud에서 자격 증명을 설정하기가 훨씬 간단해졌습니다. 지원되는 서비스라면 Connect 버튼을 클릭하고 서비스에 인증하기만 하면 바로 사용할 수 있습니다. Slack, Firecrawl, HubSpot, GitHub, Google Calendar, PagerDuty, Apify 등에 대한 수동 설정을 건너뛰세요.

Setting up Slack credentials with managed OAuth

관리형 OAuth로 Slack 자격 증명 설정하기

유의할 점:

  • 자체 OAuth 구성을 사용하고 싶다면, 인증 모드 드롭다운에서 언제든지 수동 설정으로 전환할 수 있습니다.
  • 이 기능은 n8n이 사용자를 대신해 OAuth 앱을 관리하는 n8n Cloud에서만 제공됩니다.

사용자 지정 역할: Assignments 탭 (Enterprise)#

이제 인스턴스 관리자는 각 사용자 지정 역할에 전용 Assignments 탭을 갖게 되어, 해당 역할이 할당된 모든 사용자와 그들이 속한 프로젝트, 그리고 관리로 바로 이동하는 링크를 확인할 수 있습니다. 더 이상 프로젝트를 하나하나 탐색할 필요가 없습니다.

프로젝트 범위 외부 비밀: 인스턴스 관리자 설정 (Enterprise)#

이제 인스턴스 관리자는 특정 프로젝트로 범위가 지정된 vault 연결을 생성할 수 있습니다. 해당 연결의 비밀은 인스턴스 전체가 아니라 그 프로젝트의 자격 증명 안에서만 나타납니다. 인스턴스 수준 연결은 영향을 받지 않습니다. 자세한 내용은 External secrets를 참고하세요.

별도 권한 범위로 분리된 워크플로 실행 (Enterprise)#

이제 workflow:execute사용자 지정 프로젝트 역할에서 편집 및 게시와 분리된 별개의 범위입니다. 사용자에게 워크플로를 수정할 수 없으면서 실행 권한만 부여할 수 있어, 민감한 워크플로에서 흔히 요구되는 규정 준수 요건을 충족합니다.

Note

제공 범위: 사용자 지정 역할과 프로젝트 범위 외부 비밀은 n8n Enterprise에서 제공됩니다.

n8n 2.8 — 개인 공간 정책 및 더 세밀한 거버넌스 (Enterprise)#

릴리스: 2026-02-09 – 2026-02-13 (2.8.0–2.8.3)

개인 공간 정책#

2.8.3에서 릴리스됨 (2026-02-13).

새로운 Security & policies 설정 섹션은 인스턴스의 보안 요건을 강제하는 중앙 공간을 제공합니다. 기존의 2단계 인증 강제에 더해, 이제 관리자는 사용자가 자신의 개인 공간에서 무엇을 할 수 있는지 제어할 수 있습니다.

사용 가능한 정책은 다음과 같습니다.

  • 공유: 사용자가 개인 공간에서 워크플로와 자격 증명을 공유할 수 있는지 제어합니다.
  • 워크플로 게시: 사용자가 개인 공간에서 워크플로를 게시할 수 있는지 제어합니다.

이 릴리스는 사용자 지정 프로젝트 역할을 포함한 최근의 권한 모델 업데이트를 기반으로 정책 주도 거버넌스를 더 잘 지원합니다.

The new Security & policies settings section

새로운 Security & policies 설정 섹션

사용자 지정 역할: 향상된 발견성 및 권한 가시성#

2.8.3에서 릴리스됨 (2026-02-13).

이제 프로젝트 역할 선택기는 기본 제공 시스템 역할과 사용자 지정 역할을 별도 섹션으로 구분하여, 올바른 역할을 더 쉽게 찾고 선택할 수 있습니다. 역할 위에 마우스를 올리면 구성된 권한 요약이 표시되며, 전체 권한 세부 정보를 볼 수 있는 옵션도 제공됩니다.

System roles and custom roles are now displayed in separate sections

이제 시스템 역할과 사용자 지정 역할이 별도 섹션으로 표시됩니다

강화된 외부 비밀 검증#

2.8.0에서 릴리스됨 (2026-02-09).

이제 n8n은 $secrets... 표현식을 사용하는 자격 증명의 저장을 허용하기 전에, 현재 사용자가 참조된 vault에 접근할 수 있는지 검증합니다. 접근 권한이 없으면 저장 작업이 실패합니다. 이로써 추측한 비밀 경로를 통해 비밀 값이 노출되는 것을 방지합니다.

향상된 API 감사 기능#

2.8.0에서 릴리스됨 (2026-02-09).

프로젝트 멤버십과 자격 증명에 대한 가시성을 높이기 위해 API 엔드포인트가 확장되었습니다.

  • GET /projects/{projectId}/users는 할당된 역할을 포함해 프로젝트의 모든 구성원을 반환합니다.
  • GET /credentials는 소속 프로젝트를 포함해 인스턴스 전체 자격 증명의 페이지 매김 목록을 반환합니다.

이로써 UI에서 각 항목을 수동으로 검토하지 않고도 누가 어떤 프로젝트와 자격 증명에 접근할 수 있는지 더 쉽게 감사할 수 있습니다.

더 세밀한 워크플로 권한#

2.8.0에서 릴리스됨 (2026-02-09).

사용자 지정 역할의 워크플로 게시 권한이 workflow:publishworkflow:unpublish라는 두 개의 별도 범위로 분리되었습니다. 이로써 게시 취소를 독립적으로 관리해야 하는 거버넌스 시나리오에서 더 정밀한 접근 제어가 가능해집니다.

Note

제공 범위: 개인 공간 정책, 사용자 지정 역할, 강화된 외부 비밀 검증, 향상된 API 감사 기능은 n8n Enterprise에서 제공됩니다.

n8n 2.6 — AI 도구 호출을 위한 Human-in-the-loop#

릴리스: 2026-01-26

이제 AI Agent가 특정 도구를 실행하기 전에 명시적인 사람의 승인을 요구할 수 있습니다.

AI 도구 호출을 위한 Human-in-the-loop(HITL)은 검토를 도구 수준에서 직접 강제합니다. 게이트가 걸린 도구는 사람이 명시적으로 동작을 승인하지 않는 한 실행될 수 없으므로, 레코드 삭제, 프로덕션 시스템 쓰기, 영향도가 큰 이메일 발송과 같은 고영향 작업에 대한 결정론적 제어권을 갖게 됩니다. 이는 프롬프트 기반 안전장치의 불확실성을 제거하고 확률적인 에이전트 동작으로부터 사용자를 보호합니다.

검토 단계는 표준 n8n 통합을 사용해 구현되므로, 승인은 단일 사용자나 인터페이스에 국한되지 않습니다. 결정은 여러 사람과 시스템에 걸쳐 라우팅될 수 있어, 적절한 담당자가 이미 사용 중인 채널을 통해 승인하도록 강제할 수 있습니다.

할 수 있는 것:

  • MCP Client 도구나 도구로 노출된 서브 워크플로를 포함해, 에이전트가 호출할 수 있는 모든 도구에 대해 명시적인 사람의 승인을 요구합니다.
  • 승인을 선택적으로 적용하여, 일부 도구는 자율적으로 실행되고 다른 도구는 검토를 요구하도록 합니다.
  • 승인을 사용자와 채널에 걸쳐 라우팅합니다(예: Slack에서 시작된 동작을 이메일을 통해 다른 사용자의 승인으로 보냄).
  • 복잡한 워크플로 패턴이나 취약한 프롬프트 로직 없이 고영향 또는 잠재적으로 파괴적인 작업에 대한 안전 검사를 추가합니다.

사용 방법: AI Agent에서 게이트를 걸려는 도구로 이어지는 연결에서 + 아이콘을 클릭하고 Add human review step을 선택합니다. 검토를 처리하는 데 사용할 수 있는 노드와 함께 Tools 패널이 열립니다. 하나를 선택하고 승인자, 메시지, 사용 가능한 동작을 구성하세요.

에이전트가 할 수 있는 일을 제한하지 않으면서 사람의 판단이 필요한 지점을 정밀하게 제어하세요. 자세한 내용은 human-in-the-loop 도구 문서를 참고하세요.

Human in the loop for AI tool calls

n8n 2.5 — Chat 노드: Human-in-the-loop 동작#

릴리스: 2026-01-20

이제 Chat 노드에는 에이전트 워크플로에서의 human-in-the-loop 상호작용을 위한 두 가지 새로운 동작이 포함됩니다.

  • Send a message: 사용자에게 메시지를 보내고 워크플로를 계속 진행합니다.
  • Send a message and wait for response: 메시지를 보내고 사용자가 응답할 때까지 실행을 일시 중지합니다. 사용자는 Chat에서 자유 텍스트로 응답하거나, 노드 구성에 정의된 인라인 승인 버튼을 클릭해 응답할 수 있습니다.

이러한 동작은 결정론적 워크플로 단계로 사용하거나 AI Agent의 도구로 사용할 수 있으며, Chat Trigger를 사용할 때 단일 실행 내에서 다중 턴의 사람 상호작용을 가능하게 합니다.

에이전트 도구로 사용하면 에이전트가 진행하기 전에 명확화를 요청할 수 있어, 사용자 의도를 더 잘 해석하고 지시를 따르는 데 도움이 됩니다. 에이전트는 또한 장시간 실행되는 워크플로 도중 이러한 동작을 사용해 업데이트를 보낼 수도 있습니다.

방법:

  1. Chat Trigger 노드로 워크플로를 트리거합니다. 노드 파라미터에서 Response Mode 옵션을 추가하고 _Using Response Nodes_로 설정합니다.
  2. 워크플로 뒷부분에 Chat 노드를 추가하거나 AI Agent의 도구로 추가합니다. Send a message 또는 Send a message and wait for response 중 하나의 작업을 선택합니다.

유의할 점: AI Agent가 메시지 전송과 입력 대기 중에서 선택하도록 하려면, 각 동작에 하나씩 두 개의 Chat 도구 노드를 추가하세요. Chat Trigger 노드로 트리거되는 AI Agent의 경우, 에이전트가 필요할 때 명확화를 요청할 수 있도록 Send a message and wait for response를 추가하는 것을 권장합니다.

자세한 내용은 Chat 노드 문서를 참고하세요.

Human in the loop for the Chat node

n8n 2.4 — Syslog 로그 스트리밍을 위한 TLS 및 API를 통한 자격 증명 업데이트#

릴리스: 2026-01-12

Syslog 로그 스트리밍을 위한 TLS 지원#

이제 Syslog 로그 스트리밍 대상은 암호화된 연결을 위해 TCP 상의 TLS를 지원합니다. 이로써 암호화된 전송을 요구하는 엔터프라이즈 SIEM 및 관측성 플랫폼으로 안전하게 로그를 스트리밍할 수 있습니다. 이번 릴리스로 로그 스트리밍은 더 넓은 범위의 엔터프라이즈 SIEM 플랫폼과 호환됩니다.

API를 통한 자격 증명 업데이트#

이제 n8n의 public API는 새로운 PATCH /credentials/:id 엔드포인트를 통해 기존 자격 증명을 ID로 업데이트하는 것을 지원합니다. 이전에는 자격 증명을 API로 생성만 할 수 있어, 변경하려면 자격 증명을 삭제하고 다시 생성해야 했습니다.

업데이트 시 모든 자격 증명 데이터를 한 번에 교체하거나(대량 업데이트에 유용), isPartialData: true로 설정해 변경 사항을 기존 데이터와 병합할 수 있습니다. 자동화된 비밀 로테이션이나 구성을 잃지 않고 개별 값을 수정하는 데 이상적입니다.

n8n 2.2 — 더 세밀한 워크플로 권한 및 더 풍부한 감사 이벤트#

릴리스: 2025-12-22

사용자 지정 프로젝트 역할 내의 더 세밀한 워크플로 권한 (Enterprise)#

사용자 지정 프로젝트 역할을 사용하면 프로젝트 수준에서 세밀한 권한을 정의할 수 있습니다. 이번 릴리스에서는 워크플로 편집과 워크플로 게시를 분리하여 워크플로 권한이 한층 더 세분화되었습니다.

이 변경으로 워크플로 구축과 게시를 서로 다른 사용자나 팀이 처리하는 내부 프로세스에 접근 제어를 더 쉽게 맞출 수 있습니다.

Custom Project Roles

사용자 지정 프로젝트 역할

로그 스트리밍: 향상된 관측성을 위한 더 많은 감사 이벤트#

이제 로그 스트리밍에는 운영 및 보안 관련 변경 사항에 대한 가시성을 높이기 위한 추가 감사 이벤트가 포함됩니다.

이번 업데이트는 수동 워크플로 취소 및 워크플로 활성화/비활성화(게시/게시 취소), 변수 라이프사이클 이벤트(생성/업데이트/삭제), 사용자 관리 동작(2FA 활성화/비활성화 포함)에 대한 이벤트를 추가합니다.

워크플로 설정 업데이트도 일반적인 "updated" 이벤트 대신 변경된 특정 파라미터(예: 새 오류 워크플로 선택)와 함께 기록됩니다.

n8n 2.1 — Time Saved 노드#

릴리스: 2025-12-16

이전에는 팀이 실행이 어떤 경로를 거치든 관계없이 각 워크플로에 대해 단일 고정 절약 시간 값만 추적할 수 있었습니다. 새로운 Time Saved 노드를 사용하면 서로 다른 실행 경로가 서로 다른 양의 시간을 절약하는 경우에 더 정밀한 절약 시간 계산이 가능합니다.

이번 릴리스로 다음을 할 수 있습니다.

  • 고정 값 또는 동적 시간 추적 선택: 단순한 워크플로에는 고정 절약 시간 값을 사용하거나, 하나 이상의 Time Saved 노드를 사용해 실제로 거친 실행 경로를 기반으로 절약 시간을 동적으로 계산합니다.
  • 항목별 계산 구성: Time Saved 노드를 사용할 때, 모든 항목에 대해 절약 시간을 한 번 계산할지 아니면 처리된 항목 수만큼 곱할지 선택합니다.
Time saved node in a workflow

워크플로 내의 Time Saved 노드

n8n은 각 워크플로 실행 중에 실행된 모든 Time Saved 노드의 시간을 자동으로 합산하여 인사이트 대시보드에 보고합니다.

총 절약 시간 계산