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

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

Google: 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. 상단 메뉴에서 프로젝트 드롭다운을 선택한 후,
    새 프로젝트(New project) 를 선택하거나
    새 프로젝트 만들기(New Project) 페이지로 이동합니다.
  3. 프로젝트 이름(Project name) 을 입력하고,
    위치(Location) 를 선택합니다.
  4. 생성(Create) 을 선택합니다.
  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. n8n에서 Google로 로그인을 선택하여 Google 인증을 완료합니다.
  4. 새 자격 증명 저장.

비디오#

문제 해결#

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 트렌드를 격주로 만나보세요!