> For the complete documentation index, see [llms.txt](https://library.zoom.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://library.zoom.com/technical-library/ja/kn/account-and-endpoint-management/scim-guide.md).

# Entra ID と Okta 向け SCIM フィールドガイド

Entra ID または Okta と Zoom の間でカスタム SCIM マッピングを作成するためのガイド

## 概要

Zoom の SCIM2 API は、ライセンス、製品の権限、ロール、リージョン、およびサービスごとの設定を制御する多数のユーザー属性を公開しています。Microsoft Entra ID と Okta の両方に用意された標準のプロビジョニング統合は、これらのごく一部しかマッピングしません。つまり、ユーザーの作成、更新、無効化には十分でも、Zoom Phone サイト、コンタクトセンター パッケージ、Revenue Accelerator のロール、または Zoom がサポートする他の数十個の属性をプロビジョニングするには不十分です。

このガイドでは、次のものを追加するための再現可能な手順を説明します。 *任意の* Zoom SCIM属性をプロビジョニング設定に追加できます。属性を1つずつ個別に説明するのではなく、基本となる仕組みを解説します。これにより、管理者はZoomのSCIM2 APIリファレンスで属性を調べ、製品固有の記事の公開を待つことなく、独自に設定できるようになります。

### このガイドの使い方

まず、次の見出しから始まる「はじめに」を読み、 [**SCIM属性を理解する**](#understanding-scim-attributes) と、その後に続くセクション（前提条件、ディレクトリデータ、参照シナリオ、Zoom側での認証）を確認してください。これらの内容は、使用するIDプロバイダー（IdP）に関係なく適用されます。その後、使用しているプロバイダーに応じて、Microsoft Entra IDまたはOktaのセクションに進んでください。それぞれのセクションでは、最初の設定手順から認証、実例までを一通り説明しているため、セクション間を行き来する必要はありません。

このガイドの基礎となるSSOとSCIMの概念については、 [SSOフィールドガイド](https://library.zoom.com/admin-corner/account-and-endpoint-management/sso-field-guide)および [Entra ID向けZoom SSOとプロビジョニングの記事](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064121)、および [Okta向けZoom SSOの記事](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063256).

{% hint style="danger" %}
**警告**

設定ミスのあるプロビジョニングは、すでに使用中のライセンスの削除を含め、既存のユーザーに影響します。本番環境のユーザーに適用する前に、各変更を単一のテストユーザーで検証してください。
{% endhint %}

### **SCIM を使用するための前提条件**

このセクションの内容は、ID プロバイダーに関係なく適用されます。ID プロバイダー固有の手順に進む前にお読みください。

#### 両方の ID プロバイダーに共通する要件

* 承認済みの [バニティURL](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0061540)
* Zoomアカウントオーナーまたは管理者権限
* [シングルサインオン（SSO）](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060673) Zoomアカウントで有効になっている
* 以下が必要です。 [確認済みの関連付け済みドメイン](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0066259) がZoomアカウントに設定されており、プロビジョニング対象ユーザーのメールドメインと一致していること
* アイデンティティプロバイダーとZoomの間でSCIMプロビジョニングがすでに確立されている
* 割り当てられるZoomライセンス、プラン、アドオン、または設定オブジェクトは、すでに存在し、Zoomアカウントで利用可能でなければなりません

各セクションの冒頭に、アイデンティティプロバイダー固有の要件が記載されています。

#### 両方のアイデンティティプロバイダーに共通する制限

* SCIMで割り当てられるのは既存のエンタイトルメントのみです。参照先のオブジェクトを作成することはできません。詳細については、次のセクションを参照してください [**高度なマッピングを試す前に、SCIMから参照できるよう、Zoom側のオブジェクトが存在している必要があります。**](#before-attempting-advanced-mapping-zoom-side-objects-must-exist-before-scim-can-reference-them) 以下。
* 一部の属性は、ユーザーごとに1つの値しか受け付けません。Zoom Phoneの通話プランは一例です — Customer Engagement Packなどのアドオンパッケージは、SCIMを通じてプロビジョニングできません。
* その `userType` この属性は、Zoom により廃止予定としてドキュメントに記載されています。

## **はじめに**

### **SCIM 属性の理解**

Zoom SCIM 属性の構造を理解している管理者は、Zoom がサポートする任意の属性を設定することができます。レシピに従う管理者は、そのレシピで説明されている属性のみを設定できます。このセクションでは、その構造を説明します。属性をデータソースにマッピングする方法は、後のアイデンティティ プロバイダーのセクションで扱います。

#### <mark style="color:青;">各属性には、名前空間、名前、データ型、および許可される値があります</mark>

完全に動作する例から始めましょう。こちらは、ユーザーをZoom Phoneサイトに割り当てるための識別子です:

```
urn:ietf:params:scim:schemas:extension:Zoom:1.0:ユーザー:ZoomPhoneSite
```

この属性では4つのプロパティが使われます。そのうち2つは上の行に表示されています。残りの2つはAPIリファレンスに記載されており、後ほどIDプロバイダーの別の場所で入力します。ここでは、まず次の2つに注目します。 **名前空間** および **名前**.

<table><thead><tr><th width="155.290771484375">プロパティ</th><th>例から抽出されました</th><th>何をするか</th></tr></thead><tbody><tr><td><strong>名前空間</strong></td><td><code>urn:ietf:params:scim:schemas:extension:zoom:1.0:User</code></td><td>この設定がどのスキーマに属するかを Zoom に伝え、ほぼすべての Zoom 製品およびライセンス属性の共通ベースとして機能します。識別子の前半として Zoom に渡されます。</td></tr><tr><td><strong>氏名</strong></td><td><code>zoomPhoneSite</code></td><td>書き込まれている特定の Zoom 設定、ここではユーザーの Zoom Phone サイトを特定します。識別子の後半として Zoom に渡されます。大文字と小文字を区別します。</td></tr><tr><td><strong>データ型</strong></td><td><code>string</code></td><td>属性にどのような値が含まれるかをIDプロバイダーに伝え、正しく保存・フォーマットできるようにします。識別子の一部として渡されるのではなく、別途次のように宣言されます。 <strong>タイプ</strong> はEntra IDで、 <strong>データ型</strong> はOktaで使用されます。</td></tr><tr><td><strong>許可される値</strong></td><td><code>LON-01</code>、Zoom Phoneのサイト名</td><td>ユーザーに実際に適用される設定です。一部の属性では自由入力、その他の属性では固定の選択肢です — <code>基本</code>, <code>Premium</code>、または <code>Elite</code> たとえば Zoom コンタクトセンター向けです。プロビジョニング時に Zoom に渡され、識別子ではなくマッピングによって指定されます。</td></tr></tbody></table>

{% hint style="danger" %}
**警告**

Zoom は複数のユーザー拡張名前空間を公開しています。製品の設定とライセンス属性には、次の名前空間を使用します `urn:ietf:params:scim:schemas:extension:zoom:1.0:User`。このガイド全体で使用する名前空間です。エンタープライズの標準フィールドとしては、 `department`, `manager`、および `costCenter` 使用する `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User`。3つ目は、 `urn:us:zoom:scim:schemas:extension:1.0:ZoomUser`。プロビジョニング時に設定されるのではなく、API レスポンスで返されるログインタイプ情報を保持します。誤った名前空間に基づいて作成された属性は、ID プロバイダーで受け入れられ、Zoom によって無視されても通知されません。
{% endhint %}

#### <mark style="color:青;">SCIM2 API リファレンスで必要な属性を見つけてください</mark>

その [SCIM2 API リファレンス](https://developers.zoom.us/docs/api/scim2/#tag/user/post/scim2/Users) プロビジョニング時にZoomが受け付けるすべての項目を網羅した正式な一覧です。重要な操作は2つあります。 **ユーザーを作成する** および **ユーザーを更新する**.

主に次の情報を参照してください **ユーザーを更新する**。作成は1人につき一度だけですが、属性の変更は継続的に発生します。オフィスの移転、プランの変更、ロールの変更、退職などがあるため、プロビジョニングで実際に行われる処理の大半は、時間の経過とともに発生する更新です。 **ユーザーを更新する** では、 **ユーザーを作成する** に含める必要のない、削除時の値についても説明しています。たとえば、 `zoomPhoneCallingPlan` 宛先 `-1` ユーザーからすべての通話プランを削除する。

属性を見つけるには：

* SCIM2 API リファレンスを開き、次に進みます **ユーザーを更新する**.
* リクエストボディ内で、次の項目を見つけます `urn:ietf:params:scim:schemas:extension:zoom:1.0:User` オブジェクト。このガイドで説明するすべての属性が、その中に一覧表示されています。
* 名前で属性を見つけ、その属性をレコーディングします **データ型** およびその **許可される値**.
* 属性名だけでは推測できない動作が説明文に記載されています。説明文もあわせて確認してください。— `zoomPhoneExtNumber` に設定すると `0` 内線番号が自動的に割り当てられます。 `zoomPhoneCallingPlan` に設定すると `-1` すべての通話プランが削除されます。また、 `zoomPhoneNumber` には、Zoomアカウント内ですでに未割り当ての番号を指定する必要があります。

#### <mark style="color:青;">識別子の組み立て: 親、コロン、子</mark>

その中に記載されているすべての項目 `urn:ietf:params:scim:schemas:extension:zoom:1.0:User` オブジェクトは **子** のことです。オブジェクト自体が **親**。識別子を作成するには、親の名前を付け、コロンを追加してから、子の名前を追加します:

```
親       urn:ietf:params:scim:schemas:extension:zoom:1.0:User
コロン        ：
子        zoomPhoneSite

識別子   urn:ietf:params:scim:schemas:extension:zoom:1.0:ユーザー:zoomPhoneSite
```

それが構成のすべてです。Zoom に要求するルックアップテーブルも、生成するものもありません — 識別子は、すでに持っている 2 つのものをコロンでつないだものです。

#### <mark style="color:青;">親は変わらず、子だけが変わります</mark>

親が固定されているため、2番目、5番目、あるいは15番目の属性を設定するのも、異なる子を追加するだけで同じ操作です:

```
ベース（親）              urn:ietf:params:scim:schemas:extension:zoom:1.0:ユーザー

Zoom Phone サイト            urn:ietf:params:scim:schemas:extension:zoom:1.0:ユーザー:zoomPhoneSite
Zoom Phoneの電話番号          urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomPhoneNumber
Zoom Phone 内線番号       urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomPhoneExtNumber
Zoom Phone 通話プラン    urn:ietf:params:scim:schemas:extension:zoom:1.0:ユーザー:zoomPhoneCallingPlan
```

同じ親が他のすべての Zoom 製品を支えています。製品が変わっても、構造に関する点は何も変わりません:

```
コンタクトセンター パッケージ     urn:ietf:params:scim:schemas:extension:zoom:1.0:ユーザー:zoomContactCenterPackage
Revenue Accelerator ロール   urn:ietf:params:scim:schemas:extension:Zoom:1.0:ユーザー:ZoomRevenueAcceleratorロール
ワークプレイス バンドル           urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomWorkplace
Zoom Docs                  urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomDocs
```

したがって、親は一度だけ学習します。その後は、新しい属性を設定する際に API リファレンスで確認するのは、子の名前、そのデータ型、そして許可される値の3つだけです。

親と子を組み立てられるなら、この設定の最も難しい部分はもう終わったも同然です。残るのは、各値をどこから取得するのかをアイデンティティ プロバイダーに伝えることです。これは、続く Entra ID と Okta のセクションで扱います。そして、どの属性から先に取り組むかを決めることです。これは次へで扱います。

#### <mark style="color:青;">2種類のマッピング: ベーシックと高度</mark>

すべての属性が同じリスクを持つわけではなく、何かを設定する前にそれらを分類しておく価値があります。

このガイドでは、次の用語を使用しています **ベーシック** および **詳細** 『 [SSOフィールドガイド](https://library.zoom.com/admin-corner/account-and-endpoint-management/sso-field-guide)』と同様に、SAMLレスポンスのマッピングでも同じ区別がされています。これらの用語は、 **値を受け取ったときにZoomがその値をどう扱うか**を表すものであり、属性の設定の難しさを表すものではありません。仕組みとしては両者は同一です。どちらも同じ **ユーザーの更新** リクエスト本文に記載され、同じ親子のコロン区切り構造で作成され、Entra IDとOktaで同じ手順を通じて宣言およびマッピングされます。

* **ベーシックマッピング** はユーザーのプロフィールにテキストを書き込みます。Zoomは送信された値をそのまま保存し、何かと照合することはありません。
* **高度なマッピング** アカウントに対して値を割り当てます。Zoom はその値を受け取り、一致するオブジェクト、または購入済みプランの空きシートを検索します。この検索は失敗することがあります。

<table><thead><tr><th width="199.435791015625"></th><th>ベーシック マッピング</th><th>高度なマッピング</th></tr></thead><tbody><tr><td><strong>値とは何か</strong></td><td>ユーザーのプロフィールに保存されるテキスト</td><td>Zoom内のオブジェクトへのポインタ、または購入済みシートの権利</td></tr><tr><td><strong>例</strong></td><td><code>department</code>, <code>title</code>, <code>costCenter</code></td><td><code>zoomPhoneSite</code>, <code>zoomContactCenterRole</code>, <code>zoomWorkplace</code></td></tr><tr><td><strong>親</strong></td><td>トップレベル、またはエンタープライズ拡張</td><td>Zoom拡張</td></tr><tr><td><strong>Zoomにおける前提条件</strong></td><td>なし</td><td>オブジェクトが存在しているか、シートが空いている必要があります</td></tr><tr><td><strong>値が正しくない場合</strong></td><td>プロフィールに誤ったテキストが表示される</td><td>その属性は拒否されるか、黙って無視される</td></tr></tbody></table>

この違いは、実務上の2つの判断に影響します。まず、 **Zoom で事前に何を構築する必要があるか** が決まります。基本マッピングなら何も必要ありませんが、高度なマッピングでは多くの作業が必要になる可能性があります。また、 **ミスの代償**。部署の誤りは、プロフィール上の見た目だけの問題です。サイト名の誤りやライセンス枠の不足は、ユーザーが電話を使えなくなったり、採用時に使う予定だった製品を利用できなくなったりする原因になります。また、本番環境では、すでに権限を持っていたユーザーからその権限を剥奪してしまう可能性があります。

結果の違いこそが、以下で両者を分けて扱う理由である。

#### <mark style="color:青;">ベーシックなマッピング: プロフィール情報</mark>

ベーシックなマッピングは、ユーザーの Zoom プロフィール上の説明フィールドに値を設定する。Zoom は送信された各値をそのまま保存し、既存のオブジェクトに対して検証することはない。そのため、事前に Zoom 側で構築しておくものは何もなく、値が間違っていても壊れるものはない。

**コアとなる ID フィールドは、通常すでにマッピングされています。** `ユーザー名`, `name.givenName`, `name.familyName`, `displayName`、および `emails` リクエストボディの最上位に配置され、親要素を持たない形式で、Entra ID と Okta の両方のインテグレーションが標準でこれらをマッピングします。再構築するのではなく、検証してください。 `title`, `phoneNumbers`、および `locale` もトップレベルにありますが、追加が必要な場合があります。

**エンタープライズのフィールドでは、親がもう1つ必要です。** 構成は変わらず、親だけが変わります。

```
ベース（親）         urn:ietf:params:scim:schemas:extension:enterprise:2.0:User

部門            urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department
コストセンター           urn:ietf:params:scim:schemas:extension:エンタープライズ:2.0:ユーザー:costCenter
従業員番号       urn:ietf:params:scim:schemas:extension:エンタープライズ:2.0:ユーザー:employeeNumber
組織          urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:組織
マネージャー               urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager
```

SCIM 経由で部署とコストセンターを設定するために、もはや SAML マッピングは不要です。

{% hint style="info" %}
**推奨事項**

まず基本属性を1つマッピングします。 `department` は有力な候補で、次のように処理します。 **シナリオ 0** 参照シナリオでの設定を確認し、Zoom拡張機能の設定に進む前に、テストユーザー1人を使ってエンドツーエンドで実行してください。A `department` Zoomプロフィールに値が正しく表示されれば、スキーマ宣言、マッピング、スコープ、およびプロビジョニングログを読み取る能力が確認できます。以降の高度な属性は、参照先が異なるだけで、設定方法は同じです。
{% endhint %}

#### <mark style="color:青;">高度なマッピング: 製品構成とエンタイトルメント</mark>

高度なマッピングでは、ユーザーができることを割り当てます。たとえば、Zoom Phone のサイトと通話プラン、コンタクトセンターのロールとパッケージ、Workplace バンドル、Revenue Accelerator セグメントです。これらの属性は、このガイド全体で使用される Zoom拡張機能の親の下にあります。

重要な違いは、これらの値が保存されるのではなく、 **解決される**という点です。Zoomは送信された値を受け取り、一致するオブジェクトまたはオンラインのシートを探します。基本的なマッピングではプロフィールにテキストを書き込みますが、高度なマッピングではアカウントの構成やインベントリに対する要求を行い、その要求が失敗することもあります。

このため、このガイドでは前提条件に1つのセクション全体を割いています。すべての高度な属性は、まず Zoomウェブポータルで何かが作成または購入されていることに依存しており、失敗時の挙動は、職名のスペルミスよりもはるかに厳しいものです。

#### <mark style="color:青;">すべての構成に共通する3つのレイヤー</mark>

どの属性でも、どのIDプロバイダーでも、作業は同じ3つのレイヤーです。異なるのは各コントロールの位置情報だけです。

<table><thead><tr><th width="114.4166259765625">レイヤー</th><th>目的</th><th>Microsoft Entra ID</th><th>Okta</th></tr></thead><tbody><tr><td><strong>1. 宣言する</strong></td><td>その属性がZoom アプリケーション上に存在することをIDプロバイダーに伝え、マッピング対象として使えるようにします。</td><td>ステップ1</td><td>ステップ1</td></tr><tr><td><strong>2. マップ</strong></td><td>値の取得元を定義します。</td><td>ステップ2</td><td>手順 2–3</td></tr><tr><td><strong>3. スコープ</strong></td><td>どのユーザーにこの構成が適用され、いつ実行されるかを決定します。</td><td>手順 3〜5</td><td>手順 4〜5</td></tr></tbody></table>

このパターンを理解すると、5 個目や 15 個目の属性を追加することは、同じ 3 つのレイヤーの繰り返しであり、新しいプロジェクトではありません。

#### <mark style="color:青;">Entra と Okta では、値の由来となる場所が異なります</mark>

これは、2 つのパスの間にある最も重大なアーキテクチャ上の違いであり、同じビジネス要件が Entra と Okta で異なる構成を生み出す理由を説明しています。

* **Entra IDでは、ユーザーオブジェクトの属性からのみ値を取得します。** 値は、既存のディレクトリフィールドまたは専用設計の拡張属性など、ユーザーのフィールドから取得する必要があります。ディレクトリの値とZoomの値が同じ文字列でない場合は、それらを変換するための式が必要です。
* **Oktaでは、ユーザープロフィールまたはグループの割り当てから値を取得できます。** 次の属性を宣言します。 **属性タイプ: グループ** グループに一度設定した値を、すべてのメンバーに継承させることができます。設定が組織構造に沿っている場合、変換ロジックは一切不要になります。

どちらの方法も普遍的に優れているわけではありませんが、異なる設定につながります。

### **Zoom側の事前設定要件**

#### <mark style="color:青;">高度なマッピングを試す前に、SCIMが参照できるよう、Zoom側のオブジェクトが存在している必要があります</mark>

SCIMは割り当ての仕組みであり、作成の仕組みではありません。ユーザーをZoomアカウント上にすでに存在する設定に紐付けますが、 **できません** ユーザーに代わってその設定を作成することは

高度なマッピング属性の多くは、 **参照**です。送信する値は、Zoomにすでに存在するオブジェクト（サイト、ロール、テンプレート、購入済みプラン、特定の電話番号や内線番号）を特定できる必要があります。すべてに共通するルールは次のとおりです。

> 属性が何かを指定する場合、その対象は既に存在し、送信される表記と完全に一致している必要があります。また、有限のプールから使用される場合は、未使用の定員が必要です。

参照先オブジェクトが存在しない場合、SCIMはそれを作成せず、リクエストをキューにも入れません。属性は、プロビジョニングログにエラーが返されて完全に失敗するか、あるいは黙って破棄されます。後者の場合、Zoomはペイロードを受け入れますが何も適用せず、成功を報告します。

以下のセクションでは、各項目を作成するためのナビゲーションパスとサポート記事とともに、製品別の前提条件を説明します。まずアカウントレベルの注記を読み、次にプロビジョニングする各製品のセクションを確認してください。

#### <mark style="color:青;">いずれの製品をプロビジョニングする前にも、アカウントレベルの前提条件が適用されます</mark>

このガイドの冒頭に記載されているアカウント要件（バニティURL、SSO、SCIM認証、検証済みの関連ドメイン）は、以降のすべての属性の前提条件です。セキュリティとSSOは [**管理センター**](https://zoom.com/account) → [**セキュリティと信頼**](https://zoom.com/account/setting/security)で設定し、関連ドメインは [**管理センター**](https://zoom.com/account) → **アカウント** → [**アカウントプロファイル**](https://zoom.com/account)で管理します。詳しくは、 [ZoomとMicrosoft Entra IDのSSO/SCIM設定](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064121).

さらに、明示しておくべき点が2つあります。

* **ライセンスを購入することと、ライセンスを割り当てることは同じではありません。** SCIMは割り当てを行いますが、ライセンスは事前に用意されている必要があります。詳しくは、 [ユーザーへのZoomライセンスの割り当てまたは削除](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064911).
* **ライセンスは、要求されるプランと完全に一致するプランに属している必要があります。** 該当するプランに空きライセンスがない場合、アカウントの別のプランに空き定員があっても、ライセンス属性を送信すると失敗します。

#### <mark style="color:青;">Zoom Phone</mark>

Zoom Phoneには、Zoom Phoneユーザーが事前購入済みまたは事前構築済みの複数のインフラ要素から構成されるため、最も多くの参照属性があります。

| 属性                                                       | 事前に存在している必要があるもの                                                           | 作成方法                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| -------------------------------------------------------- | -------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Zoom Phoneライセンス自体                                        | 利用可能なZoom Phoneシート。以下の項目を関連付ける前に必要な権利です。                                   | 事前に購入してください。詳しくは、 [Zoom Phoneライセンスの購入と割り当て](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0077929).                                                                                                                                                                                                                                                                                                                                                      |
| `zoomPhoneSite`                                          | 送信する値と完全に同じ名前のサイト。属性を省略すると、複数のサイトを有効にした時点でデフォルトで存在するアカウントのメインサイトが割り当てられます。 | [管理センター](https://zoom.com/account) → 製品設定 → 電話システム → [会社情報](https://zoom.com/pbx/page/telephone/settings#/settings) → **サイトを追加**、または一括作成の場合は **インポート** を選択します。詳しくは、 [複数のサイトの管理](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0069716).                                                                                                                                                                                                                  |
| `zoomPhoneNumber`                                        | アカウントに購入またはポート済みで、現在未割り当ての番号。他のユーザー、コールキュー、または自動受付に既に割り当てられている番号は再利用できません。 | [管理センター](https://zoom.com/account) → 製品設定 → 番号 → [電話番号](https://zoom.com/cpw/page/phoneNumbers#/number-list)で購入または移行し、SCIMで割り当てられるよう、対象の番号は未割り当てのままにします。詳しくは、 [番号管理を使用した電話番号の管理](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0074457) および [電話番号の管理](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060212).                                                                                                                       |
| `zoomPhoneExtNumber` （特定の値のみ）                            | 未使用の3～6桁の内線番号です。次を送信する場合は不要です。 `0`この場合、割り当てはZoomに委ねられます。                   | [管理センター](https://zoom.com/account) → 製品設定 → 電話システム → [ユーザーとルーム](https://zoom.com/pbx/page/telephone/phoneUsers#/users) → 内線番号が設定されているオブジェクトを選択 → **プロフィール** → **内線番号** → **編集**。詳細については、 [Zoom Phoneユーザーの設定を変更する](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0069338).                                                                                                                                                                                |
| `zoomPhoneCallingPlan`                                   | 購入済みで利用可能な定員があり、正確なプランコードで参照される通話プラン。                                      | 事前に購入します。詳細については、 [Zoom Phoneライセンスの購入と割り当て](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0077929) および [Zoom Phoneユーザーを管理する](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0069309)を参照してください。プランコードは [Zoom Phone通話プランのリファレンス](https://developers.zoom.us/docs/api/references/phone-calling-plans/)に記載されているか、 `type` APIの [通話プランの一覧表示](https://developers.zoom.us/docs/api/references/phone-calling-plans/) から、利用可能なライセンス数とともに返されます。 |
| `zoomPhoneCallingPlanSubscription` （複数サブスクリプションのアカウントのみ） | アカウントが同じプランに対して複数のサブスクリプションを保持している場合に、そのプランで使用する特定のサブスクリプション。              | プランと請求 → サブスクリプション管理。                                                                                                                                                                                                                                                                                                                                                                                                                                                         |

**内線番号プールはユーザーだけでなく、複数のオブジェクトタイプで共有されます。** 通話キュー、自動受付、共有回線グループ、共用エリアの電話機はすべて、同じ範囲の内線番号を使用します。管理者がユーザーリストだけを確認した際には内線番号が空いているように見えるため、これが「内線番号はすでに使用中」というエラーの最も一般的な原因です。

**番号ポータビリティが完了するまで、移行した番号を割り当てることはできません。** 番号がアカウントに存在し、かつ未割り当てである必要があります。番号ポータビリティを開始しただけでは、どちらの条件も満たされません。

**サイトは最も一般的な阻害要因です** 。サイトの作成には独自の要件があるためです。サイトの住所は緊急通話サービスの基盤となるため、実在の住所データベースと照合して検証されます。架空の住所と郵便番号の組み合わせは、検証エラーとして拒否されます。サイトを一括インポートする際、\[自動受付]列にはインターフェースに表示されるラベル文字列ではなく、値 `Yes` を指定してください。また、発信者ID名は主に米国とカナダで使用されるため、検証エラーの原因になる場合は空欄にできます。

#### <mark style="color:青;">Zoom コンタクトセンター</mark>

コンタクトセンターのプロビジョニングは、ロールとテンプレートに基づいて行われます。個々の属性は既存のコンタクトセンターオブジェクトに解決される必要があり、テンプレートには専用のSCIM属性がない設定が含まれます。

| 属性                              | 事前に存在している必要があるもの                                                                  | 作成方法                                                                                                                                                                                                                                                                                                              |
| ------------------------------- | --------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `zoomContactCenterPackage`      | 未使用のライセンスとともに購入するパッケージ —  `Essentials`, `Premium`または `Elite` 。                    | 事前に購入してください。Premiumで追加パッケージを購入するには、事前にZoomサポートへの問い合わせが必要な場合があります。詳細については、 [Zoomコンタクトセンターユーザーの設定を変更する](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060874).                                                                                                                                |
| `zoomContactCenterAddonsPlan`   | 購入済みで定員があるアドオンプラン。                                                                | 事前に購入してください。アカウントプランと請求情報。                                                                                                                                                                                                                                                                                        |
| `zoomContactCenterRole`         | スタンダードまたはカスタムのロール。名前は完全に一致している必要があります。省略すると、デフォルトで存在するデフォルトのAgentロールが割り当てられます。    | [管理者センター](https://zoom.com/account) → CX管理 → コンタクトセンター → [ロール](https://zoom.com/cci/index/admin#/admin-next/admin-roles) → **追加** → 権限を設定 → **保存**を参照してください。 [Zoomコンタクトセンターのロールを管理する](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0061941).                                                |
| `zoomContactCenterRegion`       | リージョン。省略すると、設定されている必要があるアカウントのメインリージョンが割り当てられます。                                  | [管理者センター](https://zoom.com/account) → CX管理 → コンタクトセンター → [環境設定](https://zoom.com/cci/index/admin#/admin-preferences) → 地域 → **地域を追加** → 名前を入力し、SIPゾーンを選択 → **追加**。詳細は [Zoomコンタクトセンターの地域を管理する](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0057668).                                        |
| `zoomContactCenterUserTemplate` | ユーザーテンプレート。名前は完全に一致している必要があります。追加タイプのテンプレートはユーザー作成時に適用され、更新タイプのテンプレートは更新時に適用されます。 | [管理者センター](https://zoom.com/account) → CX管理 → コンタクトセンター → ユーザー → [テンプレート](https://zoom.com/cci/index/admin#/admin-agents#templates) → **テンプレートを追加** → 選択 **追加** → ロール、パッケージ、キュー、スキルを設定 → **追加**。詳細は [Zoomコンタクトセンターのユーザー設定テンプレートを管理する](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0077757). |

{% hint style="danger" %}
**警告**

リージョンを作成する前に、コンタクトセンターのリージョン機能をZoomサポートが有効にする必要があります。また、各ユーザーは必ず1つのリージョンに属します。これはセルフサービスの切り替えではなくサポートリクエストであるため、複数リージョンへの導入を計画している場合は早めに申請してください。
{% endhint %}

**インボックス、キュー、スキルにはSCIM属性がありません。** これらをプロビジョニングするには、 [管理者センター](https://zoom.com/account) → CX管理 → コンタクトセンターで事前に作成し、ユーザーテンプレートに関連付けて、そのテンプレートを `zoomContactCenterUserTemplate`を通じて割り当てます。そのため、これらは個々のユーザーではなく、 *テンプレート* の前提条件となります。また、要件が変更された際に管理するオブジェクトをテンプレート1つに集約できます。

<table><thead><tr><th width="123.2821044921875">オブジェクト</th><th>作成方法</th></tr></thead><tbody><tr><td>キュー</td><td><a href="https://zoom.com/account">管理者センター</a> → CX管理 → コンタクトセンター → <a href="https://zoom.com/cci/index/admin#/admin-queues">キュー</a> → <strong>キューを追加</strong> → 名前、チャネル、エージェント → <strong>保存</strong>。詳細は <a href="https://support.zoom.com/hc/en/article?id=zm_kb&#x26;sysparm_article=KB0061959">Zoomコンタクトセンターのキューを管理する</a>.</td></tr><tr><td>スキル</td><td><a href="https://zoom.com/account">管理者センター</a> → CX管理 → コンタクトセンター → <a href="https://zoom.com/cci/index/admin#/admin-next/admin-skills">スキル</a> → カテゴリを選択 → <strong>スキルを追加</strong> → 名前 → <strong>追加</strong>。詳細は <a href="https://support.zoom.com/hc/en/article?id=zm_kb&#x26;sysparm_article=KB0059519">スキルとスキルカテゴリを管理する</a>.</td></tr><tr><td>受信トレイ</td><td><a href="https://zoom.com/account">管理者センター</a> → CX管理 → コンタクトセンター → <a href="https://zoom.com/cci/index/admin#/admin-next/admin-inbox">インボックス</a> → <strong>インボックスを追加</strong>。詳細は <a href="https://support.zoom.com/hc/en/article?id=zm_kb&#x26;sysparm_article=KB0059471">Zoomコンタクトセンターのインボックスを管理する</a>.</td></tr></tbody></table>

**テンプレートと個別の属性の両方が指定された場合は、個別の値が優先されます。** テンプレートを `zoomContactCenterRole` と一緒に送信すると、ロール属性がテンプレートのロール設定より優先されるため、参照されるロールとテンプレートの両方が存在する必要があります。

#### <mark style="color:青;">Zoom Revenue Accelerator</mark>

| 属性                                                                  | 事前に存在している必要があるもの                               | 作成方法                                                                                                                                                                                                                                                                                    |
| ------------------------------------------------------------------- | ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `zoomRevenueAcceleratorPlan` と `zoomRevenueAcceleratorSubscription` | オンラインの席がある、購入済みの ZRA プランまたはサブスクリプション。          | 事前に購入してください。アカウントプランと請求情報。                                                                                                                                                                                                                                                              |
| `zoomRevenueAcceleratorRole`                                        | スタンダードまたはカスタムのロール。例： `営業マネージャー` — 正確に同じ名前にします。 | [管理者センター](https://zoom.com/account) → ユーザー → [ロール](https://zoom.com/role#/) → **Revenue Accelerator** タブ → **+ ロールを追加** → 名前と説明 → **追加** → 権限を設定する → **変更を保存**。詳しくは [Zoom Revenue Accelerator のロール管理を使用する](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0059285). |
| `zoomRevenueAcceleratorSegment`                                     | ユーザーが属するセグメント。                                 | Revenue Accelerator の管理者設定。                                                                                                                                                                                                                                                             |
| `zoomRevenueAcceleratorRegion`                                      | 地域（例： `US`.                                    | Revenue Accelerator の管理者設定。                                                                                                                                                                                                                                                             |

#### <mark style="color:青;">Zoom Workplace のライセンスとアカウントのロール</mark>

上記の 3 つの製品に加えて、スタンダードユーザーレコードには、同じルールに従うロールとライセンスの参照が含まれています。

| 属性                                                                                                                                                        | 事前に存在している必要があるもの                                                         | 作成方法                                                                                                                                                                                                   |
| --------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `roles[]` (`value` / `表示`)                                                                                                                                | アカウントのロール。名前は正確に一致している必要があります。ロールは SCIM によって参照され、SCIM によって作成されることはありません。 | [管理者センター](https://zoom.com/account) → ユーザー → [ロール](https://zoom.com/role#/) → **ロールを追加** → 名前と説明 → 権限を設定。次を参照： [ロール管理の使用](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064983). |
| `zoomWorkplace` およびその他のライセンスまたはアドオンの属性：ホワイトボード、Scheduler、Clips Plus、翻訳版字幕、ワークフォース管理、品質管理、コンプライアンス管理、CX Insights、AI営業アシスト、およびそれらの `...Subscription` 対応するもの | 未使用の席とともに購入された、対応するバンドルまたはアドオン。                                          | プランと請求 → プラン管理 → プランを編集 → ライセンス数を増やします。詳細は [アカウントとアドオンのアップグレード](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063375).                                                           |
| `loginType` (`sso` / `workEmail`）、 `urn:us:zoom:scim:schemas:extension:1.0:ZoomUser`                                                                      | SSO がアカウントに設定されている、SSO ログインタイプ用の。                                        | [管理センター](https://zoom.com/account) → セキュリティと信頼 → [シングルサインオン（SSO）](https://zoom.com/account/sso/saml).                                                                                                  |

ライセンスまたはアドオン属性については、名前を付ける対象のオブジェクトはありませんが、前提条件は実質的に同じです。つまり、その特定のプールで利用可能なシートがない場合、割り当ては失敗します。

#### <mark style="color:青;">前提条件のない属性</mark>

「 **ベーシックマッピング: プロフィール情報** 」で説明したとおり、すべてのベーシックマッピング属性が該当します。Zoomはこれらの値をそのまま保存し、既存のオブジェクトと照合して検証することはありません。Zoom拡張機能の2つの属性も同様に動作します。

* **自動委任される値** — `zoomPhoneExtNumber` として送信されます `0`。この場合、Zoomが内線番号を割り当てます。
* **アカウントのカスタム属性** — `{customAttribute}` フィールド。送信した任意の文字列が格納されます。

**デフォルト値が設定された参照項目** は中間的なケースです。省略すると、 `zoomPhoneSite`, `zoomContactCenterRole`、または `zoomContactCenterRegion` それぞれメインサイト、デフォルトのエージェントロール、メインリージョンにフォールバックします。これらのデフォルト自体が存在している必要がありますが、通常は存在します。

**グループは一部例外です。** グループのプロビジョニングが有効になっている場合、SCIMはまだ存在しないZoomグループを作成し、ソースグループの名前を入力どおりに使用します。そのグループには製品設定を適用しません。メンバーだけが含まれ、それ以外は何も設定されていない状態で作成されます。Zoom Phoneのポリシー、通話権限、その他のグループレベルの設定は、グループの作成後も次の場所で設定する必要があります。 [管理センター](https://zoom.com/account) → ユーザー → [グループ](https://zoom.com/account/group#/) そのグループが表示された後。

{% hint style="info" %}
**推奨事項**

Zoom 側の構築は、属性マッピング作業が始まる前に完了・検証される、独自の承認を伴う前提フェーズとして扱ってください。サイト、番号、プラン、ロール、およびテンプレートは、ID プロバイダーの設定とは別のチームが所有していることが多く、プロビジョニングのテスト中に不足しているオブジェクトを見つけるコストは、事前に存在を確認するよりもかなり高くつきます。
{% endhint %}

### **ディレクトリデータを準備しています**

SCIM はソースに含まれているものをそのまま送信します。検証、正規化、修正は行いません。属性をマッピングする前に、対象となるソースについて次の 3 点を確認してください:

* **対象範囲内のすべてのユーザーについて値が入力されています。** 値が入力されていないフィールドは、何も送信しないか、設定済みのデフォルトを送信します。
* **値の形式と大文字・小文字の使い方が一貫しています。** 両方の ID プロバイダーで、比較ロジックは完全一致です。
* **その値はZoomが想定する値と完全に一致します。** Zoom は、サイト名、ロール名、プランの値をあいまい一致で照合しません。

既存のフィールドでは 3 つの条件すべてを満たせない場合、この連携のために意図的に値を設定した専用設計の属性を用意する方が、他のシステムも書き込むフィールドを流用するより持続可能です。

{% hint style="info" %}
**推奨事項**

ID プロバイダーの設定に手を付ける前に、正本を決めてください。失敗した SCIM の導入の多くは、プロビジョニングの問題として現れるディレクトリデータの問題です。
{% endhint %}

### **参照シナリオ**

このガイドでは4つのシナリオを通して使用します。IDプロバイダーにかかわらず、それらのビジネス要件とZoom側の前提条件は同一なので、ここで一度だけ定義します。各IDプロバイダー固有のセクションの最後では、そのプラットフォームで4つすべてを実装する方法を示します。

#### <mark style="color:青;">シナリオ 0: 部門、最初のベーシックなマッピングとして</mark>

ユーザーの部署は、ディレクトリをソースとして、Zoomプロフィールに表示されるはずです。これは、以前に最初のエンドツーエンドテストとして推奨されたベーシックなマッピングであり、手順を両方のアイデンティティプロバイダーのセクションで一通り実施できるよう、ここに含めています。

**Zoom側の前提条件。** ありません。Zoom は値を送信されたとおりに保存し、既存のオブジェクトと照合して検証することはありません。

**属性。** 親は以下の3つのシナリオとは異なる点に注意してください — `department` エンタープライズ拡張機能の配下にあり、Zoom拡張機能の配下にはありません。

| 属性                                                                      | タイプ | ノート                                                                               |
| ----------------------------------------------------------------------- | --- | --------------------------------------------------------------------------------- |
| `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department` | 文字列 | フリーテキスト。どちらの ID プロバイダーにも、すでにユーザープロファイルに `department` フィールドがあるため、新しいソース属性は必要ありません。 |

**まずここから始める理由。** Zoom プロフィールに部門の値が正しく表示されることを確認すれば、ライセンスや電話設定にリスクを与えることなく、スキーマ宣言、マッピング、スコープ、プロビジョニングログを読み取る能力を検証できます。以下の高度なシナリオは、属性の参照先だけが異なります。

**まず、すでにマッピングされているかどうかを確認してください。** デフォルトのマッピングは Entra ID と Okta で異なり、両社が Zoom 連携を更新するたびに変更されます。次の場所で既存の一覧を確認してください。 **プロビジョニング** → **マッピング** を Entra で、または **Zoom の属性マッピング** で「 **未マッピングの属性を表示** 」を Okta で有効にした状態で。もし `department` がすでにマッピングされている場合は、重複して宣言せずに確認してください。また、代わりに一から設定する属性が必要な場合は、 `costCenter`, `組織`、および `employeeNumber` 同じ親の下に配置され、同じように動作します。

#### <mark style="color:青;">シナリオ 1: Zoom Phone サイトと自動内線番号割り当て</mark>

ユーザーは、オフィスに基づいて適切な Zoom Phone サイトに配置され、管理者の介入なしに内線番号を受け取る必要があります。

**Zoom側の前提条件** サイトはあらかじめ作成しておく必要があります。次の場所で作成してください。 [**管理者センター**](https://zoom.com/account) → **製品設定** → **電話システム** → [**会社情報**](https://zoom.com/pbx/page/telephone/settings#/settings) → **サイトを追加**、または一括で **インポート**。緊急通話サービスをサポートするため、サイトの住所は実在住所データベースに照合して検証されます。そのため、架空の住所と郵便番号の組み合わせは検証に失敗します。

**属性。** どちらも名前空間を受け取ります `urn:ietf:params:scim:schemas:extension:zoom:1.0:User:` その後に名前が続きます。

| 属性                   | タイプ | ノート                       |
| -------------------- | --- | ------------------------- |
| `zoomPhoneSite`      | 文字列 | Zoomのサイト名と一字一句一致する必要があります |
| `zoomPhoneExtNumber` | 文字列 | `0` 自動割り当てをトリガーする         |

**値がこうなる理由 `0` 重要です。** すでに使用中の内線番号を把握しているのはZoomだけです。これには、ユーザーではなく通話キューや自動受付に割り当てられている内線番号も含まれます。割り当てをZoomに任せることで、プロビジョニング失敗の原因を一つ排除できます。ディレクトリから内線番号を取得する方法は、既存の内線番号を維持することが重要な移行時には適していますが、その場合もマッピングは次のように切り替える必要があります `0` 移行が完了すれば、今後参加するユーザーがディレクトリデータの継続的な保守に依存することはありません。

{% hint style="info" %}
**注**

Zoom Phone アカウントのデフォルトサイトの名前は、通常、正確に `メインサイト`、以下に表示されます [**管理者センター**](https://zoom.com/account) → **製品構成** → **電話システム** → [**会社情報**](https://zoom.com/pbx/page/telephone/settings#/settings)。特定のアカウントの名前は変更される可能性があるため、利用する前に確認してください。
{% endhint %}

#### <mark style="color:青;">シナリオ 2: 国ごとに異なる Zoom Phone 通話プラン</mark>

ある多国籍組織は、スタンドアロンの Zoom Phone 通話プランを購入しており、各ユーザーが自分の国に一致するプランを受け取る必要があります。

**Zoom 側の前提条件。** 通話プランは、アカウントで事前に購入され、利用可能になっている必要があります。プランの値については、次のドキュメントを参照してください。 [Zoom Phone の通話プランのリファレンス](https://developers.zoom.us/docs/api/references/phone-calling-plans/).

**属性。** `zoomPhoneCallingPlan` （文字列）。

**適切なプランコードの取得方法。** `zoomPhoneCallingPlan` プラン名ではなく、数値のプランコードを指定します。これを取得する最も確実な方法は、 [通話プランを一覧表示](https://developers.zoom.us/docs/api/references/phone-calling-plans/) 各プランの情報を返すAPI、 `name`、その `type` — マッピングするコード — とその `subscribed` および `オンライン` ライセンス数です。したがって、1回の呼び出しでプランの存在を確認し、送信する値を取得し、そのプランを割り当てる定員があることを検証できます。

Zoomウェブポータルには表示名のみが表示され、コードは表示されません。そのため、ポータルだけを使う管理者は、表示名を次の資料を使って対応するコードに変換する必要があります。 [Zoom Phoneの通話プランのリファレンス](https://developers.zoom.us/docs/api/references/phone-calling-plans/) —たとえば、 `UNLIMITED_PLAN_US_CA` は `200` 、 `UNLIMITED_PLAN_GB_IE` は `202`です。このリファレンスにはポータル上の表記ではなく定数名が記載されているため、完全に同じ文言かどうかではなく、地域や従量制か無制限かといったプランの特性で一致を確認してください。

別途、ZoomのSCIM2 APIリファレンスには、次のような請求プラン名が示されています `phone_calling_usca_monthly_unlimited` サンプルペイロード内の。この識別子は、 *購入* するためのものであり、ユーザーにプランを割り当てるためのものではありません。プランがどのサブスクリプションを利用するか指定する必要がある場合は、 `zoomPhoneCallingPlanSubscription`.

**なぜ `-1` がフォールバックとして使用されるのか。** SCIM2リファレンスでは、 `-1` をすべての通話プランを削除する値として定義しています。一致しないユーザーにこの値を使用すると、値をまったく送信しない場合の曖昧さを避け、「プランが割り当てられていない」という予測可能で明確な結果になります。また、ユーザーを削除せずに通話権限を解除する手段にもなります。

#### <mark style="color:青;">シナリオ 3: Zoom コンタクトセンターのパッケージ、ロール、地域</mark>

コンタクトセンターのエージェントは、後から手動で設定するのではなく、オンボーディング時点で適切な ZCC パッケージとロールが付与されるべきです。このシナリオは、この方法が製品に依存しないことを示しています — 手順自体は変わらず、変わるのは属性名と許可される値だけです。

| 属性                         | タイプ | 許可される値                                 |
| -------------------------- | --- | -------------------------------------- |
| `zoomContactCenterPackage` | 文字列 | `Essentials`, `Premium`, `Elite`       |
| `zoomContactCenterRole`    | 文字列 | 任意の ZCC ロール名。デフォルトは `Agent` 省略した場合です。  |
| `zoomContactCenterRegion`  | 文字列 | 設定済みの ZCC リージョン。省略した場合はメインリージョンが既定値です。 |

**属性を意図的に省略することについて。** 退出 `zoomContactCenterRegion` Zoom がドキュメントで定めているデフォルトがすでに適切な単一リージョン環境では、マッピングしません。デフォルト値が適切な属性は、マッピングするより省略する方が望ましいです。マッピングはすべて、保守の責任を伴います。

**運用上の注意。** SCIM2リファレンスには、次の内容も記載されています `zoomContactCenterUserTemplate`。これにより、あらかじめ用意されたZCCテンプレートが適用されます。追加タイプのテンプレートはユーザーの作成時に、更新タイプのテンプレートは更新時に適用されます。同じリクエストでテンプレートと個々の属性値の両方が指定されている場合は、個々の値が優先されます。ZCCの設定が複雑で、多数の個別属性マッピングを管理するのが煩雑になる場合は、テンプレートの利用を検討するとよいでしょう。

### **Zoom側の認証とよくあるエラー**

各IDプロバイダーにはそれぞれ独自のログがあり、各IDプロバイダーのステップ6で説明されています。以下のZoom側のログはどちらにも共通で、Zoomが実際に受け取った内容の決定的なレコーディングです。

#### <mark style="color:青;">Zoom App Marketplaceの通話ログには、リクエストとレスポンスのやり取り全体が表示されます</mark>

1. アカウントオーナーとしてZoomウェブポータルにサインインします。
2. に移動します [**Zoom App Marketplace**](https://marketplace.zoom.us/) → **管理** → **アカウント上のアプリ**.
3. ID プロバイダー接続を表すアプリケーションを選択します。Entra の場合、通常は次の名前が付けられています **Azure ID** などです。
4. 「 **通話ログ** 」タブを開きます。
5. 「 **エンドポイントで検索**」、または日付範囲、メソッド、ステータスの各フィルターを使用して、該当する通話を見つけます。
6. 行を選択して展開します。
7. requestBody `requestBody` を確認すると送信内容を正確に把握でき、 `response` を確認すると、生成されたZoomユーザーIDを含め、Zoomから返された内容を正確に把握できます。 `httpStatus`と、結果として得られた属性セットも確認できます。

Zoom は最新の 100 件の API リクエストログを保持するため、追加のプロビジョニング作業で上書きされてしまう前に、失敗をすぐに調査してください。

#### <mark style="color:青;">一般的なプロビジョニングエラーとその原因</mark>

<table><thead><tr><th width="99.69622802734375">コード</th><th>メッセージ</th><th>原因と解決策</th></tr></thead><tbody><tr><td>400</td><td>アカウントではシングルサインオン（SSO）が有効になっていません。</td><td>SSOはSCIMの前提条件です。まずZoomアカウントでSSOを有効にして設定してください。</td></tr><tr><td>400</td><td>ユーザーは非アクティブであるか、ロックされています。</td><td>対象のZoomユーザーは現在の状態では更新できません。Zoomウェブポータルでアカウントの状態を解決してください。</td></tr><tr><td>403</td><td>権限が不足しているため、リクエストは拒否されました: "ユーザー:Edit"。</td><td>SCIM接続の認証情報には必要なスコープがありません。オーナーまたは管理者アカウントで接続を再認証してください。</td></tr><tr><td>404</td><td>ユーザーは存在しません。</td><td>IDプロバイダーは、ユーザーを既存のZoomユーザーに関連付けませんでした。一致属性とユーザー名の形式を確認してください。</td></tr><tr><td>409</td><td>メールドメインがアカウントの関連ドメインと一致しません。</td><td>ユーザーのメールドメインはZoomアカウントに関連付けられていません。プロビジョニングの前にドメインを関連付けて確認してください。</td></tr><tr><td>409</td><td>有料ユーザーを追加できません。</td><td>要求された種類のライセンスはありません。アカウントの空き定員を確認するか、ユーザーをベーシックとしてプロビジョニングしてください。</td></tr><tr><td>409</td><td>[bundle name] でこれ以上ユーザーを作成できません。</td><td>特定のバンドルに残りの定員がありません。Workplace ビジネスプラス、エンタープライズ プレミア、プロプラス、および教育機関向けの同等プランに適用されます。</td></tr><tr><td>429</td><td>リクエストが多すぎます。</td><td>プロビジョニングが Zoom のレート制限を超えました。サイクルをまたいで継続する場合は調査してください。</td></tr></tbody></table>

#### <mark style="color:青;">ある障害モードでは、まったくエラーが発生しません</mark>

Zoom が受け入れるものの、何にも対応しない値 — 末尾にスペースがあるサイト名や、Zoom で名称変更されたロール名など — は、構文上は受け入れられても何にも適用されない場合があります。この発生を示すログエントリはありません。同じ問題のプラットフォーム固有のバリエーションについては、ステップ 6 を参照してください。

{% hint style="info" %}
**注**

Zoom と ID プロバイダーがユーザーの設定について食い違う場合は、ID プロバイダーを正とみなし、そちらの値を修正してください。Zoomウェブポータルで直接編集すると、次のプロビジョニング イベントで上書きされる状態になり、根本的な問題の診断が難しくなります。
{% endhint %}

## **Entra ID を使用した SCIM の設定**

#### <mark style="color:青;">Entra ID の追加要件</mark>

* Entra ID の管理者権限とエンタープライズ アプリケーションへのアクセス
* Entra ID テナントでカスタム ドメインとして検証済みの、ユーザーが使用するメール ドメイン

#### <mark style="color:青;">Entra ID の追加の制限</mark>

* 属性マッピングのソースはEntra *ユーザーオブジェクト* の属性に限られます。セキュリティグループからZoom属性に値を直接割り当てることはできません。グループメンバーシップはスコープを制御しますが、値は制御しません。
* 増分プロビジョニング サイクルは約 40 分ごとに実行されます。プロビジョニングを有効にしても、変更は即時には反映されません。
* userType の `Collaboration` 値 `userType` は、Microsoft固有の制限によりEntra IDではサポートされていません。

{% hint style="info" %}
**注**

標準的なプロビジョニング設定は、 `entra.microsoft.com` または `portal.azure.com`から行えます。ただし、手順1で使用するスキーマエディターには、Azure PortalのURLに `forceSchemaEditorEnabled` パラメーターを追加した場合にのみアクセスできます。このフラグは `entra.microsoft.com`には影響しません。このパートのすべての手順では、ポータルを途中で切り替えずに済むよう、手順1のAzure Portalリンクを使用してください。
{% endhint %}

### 手順1: Zoom アプリケーション スキーマで属性を宣言します

属性の宣言は、属性ごとに1回だけ行う操作です。マッピングを構成する前に、使用する予定のすべての属性を宣言しておくことで、手順2ですべてのターゲットを利用できるようになります。

1. スキーマエディターのURLを使用してAzure Portalにサインインします。 `https://portal.azure.com/?Microsoft_AAD_Connect_Provisioning_forceSchemaEditorEnabled=true#home`
2. 「 **Azureサービス**」で、 **Microsoft Entra ID**.
3. 左側のナビゲーションメニューの「 **管理**」で、 **エンタープライズアプリケーション**.
4. アプリケーションの一覧で、Zoomアプリケーションをクリックします。\
   **注**：アプリケーション名は、アプリケーションの作成時にEntra管理者が定義します。多くの場合、 **Zoom** または **Zoom SSO**という名前ですが、テナントによって異なる場合があります。
5. 左側のナビゲーションメニューの「 **管理**」で、クリックします **プロビジョニング**.\
   **注**：現在、Azure には2種類のレイアウトがあります。従来のエクスペリエンスでは、 **属性マッピングの編集** の下にある **プロビジョニングの管理**。新しいエクスペリエンスでは、ページを開くと **概要** タブが表示されます。左側のメニューからもう一度 **プロビジョニング** を選択してください。どちらの方法でも同じ画面に移動します。
6. クリックします **マッピング** ドロップダウンをクリックし、次に **Microsoft Entra ID ユーザーをプロビジョニング**.\
   **注**：レガシーな名前が引き続き表示されるテナントでは、このオプションは次のように表示されます **Azure Active Directory ユーザーをプロビジョニングする**.
7. 左下隅で、次を選択します **詳細オプションを表示** チェックボックス。
8. クリック **Zoom の属性リストを編集する**.
9. 最初の空行までスクロールし、次を入力してください：
   * **名前**：属性文字列全体を入力します。例： `urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomPhoneSite`
   * **種類**：選択 **文字列** または **ブール値**SCIM2 APIリファレンスに記載されているデータ型と一致する必要があります。
10. 追加の各属性についてステップ 9 を繰り返します。
11. 左上隅で、 **保存**.

{% hint style="warning" %}
**ご注意**

属性名では大文字と小文字が区別され、APIリファレンスの表記と完全に一致している必要があります。 `zoomPhoneSite` は有効です。 `zoomphonesite` と `ZoomPhoneSite` は無効です。大文字と小文字の表記が誤った属性は、スキーマエディターではエラーなく受け付けられますが、Zoom APIではエラーが表示されずに失敗します。

次のように記載されている属性では、 `boolean`, **文字列** マッピング元にリテラルテキストが指定されていれば、こちらも有効です。 `true` または `false`を選択するのは **文字列** マッピング元がテキストを格納する Entra 拡張属性の場合、こちらを選択するほうが実用的なことがよくあります。
{% endhint %}

### ステップ 2: ディレクトリ ソースを属性にマップする

Entra ID には 3 種類のマッピング タイプがあり、その選択は設定において最も重要な決定です。

<table><thead><tr><th width="133.376708984375">マッピングの種類</th><th>次のような場合に使用</th><th>動作</th></tr></thead><tbody><tr><td><strong>直接</strong></td><td>Entra のフィールドに、Zoom が期待する正確な値がすでに格納されています。</td><td>ソース値を変更せずにそのまま渡します。</td></tr><tr><td><strong>定数</strong></td><td>対象範囲内のすべてのユーザーに同じ値を割り当てる必要があります。</td><td>プロビジョニングされたすべてのユーザーに固定値を送信します。</td></tr><tr><td><strong>式</strong></td><td>値はユーザー属性によって導出、変換、または変更される必要があります。</td><td>ソース フィールドに対して式を評価し、その結果を送信します。</td></tr></tbody></table>

**マッピングを作成するには：**

1. に戻る **プロビジョニング** → **マッピング** → **Microsoft Entra ID ユーザーをプロビジョニングする**.
2. 左下隅にある **新しいマッピングを追加**.
3. 選択した種類に従ってマッピングを設定する — 下のガイダンスを参照してください。
4. クリックします **ターゲット属性** ドロップダウンから、ステップ 1 で宣言した属性を選択します。
5. クリックします **この属性を使用してオブジェクトを照合** ドロップダウンと選択 **いいえ**.\
   **注記**：カスタムZoom属性は構成値であり、ID照合キーではありません。EntraユーザーとZoomユーザーを対応付ける属性（通常は `ユーザー名` — に設定する必要があります **はい**.
6. クリックします **このマッピングを適用** ドロップダウンと選択 **常時**。そのため、この値は作成時とその後の更新時の両方に適用されます。
7. クリック **OK**.
8. 属性ごとに繰り返し、次にクリックします **保存** の上部にある **属性マッピング** ページ。

#### <mark style="color:青;">直接マッピングは、既存のフィールドを変換せずにそのまま渡します</mark>

* **マッピングの種類**: **直接**
* **ソース属性**：値がZoomの期待する値と完全に一致するEntraフィールド
* **nullの場合のデフォルト値（オプション）**：ソースフィールドが空の場合に適用されるフォールバック値

直接マッピングは最も壊れにくい方法です。ディレクトリデータが対応している場合は、常にこれを優先してください。 `physicalDeliveryOfficeName` —「 **オフィスの場所」として表示される** Entra ユーザープロフィールに、Zoom Phone のサイト名と完全に一致する値がすでに含まれている場合は、直接マッピングするだけで済み、ロジックはまったく必要ありません。

{% hint style="info" icon="lightbulb" %}
**ヒント**

入力する **null の場合のデフォルト値** ソース値が欠落すると失敗や意図しない結果が生じる場合は常に。「デフォルト」が `メインサイト` サイトマッピングを設定しておくと、オフィスの位置情報がないユーザーも未定義の状態になることなく、正常にプロビジョニングされます。
{% endhint %}

#### <mark style="color:青;">定数マッピングは、対象範囲内の全ユーザーに 1 つの値を適用します</mark>

* **マッピングの種類**: **定数**
* **定数値**：送信する固定値

固定マッピングは、単一構成のデプロイに適しており、Zoom固有のいくつかの動作を実現する仕組みでもあります。設定を `zoomPhoneExtNumber` 固定値の `0` にすると、Zoomはユーザーのサイト内で次に利用可能な内線番号を割り当て、内線番号の重複を完全に防ぎます。

#### <mark style="color:青;">式マッピングは、プロビジョニング時に値を変換または導出します</mark>

* **マッピングの種類**: **式**
* **式**：1つ以上のソース属性を評価する、ネストされた `IIF()` ステートメント

ディレクトリの値と Zoom の値が同一の文字列でない場合は、式マッピングが必要です:

```
IIF([officeLocation]="ロンドン","LON-01",
IIF([officeLocation]="マンチェスター","MAN-01",
"メイン サイト"))
```

{% hint style="danger" %}
**警告**

式では、入力されたとおりのテキストが大文字と小文字も含めて完全一致で比較されます。 `GB` と `gb` は異なる値であり、 `United Kingdom` と `united kingdom`も同様です。比較に失敗してもエラーは発生せず、デフォルトの分岐に進みます。その結果、ユーザーは誤った構成で、気づかれないままプロビジョニングされます。
{% endhint %}

ソース値を `ToUpper()` で囲み、大文字のリテラルと比較して、大文字と小文字の不一致を解消します。

```
IIF(ToUpper([country])="GB","202",
IIF(ToUpper([country])="UNITED KINGDOM","202",
"-1"))
```

#### <mark style="color:青;">ソース フィールドの形式は、Entra ユーザーがどのように作成されたかによって変わります</mark>

これは、見た目は正しく見えるのに、対象全体で一貫性のない動作をする式マッピングの最も一般的な原因です。

* **使用場所** は、ライセンスと機能の利用可否を左右するため、Microsoftによって、 `GB`のような有効なISO 3166-1 alpha-2コードを常に含むよう強制されています。このフィールドは信頼できます。
* **国または地域** にはそのような制約がなく、値は作成方法によって異なります。Entra管理ポータルのGUIで作成されたユーザーは、国名の一覧から選択するため、このフィールドには通常 `United Kingdom`が保存されます。CSVインポートまたはPowerShellで作成されたユーザーには、通常 `GB` が設定されます。これは慣例によるもので、強制されているわけではありません。

複数の方法でユーザーが作成されているテナントでは、 `country` の形式は一貫しません。式を作成する前にフィールドの形式を統一するか、上記のように両方の形式を明示的に確認してください。

### ステップ 3: ユーザーとグループをプロビジョニング範囲に含める

割り当ては、どのユーザーに設定が適用されるかを決定します。アプリケーションの割り当て範囲外のユーザーは、どのマッピングからも影響を受けないため、ロールアウト中の主な安全管理は割り当てです。

1. 次の順に移動します。 **Microsoft Entra ID** → **エンタープライズ アプリケーション** → Zoomアプリケーション → **ユーザーとグループ**.
2. 「 **ユーザー/グループの追加**.
3. 「 **ユーザーとグループ**」で、対象のユーザーまたはセキュリティグループを選択します。
4. 「 **ロールの選択**」で、適切なロールを選択します。
5. 「 **割り当て**.

実際に重要なのは、2つのロール値だけです。次のようなほかのオプションは **Corp** および **プロ** 廃止が進められている旧名称か、まれなシナリオ向けのものです。

<table><thead><tr><th width="157.5225830078125">ロール</th><th>影響</th></tr></thead><tbody><tr><td><strong>ベーシック</strong></td><td>有料のミーティングライセンスなしでユーザーをプロビジョニングします。カスタム属性 — たとえば Zoom Phone の通話プラン — が有料の権利付与の割り当てを担っている場合は、これを選択してください。</td></tr><tr><td><strong>ライセンスユーザー</strong></td><td>Zoomアカウントの <em>デフォルト</em> ライセンスプラン（例: Zoom Workplace エンタープライズ Plus）を割り当てます。この画面では特定のバンドルを選択できません。デフォルトはZoom側で設定されています。</td></tr></tbody></table>

このロールの選択は、アプリケーションに追加されたユーザーまたはグループごとに 1 回適用されます。プロビジョニングされるカスタム属性がいくつあっても変わりません。

**EntraグループをZoomグループとしてプロビジョニングするには**（デフォルトでは無効）:

1. 次に移動します。 **プロビジョニング** → **マッピング** を選択し、 **Microsoft Entra ID グループのプロビジョニング**.
2. 切り替えを **有効** に **はい**.
3. デフォルトのマッピングが設定されていることを確認します: `displayName` → `displayName`および `members` → `members`.
4. クリックします **「保存」**.
5. に戻り、 **ユーザーとグループ** グループ自体がアプリケーションに割り当てられていることを確認します。個々のメンバーだけが割り当てられている状態では不十分です。グループのプロビジョニングで処理されるのは、直接割り当てられたグループのみです。

{% hint style="warning" %}
**注意: SCIM がグループに対して行うこと、行わないこと**

一致する名前のZoomグループがまだ存在しない場合、SCIMはEntraグループの `displayName` を入力どおりに使用してグループを作成します。グループはメンバーを含めて作成されますが、 **製品の設定は適用されません**。管理者は引き続きZoomウェブポータルの [**管理センター**](https://zoom.com/account) → **ユーザー** → [**グループ**](https://zoom.com/account/group#/) を開き、グループレベルのZoom Phoneポリシー、通話権限、その他の製品設定など、意図した設定を適用する必要があります。SCIMがプロビジョニングするのはグループの存在とメンバーシップです。Zoom内でそのグループがどのような役割を果たすかは定義しません。
{% endhint %}

### ステップ 4: オンデマンド プロビジョニングで検証する

**オンデマンドプロビジョニング** は **プロビジョニングのステータス** 切り替えとは独立して実行されるため、検証に適したツールです。ここまでのすべての手順（この手順を含む）は、プロビジョニングをオフにしたまま実行できます。

1. 次に移動します。 **プロビジョニング** → **プロビジョニングの概要**.
2. クリックします。 **オンデマンドプロビジョニング**.
3. テストユーザーを1人検索して選択し、 **プロビジョニング**.
4. 結果を確認します。Entra では、各プロビジョニング イベントで実行される次の4つのステージが報告されます — **インポート**, **対象範囲内かどうかの判定**, **照合**、および **プロビジョニング** — それぞれ個別に展開できます。
5. 表示されている属性値が意図どおりであることを確認します。
6. Zoomウェブポータルにサインインし、設定が適用されたことを確認します。

{% hint style="info" %}
**推奨事項**

母集団の中で最も *難しい* ケースを代表するユーザーで検証します。たとえば、海外のユーザー、別の方法で作成されたユーザー、またはソース フィールドが空のユーザーです。単純なケースだけを対象にしたテストでは、ステップ 2 で説明した失敗パターンは明らかになりません。
{% endhint %}

### 手順 5: 継続的なプロビジョニングを有効にする

プロビジョニングを有効にすると、構成は対象範囲内のすべてのユーザーに対して本番環境で有効になります。まず手順 1 から 4 を完了して確認してください。

1. 移動先： **Microsoft Entra ID** → **エンタープライズ アプリケーション** → Zoom アプリケーション → **プロビジョニング** → **プロビジョニング**.
2. 切り替える **プロビジョニングの状態** を **オン**.
3. クリックします **「保存」**.

最初のサイクルには最大で約 40 分かかる場合があります。以降の増分サイクルは、およそ 40 分間隔で実行されます。新規参加ユーザー、属性の変更、無効化は、すぐには反映されず、そのスケジュールに従って同期されます。

### 手順 6: Entra プロビジョニング ログを使用して確認する

1. 次の場所に移動します **Microsoft Entra ID** → **エンタープライズ アプリケーション** → Zoom アプリケーション → **監視** → **プロビジョニング ログ**.
2. テストユーザーを検索またはフィルターし、該当するイベントを選択します。詳細ビューが開き、次の4つのタブが表示されます。 **手順**, **トラブルシューティングと推奨事項**, **変更されたプロパティ**、および **概要**.
3. 確認します **概要** を確認して、操作が成功したか失敗したかを判断します。
4. 失敗した場合は、 **トラブルシューティングと推奨事項**を開きます。ここには、試行された操作、影響を受けたユーザー プリンシパル名、および「 **詳細** — ZoomのAPIが返すエラーコードとエラーメッセージ全文。

マッピングによって生成されるはずだった値ではなく、送信されたリテラル値が表示されるため、マッピング画面を確認するよりも信頼性が高くなります。Entra のログから判断できない場合は、Zoom App Marketplace の通話ログに移ります。通話ログについては、以下で説明しています。 **Zoom側の認証とよくあるエラー**。生のリクエストとレスポンスのやり取りを表示します。

#### <mark style="color:青;">Entra ID におけるオンボーディングとオフボーディングの動作</mark>

* スコープは主要な安全制御です。アプリケーションの割り当てスコープ外のユーザーは、この構成内のどのマッピングによっても変更されることはありません。
* Entra でユーザーを無効化するか、スコープから削除すると、プロビジョニングは自動的に元に戻り、オフボーディングの流れが完了します。
* 各失敗は対応するログエントリを生成します — ただし、前述のサイレント失敗に関する注意点があります。

### ステップ 7: Entra ID で参照シナリオを適用する

シナリオ、前提条件、属性の定義は、次の場所にあります。 [**参照シナリオ**](#reference-scenarios) セクション。ここでは Entra のマッピングのみを示します。

**シナリオ 0 — 部門。** ステップ 1 で宣言する `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department` として **文字列**。Zoom Oneではなく、エンタープライズの名前空間を使用するよう注意してください。次のようにマッピングします。 **直接** Entraの `department` フィールドから。 **nullの場合のデフォルト値** は不要です。ソースフィールドが空の場合は何も送信されず、Zoom側にオブジェクトを用意する必要もありません。

**シナリオ1 — Zoom Phoneのサイトと自動内線番号。** マッピング： `zoomPhoneSite` の方式： **直接** 、ソース： `physicalDeliveryOfficeName`、 **null の場合のデフォルト値** の設定値： `Main サイト`。マップ `zoomPhoneExtNumber` の方式： **定数** 次の値を持つ `0` 既存の内線番号構成を移行する場合を除きます。オフィスの位置情報の値がZoomサイト名と完全に一致しない場合は、次の値に置き換えてください。 **式** ステップ2に示す形式のマッピング。

**シナリオ2 — 国によって通話プランが異なる場合。** Entraではグループから値を取得できないため、式が必要です。追加の `IIF()` 国ごとのレイヤーを用意し、ステップ 2 で説明したアルファ 2 形式とフルテキスト形式の両方に対応します。

```
IIF(ToUpper([country])="GB","202",
IIF(ToUpper([country])="UNITED KINGDOM","202",
IIF(ToUpper([country])="US","200",
IIF(ToUpper([country])="UNITED STATES","200",
"-1"))))
```

通話プラン属性で有料の権利が割り当てられる場合は、 **ベーシック** ではなく **ライセンスユーザー** をステップ 3 で選択します。 **ライセンスユーザー** を選択すると、アカウントのデフォルトのライセンスも追加で適用されるため、意図した商取引上の結果にならない可能性があります。

**シナリオ 3 — コンタクトセンターのパッケージ、ロール、地域。** マッピング `zoomContactCenterPackage` を使用する **式** エージェントの階層を区別するディレクトリフィールドで制御し、 `zoomContactCenterRole` として **直接** ロール名を格納するフィールドから取得します。 `zoomContactCenterRegion` 単一リージョンのデプロイではマッピングしないでください。

## **Okta で SCIM を構成する**

#### <mark style="color:青;">Okta の追加要件</mark>

* Profile Editor にアクセスする権限を持つ Okta 管理者権限

#### <mark style="color:青;">Okta の追加制限</mark>

* ユーザーが同じ属性に対して矛盾する値を提供する複数のグループに属している場合、送信されるのは最優先グループの値のみです。手順 5 を参照してください。

{% hint style="warning" %}
**注意: 2 つのプロファイル、2 つの目的**

Oktaには、ここで重要となる2つの異なるプロファイルがあり、その違いを理解しておくと、導入時の混乱の大半を防げます。 **Oktaユーザープロファイル** は値が *保存される場所であり、* ディレクトリ内のユーザーに関連付けられます。 **Zoomユーザーアプリケーションのプロファイル** は値が *送信される* 先はZoomで、その属性にはSCIMの外部名と名前空間が含まれます。ユーザー単位の設定にはその両方と、それらをつなぐマッピングが必要です。グループレベルの設定ではアプリケーションプロファイル属性のみが必要で、値はグループの割り当てに設定します。
{% endhint %}

### 手順 1: Zoom アプリケーションのユーザープロファイルに属性を宣言する

これは、実際に Zoom に値を送信する属性です。これを宣言するのは、属性ごとに 1 回だけの操作です。

1. Okta 管理コンソールにサインインします。
2. 左側のナビゲーションメニューで **アプリケーション**をクリックし、次に **アプリケーション**.
3. ［ **ステータス**］をクリックします **アクティブ**.
4. ［ **Zoom** アプリケーション］をクリックします。\
   **注**：アプリケーション名は、アプリケーションの作成時に Okta 管理者が設定します。通常は「Zoom」という名前ですが、テナントによって異なる場合があります。 **Zoom**。
5. 次をクリックします。 **プロビジョニング** タブ。
6. 「 **Zoom 属性マッピング**」で、 **「プロファイルエディターに移動」をクリックします**.
7. 「 **属性**」で、クリックします **+ 属性を追加**.
8. 次の項目を入力してください:
   * **データ型**：選択 **文字列** または **ブール値**。SCIM2 API リファレンスに準拠します。
   * **表示名**：属性名を入力します。例： `zoomPhoneSite`.
   * **変数名**：同じ名前を入力してください。
   * **外部名**：Zoomのドキュメントに記載されている属性名を正確に入力します。例： `zoomPhoneSite`.
   * **外部名前空間**： 入力 `urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomPhoneSite`
   * **説明** （オプション）：属性が存在する理由と、その値の取得元を記録します。
   * **属性タイプ**：選択 **個人** ユーザーごとの値の場合、または **グループ** グループメンバーシップを通じて継承される値の場合。
9. クリック **保存**、または **保存してもう1件追加**.

{% hint style="danger" %}
**警告**

External name と External namespace の両方が正しい必要があります。Zoom が公開しているガイダンスでは、External namespace は完全な URN として指定されています。 *含む* 属性名 — たとえば `urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomRevenueAcceleratorRole` — 名前空間だけではありません。これは一般的な SCIM の慣例とは異なります。Zoom が動作すると説明している設定を反映しているため、上記の形式に従ってください。

属性名は全体を通して大文字小文字を区別します。大文字小文字が誤っている属性は Profile Editor でエラーなく受け入れられ、Zoom API では静かに失敗します。
{% endhint %}

### ステップ 2: Okta ユーザープロファイルにソース属性を作成します

値がユーザーごとに保持される場合は、この手順を完了してください。すべてのユーザーで値が同じ場合、または代わりにグループレベルで提供される場合は、これをスキップしてください。

1. 左側のナビゲーションメニューで、次をクリックします **ディレクトリ**してから、クリックします **プロフィールエディター**.
2. クリックします **ユーザー** タブ。
3. \[ **ユーザー** ] ボックスで、 **フィルター**をクリックします。 **すべて**.
4. の右側 **Okta**をクリックし、 **ユーザー** プロフィール。
5. 「 **属性**」で、クリックします **+ 属性を追加**.
6. 次の項目を入力してください:
   * **データ型**：手順 1 で宣言した Zoom 属性と一致させます。
   * **表示名** および **変数名**：名前を入力します。例： `zoomPhoneSite`.
   * **列挙型** （オプション）：選択 **値の列挙リストを定義します** Zoom属性が固定された値のセットのみを受け入れる場合。
   * **属性は必須** （オプション）：選択 **はい** 対象範囲内のすべてのユーザーが値を持つ必要がある場合。
7. クリックします **「保存」**.

{% hint style="info" icon="lightbulb" %}
**ヒント**

Okta のユーザープロファイル属性と Zoom アプリケーションプロファイル属性には、同じ名前を使用してください。Okta ではこれを必須としていませんが、名前を一致させるとマッピング一覧が自己文書化され、属性数が増えるにつれてトラブルシューティング時間を大幅に短縮できます。
{% endhint %}

次を使用します。 **列挙型** オプションを使用します。Zoomが固定の値セットを規定している場合は、コンタクトセンターのパッケージ、Workplaceのバンドルコード、Revenue Acceleratorのプラン値など、いずれの場合も同様です。入力時にフィールドの値を制限することで、タイプミスによるプロビジョニングの失敗が気づかれず、数週間後に権限の欠落として発覚する事態を防げます。

### ステップ3: ソース属性をZoom属性にマップします

1. 次の順に移動します： **アプリケーション** → **アプリケーション** → **アクティブ** → **Zoom** アプリケーション。
2. 次をクリックします。 **プロビジョニング** タブ。
3. 「 **Zoom属性マッピング**」で、ステップ1で定義した属性を探し、その右側にある編集アイコンをクリックします。\
   **注**：属性が表示されていない場合は、次をクリックします： **マッピングされていない属性を表示**.
4. 「 **属性値** 」ドロップダウンをクリックし、次を選択します： **Oktaプロファイルからマッピング**.
5. ソースのドロップダウン（デフォルトでは `login | string` と表示されます）をクリックし、ステップ2で作成したOktaユーザープロファイル属性を選択します。
6. 次を選択します： **作成と更新**.\
   **注**: **作成のみ** 」は、Zoomユーザーが最初にプロビジョニングされたときにのみ値を適用し、それ以降は適用しません。初回の割り当て後に上書きすべきでない値に限り、意図的に選択してください。それ以外の場合は、ディレクトリの変更が反映されるように、次を選択します： **作成と更新** 。
7. クリックします **「保存」**.
8. 各属性について繰り返します。

{% hint style="warning" %}
**注意: 値の導出または変換**

Oktaの値とZoomの値の文字列が異なる場合、「 **属性値** 」フィールドには、条件ロジックや文字列関数をサポートするOkta Expression Languageも入力できます。式の構文と使用可能な関数はOktaのリリースによって異なります。式を広く適用する前に、 **プレビュー** を使用して1人のテストユーザーで検証し、サポートされている関数についてはOktaの最新のExpression Languageドキュメントを参照してください。

変換が単純で値セットが小さい場合、Zoom の値を Okta 属性上で列挙リストとして直接定義するか、Step 5 のようにグループ レベルの属性を使用する方が、通常は式よりも保守しやすくなります。
{% endhint %}

### 手順 4: アプリケーションへのプロビジョニングを有効にする

属性マッピングは、対応するプロビジョニング操作が有効になるまで影響しません。手順5で値を割り当てる前に、それらを有効にしてください。

1. 次の順に移動します： **アプリケーション** → **アプリケーション** → **アクティブ** → **Zoom** アプリケーション。
2. 次をクリックします。 **プロビジョニング** タブ。
3. 「 **アプリへのプロビジョニング**」で、次をクリックします： **編集**.
4. 以下の設定を有効にしてから、次をクリックします： **保存**.

| 設定            | 影響                                                                                                     |
| ------------- | ------------------------------------------------------------------------------------------------------ |
| **ユーザーを作成**   | アプリケーションがOktaのユーザーに割り当てられると、Zoomでユーザーを作成するか、リンクします。                                                    |
| **ユーザー属性の更新** | アプリケーションが割り当てられると、Zoom内のユーザーの属性が更新されます。以降のOktaユーザープロファイルの変更は、Zoom内の対応する値を自動的に上書きします。                   |
| **ユーザーを無効化**  | Oktaでアプリケーションの割り当てが解除されたとき、またはOktaアカウントが無効化されたときに、Zoomアカウントを無効化します。アプリケーションを再度割り当てることで、アカウントを再有効化できます。 |

{% hint style="danger" %}
**警告**

**ユーザー属性の更新** 」を有効にすると、既存のユーザーにカスタム属性マッピングが適用されます。これを有効にしない場合、マッピングはユーザーの作成時にのみ適用され、その後のOktaでの変更はZoomに反映されません。
{% endhint %}

### ステップ 5: ユーザーまたはグループに値を割り当てる

**個々のユーザーに値を割り当てるには:**

1. 次の順に移動します： **ディレクトリ** → **ユーザー** 。次にユーザーの名前をクリックします。
2. 「 **プロファイル** 」タブをクリックし、次をクリックします： **編集**.
3. ステップ 2 で作成した属性に、Zoom が期待する値を入力します。
4. クリックします **「保存」**.

値はすぐに送信されます。同じ変更をより広範囲に適用する前に、Zoomウェブポータルで結果を確認してください。

**グループに値を割り当てるには** — 組織構造に沿って設定を行う、よりスケーラブルなパターンです。

1. 属性がステップ 1 で次の設定で宣言されていることを確認します。 **属性タイプ: グループ**。次のように宣言されている場合は **個人**、ステップ 1 を繰り返してグループレベルの同等の属性を宣言します。対象は **Zoom ユーザー** のプロファイルです。次の場所に移動します。 **ディレクトリ** → **プロファイルエディター** → **ユーザー** → **すべて**を選択し、 **グループ** を属性タイプとして選択します。
2. 次の場所に移動します。 **ディレクトリ** → **グループ** → **すべて** タブを選択し、次にクリックします。 **グループを追加**.
3. 「 **名前** 」と、オプションの「 **説明**」を入力し、次にクリックします。 **保存**.
4. グループを開き、 **アプリケーション** タブをクリックします。
5. クリックします。 **アプリケーションを割り当て**をクリックし、次に **割り当てる** を **Zoom** アプリケーションの右側でクリックします。
6. グループレベルの属性に、各メンバーに適用する値を入力します。
7. クリックします。 **保存して戻る**をクリックし、次に **完了**.
8. グループの **ユーザー** タブをクリックし、次に **ユーザーを割り当て**.
9. ユーザーを名、主メールアドレス、またはユーザー名で検索し、各項目の横にある追加ボタンをクリックします。
10. クリックします。 **完了**.

メンバーはグループの属性値を自動的に継承します。後から追加されたユーザーは参加時にそれらを継承するため、このパターンは一度きりの移行作業ではなく、継続的なオンボーディングに適しています。

#### <mark style="color:青;">ユーザーが複数のグループに属している場合、グループの優先順位が競合する値を解決します</mark>

ユーザーが同じ属性に値を提供する複数のグループのメンバーである場合、Okta は最も優先順位の高いグループの値を送信します。

1. 次の順に移動します： **アプリケーション** → **アプリケーション** → **アクティブ** → **Zoom** アプリケーション。
2. クリックします **課題** タブ。
3. 「 **フィルター**」の下にある「 **グループ**.
4. グループを目的の順序にドラッグ＆ドロップしてください。

{% hint style="info" %}
**推奨事項**

グループは、最も具体的なものから最も一般的なものへ並べてください。そうすることで、範囲の狭いグループ—特定のサイトまたはロール—が、広範な包括的グループより優先されます。この順序を逆にすると、一般的なグループがすべての具体的なグループを上書きしてしまい、通常は全体の集団に同じ意図しない設定が適用される形で現れます。
{% endhint %}

### ステップ 6: Okta システムログを使用して確認する

1. 移動先： **レポート** → **システムログ**.
2. 対象ユーザーまたはZoomアプリケーションでフィルターし、プロビジョニングの試行に時間範囲を絞り込みます。
3. 関連するイベントを開き、詳細を確認してください。詳細には、結果と下流のアプリケーションから返されたエラーが含まれます。

未解決のプロビジョニング失敗は、Zoom アプリケーションの **プロビジョニング** タブ。Okta のログでは判断できない場合は、次に説明する Zoom App Marketplace の通話ログに移動します **Zoom側の認証とよくあるエラー**。これにより、リクエストとレスポンスのやり取りを生のまま確認できます。

{% hint style="warning" %}
**注意: Okta固有のサイレント失敗**

Zoomユーザープロフィールで宣言されているものの、一度もマッピングされていない、またはマッピング先がない属性 **ユーザー属性を更新** ステップ 4 で有効にしても、マッピング一覧には表示されたままですが、何も送信されません。エラーも発生しません。値が Zoom に届かず、システムログにも対応するイベントがまったく記録されていない場合は、さらに調査する前に、マッピングとプロビジョニング設定を確認してください。
{% endhint %}

#### <mark style="color:青;">Oktaでのオンボーディングとオフボーディングの動作</mark>

* スコープは主要な安全制御です。OktaでZoomアプリケーションが割り当てられていないユーザーは、この構成内のどのマッピングによっても変更されません。
* あり **ユーザーを無効化する** が有効になっている場合、アプリケーションの割り当てを解除するか、Oktaアカウントを無効化すると、Zoomアカウントも自動的に無効化されます。
* アプリケーションを再割り当てすると、以前に無効化されたZoomアカウントが再有効化されるため、グループメンバーシップは退職者や復帰者を管理するための有効な仕組みになります。

### ステップ7: Oktaで参照シナリオを適用する

シナリオ、前提条件、属性の定義については、 [**シナリオのリファレンス**](#reference-scenarios) セクションを参照してください。ここでは、Oktaの設定のみを説明します。

**シナリオ 0 — 部門。** ステップ 1 で、属性を次の項目で定義します。 **表示名** および **変数名** `department`, **外部名** `department`、および **外部名前空間** `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User`。使用 **属性タイプ: 個人**。Okta の基本ユーザープロファイルには、すでに `department` 属性なので、ステップ 2 は省略できます。ステップ 3 でそこから直接マッピングし、選択します **作成と更新**.

{% hint style="warning" %}
**注意：エンタープライズ拡張属性の名前空間形式**

ステップ 1 の警告では、External 名前空間に属性名を追加するという Zoom の規則について説明しています。このガイダンスは、Zoom 拡張機能内の属性に関するものです。 `department` 上記のように、標準のSCIMエンタープライズ拡張に属しており、Oktaの通常の動作では、名前空間と外部名を別々のフィールドに保持します。値がZoomに届かない場合は、末尾に追加する形式を試してください — `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department` —そして、Marketplaceのコールログでどのフォームが成功したかを確認します。
{% endhint %}

**代替案（〜の場合） `department` はすでにマッピングされています。** 以下はいずれも同じように動作し、同じ親要素の下にあり、前提条件もありません。両方の属性名を置き換えてください。 **外部名** および名前空間を指定し、Okta プロフィールに対応するソース属性がまだない場合は、ステップ 2 で追加します。

| 属性               | ノート                                                                                              |
| ---------------- | ------------------------------------------------------------------------------------------------ |
| `costCenter`     | ビジネスフィールド。ユーザーごとに異なるため、誤った値が目に見えます                                                               |
| `組織`             | すべてのユーザーで同一であることが多く、間違いに気付きにくくなります                                                               |
| `employeeNumber` | IDフィールドとしてすでにマッピングされていることが多いため、宣言する前に確認してください                                                    |
| `pronouns`       | これは **Zoom** 拡張の下にあり、エンタープライズ拡張の下にはありません。そのため、このガイドの他のすべてのシナリオと同じ名前空間を使用し、上記の形式に関する問題を完全に回避できます。 |

**シナリオ 1 — Zoom Phone サイトと自動内線番号。** 次の属性を宣言します。 `zoomPhoneSite` の設定は **属性タイプ: グループ** とし、各サイトの Okta グループにその値を設定します。これにより、グループへの所属によってサイトが直接決定され、変換ロジックは不要になります。次に、 `zoomPhoneExtNumber` を個人属性として宣言し、デフォルト値を `0` に設定します。ただし、既存の内線番号設定を移行する場合は除きます。

**シナリオ 2 — 国によって異なる通話プラン。** 次の属性を宣言します。 `zoomPhoneCallingPlan` の設定は **属性タイプ: グループ** とし、通話プランの地域ごとにグループを作成します。各グループの Zoom アプリケーション割り当てでプランの値を設定します。ユーザーは所属するグループを通じて正しいプランを継承し、Okta に保存される値は Zoom が期待する値と完全に一致します。これにより、 **割り当て** タブから設定を確認および監査できるようになり、基になるディレクトリデータの入力方法に不整合があっても設定が維持されます。次の値を持つグループは、 `-1` ユーザーを削除せずに通話権限を解除するための明確な方法を提供します。

**シナリオ 3 — コンタクトセンターのパッケージ、ロール、地域。** 次の属性を宣言します。 `zoomContactCenterPackage` は、許可された 3 つの値に制限された列挙型属性とし、無効なパッケージが入力されないようにします。次に、 `zoomContactCenterRole` をグループレベルの属性として宣言します。これは、通常、ロールがチーム構造に従うためです。単一地域でのデプロイでは、 `zoomContactCenterRegion` をマッピングせずに残します。

## トラブルシューティング

### エラー

#### <mark style="color:青;">ユーザーが存在しない、またはこのアカウントに属していない</mark>

このエラーは、対象ユーザーのメールアドレスに関連付けられたアカウントがすでに存在するため、ユーザーのプロビジョニングに失敗した場合に発生します。Zoomの管理者は、ユーザーに直接連絡し、アカウントに手動で招待することをおすすめします。

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdXyiyMnR4S4EhYFqFUXgrePk-RwciKw8-jcxKxViZiIZ4I2kp0j1f_alWR7Hq9WuYhwz6ohh4LodWERfiXSr27LFN20r-r95xBJ6AjD7lF9k58yIJeYLpMmHR3BHYcPTMYkVwqZw?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="563"><figcaption><p>プロビジョニングエラーの例。</p></figcaption></figure></div>

#### <mark style="color:青;">有料ユーザーを追加できない</mark>

このエラーは、アカウントのライセンスが不足している状態でSCIMがユーザーをプロビジョニングしようとした場合に発生します。このエラーを解決するには、ユーザーをベーシックユーザーとしてプロビジョニングするか、プロビジョニングに使用できるライセンスを用意する必要があります。

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdXyiyMnR4S4EhYFqFUXgrePk-RwciKw8-jcxKxViZiIZ4I2kp0j1f_alWR7Hq9WuYhwz6ohh4LodWERfiXSr27LFN20r-r95xBJ6AjD7lF9k58yIJeYLpMmHR3BHYcPTMYkVwqZw?key=ug1dFE_WGWGnyMfD5tJnNw" alt="" width="563"><figcaption><p>プロビジョニングエラーの例。</p></figcaption></figure></div>

### SCIMログを使用したユーザープロビジョニングのトラブルシューティング

Zoomでは、最新の100件のAPIリクエストログを [Zoom Marketplace](https://marketplace.zoom.us/)で確認できます。Zoomの管理者はこれらのログを使用して、プロビジョニングAPIを通じて送受信されている情報を確認できます。ログにアクセスするには、Zoomの管理者としてZoom Marketplaceにサインインし、 **管理**をクリックします。次のページで、 **通話ログ** の下にある **個人用アプリ管理**を選択します。そこから、項目をクリックしてAPIログを展開し、内容を確認します。

次の画像は、SCIMユーザープロビジョニングリクエストの例です。ユーザーのアイデンティティ属性とライセンス属性が参考として強調表示されています。

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcIxosFPBR8E4f1hj0vZQ7_nxnRd_isIqJYhKTQbocw4UfXlCBCkscqx8bGvY8JwuazgtRROPJm9PCZfZ4hJ5GQBqBzJA-PgS-mXkptGa0xq82SMXjl9Ip-faCDk3OQuLUXK0iobQ?key=ug1dFE_WGWGnyMfD5tJnNw" alt=""><figcaption><p>SCIMユーザープロビジョニングリクエストの例。</p></figcaption></figure></div>

レスポンスマッピングと同様に、Zoomが適用できるのは、プロビジョニングリクエストでアイデンティティプロバイダーから送信された情報のみです。これらのログを使用して、ユーザーのアイデンティティ属性とライセンス属性がアイデンティティプロバイダーから送信されていることを確認してください。これらのアサーションに想定される情報が含まれていない場合は、サポートを受けるためにアイデンティティプロバイダーに連絡してください。


---

# 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://library.zoom.com/technical-library/ja/kn/account-and-endpoint-management/scim-guide.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.
