n8n 자격증명 오버라이드로 OAuth 원클릭 연결 만들기 (셀프호스팅)

핵심 메시지

• n8n의 잘 알려지지 않은 자격증명 오버라이드 기능은 클라이언트 ID·시크릿을 고정값으로 넣어 설정 화면에서 숨기고, 사용자에게는 원클릭 연결 버튼만 보여준다.
• OAuth를 한 번만 설정해 두면 이후에는 다시 설정할 필요가 없어, IT팀이 자격증명을 준비하면 비개발 동료는 OAuth가 무엇인지 몰라도 서비스를 연결할 수 있다.
• 이 기능은 환경 변수를 편집할 수 있는 셀프호스팅 인스턴스에서만 동작하며, n8n 클라우드는 이미 원클릭 연결을 기본 제공한다.
• 구글처럼 십수 개 통합이 하나의 공통 자격증명 유형을 공유하는 경우, 그 하나만 오버라이드하면 이를 상속하는 모든 통합에 적용된다.

쉽게 이해하기

영상은 워크플로 자동화 도구 n8n을 직접 호스팅해 쓸 때, 서비스 연결을 위한 OAuth 설정을 사용자마다 반복하지 않고 “버튼으로 로그인” 방식으로 바꾸는 방법을 다룬다. 핵심은 자격증명 오버라이드(credential overrides)라는 잘 알려지지 않은 기능이다. 이 기능은 자격증명 필드에 고정값을 넣어 설정 화면에서 감춰 준다.

평소 Gmail을 연결하려면 클라이언트 ID와 시크릿을 입력해야 하고, 그 값을 넣어야 연결 버튼이 나타난다. 오버라이드로 그 두 값을 기본값으로 미리 지정해 두면 자격증명 화면에서 해당 필드가 사라지고 곧바로 원클릭 연결 버튼이 나온다. OAuth 자체는 한 번 설정해야 하지만, 그 뒤로는 다시 손댈 필요가 없다.

직장에서 특히 유용하다. IT팀이 자격증명을 한 번 세팅해 두면, OAuth가 무엇인지 모르는 회계팀 동료도 그냥 버튼만 눌러 연결할 수 있다. 발표자는 개인 인스턴스에서도 편리해서 늘 쓴다고 말한다. 다만 환경 변수를 수정할 수 없는 n8n 클라우드 계정에서는 동작하지 않는데, 클라우드는 이미 대부분 원클릭 연결을 제공하기 때문에 문제되지 않는다.

설정 절차는 대략 이렇다. 먼저 환경 변수를 추가해 기능을 켠다. 그다음 자격증명의 필드 이름과 스키마를 확인하고, 이를 HTTP 요청에 넣어 오버라이드로 등록한다. 이 등록 과정은 인스턴스가 시작될 때마다 실행되도록 구성한다. 영상은 비교적 단순한 Airtable을 먼저, 이어서 구글을 예로 든다.

구글이나 마이크로소프트는 여기서 진가가 드러난다. 예컨대 n8n에는 구글 통합이 열댓 개가 넘는데, 깃허브에서 보면 이들이 모두 같은 범용 구글 자격증명 유형을 상속한다. 따라서 그 하나의 구글 OAuth 자격증명만 오버라이드하면 이를 상속하는 모든 통합에 한 번에 적용된다. 게다가 인스턴스의 모든 사용자에게 적용되므로, n8n으로 무언가를 만들 때 가장 큰 장애물이 사라진다.

주요 인사이트

• 자격증명 오버라이드는 자격증명 필드에 하드코딩된 기본값을 주입해 설정 화면에서 숨기는 방식으로 동작한다.
• OAuth 설정을 한 번만 해 두면 되므로, 자격증명 관리라는 반복 작업을 팀 전체에서 제거할 수 있다.
• 공통 자격증명 유형을 상속하는 구글·마이크로소프트 통합은 상위 유형 하나만 오버라이드해도 전부 커버된다.
• 이 기능은 셀프호스팅에서 환경 변수를 편집할 수 있을 때만 쓸 수 있고, 클라우드 호스팅에서는 적용되지 않는다.

자주 묻는 질문

관련 AI 소식