> For the complete documentation index, see [llms.txt](https://help.verkada.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.verkada.com/command/ja/sekyuriti/identity-providers/microsoft-entra-id.md).

# Microsoft Entra ID

Microsoft Entra ID（Azure AD）でSSOとユーザープロビジョニングを設定

ユースケースに応じて、 [Verkada Command](/command/ja/hajimeni/get-started-with-verkada-command.md) Microsoft Entra ID やその他の IDプロバイダ \[IdPs] と、以下の方法で連携できます：

* OpenID Connect (OIDC)
* Security Assertion Markup Language (SAML)
* クロスドメインID管理システム（SCIM）

**OIDC** および **SAML** どちらも認証を処理し、Microsoft Entra ID が、環境内の他の SaaS アプリケーションへのアクセスを管理するのと同じように Command へのアクセスを管理できるようにします。どちらのプロトコルでも、既存の ID フレームワークに Command を統合し、現在のポリシーに沿ってユーザーを認可できます。

**SCIM** Microsoft Entra ID にある既存のユーザーとグループを活用し、それらを Command と同期できます。これにより、現在の中央 IDプロバイダ を維持し、既存のユーザーとグループを使用して Command の権限を構成できます。

{% hint style="info" %}
Verkada では、セキュリティ強化と設定のしやすさの観点から、SAML より OIDC を推奨しています。OIDC ではさらに [Enterprise Controlled Encryption](/command/ja/sekyuriti/enterprise-controlled-encryption.md).
{% endhint %}

| 機能                | サポートあり |
| ----------------- | :----: |
| OIDC SSO          |   はい   |
| SAML SSO          |   はい   |
| SCIM ユーザープロビジョニング |   はい   |
| ECE サポート          |   はい   |

***

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

#### Microsoft Entra ID 向け OIDC ベースの SSO

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

{% hint style="info" %}
有効化 [Enterprise Controlled Encryption（ECE）](/command/ja/sekyuriti/enterprise-controlled-encryption.md) セキュリティ強化のため。
{% endhint %}

***

**Microsoft Entra ID の設定**

{% stepper %}
{% step %}
**お使いの** [**Microsoft Entra ID ポータル**](https://portal.azure.com)**.**
{% endstep %}

{% step %}
**App registrations を検索して選択します。**
{% endstep %}

{% step %}
**［新規登録］をクリックします。**

a. アプリケーションに名前を付けます **Verkada SSO OIDC。**\
b. 次の項目で **サポートされるアカウントの種類、** 次を選択します： **この組織ディレクトリ内のアカウントのみ（単一テナントのみ）。**\
c. 次の項目で **リダイレクト URI**、次を選択します **シングルページ アプリケーション** （SPA）をプラットフォームとして選択し、次のコールバック URL を追加します：

1. <https://command.verkada.com/oidc/aad/callback>
2. [https://org-short-name.command.verkada.com/oidc/aad/callback](http://org-short-name.command.verkada.com/oidc/aad/callback) （URI 内の org-short-name を、Command オーガナイゼーション' の短い名前に置き換えてください。）

{% hint style="warning" %}
コールバック URI の末尾にスラッシュがないことを確認してください。
{% endhint %}
{% endstep %}

{% step %}
**［登録］をクリックします。**
{% endstep %}

{% step %}
**アプリケーション（クライアント）ID とディレクトリ（テナント）ID をコピーして、安全な場所に保存してください。Verkada Command でセットアップを完了するために必要になります。**
{% endstep %}

{% step %}
**左側で、［管理］>［API を公開する］をクリックします。**

a. クリックします **スコープを追加します。**\
b. クリックします **保存して続行**。\
c. 入力します *verkada\_ece* 次の項目に対して：

* スコープ名
* 管理者同意の表示名
* 管理者同意の説明
* ユーザー同意の表示名
* ユーザー同意の説明

d. 設定します **誰が同意できますか？** を **管理者とユーザー。**\
e. クリックします **スコープを追加します。**

<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-aec1149e6970227126f726c9c06f46e5c865b681%2F1d3772842a085fc3d15f2795987254a747399203.png?alt=media" alt="" width="800"></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. 次の項目で **［Provider］を選択し、** 次を選択します： **Microsoft Entra ID。**\
d. 次の項目で **［Add Client and Tenant］で、** ［＋］をクリックします。

1. ［ **Client ID** ］フィールドに、Microsoft Entra ID からコピーした Client ID を貼り付けます。
2. ［ **Tenant ID** ］フィールドに、Microsoft Entra ID からコピーした Tenant ID を貼り付けます。
3. クリックします **完了**.

e. 次の項目で **メールドメイン、** ［＋］をクリックしま&#x3059;**.**

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

   <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 %}
**［Run Login Test］をクリックします。**
{% endstep %}

{% step %}
**ログインテストが成功すると、OIDC 設定ページにリダイレクトされるはずです。ログイン後、ホワイトリストに登録する必要があるドメインを追加してください。**
{% endstep %}

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

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

***

#### モバイルアプリケーション経由でログインする

{% hint style="info" %}
Android および iOS の Command アプリは、OIDC ベースのログインをサポートしています。
{% endhint %}

{% stepper %}
{% step %}
**Command アプリを開きます。**
{% endstep %}

{% step %}
**メールアドレス欄にメールアドレスを入力し、［次へ］をクリックします。**
{% endstep %}

{% step %}
**ログイン処理を完了するために、IdP（Microsoft Entra ID）にリダイレクトされるはずです。**
{% endstep %}
{% endstepper %}
{% endtab %}

{% tab title="SAML" %}

### Microsoft Entra ID SAML 連携

***

#### Microsoft Entra ID で SAML を設定する

Verkada Command はギャラリー アプリケーションとして登録されており、Microsoft Entra ID マーケットプレース内で見つけることができます。つまり、Microsoft Entra ID Free、Microsoft Entra ID P1、Microsoft Entra ID P2 ライセンスで利用できます。

{% hint style="danger" %}
開始するには、次のものが必要です： `クライアント ID`。次の方法を確認してください： [生成し、メールドメインを設定する](/command/ja/sekyuriti/identity-providers.md#generate-client-id)。その後、この手順の残りを完了するためにこの記事に戻ってください。
{% endhint %}

{% stepper %}
{% step %}
**Microsoft Entra ID ディレクトリに Verkada Command をエンタープライズ アプリケーションとして追加します。Microsoft Entra ID の概要ページに移動し、［Enterprise applications］を選択します。**

<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-a79722a44181b1fdc58b4a446717b725395bf3f0%2Fea7d4d52ebddb8b4b886e1e9eb2febc75e0d86b3.png?alt=media" alt="" width="603"></div>
{% endstep %}

{% step %}
**ページ上部で［New Application］を選択し、Verkada Command を検索します。**
{% endstep %}

{% step %}
**Verkada Command を選択し、［Create］をクリックします。&#x20;*****アプリケーションをお使いの*****&#x20;Microsoft Entra ID&#x20;*****テナント*****.**

<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-31d38b1f41a163cd63acdd388f7841043225dcba%2Fa059e22dc1d67995f891ded49cfd7d882ce4e00a.png?alt=media" alt="" width="629"></div>

ページが更新されると、以下に示すようなメニューが表示されます。
{% endstep %}

{% step %}
**［Set up single sign-on］で、［Get started］をクリックします。**

<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-6a28059d10b2ee41a6e442c29b98e00025eff15a%2F7cf12443f73d5124fb52129d4b2835c317bf1d57.png?alt=media" alt="" width="389"></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-d6d6ca8dd62db59b642475c10341b7b46962fb2c%2F0e6513aae4262222ba5c16809425c6c77d2b8333.png?alt=media" alt="" width="376"></div>
{% endstep %}

{% step %}
**必要に応じて［Edit］をクリックし、SAML 接続をさらに設定します。**
{% endstep %}

{% step %}
**次の項目を設定します。Microsoft Entra ID に追加する前に、各 URL の末尾にクライアント ID を追加する必要があります。注の下の例を参照してください。**

a. 次の項目について **識別子**：\
米国のオーガナイゼーション' の場合： <https://vauth.command.verkada.com/saml/sso>\
EU のオーガナイゼーション' の場合： <https://saml.prod2.verkada.com/saml/sso>AUS のオーガナイゼーション' の場合： <https://saml.prod-ap-syd.verkada.com/saml/sso>

b. 次の項目について **返信 URL**：\
米国のオーガナイゼーション' の場合： <https://vauth.command.verkada.com/saml/sso>\
EU のオーガナイゼーション' の場合： <https://saml.prod2.verkada.com/saml/sso>\
AUS のオーガナイゼーション' の場合： <https://saml.prod-ap-syd.verkada.com/saml/sso>

c. 次の項目について **サインオン URL**：\
米国のオーガナイゼーション' の場合： <https://vauth.command.verkada.com/saml/login>\
EU のオーガナイゼーション' の場合： [https://saml.prod2.verkada.com/saml/login](https://saml.prod2.verkada.com/saml/login/)\
AUS のオーガナイゼーション' の場合： <https://saml.prod-ap-syd.verkada.com/saml/sso>

{% hint style="warning" %}
所属リージョンを確認するには、次の場所を参照してください： [Verkada 用にオーガナイゼーション' が作成された場所](/command/ja/hajimeni/get-started-with-verkada-command.md).
{% endhint %}

<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-e84505986b291d1cf02b8ac24fe7db4af6b4733e%2Ff62fd260c99f8d34d4950ec1001629614d31095d.png?alt=media" alt="" width="561"></div>
{% endstep %}

{% step %}
**［保存］をクリックします。**
{% endstep %}

{% step %}
**［Attributes & Claims］で、［Edit］をクリックし、次の属性と一致させます：**

<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-8cdb4bb7a93e576e03f624af4351e402854ae662%2F8a7793cc70060ce40c5de3ee9b01b011005ee621.png?alt=media" alt="" width="806"></div>

{% hint style="warning" %}
メールに別のソース属性を使用する場合は、使用したいソース属性に従って属性を設定してください。
{% endhint %}
{% endstep %}

{% step %}
**［SAML Signing Certificate］で、この Federation Metadata XML を Command にインポートします。**
{% endstep %}

{% step %}
**［Download］をクリックして保存します。**

<div align="left" data-with-frame="true"><figure><img src="https://1706941156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2FmfEkOw29Ocbgl3OiCU9l%2Fimage.png?alt=media&amp;token=6850c898-fc72-49fb-8dd6-1c9906435d4f" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="info" %}
次に表示されるダイアログには、連携完了後に使用できるツールが含まれます。
{% endhint %}
{% endstep %}

{% step %}
**Verkada Command に進み、** [**設定を完了します**](/command/ja/sekyuriti/identity-providers.md#command-sso-configuration)**.**
{% endstep %}
{% endstepper %}

***

#### Microsoft Entra ID で SAML 接続をテストする

{% stepper %}
{% step %}
**ファイルがアップロードされたら、Microsoft Entra ID で［Test］をクリックして連携をテストします。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-67a512262a5b97e88b3dc244907bae7a5fd6e955%2Ff3f197e1c60a2b69aaa4e5ac9d7dadce9ac29dde.png?alt=media" alt="" width="763"></div>
{% endstep %}

{% step %}
**［Sign in as current user］でログインします。すべて正しく設定されていれば、Command プラットフォームにリダイレクトされるはずです。**
{% endstep %}

{% step %}
**シングルサインオンでログインし、Command へのアクセスを確認します。**
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
現時点では、Microsoft Entra ID はアプリへのアクセスに対するネストされたグループをサポートしていません。すべてのユーザーは、割り当て対象となるグループの直接メンバーである必要があります。
{% endhint %}

***

#### モバイルアプリケーション経由でログインする

{% hint style="info" %}
Android および iOS の Command アプリは、SAML ベースのログインをサポートしています。
{% endhint %}

{% stepper %}
{% step %}
**Command アプリを開きます。**
{% endstep %}

{% step %}
**メールアドレス欄にメールアドレスを入力し、［次へ］をクリックします。**
{% endstep %}

{% step %}
**ログイン処理を完了するために、IdP（Microsoft Entra ID）にリダイレクトされるはずです。**
{% endstep %}
{% endstepper %}
{% endtab %}

{% tab title="ユーザープロビジョニング（SCIM）" %}

#### Microsoft Entra ID SCIM 連携

Verkada Command は、自動ユーザーおよびグループプロビジョニングのために、System for Cross-Domain ID管理（SCIM）を使用して Microsoft Entra ID と連携します。

SCIM は、Microsoft Entra ID のユーザーとグループを直接 Command に同期します。これにより、次のことが可能になります：

* Microsoft Entra ID を中央の IDプロバイダ として維持できます。
* Entra ID で変更が発生すると、Command のユーザーとグループを自動的に更新できます。
* 既存の ID 管理構造を使用して、Command の権限を割り当てて管理できます。

{% hint style="info" %}
オーガナイゼーション' が SCIM を使用している場合、電話番号は SCIM 経由でのみプロビジョニングできます。Command で電話番号を直接編集することはできません。
{% endhint %}

***

**Microsoft Entra ID での SCIM の設定**

Microsoft Entra ID で SCIM を設定する前に、Command でシークレットトークンを生成する必要があります。

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

{% step %}
**［Org Settings］で、［Login & Access & Logs > SCIM Users Provisioning］を選択します。**
{% endstep %}

{% step %}
**［Add Domain］をクリックし、SCIM で使用する予定の関連メールドメインをすべて入力します。**

これにより SCIM トークンが生成され、 **1 回しか表示されません。**

a. クリックします **コピー** して、後で設定に使用できるよう安全な場所に保存します。\
b. クリックします [**更新**](/command/ja/sekyuriti/identity-providers/scim-token-management.md) トークンをコピーしていない、または表示されない場合は、新しいトークンを生成します。
{% endstep %}

{% step %}
**Microsoft Entra ID のホームページで、［Enterprise applications > New application > Create your own application］を選択します。**
{% endstep %}

{% step %}
**［Create your own application］のサイドパネルで、アプリケーション名を入力し、"Integrate any other aplication you don't find in the gallery (Non-gallery)" を選択して、［Create］をクリックします。**

{% hint style="warning" %}
Verkada Command アプリケーションは選択しないでください。これは事前構成済みの SAML 専用アプリケーションです。
{% endhint %}

<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-5cfbf0ff95ca73f13f19aed05b2c61b8dd761961%2F0d277fc07236fd024fc828626266cebb7a1739c5.png?alt=media" alt="" width="638"></div>
{% endstep %}

{% step %}
**［Provision User Accounts］で、［Get started］をクリックします。**

<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-1341f38eab1af808467616d35442152f48ab2d9d%2F0dfb71e30a18d4b2696fdbee4277dcf0c0517399.png?alt=media" alt="" width="380"></div>
{% endstep %}

{% step %}
**［Manage > Provisioning］を選択します。**
{% endstep %}

{% step %}
**プロビジョニングページで：**

a. Provisioning Mode を Automatic に設定します。

b. Verkada Command で、次に戻ります： **［Admin > Login & Access & Logs > SCIM Users Provisioning］**。SCIM 設定に表示される Tenant URL をコピーします。

c. この値を Microsoft Entra ID の Tenant URL フィールドに貼り付けます。

d. Verkada Command で生成された SCIM トークン（手順 2）をシークレットトークンとして入力します。

<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-bbcbdb56d3a1769a9abb7fd774dade529c56c69f%2F6c4f280ddf634cc0ce6b263d9151b1376832a14a.png?alt=media" alt="" width="570"></div>
{% endstep %}

{% step %}
**［Test Connection］をクリックします。SCIM 接続が成功したことを示す確認メッセージが表示されるはずです。**

<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-902e0f5456e4f35ffeb11b024cbf5dd8baf605c0%2Fa5c7bdcf892e35acf42b6bdff389f416b64c7719.png?alt=media" alt="" width="184"></div>
{% endstep %}

{% step %}
**［保存］をクリックします。**
{% endstep %}
{% endstepper %}

***

**Microsoft Entra ID グループの属性を設定する**

{% stepper %}
{% step %}
**Entra ID ポータルで、［Mappings］ドロップダウンを展開し、［Provision Microsoft Entra ID Groups］を選択します。**

<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-4a623fd52425e353786b4892cd3acc7d4b8edf27%2Ff10d56a65a6b2ac555032ee1de3f886f556f5eb3.png?alt=media" alt="" width="353"></div>
{% 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-31130622b7f819e0fe728159be45127f19ef2c0e%2F44aa9e033fa9a4e96216e17268ab26622e3dcdf7.png?alt=media" alt="" width="741"></div>

{% hint style="warning" %}
［ **externalId** ］属性は既定で追加されます。設定の問題を避けるため、この属性を削除してください。
{% endhint %}
{% endstep %}

{% step %}
**（オプション）マッピングを追加する必要がある場合：**

a. クリックします **新しいマッピングを追加** > 次を選択します： **ソース属性** を、上記の Microsoft Entra ID 属性に一致させます。\
b. 次を設定します： **ターゲット属性** を次と一致させます **customappsso** 上記の属性。\
c. クリックします **OK**.
{% endstep %}

{% step %}
**必要に応じて［Save］をクリックし、変更を確認します。**
{% endstep %}

{% step %}
**ページ上部で［Provisioning］を選択して、プロビジョニングページに戻ります。**
{% endstep %}
{% endstepper %}

***

**Microsoft Entra ID ユーザーの属性を設定する**

{% stepper %}
{% step %}
**Entra ID ポータルで、［Mappings］ドロップダウンを展開し、［Provision Microsoft Entra ID Users］を選択してユーザーマッピングを変更します。**
{% endstep %}

{% step %}
**マッピングを下の属性テーブルに一致するように更新します。**

| customappsso 属性                                                             | Microsoft Entra ID 属性                                        |
| --------------------------------------------------------------------------- | ------------------------------------------------------------ |
| `userName`                                                                  | mail                                                         |
| `active`                                                                    | Switch(\[IsSoftDeleted], , "False", "True", "True", "False") |
| `title`                                                                     | jobTitle                                                     |
| `name.givenName`                                                            | givenName                                                    |
| `name.familyName`                                                           | surname                                                      |
| `phoneNumbers[type eq "work"].value`                                        | telephoneNumber                                              |
| `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber` | employeeId                                                   |
| `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:オーガナイゼーション'`    | companyName                                                  |
| `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department`     | department                                                   |
| `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter`     | costCenter                                                   |

{% hint style="warning" %}
［ **Switch** Microsoft Entra ID 属性の下の属性は、次の種類として追加されます： **Expression** マッピングの種類。
{% endhint %}

{% hint style="warning" %}
Source Attribute は Microsoft Entra ID Attribute で、Target Attribute は customappsso Attribute です。 **customappsso** いずれかの属性が Target Attributes として利用できない場合は、Microsoft Entra ID プラットフォームにオプションとして追加する必要がある場合があります。その場合は、 **詳細オプションを表示** のチェックボックスをオンにし、 **customappsso の属性リストを編集**.
{% endhint %}
{% endstep %}

{% step %}
**［Save］をクリックして変更を確認します。**
{% endstep %}

{% step %}
**上部で［Provisioning］を選択し、［Provisioning Status］をオンに切り替えます。**

<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-9bf4b864e5ebcab4b004a36e3fb9f1efb5de5508%2F2f8bbcec0c707caff24b2482e6a9016ade0cf410.png?alt=media" alt="" width="528"></div>
{% endstep %}

{% step %}
**要件に応じて、スコープを次のいずれかの必要なオプションに調整します：**

* すべてのユーザーとグループを同期します。
* 割り当て済みのユーザーとグループのみを同期します。

{% hint style="warning" %}
［Users and Groups］で、ユーザーとグループがエンタープライズ アプリケーションに割り当てられていることを確認します。割り当てられたものが、Command にプロビジョニングされ、存在するものです。
{% endhint %}
{% endstep %}

{% step %}
**ユーザーがアプリケーションに割り当てられていることを確認します。初回プロビジョニングのサイクルが完了したら：**

a. 次の項目で、正常にプロビジョニングされたユーザーとグループの合計数が表示されるはずです： **概要**。\
b. Command では、これらのユーザーとグループに関連する **SCIM Managed** タグが表示されます。これらの同期されたユーザーとグループは、Command で使用でき、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-c9de2cdcacd0a3b5eb9526668689ce24f683ce87%2F37548569136def5ff33826d71fa20894c5d98e8c.jpg?alt=media" alt="" width="1449"></div>
{% endstep %}
{% endstepper %}

**Command から SCIM 管理ユーザーを削除する**

SCIM 管理ユーザーが IDプロバイダ で無効化された場合、Command からユーザーを削除する方法は 2 つあります：

* **ユーザーを削除する** – アカウントは Deleted Users ページに移動しますが、履歴の録画、ロール、権限は保持されます。
* **ユーザーを完全に削除する** – すべてのロール、資格情報、アクセスログ、および関連データが消去されます。ユーザーが SCIM 経由で再プロビジョニングされると、Command は新しいユーザー録画を作成します。

{% hint style="warning" %}
Command でいずれの削除オプションも使用できるようにするには、まず IDプロバイダ（IdP）でユーザーを無効化する必要があります。
{% endhint %}

***

**（オプション）SCIM ユーザーにアクセス資格情報を追加する**

{% stepper %}
{% step %}
**お使いの** [**Azure ポータル**](https://portal.azure.com)**.**
{% endstep %}

{% step %}
**検索バーに入力して、Enterprise Applications を選択します。**
{% endstep %}

{% step %}
**Verkada SCIM アプリケーションを選択します。**
{% endstep %}

{% step %}
**左パネルで［Manage > Provisioning］をクリックします。**
{% endstep %}

{% step %}
**［Mappings］サブメニューを展開し、［Provision Microsoft Entra ID Users］を選択します。**
{% endstep %}

{% step %}
**下部で、［Show advanced options > Edit attribute list for customappsso］をクリックします。**

a. 下の表の属性を追加します。\
b. クリックします **保存**.
{% endstep %}

{% step %}
**［Provision Microsoft Entra ID Users］に戻り、［Add New Mapping］を選択します。**

a. extensionAttributes 1-5 を次のように使用します： **ソース属性** そして、次のために作成された新しい属性にマッピングします： **カード形式、カード番号、カード番号 Hex、資格情報の状態、** および **施設コード** をターゲット属性として。

1. 参照 [許容されるカード形式](/access-control/ja/insutru/badge-reader-support/supported-card-formats.md) について、受け入れ可能なカード形式と、それに関連する施設コード、カード番号、および/またはカード番号 Hex の長さを確認してください。
2. **資格情報の状態** は "active"、"deactivated"、または "deleted" にできます
3. クリックします **保存**.

b. 部門識別子を同期するには、希望するソース属性（例：department やカスタム拡張属性）を使用して新しいマッピングを追加し、ターゲット属性を costCenter に設定します（`urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter`）。これにより、部門 ID の値が Command に同期されます。
{% endstep %}
{% endstepper %}

**属性テーブル**

| 名前                                                                                | 種類  |
| --------------------------------------------------------------------------------- | --- |
| `urn:ietf:params:scim:schemas:extension:verkada:access:2.0:User:cardFormat`       | 文字列 |
| `urn:ietf:params:scim:schemas:extension:verkada:access:2.0:User:cardNumber`       | 文字列 |
| `urn:ietf:params:scim:schemas:extension:verkada:access:2.0:User:cardNumberHex`    | 文字列 |
| `urn:ietf:params:scim:schemas:extension:verkada:access:2.0:User:credentialStatus` | 文字列 |
| `urn:ietf:params:scim:schemas:extension:verkada:access:2.0:User:facilityCode`     | 文字列 |
| `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter`           | 文字列 |

**App Registration を編集する**

Entra AD で作成された SCIM 有効の Enterprise Application には、通常それぞれ専用の App Registration が必要です。

{% stepper %}
{% step %}
**検索バーに入力して、App registrations を選択します。**
{% endstep %}

{% step %}
**［All Applications］タブに切り替え、Verkada SCIM アプリケーションの名前を検索します。**
{% endstep %}

{% step %}
**［Overview］で、App Registration の Application (client) ID と Directory (tenant) ID を控えます。後で、app registration から Command アプリケーションの資格情報を設定するときに必要になります。**
{% endstep %}

{% step %}
**左ナビゲーションで［Manage］をクリックします。**

a. 次の項目で **Certificates & secrets：**

1. クリックします **New client secret**.
2. 次を設定します： **説明** を「*Verkada SCIM Credentials」* そして、希望する証明書の有効期限を設定します。
3. 次に表示される値をコピーして保存します **値** 新しく作成されたクライアント シークレットの値です。 **これは一度だけ表示されます。**

e. 次の項目で **API のアクセス許可**:

1. クリックします **［アクセス許可を追加］ > Microsoft Graph。**
2. 選択 **アプリケーションのアクセス許可** を検索して「*User.ReadWrite.All*".
   1. アクセス許可を割り当てるには、チェックボックスをオンにします。
   2. クリックします **アクセス許可を追加**.

      <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-aa4f0f2b5bbbaff72fb9e9a15901a282ef35d44f%2Fad547ffe93d23f99995dd7a4c0ea257e45d3c7ff.png?alt=media" alt="" width="774"></div>
3. Microsoft Entra ID と Command アプリケーション間で通知されるすべてのステージ変更を手動で確認・承認する必要を避けるには、 **Default Directory に管理者の同意を付与する**.

   <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-4423e1c0a9d4075c8aad869aa3639e31dfab157b%2Faf0b59609d298ec030fd694acd9bf2c34bbd19a6.png?alt=media" alt="" width="512"></div>

{% endstep %}
{% endstepper %}

{% hint style="warning" %}
次の資格情報リストを参照してください: [使用可能なカード形式](/access-control/ja/insutru/badge-reader-support/supported-card-formats.md).
{% endhint %}

**資格情報にアクセスして更新する**

特定のユーザーの拡張属性と資格情報情報を設定するには、次の Graph API の手順を使用してください: <https://learn.microsoft.com/en-us/graph/extensibility-overview>.

{% hint style="warning" %}
設定する **credentialStatus** 属性を **active** ユーザーの資格情報を設定する際にこれを設定することは、Command と資格情報を正常に同期するために必要です。資格情報の状態 (credentialStatus) は extensionAttribute4 に対応します。
{% endhint %}

例:

```
curl --location --request PATCH 'https://graph.microsoft.com/v1.0/users/<UserID>' \
--header 'Authorization: Bearer <secure token>' \
--header 'Content-Type: application/json' \
--data '{
    "onPremisesExtensionAttributes": {
        "extensionAttribute1": "Standard 26-bit Wiegand",
        "extensionAttribute2": "7777",
        "extensionAttribute3": "7",
        "extensionAttribute4": "active",
        "extensionAttribute5": "111"
    }
}'
```

***

**外部 ID を Verkada に同期**

［ `externalId` このフィールドを使用すると、Microsoft Entra を通じてユーザーに永続的でグローバルに一意の識別子を割り当てることができ、Verkada はそれを連携全体で参照できます。これは、ユーザーをシステム間で識別する必要がある大規模な企業環境や、資格情報（例: アクセスカード）を一意の ID キーに紐づける必要がある場合に特に便利です。Verkada は、この値を SCIM ユーザー スキーマの一部として受信し、保存することをサポートしています。このフィールドは大文字と小文字を区別し、通常は Microsoft Entra インスタンス内の指定された属性から文字列値を受け取るように構成されます。この機能は、カスタム資格情報管理、従業員ライフサイクルの自動化、組織間で一貫したユーザー マッピングなどの高度なワークフローをサポートします。

**Azure の externalId を Verkada にマッピング**

Microsoft Entra ID (Azure) から Verkada にカスタム externalId 値を同期するには、次の手順に従います:

{% stepper %}
{% step %}
お使いの **Azure ポータル。**
{% endstep %}

{% step %}
検索バーに入力して、次を選択します **エンタープライズ アプリケーション。**
{% endstep %}

{% step %}
次の項目を選択します **Verkada SCIM アプリケーション。**
{% endstep %}

{% step %}
左側のパネルで、次をクリックします **［管理］ > ［プロビジョニング］。**
{% endstep %}

{% step %}
次を展開します **マッピング** サブメニューを開いて、次を選択します **Microsoft Entra ID ユーザーをプロビジョニングする。**
{% endstep %}

{% step %}
下までスクロールして、次をクリックします **［詳細オプションを表示］ > ［customappsso の属性リストを編集］。**
{% endstep %}

{% step %}
**次の新しい属性を追加します:**

`urn:ietf:params:scim:schemas:extension:verkada:core:2.0:User:externalId`

* 種類: 文字列
* 大文字と小文字を区別: はい
  {% endstep %}

{% step %}
**［保存］をクリックします。**
{% endstep %}

{% step %}
次に戻ります **Microsoft Entra ID ユーザーをプロビジョニングする** をクリックして、 **新しいマッピングを追加します。**
{% endstep %}

{% step %}
次の **ソース属性**では、外部 ID が保存されている Azure AD のフィールドを選択します (例: `extensionAttribute1`, `employeeId`など)。
{% endstep %}

{% step %}
次の **ターゲット属性**には、次を使用します: `urn:ietf:params:scim:schemas:extension:verkada:core:2.0:User:externalId`
{% endstep %}

{% step %}
**OK をクリックしてから、保存します。**
{% endstep %}
{% endstepper %}

プロビジョニングが完了すると、external\_id の値は Verkada 内のユーザーの SCIM 録画に保存されます。これにより、ユーザーは柔軟で API で照会可能な ID を利用でき、それは組織内で一意のままで、完全にユーザー自身の管理下にあり、Verkada の内部識別子に紐づくことも、ユーザーインターフェースに表示されることもありません。

![](https://1706941156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-ad87e0166a1792938d4c35d10f1172332fbfa36e%2Fa1cab99d0a59e02d8322c174969b568cb1519438.png?alt=media)
{% 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/ja/sekyuriti/identity-providers/microsoft-entra-id.md?ask=<question>&goal=<user_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.
