서비스 계정 사용은 OAuth2보다 더 복잡합니다. 시작하기 전에:

• 노드가 서비스 계정과 호환되는지 확인합니다.
• 서비스 계정을 사용해야 하는지 확인합니다. 대부분의 사용 사례에서 OAuth2가 더 나은 옵션입니다.
• 서비스 계정 생성 및 관리에 관한 Google 문서를 읽습니다.

사전 요구 사항#

• Google Cloud 계정을 생성합니다.

서비스 계정 설정#

n8n 자격 증명을 Google 서비스 계정에 연결하는 단계는 네 가지입니다:

1. Google Cloud Console 프로젝트 생성.
2. API 활성화.
3. Google Cloud 서비스 계정 설정.
4. n8n 자격 증명 완료.

Google Cloud Console 프로젝트 생성#

먼저 Google Cloud Console 프로젝트를 생성합니다. 이미 프로젝트가 있다면 다음 섹션으로 건너뜁니다:

1. Google 계정으로 Google Cloud Console에 로그인합니다.

2. 상단 메뉴에서 상단 내비게이션의 프로젝트 드롭다운을 선택하고 새 프로젝트를 선택하거나, 새 프로젝트 페이지로 직접 이동합니다.

3. 프로젝트 이름을 입력하고 프로젝트의 위치(조직 및/또는 상위 리소스)를 선택합니다.

4. 만들기를 선택합니다.

5. 상단 내비게이션을 확인하여 프로젝트 드롭다운에 방금 생성한 프로젝트가 선택되어 있는지 확인합니다. 그렇지 않으면 방금 생성한 프로젝트를 선택합니다.

   

API 활성화#

프로젝트가 생성되면 필요한 API를 활성화합니다:

1. Google Cloud Console - 라이브러리에 접속합니다. 올바른 프로젝트에 있는지 확인하세요.

   

2. API 및 서비스 > 라이브러리로 이동합니다.
3. 활성화하려는 API를 검색하고 선택합니다. 예를 들어 Gmail 노드의 경우 Gmail API를 검색하여 활성화합니다.
4. 일부 연동은 다른 API가 필요하거나 접근 권한 요청이 필요합니다:
   • Google Perspective: API 접근 권한 요청.
   • Google Ads: 개발자 토큰 발급 필요.

* Google Docs
* Google Sheets
* Google Slides

1. 사용 설정을 선택합니다.

Google Cloud 서비스 계정 설정#

1. Google Cloud Console - 라이브러리에 접속합니다. 올바른 프로젝트에 있는지 확인합니다.

   

2. 왼쪽 탐색 메뉴를 열고 APIs & Services > Credentials로 이동합니다. Google이 Credentials 페이지로 이동합니다.

3. + Create credentials > Service account를 선택합니다.

4. Service account name에 이름을 입력하고 Service account ID에 ID를 입력합니다. 자세한 내용은 서비스 계정 생성을 참조하세요.

5. Create and continue를 선택합니다.

6. 사용 사례에 따라 Select a role과 해당 섹션을 사용하여 Grant users access to this service account를 설정할 수 있습니다.

7. Done을 선택합니다.

8. Service Accounts 섹션에서 새로 생성한 서비스 계정을 선택합니다. Keys 탭을 엽니다.

9. Add key > Create new key를 선택합니다.

10. 나타나는 모달에서 JSON을 선택한 다음 CREATE를 선택합니다. Google이 파일을 컴퓨터에 저장합니다.

n8n 자격 증명 완료#

Google 프로젝트와 자격 증명이 완전히 구성되면 n8n 자격 증명을 완료합니다:

1. 다운로드한 JSON 파일을 엽니다.
2. client_email을 복사하여 n8n 자격 증명의 Service Account Email로 입력합니다.
3. private_key를 복사합니다. 주변의 " 표시는 포함하지 않습니다. n8n 자격 증명의 Private Key로 입력합니다.

4. 선택 사항: 사용자를 가장(Impersonate a User)할지 여부를 선택합니다(켜짐).
   1. 이 옵션을 사용하려면 Google Workspace 수퍼 관리자로 서비스 계정에 대해 도메인 전체 위임을 활성화해야 합니다.
   2. 가장할 사용자의 Email을 입력합니다.
5. 이 자격 증명을 HTTP Request 노드와 함께 사용할 계획이라면 Set up for use in HTTP Request node를 켭니다.
   1. 이 설정을 켜면 노드에 **Scope(s)**를 추가해야 합니다. n8n이 일부 스코프를 미리 채웁니다. 자세한 내용은 Google API의 OAuth 2.0 스코프를 참조하세요.
6. 자격 증명을 저장합니다.

동영상#

문제 해결#

서비스 계정이 Google Drive 파일에 접근할 수 없음#

서비스 계정은 서비스 계정의 연결된 사용자 이메일과 공유되지 않은 Google Drive 파일 및 폴더에 접근할 수 없습니다.

1. Google Cloud Console에 접속하여 서비스 계정 이메일을 복사합니다.
2. Google Drive에 접속하여 지정된 파일 또는 폴더로 이동합니다.
3. 파일 또는 폴더를 마우스 오른쪽 버튼으로 클릭하고 Share를 선택합니다.
4. 서비스 계정 이메일을 Add People and groups에 붙여넣습니다.
5. 읽기-쓰기 접근을 위해 Editor를 선택하거나 읽기 전용 접근을 위해 Viewer를 선택합니다.

도메인 전체 위임 활성화#

서비스 계정으로 사용자를 가장하려면 서비스 계정에 대해 도메인 전체 위임을 활성화해야 합니다.

서비스 계정에 도메인 전체 권한을 위임하려면 Google Workspace 도메인의 수퍼 관리자여야 합니다. 그런 다음:

1. Google Workspace 도메인의 관리자 콘솔에서 햄버거 메뉴를 선택한 다음 Security > Access and data control > API Controls를 선택합니다.
2. Domain wide delegation 패널에서 Manage Domain Wide Delegation을 선택합니다.
3. Add new를 선택합니다.
4. Client ID 필드에 서비스 계정의 Client ID를 입력합니다. Client ID를 얻으려면:
   • Google Cloud Console 프로젝트를 열고 Service Accounts 페이지를 엽니다.
   • OAuth 2 Client ID를 복사하여 Domain Wide Delegation의 Client ID로 사용합니다.
5. OAuth scopes 필드에 애플리케이션 접근 권한을 부여할 쉼표로 구분된 스코프 목록을 입력합니다. 예를 들어, 애플리케이션이 Google Drive API와 Google Calendar API에 도메인 전체 전체 접근이 필요한 경우 다음을 입력합니다: https://www.googleapis.com/auth/drive, https://www.googleapis.com/auth/calendar.
6. Authorize를 선택합니다.

Workspace의 모든 사용자를 가장할 수 있게 되기까지 5분에서 24시간이 걸릴 수 있습니다.