자격 증명 생성 및 편집
n8n v2.29자격 증명은 n8n 워크플로를 API나 데이터베이스와 같은 외부 서비스에 연결하는 데 사용되는, 안전하게 저장된 인증 정보입니다. 워크플로 에디터에서 노드를 편집할 때 자격 증명 드롭다운에서 새 자격 증명을 생성할 수도 있습니다.
자격 증명은 n8n 워크플로를 API나 데이터베이스와 같은 외부 서비스에 연결하는 데 사용되는, 안전하게 저장된 인증 정보입니다.
자격 증명 생성#
- 사이드 메뉴 왼쪽 상단의
.png)
Create 버튼을 선택합니다. Credential을 선택합니다. - n8n 인스턴스가 프로젝트1를 지원하는 경우, 자격 증명을 개인 공간(personal space) 내부에 생성할지 아니면 액세스 권한이 있는 특정 프로젝트 내부에 생성할지도 선택해야 합니다. 커뮤니티 버전을 사용 중이라면 자격 증명은 개인 공간 내부에 생성됩니다.
- 연결하려는 앱 또는 서비스를 선택합니다.
또는:
- Overview 페이지 또는 특정 프로젝트에서 오른쪽 상단의 Create 버튼을 사용합니다. Credential을 선택합니다.
- Overview 페이지에서 이 작업을 수행하는 경우 자격 증명은 개인 공간 내부에 생성됩니다. 프로젝트 내부에서 이 작업을 수행하는 경우 자격 증명은 해당 특정 프로젝트 내부에 생성됩니다.
- 연결하려는 앱 또는 서비스를 선택합니다.
워크플로 에디터에서 노드를 편집할 때 자격 증명 드롭다운에서 새 자격 증명을 생성할 수도 있습니다.
자격 증명 모달에 들어가면 서비스에 필요한 세부 정보를 입력합니다. 안내가 필요하면 credentials library에서 해당 서비스 페이지를 참조하세요.
자격 증명을 저장하면 n8n이 해당 자격 증명을 테스트하여 정상 작동하는지 확인합니다.
자격 증명 이름 지정
n8n은 새 자격 증명의 이름을 기본적으로 "노드 이름 account"로 지정합니다. 노드 이름을 변경하는 것과 마찬가지로 이름을 클릭하여 자격 증명의 이름을 변경할 수 있습니다. 자격 증명의 앱 또는 서비스, 유형, 용도를 식별할 수 있는 이름을 지정하는 것이 좋은 방법입니다. 이름 지정 규칙(naming convention)을 사용하면 자격 증명을 더 쉽게 추적하고 식별할 수 있습니다.
허용된 HTTP 요청 도메인#
Allowed HTTP Request Domains 필드는 웹 기반 API 및 서비스를 위한 많은 n8n 자격 증명에 표시됩니다. 이 필드는 HTTP Request 노드에서 해당 자격 증명을 선택했을 때, 그 자격 증명을 사용할 수 있도록 허용되는 도메인을 제어합니다. 자격 증명이 자체 전용 노드에서 사용될 때는 아무런 영향을 미치지 않습니다.
이 필드에는 세 가지 옵션이 있습니다.
- All: 자격 증명을 모든 URL에 대해 사용할 수 있습니다.
- Specific Domains: 특정 도메인으로 제한합니다(
httpbin.org, api.github.com처럼 쉼표로 구분된 목록을 제공). - None: HTTP Request 노드에서 자격 증명 사용이 완전히 차단됩니다.
이 필드는 자격 증명이 의도한 도메인 외부의 URL로 전송되는 것과 같은 자격 증명 오용을 방지합니다.
자격 증명 내 표현식#
표현식2을 사용하면 워크플로가 실행되는 동안 자격 증명을 동적으로 설정할 수 있습니다.
- 워크플로에서 자격 증명이 포함된 데이터 경로를 찾습니다. 이는 데이터의 정확한 매개변수 이름에 따라 달라집니다. 자격 증명이 필요한 노드에 도달했을 때, 해당 자격 증명을 포함한 데이터가 워크플로에서 사용 가능한 상태인지 확인하세요.
- 자격 증명을 생성할 때, 표현식을 사용하려는 필드 위에 마우스를 올립니다.
- Expression 토글을 켭니다.
- 표현식을 입력합니다.
예제 워크플로#
대화형 워크플로 데모입니다. 워크플로 JSON 보기 또는 n8n 공식 문서에서 확인하세요.
예제 사용하기#
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.