> 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/government-solutions/ja/shingurusainonsso/kesoryshonnoidpurobaida/microsoft-entra-id-saml-integration-government-solutions.md). # Microsoft Entra ID SAML統合 Verkada Command は Microsoft Entra ID と次の2つの方法で統合できます: * Security Assertion Markup Language (SAML) * クロスドメイン ID 管理のためのシステム (SCIM) **SAML** 認証を処理し、Microsoft Entra ID が Verkada Command へのアクセスを管理できるようにします。これは、Microsoft Entra ID テナントですでに統合されている他の Software-as-a-Service (SaaS) アプリケーションへのアクセスを管理するのと同じです。つまり、既存の ID フレームワークに Verkada Command を統合し、現在のポリシーに沿ってユーザーを承認できます。 **SCIM** Microsoft Entra ID の既存のユーザーとグループを活用し、それらを Verkada Command と同期できます。これにより、現在の中央 IdP を維持し、既存のユーザーとグループを使用して Verkada Command の権限を構成できます。 *** ### 開始する前に 統合を成功させるには、次のものが必要です: * Microsoft Entra ID テナントへの管理者アクセス * 次を生成します [クライアント ID](/government-solutions/ja/shingurusainonsso/kesoryshonnoidpurobaida.md#generate-client-id) *** {% tabs %} {% tab title="SAML" %} ## Microsoft Entra ID で SAML を設定する Verkada Command は Microsoft Entra ID マーケットプレースのギャラリー アプリケーションとして利用でき、Microsoft Entra ID Free、P1、P2 ライセンスで使用できます。 {% stepper %} {% step %} **Microsoft Entra ID ディレクトリに Verkada Command をエンタープライズ アプリケーションとして追加します。Microsoft Entra ID の概要ページに移動し、\[エンタープライズ アプリケーション] を選択します。**
{% endstep %} {% step %} **ページ上部で \[新しいアプリケーション] を選択し、Verkada Command を検索します。** {% endstep %} {% step %} **Verkada Command を選択し、\[作成] をクリックします。 *****アプリケーションをあなたの***** Microsoft Entra ID *****テナント*****.**
ページが更新されると、以下のようなメニューが表示されるはずです。\ ​ {% endstep %} {% step %} **\[シングル サインオンの設定] で、\[開始] をクリックします。**
{% endstep %} {% step %} **シングル サインオン方式として SAML を選択します。**
{% endstep %} {% step %} **必要に応じて、\[編集] をクリックして SAML 接続をさらに構成します。** {% endstep %} {% step %} **次のフィールドを構成します。Microsoft Entra ID に追加する前に、各 URL の末尾にクライアント ID を追加する必要があります。下の注記の例を参照してください。** a. 次の **識別子**: [https://saml.prod-govus-pine.verkadagov.com/saml/sso](https://saml.prod-govus-pine.verkadagov.com/saml/sso/)\ b. 次の **返信 URL**: \ c. 次の **サインオン URL**: {% endstep %} {% step %} **\[保存] をクリックします。** {% endstep %} {% step %} **\[属性とクレーム] で、これらの属性に合わせるように \[編集] をクリックします:**
{% hint style="warning" %} メールに別のソース属性を使用する場合は、使用するソース属性に応じて属性を構成してください。 {% endhint %} {% endstep %} {% step %} **\[SAML 署名証明書] > \[フェデレーション メタデータ XML] で、\[ダウンロード] をクリックします。Verkada Command にアップロードするために XML ファイルを保存します。**
{% hint style="info" %} 次に表示されるダイアログには、統合が完了した後に使用できるツールが含まれます。 {% endhint %} {% endstep %} {% step %} **Verkada Command に進んで** [**設定を完了します**](/government-solutions/ja/shingurusainonsso/kesoryshonnoidpurobaida.md#command-configuration)**.** {% endstep %} {% endstepper %} *** ### Microsoft Entra ID で SAML 接続をテストする {% stepper %} {% step %} **Command で XML メタデータ ファイルをアップロードしたら、Microsoft Entra ID アカウントで \[テスト] をクリックして統合を確認します。この操作により、Command アカウントを持つすべてのユーザーに通知が送信され、組織への招待が行われます。**
{% endstep %} {% step %} **現在のユーザーとしてサインインしてログインします。すべてが正しく設定されていれば、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 を中央の IdP として維持できます。 * 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 で、\[すべての製品] > \[Admin] に移動します。** {% endstep %} {% step %} **Org Settings で、\[Login & Access & Logs] > \[SCIM Users Provisioning] を選択します。** {% endstep %} {% step %} **［Add Domain］をクリックし、SCIM で使用する予定の関連するすべてのメールドメインを入力します。** これにより SCIM トークンが生成されます。 **これは一度しか表示できません。** a. クリック **コピー** し、後で構成時に使用するため、トークンを安全な場所に保存します。\ b. クリック [**更新**](broken://pages/674cd271c533a1e1a66f756b9309fcd9af2c9c60) をクリックして、トークンをコピーしていない場合や表示されていない場合に新しいトークンを生成します。 {% endstep %} {% step %} **Microsoft Entra ID のホームページで、\[Enterprise applications] > \[New application] > \[Create your own application] を選択します。** {% endstep %} {% step %} **［Create your own application］のサイドパネルでアプリケーション名を入力し、非ギャラリー アプリケーションを選択して、［Create］をクリックします。**
{% endstep %} {% step %} **［Provision User Accounts］で［Get started］をクリックします。**
{% endstep %} {% step %} **［Manage］>［Provisioning］を選択します。** {% endstep %} {% step %} **プロビジョニング ページで、** 1. プロビジョニング モードを自動に設定します。 2. 米国のオーガナイゼーション' では、Tenant URL を次のように設定します: {% hint style="warning" %} どのリージョンに属しているかを確認するには、 [Verkada 用にオーガナイゼーション' が作成された場所を参照してください](broken://pages/13d994a47f7488c16bbe820def76657fe479f7cd). {% endhint %} f. SCIM の *トークン* を、Verkada Command（手順 2）で生成されたシークレット トークンとして入力します。
{% endstep %} {% step %} **［Test Connection］をクリックします。SCIM 接続が成功したことを示す確認メッセージが表示されるはずです。**
{% endstep %} {% step %} **\[保存] をクリックします。** {% endstep %} {% endstepper %} *** **Microsoft Entra ID グループの属性を構成する** {% stepper %} {% step %} **Entra ID ポータルで［Mappings］ドロップダウンを展開し、［Provision Microsoft Entra ID Groups］を選択します。**
{% endstep %} {% step %} **次のデータテーブルのスクリーンショットに一致するようにマッピングを構成します:**
{% hint style="warning" %} この **externalId** 属性は既定で追加されます。構成に問題が発生しないよう、この属性を削除してください。 {% endhint %} {% endstep %} {% step %} **（オプション）マッピングを追加する必要がある場合:** a. クリック **新しいマッピングを追加** > 次を選択します: **ソース属性** を、上記の Microsoft Entra ID の属性に合わせます。\ b. 次を設定します: **ターゲット属性** を次に合わせます: **customappsso** 上記の属性。\ c. 次をクリックします: **OK**. {% endstep %} {% step %} **必要に応じて、［Save］をクリックして変更を確認します。** {% endstep %} {% step %} **ページ上部で［プロビジョニング］を選択して、プロビジョニング ページに戻ります。** {% endstep %} {% endstepper %} *** **Microsoft Entra ID ユーザーの属性を構成する** {% stepper %} {% step %} **Entra ID ポータルで［マッピング］ドロップダウンを展開し、［Microsoft Entra ID ユーザーのプロビジョニング］を選択してユーザー マッピングを変更します。** {% endstep %} {% step %} **以下の属性表に合わせてマッピングを更新します。** {% hint style="warning" %} この **切り替え** Microsoft Entra ID Attribute の下の attribute は、as an として追加されます **式** マッピングの種類。 {% endhint %} Switch(\[IsSoftDeleted], "False", "True", "True", "False") | customappsso 属性 | Microsoft Entra ID 属性 | | -------------------------------------------------------------------- | ------------------------------------------------------------ | | ユーザー名 | ユーザー プリンシパル名 | | 有効 | Switch(\[IsSoftDeleted], , "False", "True", "True", "False") | | 肩書き | 役職 | | name.名 | 名 | | name.姓 | 姓 | | 電話番号\[type eq "work"].value | 電話番号 | | urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:従業員番号 | 従業員ID | | urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:組織 | 会社名 | | urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:部署 | 部署 | | urn:ietf:params:scim:schemas:extension:verkada:core:2.0:User:コストセンター | コストセンター | {% hint style="warning" %} Source Attribute は Microsoft Entra ID 属性で、Target Attribute は customappsso 属性です。もしこれらの **customappsso** 属性のいずれかが Target Attribute として利用できない場合は、Microsoft Entra ID プラットフォームにオプションとして追加する必要がある場合があります。これを行うには、 **詳細オプションを表示** ボックスにチェックを入れて、 **customappsso の属性リストを編集**. {% endhint %} {% hint style="warning" %} SCIM で管理されているユーザーは、Command で電話番号を編集するオプションがなくなりました。代わりに、SCIM 経由でのみプロビジョニングできます。IDP 側では、IDP インスタンス内の任意のフィールドが Command の **電話番号** フィールドにマップされるように、属性マッピングを設定できます。また、 **いいえ** IDP のフィールドは、 **電話番号** Command のフィールドです。ただし、この場合でも、電話番号は Command 内でロックされたままで、SCIM 経由でのみ編集できます。 {% endhint %} {% endstep %} {% step %} **変更を確定するには、\[保存] をクリックします。** {% endstep %} {% step %} **上部で \[Provisioning] を選択し、\[Provisioning Status] をオンにします。**
{% endstep %} {% step %} **要件に応じて、スコープを次のいずれかの必要なオプションに調整します：** * すべてのユーザーとグループを同期します。 * 割り当て済みのユーザーとグループのみを同期します。 {% hint style="warning" %} ［Users and Groups］で、ユーザーとグループがエンタープライズ アプリケーションに割り当てられていることを確認します。割り当てられているものがプロビジョニングされ、Command に表示されます。 {% endhint %} {% endstep %} {% step %} **ユーザーがアプリケーションに割り当てられていることを確認します。初回のプロビジョニング サイクルが完了すると：** a. の下に、正常にプロビジョニングされたユーザーとグループの合計数が表示されるはずです **概要**。\ b. Command では、これらのユーザーとグループに関連付けられた **SCIM 管理** タグ。これらの同期されたユーザーとグループは、Command で使用できるようになり、Command プラットフォームへのアクセスを制御するための権限を割り当てられます。
{% endstep %} {% endstepper %} **Command から SCIM 管理ユーザーを削除する** IDプロバイダで SCIM 管理ユーザーが無効化されると、Command からそのユーザーを 2 つの方法で削除できます： * **ユーザーを削除する** – アカウントは削除済みユーザーページに移動しますが、履歴の録画、ロール、権限は保持されます。 * **ユーザーを完全に削除する** – すべてのロール、認証情報、アクセスログ、および関連データが消去されます。ユーザーが 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 %} **左側のパネルで、\[管理] > \[プロビジョニング] をクリックします。** {% endstep %} {% step %} **［マッピング］サブメニューを展開し、［Microsoft Entra ID ユーザーのプロビジョニング］を選択します。** {% endstep %} {% step %} **下部で、\[詳細オプションを表示] > \[customappsso の属性リストを編集] をクリックします。** a. 以下の表の属性を追加します。\ b. クリック **保存**. {% endstep %} {% step %} **Microsoft Entra ID ユーザーのプロビジョニングに戻り、\[新しいマッピングを追加] を選択します。** a. extensionAttributes 1-5 を使用して **ソース属性** それらを、作成した新しい属性にマッピングし **カード形式、カード番号、カード番号の16進数、認証情報のステータス、** および **施設コード** をターゲット属性として使用します。 1. 参照 [許容されるカード形式](/access-control/ja/insutru/badge-reader-support/supported-card-formats.md) 許容されるカード形式と、それに関連付けられた施設コード、カード番号、および/またはカード番号の16進数の長さについて。 2. **認証情報のステータス** 「active」、「deactivated」、または「deleted」にできます 3. クリック **保存**. b. 部門識別子を同期するには、必要なソース属性（例: department またはカスタム拡張属性）を使用して新しいマッピングを追加し、ターゲット属性を costCenter (urn:ietf:params:scim:schemas:extension:verkada:core: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:verkada:core:2.0:User:コストセンター | 文字列 | **アプリ登録を編集する** Entra AD で作成された SCIM 有効のエンタープライズ アプリケーションは通常、それぞれ専用のアプリ登録を必要とします。 {% stepper %} {% step %} **検索バーに「App registrations」と入力して選択します。** {% endstep %} {% step %} **［All Applications］タブに切り替え、Verkada SCIM アプリケーションの名前を検索します。** {% endstep %} {% step %} **概要で、アプリ登録の Application (client) ID と Directory (tenant) ID を控えます。後で、アプリ登録から Command アプリケーションの認証情報を構成するときに必要になります。** {% endstep %} {% step %} **左側のナビゲーションで、\[管理] をクリックします。** a. の下に **証明書とシークレット:** 1. クリック **新しいクライアント シークレット**. 2. 次を設定します **説明** を"*Verkada SCIM 資格情報"* そして、希望する証明書の有効期限を設定します。 3. 次に表示される値をコピーして保存します **値** 新しく作成されたクライアント シークレットの。 **これは一度だけ表示されます。** e. の下に **API のアクセス許可**: 1. クリック **アクセス許可の追加 > Microsoft Graph。** 2. 選択します **アプリケーションのアクセス許可** そして"*User.ReadWrite.All*". 1. チェックボックスをオンにして、アクセス許可を割り当てます。 2. クリック **アクセス許可を追加**.
3. Microsoft Entra ID とお使いの Command アプリケーションの間で通知されるすべての段階の変更を手動で確認および承認する必要を避けるには、次を選択します **Default Directory に管理者の同意を付与**.
{% endstep %} {% endstepper %} {% hint style="warning" %} については、この資格情報の一覧を参照してください [使用可能なカード形式](/access-control/ja/insutru/badge-reader-support/supported-card-formats.md). {% endhint %} **資格情報にアクセスして更新する** 特定のユーザーの拡張属性と資格情報を設定するには、次の Graph API 手順を使用します: . {% hint style="warning" %} 次を設定すること **credentialStatus** 属性を **有効** ユーザーの資格情報を設定するときに、Command と資格情報を正常に同期するために必要です。資格情報の状態 (credentialStatus) は extensionAttribute4 です。 {% endhint %} 例: ``` curl --location --request PATCH 'https://graph.microsoft.com/v1.0/users/' \\ --header 'Authorization: Bearer ' \\ --header 'Content-Type: application/json' \\ --data '{ "onPremisesExtensionAttributes": { "extensionAttribute1": "Standard 26-bit Wiegand", "extensionAttribute2": "7777", "extensionAttribute3": "7", "extensionAttribute4": "active", "extensionAttribute5": "111" } }' ``` *** **Verkada に外部 ID を同期** externalId フィールドを使用すると、Microsoft Entra を通じてユーザーに永続的でグローバルに一意な識別子を割り当てることができ、Verkada はそれを各種統合間で参照できます。これは、システム間でユーザーを区別する必要がある大規模なエンタープライズ環境や、資格情報（例: アクセスカード）を一意の ID キーに紐づける必要がある場合に特に便利です。Verkada は、この値を SCIM ユーザースキーマの一部として受け取り、保存することをサポートしています。このフィールドは大文字と小文字を区別し、通常は Microsoft Entra インスタンス内の指定した属性からの文字列値を受け取るよう設定します。この機能は、カスタムの資格情報管理、従業員ライフサイクルの自動化、組織間での一貫したユーザーマッピングなどの高度なワークフローをサポートします。 **Azure から Verkada へ externalId をマップ** Microsoft Entra ID (Azure) から Verkada にカスタム externalId 値を同期するには、次の手順に従います: {% stepper %} {% step %} **Azure ポータルにログインします。** {% endstep %} {% step %} **検索バーに「Enterprise Applications」と入力して選択します。** {% 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 %} **ソース属性では、Azure AD で外部 ID が保存されているフィールドを選択します（例: 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 の内部識別子に紐づけられたり、ユーザーインターフェースに表示されたりすることはありません。 ![](/files/1f5e1d9d1c9fd64c0c4e7c613c0a3c299b4c1e3b) {% hint style="info" %} **動作を見てみませんか?** 次をチェックしてください [動画チュートリアル](https://www.youtube.com/watch?v=YSMzqFwWlW4). {% endhint %} {% 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.verkada.com/government-solutions/ja/shingurusainonsso/kesoryshonnoidpurobaida/microsoft-entra-id-saml-integration-government-solutions.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.