n8n에서 지메일(gmail) 자격증명(credential) 등록하는 방법

n8n에서 Gmail OAuth2 API를 사용하기 위한 자격증명 등록하는 방법에 대해 설명합니다. 크게 Google Cloud에서 사전에 설정해야 할 부분과 n8n에서 자격 증명을 등록하는 두 단계 작업으로 진행합니다.

1. Google Cloud에서 OAuth 설정

(1) Google Cloud 계정 생성

• 연동할 지메일 계정과 동일한 계정으로 구글 클라우드에 가입한다.

(2) 구글 클라우드 콘솔 프로젝트 생성

1. 오른쪽 상단에서 콘솔 메뉴를 클릭해서 콘솔 화면으로 이동한다.
   

   

   
   
2. 팝업의 서비스 약관 2개 항목을 체크 표시하고 "동의 및 계속하기"를 클릭한다.
   

   

   
   
3. 콘솔 화면에서 왼쪽 상단 "프로젝트 선택" 버튼을 클릭하고 프로젝트 선택 팝업에서 "새 프로젝트"를 클릭한다.
   

   

   
   
4. 새 프로젝트 생성 화면에서 프로젝트 이름을 작성하고 "만들기" 버튼을 클릭한다.
   

   

   
   
5. 콘솔 화면 왼쪽 상단 "프로젝트 선택" 버튼을 클릭해서 방금 만든 프로젝트를 클릭한다.
   

   

   
   

(3) APIs 활성화 하기

1. 키보드 자판에서 마침표(".")를 눌러서 탐색 메뉴를 오픈한다.
2. 탐색 메뉴에서 "API 및 서비스" > "라이브러리"로 이동한다.
   

   

   
   
3. "API 및 서비스 검색" 입력란에 "gmail api"을 입력하고 키보드 Enter를 누른다.
   

   

   
   
4. 검색 결과에서 "Gmail API"를 선택한다.
   

   

   
   .
5. 제품 세부정보 화면에서 "사용" 버튼을 클릭해서 활성화 한다.
   

   

   
   

(4) OAuth 동의 화면 설정하기

1. Gmail API를 활성화 했던 화면에서 왼쪽 탐색 메뉴의 "OAuth 동의 화면"을 클릭한다.
   

   

   
   
2. "OAuth 동의 화면"의 User Type을 "외부"를 선택한다. Google Workspace 사용자가 아닐 경우 앱을 외부(일반) 사용자에게 제공하는 것만 가능하다. 그리고 "만들기" 버튼을 클릭한다.
   

   

   
   
3. 앱 등록 수정 화면에서 앱 정보(앱 이름, 사용자 지원 이메일)를 작성한다.
   

   

   
   
4. 승인된 도메인 항목의 "+ 도메인 추가" 버튼을 클릭한다.
5. n8n 클라우드 서비스를 사용하는 경우 n8n.cloud를 입력하고,
6. self-hosting 방식으로 구축했다면 구축한 n8n 도메인을 입력한다.
   

   

   
   
7. 개발자 연락처 정보에 이메일 주소를 입력하고 "저장 후 계속" 버튼을 클릭한다.
   

   

   
   
8. 범위 단계에서는 추가할 내용이 없다. "저장 후 계속" 버튼을 클릭한다.
9. 외부(External) 사용자 유형인 경우, 테스트 사용자 등록이 필수이다. 테스트 사용자 단계에서 "+ ADD USERS" 버튼을 클릭해서 테스트 사용자를 등록한다. 그리고 나서 "저장 후 계속" 버튼을 클릭한다.
   

   

   
   
10. 요약 단계에서 입력한 정보를 확인 후 "대시보드로 돌아가기" 버튼을 클릭합니다.

(5) Google OAuth 클라이언트 자격 증명 만들기

1. 왼쪽 탐색 메뉴에서 "사용자 인증 정보" 메뉴를 클릭한다.
   

   

   
   .
2. 사용자 인증 정보 화면에서 "+ 사용자 인증 정보 만들기" 메뉴를 클릭하고 "OAuth 클라이언트 ID"를 선택한다.
   

   

   
   
3. 애플리케이션 유형 항목에서 "웹 애플리케이션"을 드랍다운 메뉴에서 선택한다. 그리고 적당한 이름을 작성한다.
   

   

   
   
4. 승인된 리디렉션 URI 항목에서 "+ URI 추가" 버튼을 클릭해서 n8n에서 카피한 OAuth Redirect URL을 입력합니다. 리디렉션 URI 확인 방법은 "2. n8n 자격 증명 설정" 챕터의 c 단계에서 확인 할 수 있다. 그리고 나서 "만들기" 버튼을 클릭한다.
   

   

   
   
5. "OAuth 클라이언트 생성됨" 팝업에서 확인을 클릭한다.
6. 생성된 OAuth 2.0 클라이언트 ID 항목에서 "클라이언트 ID"를 카피 해 둔다.
   

   

   
   
7. 그리고 클라이언트 ID 이름을 클릭해서 상세 페이지에서 "클라이언트 보안 비밀번호"도 카피해 둔다.
   

   

   
   

2. n8n 자격 증명 설정

1. 브라우저에서 n8n에 로그인한다.
2. "Overview" 화면에서 "+ Create" > "Credential" 메뉴를 클릭한다.
   

   

   
   .
3. Add new credential 팝업에서 "Gmail OAuth2 API"를 선택한다.
   

   

   
   .
4. 전 단계에서 카피 해둔 클라이언트 ID와 클라이언트 보안 비밀번호를 입력하고 "Sign in with Google" 버튼을 클릭한다.
   

   

   
   
5. Choose an account 팝업에서 연동할(구글 클라우드에서 생성했던) 계정을 선택한다.
   

   

   
   
6. "Google에서 확인하지 않은 앱"이라는 메세지가 뜨면 "계속"을 클릭한다.
7. "Google 계정에 대한 액세스를 요청합니다" 화면에서 모드 선택을 클릭 후 "계속"을 클릭한다. "Got connected. The window can be closed now."라는 메세지가 보이면 연동된 것이다.