](https://saml.prod-ap-syd.verkada.com/saml/sso/%3Cclient-ID%3E)
{% hint style="warning" %}
다음을 참조하십시오 **Admin > Data Privacy > Data Residency > Data Processing Location** 에서 리전 위치를 확인합니다.
{% endhint %}
{% endstep %}
{% step %}
**로그인을 완료하기 위해 Google Workspace 앱 구성 페이지로 리디렉션됩니다.**
{% endstep %}
{% endstepper %}
***
### 모바일 애플리케이션을 통해 로그인
{% hint style="info" %}
Android 및 iOS용 Command는 SAML을 통한 로그인을 지원합니다.
{% endhint %}
{% stepper %}
{% step %}
**이메일 주소 필드에 사용자의 이메일을 입력하고 다음을 클릭합니다.**
{% endstep %}
{% step %}
**로그인 절차를 완료하기 위해 IdP(Google Workspace)로 리디렉션됩니다.**
{% endstep %}
{% endstepper %}
{% endtab %}
{% tab title="사용자 프로비저닝" %}
## Google Workspace 사용자 프로비저닝
Google Workspace 기본 통합을 통해 조직은 Google Workspace의 사용자와 그룹을 Verkada Command로 자동 동기화할 수 있습니다. 이를 통해 ID 관리와 일반적인 사용자 온보딩이 간소화됩니다.
Okta 또는 Azure와의 Verkada SCIM 통합과 달리, 이 통합은 도메인 전체 위임이 설정된 Google 서비스 계정을 통해 인증되는 Google Workspace Admin SDK 및 Reports API를 사용합니다.
통합이 활성화되면 Command에서 다음을 수행할 수 있습니다:
* 선택한 Google Workspace 그룹 또는 조직 단위(OU)에서 사용자 및 그룹 가져오기
* 이를 관리형 사용자 및 그룹으로 Command에 동기화
* 예약된 백그라운드 동기화 및 Admin UI의 온디맨드 동기화로 디렉터리 정확성 유지
***
### Google 서비스 계정 만들기
Command가 Google Workspace 도메인에서 사용자 및 그룹 데이터를 읽으려면 서비스 계정을 사용하여 Google API에 인증해야 합니다. 이 유형의 계정은 프로그래밍 방식의 액세스를 위해 설계되었으며 올바른 API 범위 및 도메인 전체 위임으로 구성해야 합니다. 이러한 설정은 다음에서 구성됩니다 [Google Cloud 콘솔](https://console.cloud.google.com/?hl=en-au) 계정.
#### 정책 및 역할 확인
먼저 사용자에게 서비스 계정을 만들고 서비스 계정 JSON 키를 생성할 권한이 있는지 확인해야 합니다. 테넌트의 보안 정책에 의해 차단되지 않도록 하려면:
{% stepper %}
{% step %}
**다음으로 이동합니다** [**Google Cloud 콘솔**](https://console.cloud.google.com/?hl=en-au) **그리고 최고 관리자 자격 증명으로 로그인합니다.**
{% endstep %}
{% step %}
**왼쪽 상단에서 프로젝트 선택기 드롭다운을 열고 최상위(유형: 조직) 리소스를 선택합니다.**
{% endstep %}
{% step %}
**왼쪽 패널에서 IAM & Admin → IAM으로 이동합니다.**
{% endstep %}
{% step %}
**주 구성원별 보기에서 액세스 권한 부여를 클릭합니다.**
a. 다음에서 **주 구성원 추가**, 사용자의 이메일 주소를 입력합니다.\
b. 다음에서 **역할 할당**, 다음을 검색하여 선택합니다 **조직 정책 관리자**.\
c. 클릭 **저장**.
{% endstep %}
{% step %}
**왼쪽 패널에서 조직 정책을 선택합니다.**
{% endstep %}
{% step %}
**정책 목록에서 다음을 검색하여 사용 중지합니다:**
{% code title="사용 중지할 조직 정책" %}
```
서비스 계정 생성 사용 중지 | 관리됨
서비스 계정 생성 사용 중지 | 관리됨(레거시)
서비스 계정 키 생성 사용 중지 | 관리됨
서비스 계정 키 생성 사용 중지 | 관리됨(레거시)
```
{% endcode %}
{% endstep %}
{% endstepper %}
#### 서비스 계정 만들기
{% stepper %}
{% step %}
**다음** [**Google Cloud 콘솔**](https://console.cloud.google.com/?hl=en-au)**, 왼쪽 상단에서 프로젝트 선택기 드롭다운을 엽니다.**
{% endstep %}
{% step %}
**새 프로젝트를 클릭합니다.**
{% endstep %}
{% step %}
**프로젝트 이름을 입력합니다(예: *****Verkada 사용자 동기화*****)를 입력하고 프로젝트를 만듭니다.**
{% endstep %}
{% step %}
**프로젝트가 생성되면 왼쪽 상단 탐색 모음에서 해당 프로젝트가 선택되었는지 확인합니다.**
{% endstep %}
{% step %}
**왼쪽 사이드바에서 IAM & Admin → Service Accounts로 이동합니다.**
{% endstep %}
{% step %}
**+ 서비스 계정 만들기를 클릭합니다.**
{% endstep %}
{% step %}
**다음 필드를 입력합니다:**
* **이름:** 설명적인 이름을 입력합니다(예: *Verkada 사용자 프로비저닝*)
* **ID:** 그대로 두거나 사용자 지정합니다(선택 사항)
* **설명:** 다음과 같은 메모를 추가합니다 *Verkada가 Workspace 디렉터리 데이터를 읽는 데 사용* (선택 사항)
{% endstep %}
{% step %}
**만들기 및 계속을 클릭합니다.**
{% endstep %}
{% step %}
**프로젝트 액세스 권한 부여 단계는 건너뜁니다. 여기에는 역할이 필요하지 않습니다.**
{% endstep %}
{% step %}
**계속 → 완료를 클릭합니다.**
{% endstep %}
{% step %}
**서비스 계정 목록에서 새로 생성한 계정의 OAuth 2 클라이언트 ID를 복사합니다. 설정을 완료하려면 나중에 이 ID가 필요합니다.**
{% endstep %}
{% endstepper %}
#### JSON 키 생성
{% stepper %}
{% step %}
**서비스 계정 목록에서 계정 이름을 클릭하거나 새 서비스 계정 옆의 점 3개를 선택한 후 키 관리를 선택합니다.**
{% endstep %}
{% step %}
**키 탭에서 키 추가 → 새 키 만들기를 클릭합니다.**
{% endstep %}
{% step %}
**JSON을 선택하고 만들기를 클릭합니다.**
{% endstep %}
{% step %}
**A `.json` 파일이 컴퓨터에 다운로드됩니다. 나중에 Verkada Command에서 통합을 설정할 때 사용할 수 있도록 안전한 위치에 저장합니다.**
{% endstep %}
{% endstepper %}
{% hint style="danger" %}
이 JSON 파일에는 Command의 Google Workspace 통합이 OAuth 2.0을 통해 Google API에 인증하는 데 사용하는 자격 증명이 포함되어 있습니다. 이 파일은 Workspace 데이터에 대한 액세스를 제공하므로 안전하게 보관하고 절대 공유하거나 공개해서는 안 됩니다.
{% endhint %}
#### 필수 Google API 활성화
Verkada Command는 사용자, 그룹, 도메인 및 감사 로그를 읽기 위해 특정 Google Workspace API에 대한 액세스가 필요합니다. 통합이 작동하려면 먼저 Google Cloud 프로젝트에서 이러한 API를 활성화해야 합니다.
{% stepper %}
{% step %}
**다음으로 이동합니다** [**Google Cloud 콘솔**](https://console.cloud.google.com/)**, 그리고 최고 관리자 자격 증명으로 로그인합니다.**
{% endstep %}
{% step %}
**왼쪽 사이드바에서 APIs & Services → API Library로 이동합니다.**
{% endstep %}
{% step %}
**검색창에서 Admin SDK API를 찾아 선택한 후 활성화를 클릭합니다.**
{% hint style="warning" %}
이 API는 사용자, 그룹 및 도메인 메타데이터를 읽는 데 필요합니다.
{% endhint %}
{% endstep %}
{% step %}
**(선택 사항) 감사 로그 모니터링 및 디렉터리 변경 감지를 허용하려면 Reports API를 검색하여 활성화합니다.**
{% endstep %}
{% endstepper %}
***
### 도메인 전체 위임 활성화
서비스 계정이 관리자를 가장하고 도메인 전체의 사용자 및 그룹 데이터에 액세스하도록 하려면 도메인 전체 위임을 부여해야 합니다. 이렇게 하면 수동 재인증 없이 서비스 계정이 관리자를 대신하여 읽기 작업을 수행할 수 있습니다.
{% stepper %}
{% step %}
**다음으로 이동합니다** [**Google Admin Console**](https://admin.google.com/) **그리고 Google Workspace 테넌트의 최고 관리자 자격 증명으로 로그인합니다.**
{% endstep %}
{% step %}
**Admin Console 홈페이지에서 Security →Access & data control → API Controls로 이동합니다.**
{% endstep %}
{% step %}
**API Controls 페이지에서 Domain-wide Delegation 섹션까지 스크롤하여 Manage Domain Wide Delegation을 클릭합니다.**
{% endstep %}
{% step %}
**Add New를 클릭하고 다음 세부 정보를 입력합니다:**
* **클라이언트 ID:** 서비스 계정 키 파일의 OAuth 2 클라이언트 ID(다음 `client_id` JSON의 필드)를 붙여넣습니다.
* **OAuth 범위(쉼표로 구분):**
https://www.googleapis.com/auth/admin.directory.user.readonly,
https://www.googleapis.com/auth/admin.directory.group.readonly,
https://www.googleapis.com/auth/admin.directory.orgunit.readonly
{% endstep %}
{% step %}
**승인을 클릭합니다.**
{% endstep %}
{% endstepper %}
새 위임 항목이 페이지에 표시되어, 이제 서비스 계정을 Verkada Command에서 사용자, 그룹 및 감사 데이터를 쿼리하는 데 사용할 수 있음을 확인합니다.
#### 사용자 속성 값 설정
사용자를 Verkada Command에 동기화하기 전에 이름, 성, 이메일, 직원 ID와 같은 주요 속성이 Google Workspace에 올바르게 입력되어 있는지 확인합니다.
{% stepper %}
{% step %}
**다음에 로그인합니다** [**Google Admin Console**](https://admin.google.com/) **최고 관리자 계정을 사용하여.**
{% endstep %}
{% step %}
**Directory → Users로 이동합니다.**
{% endstep %}
{% step %}
**업데이트할 사용자 프로필을 선택합니다.**
{% endstep %}
{% step %}
**User information을 클릭한 다음 관련 섹션(예: Basic information 또는 Employee information)을 확장합니다.**
{% endstep %}
{% step %}
**필요에 따라 다음 필드를 업데이트합니다:**
* **기본 이메일 주소**
* **이름** 및 **성**
* **직원 ID** (다음 아래 *직원 정보*)
* **전화번호** (다음 아래 *연락처 정보*)
{% endstep %}
{% step %}
**변경 사항을 적용하려면 저장을 클릭합니다.**
{% endstep %}
{% endstepper %}
다음 속성을 Google Workspace에서 Verkada Command로 동기화할 수 있습니다:
| Google Workspace 속성 이름 | Command 필드 |
| ---------------------- | ---------- |
| 이메일 | 이메일 |
| 이름 | 이름 |
| 성 | 성 |
| 부서 | 부서 |
| 비용 센터 | 부서 ID |
| 직원 ID | 직원 ID |
| 직책 | 직원 직함 |
| 전화번호(기본 자택/직장/모바일) | 전화번호 |
{% hint style="danger" %}
Google Workspace에서 동기화된 사용자 및 그룹은 Workspace에서만 관리되며 Verkada Command에서는 편집할 수 없습니다. Command와 성공적으로 동기화하려면 사용자에게 이름, 성 및 이메일 주소가 있어야 합니다.
{% endhint %}
{% hint style="info" %}
사용자의 전화번호가 Verkada Command에 올바르게 동기화되도록 국가 코드를 포함하고 공백이나 하이픈 없이 국제 형식으로 입력합니다.
**예:** `+14155552671`
{% endhint %}
***
### Command에서 통합 활성화
{% hint style="danger" %}
다음이 필요합니다 **조직 관리자** 이 통합을 구성할 권한.
{% endhint %}
{% stepper %}
{% step %}
**Verkada Command에서 All Products > Admin으로 이동합니다.**
{% endstep %}
{% step %}
**조직 설정에서 Login & Access → User Provisioning → Google Workspace를 선택합니다.**
a. Google Workspace 최고 관리자의 이메일 주소를 입력합니다. 보안 및 연속성을 위해 Verkada는 개인 사용자 계정 대신 동등한 관리자 권한이 있는 전용 서비스 계정을 사용할 것을 권장합니다.\
a. Google Cloud Console 프로젝트에서 생성한 JSON 키를 업로드합니다.\
b. 인증에 성공하면 다음을 클릭합니다 **추가** 를 클릭하여 Command에 동기화할 그룹 및/또는 조직 단위를 선택합니다.\
c. 클릭 **활성화**.
{% endstep %}
{% step %}
**첫 번째 동기화가 성공적으로 완료되면 언제든지 온디맨드 업데이트를 위한 지금 동기화 버튼을 사용할 수 있습니다.**
{% endstep %}
{% endstepper %}
***
### FAQ
사용자가 정기적으로 자동 동기화되나요?
예. 사용자는 40분마다 Google Workspace 계정에서 Verkada Command로 자동 동기화됩니다.
{% endtab %}
{% endtabs %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://help.verkada.com/command/ko/security/identity-providers/google-workspace.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
