# Google Workspace

Verkada Command は、シングルサインオン（SSO）シナリオ向けに、Google Workspace（ほかの IDプロバイダ［IdP］も含む）と統合する機能を備えています。\
\
Security Assertion Markup Language（SAML）は認証部分を担い、Google Workspace を Command へのアクセス管理に使用できるようにします。

{% hint style="info" %}
Verkada は、セキュリティの強化と設定の容易さのために、SAML より OIDC を推奨しています。
{% endhint %}

***

{% tabs %}
{% tab title="OIDC（推奨）" %}

## Google Workspace 向けの OIDC ベースの SSO

Verkada Command は、Google Workspace と OpenID Connect（OIDC）を通じたシングルサインオン（SSO）をサポートしています。この統合により、既存の Google 認証情報を使用して、シームレスかつ安全にユーザーが認証でき、Command へのアクセスが効率化され、全体的なセキュリティも向上します。

{% hint style="danger" %}
OIDC は Desk Station アプリではサポートされていません。
{% endhint %}

{% hint style="info" %}
有効にする [Enterprise Controlled Encryption（ECE）](https://help.verkada.com/command/ja/sekyuriti/enterprise-controlled-encryption) によってセキュリティを強化します。
{% endhint %}

***

### OIDC の設定

{% stepper %}
{% step %}
**にログインします** [**Google Cloud コンソール**](https://console.cloud.google.com/)**.**
{% endstep %}

{% step %}
**［新しいプロジェクト］をクリックして、Google Workspace 組織の下に新しいプロジェクトを作成します。**

<div align="left" data-with-frame="true"><img src="https://1706941156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-884236e69220503157e3c186d79d29c3cb7167af%2Fadf638b013e362ffde911084012d560c03eeefab.png?alt=media" alt="" width="697"></div>
{% endstep %}

{% step %}
**新しいプロジェクトで、［APIs & Services］>［Library］に移動します。**

<div align="left" data-with-frame="true"><img src="https://1706941156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-56e96bb0ac3d8b1c8900574c5cbd41edd66577ad%2F8cbca777f82cc9a5dd434f81e73cc2b7338db38c.png?alt=media" alt="" width="800"></div>

a. 以下の API を有効にします：

1. Identity and Access Management（IAM）API

   <div align="left" data-with-frame="true"><img src="https://1706941156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-ae89f5976810694518f3355ae25eb1bfeaf529a3%2Fac8c527ab9b9487e5eb46bc38a0c4367a70fc991.png?alt=media" alt="" width="607"></div>
2. Admin SDK API

   <div align="left" data-with-frame="true"><img src="https://1706941156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-6ca1c235c69e501918f7b7d53dd6a009570bec89%2F742d66b0d105811436c0ae22ae679acefa3f0d70.png?alt=media" alt="" width="577"></div>

{% endstep %}

{% step %}
**［APIs & Services］>［OAuth Consent Screen］に移動します。ユーザータイプとして［Internal］を選択し、［Create］をクリックします。**

<div align="left" data-with-frame="true"><img src="https://1706941156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-7f9e31ce7e9cc06ba77eb96e6c73f33bd7ab89e2%2F3c61c77fe771830937aeabff21c7fff82fee0bcb.png?alt=media" alt="" width="800"></div>
{% endstep %}

{% step %}
**［Edit App］をクリックします。**

<div align="left" data-with-frame="true"><img src="https://1706941156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-b264a64faa30b8adba944d60e79a14c47627e057%2F2e31007c5ca1be3dc3a7907c642ac5caee323143.png?alt=media" alt="" width="800"></div>
{% endstep %}

{% step %}
**OAuth Consent Screen を設定します。アプリに識別しやすい名前（例：Verkada SSO OIDC）を付け、組織の Google Workspace を管理する担当部署（例：IT）のメールアドレスをアプリのユーザーサポート用メールとして入力します。［Save and Continue］をクリックします。**

<div align="left" data-with-frame="true"><img src="https://1706941156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-c21bd05aad0f48accb9494daa7243a5c21ded685%2F7f838ada4a73a788d059b5d8196b25bf6271d2a5.png?alt=media" alt="" width="800"></div>
{% endstep %}

{% step %}
**OAuth スコープを設定します。**

<div align="left" data-with-frame="true"><img src="https://1706941156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-3a733f18965e032a92a822acc0ef7f6dedd20617%2F2c1878b82e12e17883245fb7ae786bab89f34dbc.png?alt=media" alt="" width="800"></div>
{% endstep %}

{% step %}
**次のスコープを選択します：**

* userinfo.email
* userinfo.profile
* openid
* <https://www.googleapis.com/auth/admin.directory.user.readonly>
  {% endstep %}

{% step %}
**［Update］をクリックします。**

<div align="left" data-with-frame="true"><img src="https://1706941156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-03195565d76097392a95b8c51f07a43912de638c%2F193a7388344227b731f24036977ec1c45b402cfe.png?alt=media" alt="" width="669"></div>

最後のオプションが表示されない場合は、次を行う必要があるかもしれません **表に追加** の下で **スコープを手動で追加**.

<div align="left" data-with-frame="true"><img src="https://1706941156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-60516cddd098d8ebd4be0e4a069079178e6e2069%2F9681180117337bca5ecd0912211472dd1f3d35a7.png?alt=media" alt="" width="659"></div>
{% endstep %}

{% step %}
**［Save and Continue］をクリックし、アプリケーションのダッシュボードに戻ります。**
{% endstep %}

{% step %}
**［Credentials］に移動します。［Create Credentials］をクリックして、OAuth クライアント ID を作成します。**

<div align="left" data-with-frame="true"><img src="https://1706941156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-9e6fb9ecc56404a2fea814e703b6d36a2f324dc2%2F91981f0d012b115d347d36144058770c831e6fd3.png?alt=media" alt="" width="621"></div>
{% endstep %}

{% step %}
**アプリケーションの種類として［Web application］を選択します。クライアントに識別しやすい名前を付け、承認済みのリダイレクト URI の一覧に次を追加します：**

* <https://command.verkada.com/oidc/google/callback>
* [https://org-short-name.command.verkada.com/oidc/google/callback](http://org-short-name.command.verkada.com/oidc/google/callback) （org-short-name は Command 組織の短縮名です）

［Create］をクリック **作成**.

<div align="left" data-with-frame="true"><img src="https://1706941156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-a8560fc5eb1fa64f56e23e6e833cd631fcc2fa82%2Ff25929e6d8cdd27f67d4b1376d7f91a6891bf483.png?alt=media" alt="" width="407"></div>
{% endstep %}

{% step %}
**クライアント ID をコピーします。クライアント シークレットは使用しないことに注意してください。**

<div align="left" data-with-frame="true"><img src="https://1706941156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-2227897f30e47ae2401daa92736c5d9984ac0058%2Fbf7841ec6a680f5501e99bcc8016ce3c109a38c0.png?alt=media" alt="" width="474"></div>
{% endstep %}
{% endstepper %}

***

### Verkada Command の設定

{% stepper %}
{% step %}
**Verkada Command で、［All Products］>［Admin］に移動します。**
{% endstep %}

{% step %}
**左側のナビゲーションで、［Login & Access］を選択します。**
{% endstep %}

{% step %}
**［Single Sign-On Configuration］を選択します。**
{% endstep %}

{% step %}
**［OIDC Configuration］の下で、［Add New］をクリックします。**

a. をオンにします **有効にする。**\
b.（任意）をオンにします **OIDC SSO を必須にする。**\
c. の下で **プロバイダを選択**、選択 **Google**。\
d. 以下で **クライアントとテナントを追加** 、:plus: をクリックします。

1. 次の項目で **クライアントID** フィールドに、Google Cloud Console からコピーしたクライアントIDを貼り付けます。
2. 次の項目で **テナントID** フィールドに、組織の Google Workspace で使用されているドメインを入力します（Google のメールアドレスが <example@your-domain.com>の場合は、your-domain.com を入力します）。
3. をクリックします **完了** して設定を完了します。

   <div align="left" data-with-frame="true"><img src="https://1706941156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-a73c6839f058034a8f510bf1f265ae05c4aada2e%2F0ef79b636454c994d674e62556e118529bf0c957.png?alt=media" alt="" width="476"></div>

h. **メールドメイン、** :plus: をクリッ&#x30AF;**.**

1. 現在のドメイン名を入力します（例：@verkada.com）。
2. ［Create］をクリック **完了**.

   <div align="left" data-with-frame="true"><img src="https://1706941156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-03a2ba25ea251f2a72146ba1464a58bc4e11e7fd%2Ff054308c20f7523b4f1f29da383884cb7c2e6453.png?alt=media" alt="" width="215"></div>

{% endstep %}

{% step %}
**ログインテストの下で［ログインテストを実行］をクリックします。**
{% endstep %}

{% step %}
**ログインテストが成功すると、OIDC 設定ページにリダイレクトされるはずです。ログインしたら、Associated Domains の下にホワイトリストに追加する必要があるドメインを追加します。**
{% endstep %}

{% step %}
**ドメインを追加したら、ログインテストをもう一度実行します。2 回目のログインテストが正常に完了するまで、SSO は有効になりません。**
{% endstep %}

{% step %}
**ドメインが確認されると、正常に検証されたことが表示されます。**
{% endstep %}
{% endstepper %}
{% endtab %}

{% tab title="SAML" %}

## Google Workspace SAML 統合

Verkada Command は、シングルサインオン（SSO）シナリオ向けに、Google Workspace（ほかの IDプロバイダ［IdP］も含む）と統合する機能を備えています。\
\
Security Assertion Markup Language（SAML）は認証部分を担い、Google Workspace を Command へのアクセス管理に使用できるようにします。

***

#### 始める前に

{% stepper %}
{% step %}
**Verkada Command にすでに登録されており、同じカスタムドメインにユーザーのアカウントが存在することを確認してください。Command をカスタムアプリケーションとして追加できます。**
{% endstep %}

{% step %}
**統合を最大限に活用するため、これらの用語に慣れておいてください。**

* **クライアントID**—クライアントID。場所を確認するには、 **管理者 > プライバシーとセキュリティ > シングルサインオン設定 > 新規追加**.
* **フェデレーションデータ XML**—Verkada が Google Workspace と Command インスタンス間のフェデレーションを設定できるようにする、Google Workspace インスタンス固有の情報（これをダウンロードする手順は後ほど説明します）。
  {% endstep %}
  {% endstepper %}

***

### Google Workspace の設定

{% stepper %}
{% step %}
**Google Workspace > Google 管理コンソール に移動し、Web アプリとモバイルアプリ を選択します。**

<div align="left" data-with-frame="true"><img src="https://1706941156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-fa29dfcbd4d998bc7dbe2ad3fb5bc485496c5ac9%2Fe6aba3d44aaf305e280a2bc226199f5680045f9e.png?alt=media" alt="" width="882"></div>
{% endstep %}

{% step %}
**［アプリを追加］ドロップダウンを選択し、［カスタム SAML アプリを追加］を選択します。**

<div align="left" data-with-frame="true"><img src="https://1706941156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-aeba46ff2b1e2f9391d5329a9defcf4301df292b%2F8740eab3217921da0c3d8a5b0663b3ec2c9cc37d.png?alt=media" alt="" width="620"></div>
{% endstep %}

{% step %}
**アプリケーション情報を入力します。名前と説明は任意のものを使用できます。**
{% endstep %}

{% step %}
**以下を取得します** [**Verkada Command ロゴ**](https://downloads.intercomcdn.com/i/o/115376791/162cbb458c1ceefd1aeed502/Verkada_logoSymbol_256x256+\(3\).png?expires=1759590000\&signature=c65fe8ed71111e37e851aeca0ee3054c090c8a01e3e24bf77816092e5bf0102b\&req=dSEiFc54moheFb4X1HO4gYAM81kpwT1YtLg28NWB3RV5Y2yu8G8cCA13ulLf%0A) **を、Google Workspace アプリケーションに追加します。**
{% endstep %}

{% step %}
**［続行］をクリックします。**

<div align="left" data-with-frame="true"><img src="https://1706941156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-29598e160802e28900a4c5522c0c2d3abca93b0f%2F4ab454acd51d9b594f9b6626bc96bbdaa3b04829.png?alt=media" alt="" width="515"></div>
{% endstep %}

{% step %}
**オプション 1 を使用して、フェデレーションメタデータの Extensible Markup Language（XML）に対応する IdP メタデータをダウンロードし、［続行］をクリックします。**

<div align="left" data-with-frame="true"><img src="https://1706941156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-b88a9dcbf7dddb0f832b1bb3246320b4904a0b29%2F9b2f2278c664a656aff9803173a785d43ce6df9f.png?alt=media" alt="" width="515"></div>

{% hint style="warning" %}
このファイルにより、Verkada は Command で SSO を設定できます。今後使用できるよう、わかりやすい場所に保存してください。
{% endhint %}
{% endstep %}

{% step %}
**サービスプロバイダの詳細を（表示されているとおりに）入力して SSO を設定するか、（Verkada Command の）［新しい SSO 設定］ページから詳細をコピーし、［続行］をクリックします。**

a. 次の項目で **ACS URL**：\
米国のオーガナイゼーションの場合： [https://vauth.command.verkada.com/saml/sso/](https://vauth.command.verkada.com/saml/sso/%3Cclient-id%3E)\
EU のオーガナイゼーションの場合： [https://saml.prod2.verkada.com/saml/sso](https://saml.prod2.verkada.com/saml/login/)[/](https://saml.prod2.verkada.com/saml/sso/%3Cclient-id%3E)AUS のオーガナイゼーションの場合: <https://saml.prod-ap-syd.verkada.com/saml/sso/%3Cclient-ID%3E>\
b. 次の項目について **Entity ID**：\
米国のオーガナイゼーションの場合： [https://vauth.command.verkada.com/saml/sso/](https://vauth.command.verkada.com/saml/sso/%3Cclient-id%3E)\
EU のオーガナイゼーションの場合： [https://saml.prod2.verkada.com/saml/sso](https://saml.prod2.verkada.com/saml/login/)[/](https://saml.prod2.verkada.com/saml/sso/%3Cclient-id%3E)AUS のオーガナイゼーションの場合: <https://saml.prod-ap-syd.verkada.com/saml/sso/%3Cclient-ID%3E>\
c. 次の項目について **Start URL**：\
米国のオーガナイゼーションの場合： [https://vauth.command.verkada.com/saml/login/](https://vauth.command.verkada.com/saml/login/%3Cclient-id%3E)\
EU のオーガナイゼーションの場合： [https://saml.prod2.verkada.com/saml/login](https://saml.prod2.verkada.com/saml/login/)[/](https://saml.prod2.verkada.com/saml/login/%3Cclient-id%3E)AUS のオーガナイゼーションの場合: [https://saml.prod-ap-syd.verkada.com/saml/login/](https://saml.prod-ap-syd.verkada.com/saml/login/%3Cclient-id%3E)

{% hint style="warning" %}
[オーガナイゼーションが作成された場所を確認し、](https://help.verkada.com/command/ja/hajimeni/get-started-with-verkada-command) オーガナイゼーションがどのリージョンにあるかを確認します。
{% endhint %}
{% endstep %}

{% step %}
**属性マッピング（下図のとおり）を入力し、［完了］をクリックします。これにより、Command がユーザーに関する正しい情報を受け取るようになります。アプリの設定ページにリダイレクトされます。**

<div align="left" data-with-frame="true"><img src="https://1706941156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-5ca9c8d5ff4e2e08abda4dd063459b7047684d04%2Fcfe83694fe2cd19493f66162c98fcbac819a0695.png?alt=media" alt="" width="515"></div>
{% endstep %}
{% endstepper %}

***

### Command 設定

{% stepper %}
{% step %}
**Verkada Command で、［すべての製品］>［管理者］に移動します。**
{% endstep %}

{% step %}
**［ログインとアクセス］>［シングルサインオン（SSO）］を選択します。**
{% endstep %}

{% step %}
**［追加］をクリックして新しい設定を開始するか、既存の設定を編集します。**
{% endstep %}

{% step %}
**［Identity Provider XML Metadata］の下で、メタデータファイルをアップロードします。**
{% endstep %}

{% step %}
**［Email Domains］の下で、オーガナイゼーションへのログインに使用するメールドメインを追加します。**
{% endstep %}

{% step %}
**次の URL のいずれかで Command にアクセスできることを確認します（&#x20;*****client-id*****&#x20;は設定時に使用したものに置き換えてください）。**

* US のオーガナイゼーションの場合: [https://vauth.command.verkada.com/saml/login/](https://vauth.command.verkada.com/saml/login/%3Cclient-id%3E)
* EU のオーガナイゼーションの場合： [https://saml.prod2.verkada.com/saml/login/](https://saml.prod2.verkada.com/saml/login/%3Cclient-id%3E)
* AUS のオーガナイゼーションの場合: <https://saml.prod-ap-syd.verkada.com/saml/sso/%3Cclient-ID%3E>

{% hint style="warning" %}
参照: **［管理者］>［データプライバシー］>［データレジデンシー］>［データ処理場所］** を確認して、リージョンの場所を確認します。
{% 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管理と一般的なユーザーのオンボーディングが簡素化されます。

Verkada の Okta または Azure との SCIM 統合とは異なり、この統合では Google Workspace Admin SDK と Reports API を使用し、ドメイン全体への委任を持つ Google サービスアカウントを通じて認証されます。

統合を有効にすると、Command では次のことが可能になります:

* 選択した Google Workspace グループまたは組織部門（OU）からユーザーとグループをインポートする
* それらを管理対象のユーザーとグループとして Command に同期する
* 管理 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) **Super Admin の認証情報でサインインします。**
{% endstep %}

{% step %}
**左上の［プロジェクト セレクタ］ドロップダウンを開き、最上位（種類: Organization）リソースを選択します。**
{% endstep %}

{% step %}
**左側のパネルから、［IAM と管理］→［IAM］に移動します。**
{% endstep %}

{% step %}
**［プリンシパルで表示］の下で［アクセス権を付与］をクリックします。**

a. 次の項目について **プリンシパルを追加**で、ユーザーのメールアドレスを入力します。\
b. **ロールを割り当て**で、検索して次を選択します **Organization Policy Administrator**。\
c.  **保存**.
{% endstep %}

{% step %}
**左側のパネルから、\[Organization Policies] を選択します。**
{% endstep %}

{% step %}
**ポリシーの一覧で、以下を検索して無効化します。**

```
サービス アカウントの作成を無効にする | Managed
サービス アカウントの作成を無効にする | Managed（Legacy）
サービス アカウント キーの作成を無効にする | Managed
サービス アカウント キーの作成を無効にする | Managed（Legacy）
```

{% endstep %}
{% endstepper %}

#### サービス アカウントを作成する

{% stepper %}
{% step %}
**次の項目で** [**Google Cloud コンソール**](https://console.cloud.google.com/?hl=en-au)**で、左上にある \[Project Selector] ドロップダウンを開きます。**
{% endstep %}

{% step %}
**\[New Project] をクリックします。**
{% endstep %}

{% step %}
**プロジェクト名を入力し（例：&#x20;*****Verkada User Sync*****）、プロジェクトを作成します。**
{% endstep %}

{% step %}
**プロジェクトが作成されたら、左上のナビゲーションバーでそれが選択されていることを確認します。**

<div align="left" data-with-frame="true"><img src="https://1706941156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-884a85ca1fb5289e6cef0de93d9408bbea74cc5d%2F0e125cea13e81507b9cafadd65e0acda4188ffdc.png?alt=media" alt="" width="687"></div>
{% endstep %}

{% step %}
**左側のサイドバーから、\[IAM & Admin] → \[Service Accounts] に移動します。**
{% endstep %}

{% step %}
**\[+ Create Service Account] をクリックします。**
{% endstep %}

{% step %}
**以下のフィールドに入力します。**

* **名前:** わかりやすい名前を入力します（例： *Verkada User Provisioning*)
* **ID:** そのままにするか、カスタマイズします（任意）
* **説明:** 次のようなメモを追加します *Verkada が Workspace ディレクトリ データを読み取るために使用* （任意）
  {% endstep %}

{% step %}
**\[Create and Continue] をクリックします。**
{% endstep %}

{% step %}
**\[Grant Project Access] の手順はスキップします — ここではロールは不要です。**
{% endstep %}

{% step %}
**\[Continue] → \[Done] をクリックします。**
{% endstep %}

{% step %}
**サービス アカウントの一覧から、新しく作成したアカウントの OAuth 2 Client ID をコピーします。この ID は、後でセットアップを完了するために必要です。**
{% endstep %}
{% endstepper %}

#### JSON キーを生成する

{% stepper %}
{% step %}
**\[Service Accounts] の一覧で、アカウント名をクリックするか、新しいサービス アカウントの横にある 3 点アイコンを選択して \[Manage keys] を選びます。**

<div align="left" data-with-frame="true"><img src="https://1706941156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-45a367d261acca9f13df87d35168bff5c58431ff%2F27b89047074c2c1a07ad5ebfd00a70cd353d451b.png?alt=media" alt="" width="800"></div>
{% endstep %}

{% step %}
**\[Keys] タブで、\[Add Key] → \[Create new key] をクリックします。**
{% endstep %}

{% step %}
**\[JSON] を選択して \[Create] をクリックします。**
{% endstep %}

{% step %}
**A `.json` ファイルがコンピューターにダウンロードされます。後で Verkada Command で連携を設定するときに使えるよう、安全な場所に保存してください。**

<div align="left" data-with-frame="true"><img src="https://1706941156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-51583d22ea1c30259ebbfef2023bdc52e248cd86%2F34669a715d0b1ac0d73525b1306b399cc9b06227.png?alt=media" alt="" width="800"></div>
{% endstep %}
{% endstepper %}

{% hint style="danger" %}
この JSON ファイルには、Command の Google Workspace 連携が OAuth 2.0 経由で Google APIs に認証するために使用する認証情報が含まれています。このファイルは Workspace データへのアクセスを提供するため、安全に保管し、共有したり公開したりしないでください。
{% endhint %}

#### 必要な Google APIs を有効にする

Verkada Command では、ユーザー、グループ、ドメイン、監査ログを読み取るために、特定の Google Workspace APIs へのアクセスが必要です。連携を機能させるには、これらの APIs を事前に Google Cloud プロジェクトで有効にする必要があります。

{% stepper %}
{% step %}
**次へ移動し、** [**Google Cloud コンソール**](https://console.cloud.google.com/)**で、Super Admin の認証情報を使用してサインインします。**
{% endstep %}

{% step %}
**左側のサイドバーから、\[APIs & Services] → \[API Library] に移動します。**
{% endstep %}

{% step %}
**検索バーで Admin SDK API を見つけて選択し、\[Enable] をクリックします。**

{% 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 のホームページから、セキュリティ → アクセスコントロールとデータ制御 → API Controls に移動します。**
{% endstep %}

{% step %}
**API Controls ページで、ドメイン全体の委任セクションまでスクロールし、［Manage Domain Wide Delegation］をクリックします。**
{% endstep %}

{% step %}
**［Add New］をクリックし、次の詳細を入力します：**

* **クライアント ID：** サービスアカウントのキーファイル（JSON 内の `client_id` フィールド）の OAuth 2 クライアント ID を貼り付けます。
* **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 %}
**［Authorize］をクリックします。**
{% endstep %}
{% endstepper %}

新しい委任エントリがページに表示され、サービスアカウントを使用して Verkada Command からユーザー、グループ、監査データをクエリできることが確認されます。

#### ユーザー属性値を設定する

ユーザーを Verkada Command に同期する前に、主要な属性（名、姓、メール、社員 ID など）が Google Workspace に正しく入力されていることを確認します。

{% stepper %}
{% step %}
**にサインインします** [**Google Admin Console**](https://admin.google.com/) **スーパー管理者アカウントを使用して。**
{% endstep %}

{% step %}
**ディレクトリ → ユーザー に移動します。**
{% endstep %}

{% step %}
**更新したいユーザープロフィールを選択します。**
{% endstep %}

{% step %}
**［User information］をクリックし、該当するセクション（たとえば、基本情報や社員情報）を展開します。**
{% endstep %}

{% step %}
**必要に応じて、次のフィールドを更新します：**

* **主要メールアドレス**
* **名** および **姓**
* **社員 ID** （ *Employee information*)
* **電話番号** （ *連絡先情報*)
  {% endstep %}

{% step %}
**［Save］をクリックして変更を適用します。**
{% 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" %}
この統合を設定するには **Org Admin** 権限が必要です。
{% endhint %}

{% stepper %}
{% step %}
**Verkada Command で、［All Products］>［Admin］に移動します。**
{% endstep %}

{% step %}
**Org Settings で、ログインとアクセス → ユーザープロビジョニング → Google Workspace を選択します。**

a. Google Workspace のスーパー管理者のメールアドレスを入力します。セキュリティと継続性のため、Verkada では、個人のユーザーアカウントではなく、同等の管理者権限を持つ専用のサービスアカウントを使用することを推奨しています。\
a. Google Cloud Console プロジェクトで生成した JSON キーをアップロードします。\
b. 認証が成功したら、 **追加** をクリックして、Command に同期したいグループや組織部門を選択します。\
c. クリックします **有効にする**.
{% endstep %}

{% step %}
**最初の同期が正常に完了すると、いつでもオンデマンドで更新できる［Sync Now］ボタンが利用可能になります。**

<div align="left" data-with-frame="true"><img src="https://1706941156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-b67e099a53c173ef3390f3efe509ca0453eb1ea4%2Fdd0c4665c02bc41d200c7540d40b33f3c658dfe6.png?alt=media" alt="" width="800"></div>
{% endstep %}
{% endstepper %}

***

### FAQ

<details>

<summary>ユーザーは定期的なスケジュールで自動的に同期されますか？</summary>

はい、ユーザーは Google Workspace アカウントから Verkada Command に 40 分ごとに自動で同期されます。

</details>
{% endtab %}
{% endtabs %}