자격 증명(Credentials) 만들고 편집하기

자격 증명(credential)은 n8n 워크플로를 API나 데이터베이스 같은 외부 서비스에 연결하기 위해 안전하게 저장되는 인증 정보예요. n8n Cloud에서는 일부 AI 모델과 서비스는 자격 증명 없이 Use Gateway credits로 실행할 수도 있습니다. 자격 증명을 저장하면 n8n이 제대로 동작하는지 자동으로 테스트해 줍니다.

출처: 공식문서

본문

자격 증명 만들기

사이드 메뉴 왼쪽 위의 Create 버튼을 선택하고 credential을 선택합니다.
n8n 인스턴스가 프로젝트를 지원하면 자격 증명을 개인 공간에 만들지, 접근 권한이 있는 특정 프로젝트에 만들지 선택해야 합니다. 커뮤니티 버전을 쓰면 개인 공간에 만듭니다.
연결하려는 앱 또는 서비스를 선택합니다.

또는:

Overview 페이지 또는 특정 프로젝트에서 오른쪽 위 Create 버튼을 사용해 Credential을 선택합니다.
Overview 페이지에서 만들면 개인 공간에, 프로젝트 안에서 만들면 해당 프로젝트 안에 만들어집니다.
연결하려는 앱 또는 서비스를 선택합니다.

워크플로 에디터에서 노드를 편집할 때 자격 증명 드롭다운에서 새 자격 증명을 만들 수도 있습니다.

자격 증명 모달에서 서비스에 필요한 세부 정보를 입력하세요. 서비스를 저장하면 n8n은 동작하는지 테스트합니다.

자격 증명 이름 짓기: n8n은 새 자격 증명의 이름을 기본적으로 "노드 이름 account"로 짓습니다. 이름을 클릭하면 노드 이름 변경처럼 이름을 바꿀 수 있어요. 앱·서비스, 타입, 목적을 식별할 수 있는 이름을 붙이는 게 좋은 관행입니다.

자격 증명 타입 선택하기

OAuth 자격 증명을 만들거나 편집할 때 Credential type을 선택합니다:

Fixed credential: 워크플로를 누가 실행하든 같은 자격 증명을 사용합니다. 기본 동작입니다.
End-user credential: 실행 시점에 각 사용자의 자격 증명을 사용하며, 해당 사용자만 볼 수 있고 사용할 수 있습니다.

End-user credential은 워크플로를 트리거한 사람의 자격 증명으로 실행하게 해주고, 각 사용자의 데이터를 그 사용자에게만 비공개로 유지합니다. Fixed/End-user 선택은 n8n Cloud Enterprise와 셀프호스티드 Enterprise의 OAuth 자격 증명에서 나타납니다.

허용된 HTTP 요청 도메인

Allowed HTTP Request Domains 필드는 웹 기반 API·서비스용 많은 n8n 자격 증명에 나타납니다. 자격 증명이 HTTP Request 노드에서 선택됐을 때 사용이 허용되는 도메인을 제어합니다. 전용 노드에서 자격 증명을 쓸 때는 효과가 없습니다.

All: 자격 증명을 어떤 URL에도 사용할 수 있습니다.
Specific Domains: 특정 도메인으로 제한합니다(쉼표로 구분된 목록, 예: httpbin.org, api.github.com).
None: HTTP Request 노드에서 사용이 완전히 차단됩니다.

이 필드는 의도한 도메인 밖의 URL로 자격 증명을 보내는 것 같은 오용을 방지합니다.

자격 증명에서 표현식 사용하기

표현식을 사용해 워크플로가 실행될 때 자격 증명을 동적으로 설정할 수 있습니다:

워크플로에서 자격 증명이 담긴 데이터 경로를 찾습니다. 데이터의 정확한 파라미터 이름에 따라 달라집니다. 자격 증명을 담은 데이터가 필요할 노드에 도달했을 때 워크플로에서 사용 가능한지 확인하세요.
자격 증명을 만들 때 표현식을 쓰려는 필드 위에 마우스를 올립니다.
Expression을 켭니다.
표현식을 입력합니다.

n8n 프로젝트는 워크플로, 변수, 자격 증명을 별도 그룹으로 분리해 관리하기 쉽게 해줍니다. 프로젝트는 관련 리소스를 공유하고 구획화해 팀 협업을 쉽게 만듭니다.

더 알아보기

표현식: 노드 파라미터를 동적으로 채우는 문법
Gateway credits: 자격 증명 없이 모델·서비스 실행