콘텐츠로 이동
📣 인포그랩에서 OpenAI 기술 기반으로 자체 개발한 자동화 번역 프로그램을 통해 n8n 공식 문서의 한글판을 국내 최초로 제공합니다.

n8n 공식 기술 문서 한글판 by 인포그랩

Google: OAuth2 일반#

이 문서에는 사용자 정의 작업와 함께 사용할 일반 OAuth2 Google 자격 증명을 만드는 방법에 대한 지침이 포함되어 있습니다.

n8n Cloud 사용자 참고 사항

다음 노드에서는 OAuth 섹션에서 Sign in with Google 을 선택하여 인증할 수 있습니다:

필요조건#

OAuth 설정#

n8n 자격 증명을 Google 서비스에 연결하는 데는 다섯 단계가 필요합니다:

  1. Google Cloud Console 프로젝트 만들기.
  2. API 활성화.
  3. OAuth 동의 화면 구성.
  4. Google OAuth 클라이언트 자격 증명 만들기.
  5. n8n 자격 증명 마무리.

Google Cloud Console 프로젝트 만들기#

먼저, Google Cloud Console 프로젝트를 만듭니다. 이미 프로젝트가 있는 경우 다음 섹션으로 건너뛰십시오:

  1. Google Cloud Console에 Google 자격 증명을 사용하여 로그인합니다.
  2. 상단 메뉴에서 상단 내비게이션의 프로젝트 드롭다운을 선택하고 새 프로젝트를 선택하거나 새 프로젝트 페이지로 직접 이동합니다.
  3. 프로젝트 이름을 입력하고 프로젝트의 위치를 선택합니다.
  4. 생성을 선택합니다.

  5. 상단 내비게이션을 확인하고 프로젝트 선택 드롭다운에서 방금 생성한 프로젝트가 선택되었는지 확인합니다. 그렇지 않은 경우 방금 만든 프로젝트를 선택합니다.

    Google Cloud 상단 내비게이션의 프로젝트 드롭다운
    Google Cloud 상단 내비게이션의 프로젝트 드롭다운 확인

API 활성화#

프로젝트가 생성되면 액세스할 API를 활성화합니다:

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

    Google Cloud 상단 네비게이션의 프로젝트 드롭다운
    Google Cloud 상단 네비게이션에서 프로젝트 드롭다운을 확인하세요

  2. APIs & Services > Library 로 이동합니다.

  3. 활성화할 API를 검색하고 선택합니다.
    예를 들어, Gmail 노드를 사용하려면 Gmail API 를 검색하여 활성화하세요.
  4. 일부 통합 서비스는 추가 API 활성화 또는 액세스 요청이 필요할 수 있습니다: * Google Perspective API: API 액세스 요청 * Google Ads: 개발자 토큰(Developer Token){:target=_blank .external-link) 발급 필요

Google Drive API 필요

다음 서비스는 자체 API 외에도 Google Drive API 를 활성화해야 합니다: * Google Docs * Google Sheets * Google Slides

Google Vertex AI API

Vertex AI API 를 활성화할 뿐만 아니라,
Cloud Resource Manager API도 활성화해야 합니다.

  1. ENABLE 버튼을 선택하여 API를 활성화합니다.

OAuth 동의 화면 구성#

이전에 Google Cloud 프로젝트에서 OAuth를 사용한 적이 없다면 OAuth 동의 화면을 구성해야 합니다:

  1. Google Cloud Console - 라이브러리에 접속합니다. 올바른 프로젝트에 있는지 확인합니다.
    Google Cloud 상단 내비게이션의 프로젝트 드롭다운
    Google Cloud 상단 내비게이션의 프로젝트 드롭다운 확인
  2. 왼쪽 내비게이션 메뉴를 열고 API 및 서비스 > OAuth 동의 화면으로 이동합니다.
  3. 사용자 유형에서 조직의 Google 워크스페이스 내 사용자 액세스를 위해 내부를 선택하거나 Google 계정을 가진 모든 사용자에 대해 외부를 선택합니다. 사용자 유형에 대한 자세한 정보는 Google의 사용자 유형 문서를 참조하십시오.
  4. 생성을 선택합니다.
  5. 필수 정보를 입력합니다:
    • 앱 이름
    • 사용자 지원 이메일
    • 개발자 연락처 정보의 이메일 주소 필드
  6. 허가된 도메인 섹션에서 n8n의 클라우드 서비스를 사용하는 경우 n8n.cloud를 추가합니다. 셀프 호스팅하는 경우 n8n 인스턴스의 도메인을 추가합니다.
  7. 저장하고 계속하기를 선택하여 범위 페이지로 이동합니다.
  8. 범위를 설정할 필요가 없습니다. 저장하고 계속하기를 다시 선택하여 요약 페이지로 이동합니다.
  9. 요약 페이지에서 정보의 정확성을 검토합니다.

Google OAuth 클라이언트 자격증명 생성하기#

그 다음, Google에서 OAuth 클라이언트 자격증명을 생성합니다:

  1. API 및 서비스 섹션에서 자격 증명을 선택합니다.
  2. + 자격 증명 생성 > OAuth 클라이언트 ID를 선택합니다.
  3. 애플리케이션 유형 드롭다운에서 웹 애플리케이션을 선택합니다.
  4. Google이 자동으로 이름을 생성합니다. 콘솔에서 인식할 수 있는 이름으로 이름을 업데이트합니다.
  5. n8n 자격 증명에서 OAuth 리디렉션 URL을 복사합니다. Google 콘솔의 승인된 리디렉션 URI에 붙여넣습니다.
  6. 생성을 선택합니다.

n8n 자격 증명 완료하기#

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

  1. Google의 OAuth 클라이언트 생성됨 모달에서 클라이언트 ID를 복사합니다. n8n 자격 증명에 입력합니다.
  2. 동일한 Google 모달에서 클라이언트 비밀을 복사합니다. n8n 자격 증명에 입력합니다.
  3. 이 자격 증명에 대한 범위를 제공해야 합니다. 자세한 내용은 Scopes를 참조하세요. 여러 범위를 공백으로 구분된 목록으로 입력합니다. 예를 들어: 
    1
    https://www.googleapis.com/auth/gmail.labels https://www.googleapis.com/auth/gmail.addons.current.action.compose
  4. n8n에서 Google로 로그인을 선택하여 Google 인증을 완료합니다.
  5. 새 자격 증명을 저장합니다.

비디오#

다음 비디오는 위에 설명된 단계를 보여줍니다:

범위#

Google 서비스는 하나 이상의 가능한 액세스 범위를 가집니다. 범위는 사용자가 할 수 있는 일을 제한합니다. 모든 서비스의 범위 목록은 OAuth 2.0 Scopes for Google APIs를 참조하세요.

n8n은 모든 범위를 지원하지 않습니다. 일반적인 Google OAuth2 API 자격 증명을 생성할 때, 아래의 지원되는 범위 목록에서 범위를 입력할 수 있습니다. n8n이 이미 지원하지 않는 범위를 입력하면 작동하지 않습니다.

지원되는 범위
서비스 사용 가능한 범위
Gmail https://www.googleapis.com/auth/gmail.labels
https://www.googleapis.com/auth/gmail.addons.current.action.compose
https://www.googleapis.com/auth/gmail.addons.current.message.action
https://mail.google.com/
https://www.googleapis.com/auth/gmail.modify
https://www.googleapis.com/auth/gmail.compose
Google Ads https://www.googleapis.com/auth/adwords
Google Analytics https://www.googleapis.com/auth/analytics
https://www.googleapis.com/auth/analytics.readonly
Google BigQuery https://www.googleapis.com/auth/bigquery
Google Books https://www.googleapis.com/auth/books
Google Calendar https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.events
Google Cloud Natural Language https://www.googleapis.com/auth/cloud-language
https://www.googleapis.com/auth/cloud-platform
Google Cloud Storage https://www.googleapis.com/auth/cloud-platform
https://www.googleapis.com/auth/cloud-platform.read-only
https://www.googleapis.com/auth/devstorage.full_control
https://www.googleapis.com/auth/devstorage.read_only
https://www.googleapis.com/auth/devstorage.read_write
Google Contacts https://www.googleapis.com/auth/contacts
Google Docs https://www.googleapis.com/auth/documents
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
Google Drive https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.appdata
https://www.googleapis.com/auth/drive.photos.readonly
Google Firebase Cloud Firestore https://www.googleapis.com/auth/datastore
https://www.googleapis.com/auth/firebase
Google Firebase Realtime Database https://www.googleapis.com/auth/userinfo.email
https://www.googleapis.com/auth/firebase.database
https://www.googleapis.com/auth/firebase
Google Perspective https://www.googleapis.com/auth/userinfo.email
Google Sheets https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
Google Slide https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/presentations
Google Tasks https://www.googleapis.com/auth/tasks
Google Translate https://www.googleapis.com/auth/cloud-translation
GSuite Admin https://www.googleapis.com/auth/admin.directory.group
https://www.googleapis.com/auth/admin.directory.user
https://www.googleapis.com/auth/admin.directory.domain.readonly
https://www.googleapis.com/auth/admin.directory.userschema.readonly

문제 해결#

Google이 이 앱을 검증하지 않았습니다#

OAuth 인증 방법을 사용할 경우,
"Google hasn't verified this app" (Google에서 이 앱을 검증하지 않았습니다) 라는 경고 메시지가 표시될 수 있습니다.

이 문제를 방지하려면, 인증하려는 동일한 계정에서 OAuth 자격 증명을 생성하세요.

만약 개발자 또는 다른 제3자가 생성한 자격 증명을 사용해야 한다면,
다음 문서의 안내를 따르세요:
Google Cloud 문서 | 인증 오류: Google hasn't verified this app.

Google Cloud 앱이 권한을 잃어버림#

Google Cloud 앱의 게시 상태(Publishing status) 가 Testing 으로 설정되고,
사용자 유형(User type) 이 External 인 경우,
동의(Consent) 및 토큰이 7일 후 만료됩니다.

자세한 내용은 Google Cloud Platform Console 도움말 | OAuth 동의 화면 설정을 참고하세요.

이 문제를 해결하려면,
n8n 자격 증명 모달(Credentials modal)에서 앱을 다시 연결하세요.

인포레터에서 최신 DevOps 트렌드를 격주로 만나보세요!