구글 크리덴셜 설정

지메일(Gmail), 구글 시트(Google Sheets), 구글 캘린더(Google Calendar) 등 구글 서비스와 연동하는 노드를 사용하려면 먼저 구글 크리덴셜(Credential)을 **에이전트리아(Agentria)**에 등록해야 합니다.

에이전트리아는 OAuth 2.0 연동을 지원합니다. 구글 계정으로 로그인하기만 하면 별도의 키 발급 없이 크리덴셜 등록이 끝나며, 커스텀 앱이나 조직 브랜딩이 필요한 고급 사용자는 Client ID·Client Secret을 직접 발급받아 연동할 수도 있습니다.

사전 준비

• 구글 계정이 필요합니다.

• 구글 서비스 노드(예: Gmail 노드)를 사용하는 어빌리티가 있으면 노드 편집기에서 바로 크리덴셜을 등록할 수 있습니다. 어빌리티가 없어도 프로젝트의 크리덴셜 메뉴에서 미리 등록해둘 수 있습니다.

OAuth 2.0으로 연동하기 (기본, 권장)

대부분의 사용자에게 권장하는 방법입니다. 구글 계정으로 로그인하는 것만으로 연동이 끝나며, 키를 따로 발급받거나 관리할 필요가 없습니다.

1단계: 크리덴셜이 필요한 노드 준비

구글 서비스와 연동하는 노드를 사용하는 상황을 가정합니다. 이 가이드에서는 Gmail 노드를 예로 듭니다.

2단계: 노드에서 크리덴셜 선택

Gmail 노드를 더블 클릭하여 노드 편집기로 진입한 뒤 크리덴셜 드롭다운을 확인합니다. 아래 화면은 이미 크리덴셜이 등록된 상태를 예시로 보여주며, 실제로 처음 진입하면 목록이 비어 있습니다. 등록된 크리덴셜이 없다면 + 새 크리덴셜 추가를 클릭합니다.

3단계: 기존 크리덴셜 연결 상태 확인

이미 등록된 크리덴셜이 있다면 목록에서 연필 아이콘을 클릭해 수정 화면으로 진입할 수 있습니다. Authentication 영역의 상태가 연결 안 됨으로 표시된다면 아직 구글 계정과 연동되지 않은 것이므로 Google Connect가 필요합니다.

4단계: 프로젝트에서 크리덴셜 관리

새 크리덴셜은 노드 편집기가 아니라 프로젝트에서도 등록할 수 있습니다. 왼쪽 패널의 크리덴셜 메뉴로 진입하면 프로젝트의 모든 크리덴셜을 목록으로 관리할 수 있습니다. 처음에는 목록이 비어 있으며, 우측 상단의 크리덴셜 추가 버튼을 클릭합니다.

5단계: 새 크리덴셜 추가

연결할 앱 또는 서비스를 선택하세요 드롭다운에서 Google Gmail처럼 사용할 서비스를 검색해 선택합니다. 크리덴셜 이름과 설명을 입력합니다.

6단계: 인증 방식 선택

Authentication 드롭다운에서 인증 방식을 선택합니다.

• Oauth 2.0: 서비스에 로그인하면 연결됩니다. 키를 따로 설정할 필요가 없어요.

• Client ID / Client Secret: 서비스 콘솔에서 발급한 키(토큰)를 붙여넣어 연결합니다.

일반 사용자에게는 Oauth 2.0 방식을 권장합니다.

Client ID / Client Secret을 선택하면 위와 같이 Callback URL, Client ID, Client Secret 입력 필드가 나타납니다. 이 방식은 커스텀 앱이나 조직 브랜딩이 필요한 고급 사용자를 위한 옵션이며, 발급 방법은 이 문서의 "Client ID·Client Secret으로 연동하기" 섹션에서 별도로 안내합니다. 이어지는 단계는 Oauth 2.0을 선택했다고 가정합니다.

7단계: 구글 계정 선택

Google Connect 버튼을 클릭하면 구글 계정 선택 화면으로 이동합니다. 연동할 계정을 선택합니다.

8단계: 접근 권한 허용

Gmail을 통해 수행할 작업에 필요한 권한 항목을 확인하고 계속을 클릭합니다.

9단계: 연동 완료 확인 및 저장

크리덴셜 설정 창으로 돌아오면 Authentication 상태가 연결됨으로 바뀐 것을 확인할 수 있습니다. 저장을 클릭하면 크리덴셜 등록이 완료되며, 이제 노드에서 이 크리덴셜을 선택해 바로 실행할 수 있습니다.

Client ID / Client Secret으로 연동하기 (고급)

커스텀 앱이나 조직 브랜딩이 필요한 고급 사용자는 구글 클라우드 콘솔에서 직접 OAuth 클라이언트를 생성해 Client ID와 Client Secret을 발급받아 연동할 수 있습니다. Oauth 2.0 방식보다 단계가 많고 구글 클라우드 콘솔 설정이 필요합니다. 발급한 Client ID·Client Secret은 한 번 발급해두면 여러 구글 기반 노드에서 재사용할 수 있습니다.

1단계: 구글 클라우드 콘솔 접속

크리덴셜 발급을 위해 브라우저에서 새 탭 또는 새 창을 열고 🔗구글 클라우드 콘솔 Auth 플랫폼 페이지로 접속합니다.

프로젝트 생성(Create Project) 버튼을 클릭하여 프로젝트를 생성합니다.

2단계: OAuth 관리

OAuth는 인터넷 사용자 인증 및 권한 부여를 위한 개방형 표준 프로토콜입니다.

구글 크리덴셜을 발급하기 위해서는 OAuth 플로우를 거쳐야 합니다.

프로젝트 명을 설정하고 조직(Organization)을 선택합니다.

개인 사용자라면 '조직 없음(No organization)' 상태로 두고 만들기(Create)를 클릭합니다.

시작하기(Get Started) 버튼을 클릭하여 프로젝트를 구성합니다.

1단계: 앱 정보(App Information)

• 애플리케이션 이름(App name) 설정

• 사용자 이메일(User support) 설정

2단계: 사용 대상(Audience)

• 내부(Internal): 소속된 조직 내 Google Workspace 사용자를 대상으로 제한 (조직 내부 앱을 만들 때 적합)

• 외부(External): Google 계정이 있는 모든 테스트 사용자를 대상으로 하며, 테스트 사용자 목록에 추가한 사용자들만 이용 가능 (대중적으로 서비스할 앱을 만들 때 적합)

3단계: 연락처 정보(Contact Information)

• 연락처 정보에 프로젝트 변경 사항을 보고받을 이메일 주소 입력 (사용자 이메일과 동일해도 됨)

4단계: 완료(Finish)

• Google 정책에 동의하고 프로젝트 생성

만들기(Create)를 클릭하면 OAuth 프로젝트 구성이 완료됩니다.

3단계: OAuth 클라이언트 ID 생성

사용자 인증 정보를 생성하기 위해 클라이언트 ID를 생성해야 합니다.

이 단계를 진행하는 과정에서 Client ID와 Client Secret이 표시된다면, 반드시 안전한 곳에 복사해두어야 합니다.

OAuth 클라이언트 생성(Create OAuth client)을 클릭하여 ID를 생성합니다.

만약 버튼을 찾기 어렵다면, 사이드바에서 고객(클라이언트, Clients) 탭으로 진입하여 +클라이언트 생성(Create client)을 클릭하면 같은 ID 생성 과정을 진행할 수 있습니다.

• 에이전트리아에서 사용하기 위해 애플리케이션 유형은 웹 애플리케이션(Web application)으로 합니다.

• 클라이언트 ID 이름을 입력합니다.

• JavaScript 출처(origins)는 생략해도 됩니다.

• 이제 리디렉션 URL을 입력할 차례입니다.

사용자 인증을 진행할 때 성공 또는 실패 결과를 돌려주기 위해 리디렉션 URL(콜백 URL)이 필요합니다.

구글 콘솔 페이지를 잠시 그대로 두고, 승인된 리디렉션 URL을 추가하기 위해 에이전트리아 크리덴셜 설정 페이지로 이동합니다.

4단계: 에이전트리아에서 크리덴셜 추가

Authentication을 Client ID / Client Secret으로 선택한 상태입니다.

아래의 Callback URL을 복사하여 5단계를 진행합니다.

크리덴셜 팝업창은 아직 저장할 수 없는 상태이므로, 에이전트리아 페이지를 그대로 두고 다시 구글 콘솔 페이지로 이동합니다.

5단계: Callback URL 등록

클라이언트 ID 만들기를 진행 중이던 구글 클라우드 콘솔에서 승인된 리디렉션 URL 부분의 +URI 추가(Add URI) 버튼을 클릭하면 리디렉션 URL 입력창이 나옵니다.

입력창에 4단계에서 복사해둔 Callback URL을 붙여넣습니다.

Create(만들기)를 클릭하여 저장하면 OAuth 클라이언트가 생성됩니다.

생성 완료 팝업은 닫아도 됩니다.

6단계: Secret 보관 (중요)

고객(Clients) 탭에서 Client ID를 클릭하면 위에서 닫았던 팝업의 내용을 다시 확인할 수 있습니다.

시간이 지나면 보안 비밀번호를 복사할 수 없으니 반드시 만든 직후에 클라이언트 ID(Client ID)와 클라이언트 암호(Client Secret)를 복사하여 안전한 곳에 저장합니다.

JSON 파일 형태로 다운받아 안전한 곳에 보관하는 것도 좋은 방법입니다.

이 정보는 8단계에서 사용합니다.

7단계: 데이터 액세스 범위 추가

사이드바에서 데이터 액세스(Data Access) 탭으로 진입합니다.

범위 추가 또는 삭제(Add or remove scopes) 버튼을 클릭하면 사이드 팝업이 열립니다.

상단 메시지의 Google API 라이브러리 🔗링크로 접속합니다.

검색창에 필요한 API를 검색합니다. (예시: Gmail API, Google Sheets API)

본 가이드는 Gmail API 기준으로 설명합니다.

검색 결과를 선택하고 사용(Enable) 버튼을 클릭해 활성화합니다.

이제 구글 클라우드 콘솔에서의 모든 설정이 끝났습니다. 에이전트리아 페이지로 돌아갑니다.

8단계: 크리덴셜에 Client ID·Client Secret 입력

에이전트리아에서 설정 중이던 크리덴셜 팝업창의 Client ID, Client Secret 필드에 6단계에서 기록해두었던 값을 입력합니다.

만약 정보를 복사해두지 않았다면 Clients 탭으로 접속해 Client ID를 클릭하여 다시 확인할 수 있습니다.

Google Connect 버튼을 클릭하여 구글 계정을 연동합니다.

연동 방식은 Oauth 2.0 방식의 7~9단계와 동일합니다.

저장을 클릭하면 크리덴셜 설정이 완료되고 영역 상태가 연결됨으로 표시됩니다.

참고: 이 방식으로 발급한 클라이언트 정보는 재사용할 수 있지만, 6개월 동안 사용하지 않으면 기한이 만료됩니다. 만료된 경우 다시 사용을 허용한 후 인증을 진행하면 됩니다.

다음 단계

구글 크리덴셜 설정이 완료되었습니다.

이제 노드에서 크리덴셜을 선택해 구글 서비스 연동을 바로 사용할 수 있습니다.

• 🔗 Gmail 노드 사용하기

자주 묻는 질문

구글 크리덴셜이란 무엇인가요?

구글 크리덴셜은 Gmail, 구글 시트, 구글 캘린더 등 구글 서비스와 연동하는 노드가 사용자의 구글 계정에 접근할 수 있도록 에이전트리아에 등록하는 인증 정보입니다. 이 정보가 등록되어 있어야 노드가 실제 구글 계정 데이터를 읽고 쓸 수 있습니다.

구글 크리덴셜은 언제 필요한가요?

Gmail 노드처럼 구글 서비스와 연동하는 노드를 워크플로에 추가해 실행하려는 시점에 필요합니다. 크리덴셜이 등록되어 있지 않거나 구글 계정과 연결되지 않은 상태라면 노드를 실행할 수 없습니다.

Oauth 2.0과 Client ID/Client Secret 중 어떤 방식을 선택해야 하나요?

대부분의 사용자는 별도의 키 발급 없이 구글 계정 로그인만으로 연동되는 Oauth 2.0 방식을 사용하면 됩니다. 커스텀 앱이나 조직 브랜딩이 필요한 고급 사용자만 구글 클라우드 콘솔에서 직접 발급한 Client ID·Client Secret을 사용하는 방식을 선택하면 됩니다.

구글 크리덴셜은 노드와 어떻게 연결되나요?

Gmail 노드 등 구글 서비스와 연동하는 노드의 편집기에서 크리덴셜 드롭다운을 열어 등록된 크리덴셜을 선택하면 됩니다. 크리덴셜은 프로젝트 단위로 등록되므로, 한 번 등록해두면 같은 프로젝트의 여러 구글 서비스 노드에서 재사용할 수 있습니다.