> For the complete documentation index, see [llms.txt](https://guide.roundhr.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide.roundhr.com/setting/integrations/services/gmail/trouble-shooting.md).

# Gmail 접근 권한 설정

Gmail 접근 권한 설정은 Gmail 연동이 되지 않을 때 구글 관리 콘솔에서 앱 액세스· 도메인 위임 권한을 추가해 연동 문제를 해결하는 방법을 안내합니다.

## 개요

**Gmail 접근 권한 설정**은 Gmail 연동이 되지 않을 때 구글 관리 콘솔에서 필요한 접근 권한을 추가해 연동 문제를 해결하는 방법입니다. 상황에 따라 아래 세 가지 방법 중 하나를 사용합니다.

***

## 1. 안전하지 않음 앱으로 이동 (개별 계정)

구글 로그인 중 "안전하지 않은 앱" 경고가 나오면 **이동**을 선택해 진행합니다.

<figure><img src="https://3113620308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx3vbe9mozK3C5425TCxL%2Fuploads%2Fgit-blob-583f1ec754fdc14d19957fedb6b0db633db81901%2Fset_integ_services_gmail_trouble-shooting_s1_01.png?alt=media" alt="구글 로그인 중 안전하지 않은 앱 경고 화면에서 이동을 선택하는 화면"><figcaption><p>안전하지 않음 앱 이동</p></figcaption></figure>

{% hint style="info" %}
개별 계정이 아니라 조직 전체에 권한을 주려면 아래 2번을 참고하세요.
{% endhint %}

***

## 2. API 관리 > 앱 액세스 제어 추가 (조직 전체)

* 구글 어드민 [앱 액세스 제어 관리](https://admin.google.com/ac/owl/list?tab=configuredApps)에서 **Round Workflow** 앱을 추가합니다. 새 앱 구성을 추가해 주세요.

<figure><img src="https://3113620308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx3vbe9mozK3C5425TCxL%2Fuploads%2Fgit-blob-6496a4cb06b4c145ab7469c58378628329d1e36c%2Fset_integ_services_gmail_trouble-shooting_s2_01.png?alt=media" alt="구글 어드민 앱 액세스 제어 관리에서 새 앱 구성을 추가하는 화면"><figcaption><p>앱 액세스 제어 추가</p></figcaption></figure>

* 새 앱 구성에서 Round Workflow 앱의 클라이언트를 아래 값으로 검색해 추가합니다.
  * 검색: `320456075498-cdnbm7vghm77bi8rkcgj56jsq6ha86u4`

<figure><img src="https://3113620308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx3vbe9mozK3C5425TCxL%2Fuploads%2Fgit-blob-8aa2e36d4b472a3871fefa8e7df346426c0bb70d%2Fset_integ_services_gmail_trouble-shooting_s2_02.png?alt=media" alt="새 앱 구성에서 Round Workflow 클라이언트를 검색해 추가하는 화면"><figcaption><p>Round Workflow 앱 추가</p></figcaption></figure>

* 검토 완료까지 진행한 뒤 다시 Gmail 연동을 진행하면 정해진 권한대로 연동됩니다.

***

## 3. 도메인 위임 설정 (선택)

{% hint style="info" %}
개별 OAuth 설정을 한다면 도메인 전체 위임 설정은 하지 않아도 됩니다.
{% endhint %}

도메인 위임은 Google Workspace 기능으로, 모든 직원을 대신해 OAuth 액세스 권한을 부여해 직원이 개별적으로 권한을 부여할 필요가 없게 합니다.

* [도메인 위임](https://admin.google.com/ac/owl/domainwidedelegation)을 방문해 새 앱 구성 드롭다운을 열고 **새 앱 추가**를 클릭합니다.
* 새 클라이언트 추가에 아래 정보를 입력합니다.
  * 클라이언트 ID: `320456075498-cdnbm7vghm77bi8rkcgj56jsq6ha86u4.apps.googleusercontent.com`
  * OAuth 범위(이메일 읽기·발송 권한): `https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/gmail.send`
* 이후 다시 Gmail 연동을 하면 권한 오류 없이 연동됩니다.

***

## 자주 묻는 질문

<details>

<summary>앱 액세스 제어와 도메인 위임 중 무엇을 해야 하나요?</summary>

조직 전체에 권한을 주려면 2번(앱 액세스 제어)을 진행합니다. 도메인 위임(3번)은 선택 사항이며, 개별 OAuth 설정을 이미 했다면 도메인 위임은 하지 않아도 됩니다.

</details>

<details>

<summary>구글 로그인 중 "안전하지 않은 앱" 경고가 떠요.</summary>

개별 계정이라면 경고 화면에서 이동을 선택해 계속 진행하면 됩니다. 조직 전체에 권한을 주려면 이 방법 대신 2번(앱 액세스 제어)을 진행하세요.

</details>

<details>

<summary>앱 액세스 제어에는 어떤 앱을 추가하나요?</summary>

구글 어드민 앱 액세스 제어 관리에서 Round Workflow 앱을 추가합니다. 새 앱 구성에서 클라이언트를 `320456075498-cdnbm7vghm77bi8rkcgj56jsq6ha86u4` 값으로 검색해 추가한 뒤, 검토를 완료하고 다시 Gmail 연동을 진행하면 됩니다.

</details>