この記事の内容
dropdown icon
クロスドメイン ID 管理システム (SCIM)
    Entra ID ウィザード アプリ
Azure アプリケーション ギャラリーから Webex を追加
Entra ID のアプリケーションにグループ/ユーザーを割り当てる
Entra ID を認証して、ユーザーを Control Hub 組織と同期させます
ユーザー属性を Entra ID から Webex にマッピング
サポートされている同期オブジェクト
Cisco Webex Entra ID ギャラリー アプリを使用したレガシー SCIM プロビジョニング
list-menuこの記事の内容
list-menuフィードバックがある場合

Microsoft Entra ID のプレビルド Cisco Webex エンタープライズ アプリケーションを使用して、割り当てられたユーザーを Control Hub に同期し、レガシー SCIM プロビジョニング インテグレーションを使用します。 このオプションは、Cisco Webex ギャラリー アプリをすでに使用している組織向けです。

クロスドメイン アイデンティティ管理のシステム (SCIM)

ディレクトリのユーザと Control Hub のインテグレーションは、クロスドメイン ID 管理 (SCIM) API のシステムを使用します。SCIM は、アイデンティティ ドメインまたは IT システム間のユーザー アイデンティティ情報の交換を自動化するオープン標準です。SCIM は、クラウドベースのアプリケーションおよびサービスでのユーザー アイデンティティの管理を容易にするように設計されています。SCIM は、REST を通じて標準化された API を使用しています。

SCIM 同期では、オンプレミスのインフラストラクチャやコネクタは必要ありません。この統合により、ユーザーが Entra ID でアプリケーションを作成、更新、または削除されるたびに、ユーザー リストの同期が保たれます。

Entra ID が null 値を同期しません。属性値を NULL に設定した場合、Webex では削除されないか、NULL 値でパッチ適用されません。この制限がユーザーに影響する場合、Microsoft に連絡してサポートを受け取る必要があります。

Entra ID ウィザード アプリ

Control Hub の Entra ID ウィザード アプリを使用して、Webex とのユーザーとグループの同期を簡素化します。ウィザードアプリを使用すると、同期する属性、ユーザー、グループを簡単に設定し、ユーザーのアバターを Webex に同期するかどうかを決定できます。このウィザードを使用する利点の詳細については、「 Control Hub で Entra ID ウィザード アプリをセットアップする」を参照してください。

Azure アプリケーション ギャラリーから Webex を追加

Entra ID を使用して自動ユーザープロビジョニングするように Control Hub を設定する前に、Azure アプリケーション ギャラリーから管理対象アプリケーションのリストに Webex を追加する必要があります。

次の手順は、古い SCIM 1.1 プロトコルを使用します。{3>{4>< に移動4}SCIM 2.0のEntra IDのカスタム Webex アプリによるプロビジョニング<3より新しい SCIM 2.0 プロトコルをセットアップするための手順を確認します。

さまざまな Entra ID 同期方法の範囲については、サポートされている同期オブジェクト を参照してください。

1

管理者の資格情報を使用して、https://portal.azure.com の Azure ポータルにサインインします。

2

組織の Entra ID に移動します。

3

移動 Enterprise Applications をクリックし、 Add > Add an application from the gallery.

4

検索ボックスに、 Cisco Webex.

5

結果ペインで、 Cisco Webex[アカウントの追加] を Add アプリケーションを追加します。

An example of the Add an application screen with the Cisco Webex application highlighted.

アプリケーションが正常に追加されたことを示すメッセージが表示されます。

6

同期のために追加した Webex アプリケーションがユーザー ポータルに表示されないことを確認するには、新しいアプリケーションを開いて、 Properties、および設定 Visible to users?No.

A screen of the properties page highlighting the location of the Visible to users toggle. It can be found towards the bottom of the screen, just above the Notes field.

Entra ID のアプリケーションにグループ/ユーザーを割り当てる

この手順で Webex クラウドに同期するユーザーを選択できます。

Entra ID は「割り当て」と呼ばれる概念を使用して、どのユーザーが選択したアプリにアクセスできるかを決定します。自動ユーザー プロビジョニングのコンテキストでは、Entra ID のアプリケーションに「割り当てられた」ユーザーおよび/またはユーザーのグループだけが、Control Hub に同期されます。

Control Hub の Entra ID ウィザード アプリ を使用して、Entra ID グループと個々のグループ オブジェクトの両方のユーザーを同期します。Webex は、Entra ID ウィザード アプリの外部では個々のグループを同期できません。

初めて統合を構成する場合は、テスト用に 1 人のユーザーを割り当て、テストが成功してから、他のユーザーとグループを追加することをお勧めします。

1

Entra ID ポータルで Webex アプリケーションを開き、 Users and groups.

2

オプション Add Assignment.

3

アプリケーションに追加するユーザーやグループを見つけます:

  • アプリケーションに割り当てる個々のユーザーを見つけます。
  • アプリケーションに割り当てるユーザーのグループを見つけます。
4

オプション Select [アカウントの追加] を Assign.

Webex と同期するグループとユーザーがすべて揃うまで、この手順を繰り返します。

Entra ID を認証して、ユーザーを Control Hub 組織と同期させます

この手順を使用して、Entra ID からプロビジョニングをセットアップし、組織のベアラー トークンを取得します。この手順には、必要で推奨した管理設定が記載されています。

組織がすべてのユーザーに検証済みドメインを持つ必要がある場合、将来の同期では、未確認のドメインのユーザー作成は許可されません。ほとんどの Webex の政府組織は検証済みドメインを必要とします。

はじめる前に

Control Hub の顧客ビューから組織 ID を取得します。左下の組織名をクリックして、 Organization ID テキストファイルに追加します。この値は、テナント URL を入力する際に必要になります。この値をこの記事の例として使用します。a35bfbc6-ccbd-4a17-a488-72gf46c5420c

1

Azure ポータル にサインインして、 > Enterprise applications > All applications.

2

選択 Cisco Webex を選択します。

3

移動 Provisioningに移動し、 Provisioning ModeAutomatic.

Entra ID の Cisco Webex プロビジョニング画面。[プロビジョニングモード] ドロップダウン メニューをクリックして、[自動] を選択します。

Webex アプリには、Entra ID ユーザー属性と Webex ユーザー属性の間のデフォルトのマッピングが含まれています。これらの属性だけでも十分ユーザーを作成できますが、この記事の後半で説明するように、属性を追加することもできます。

4

コマンド Tenant URL.

Webex のオファーの URL を次の表に示します。以下を置換: OrgId 特定の値で置換します。

Table 1. Tenant URLs for Webex
Webex のオファー使用するテナント URL
Webex (既定) https://api.ciscospark.com/v1/scim/OrgId
政府/自治体向け Webex https://api-usgov.webex.com/v1/scim/OrgId

テナント URL は次のようになります。 https://api.ciscospark.com/v1/scim/a35bfbc6-ccbd-4a17-a488-72gf46c5420c.

5

次のうち 1 つだけ を行って、次のベアラー トークン値を取得します。 Secret Token:

  • Control Hub 内から新しいトークンを自動的に生成します。

    Control Hub で、 Apps > Service appsを選択し、アプリケーションを選択し、 Get a token > Authorize to get token.

  • 次の手順で新しいトークンを手動で生成します。

  1. 次の URL をコピーし、シークレット ブラウザ タブで実行します。 https://idbroker.webex.com/idb/oauth2/v1/authorize?response_type=token&client_id=C4ca14fe00b0e51efb414ebd45aa88c1858c3bfb949b2405dba10b0ca4bc37402&redirect_uri=http%3A%2F%2Flocalhost%3A3000%2Fauth%2Fcode&scope=spark%3Apeople_read%20spark%3Apeople_write%20Identity%3ASCIM&state=this-should-be-a-random-string-for-security-purpose.

    上記の URL はデフォルトの Webex ID ブローカーに適用されます。政府向け Webex を使用している場合、以下の URL を使用して、ベアラー トークンを得る必要があります。

    https://idbroker-f.webex.com/idb/oauth2/v1/authorize?response_type=token&client_id=C4ca14fe00b0e51efb414ebd45aa88c1858c3bfb949b2405dba10b0ca4bc37402&redirect_uri=http%3A%2F%2Flocalhost%3A3000%2Fauth%2Fcode&scope=spark%3Apeople_read%20spark%3Apeople_write%20Identity%3ASCIM&state=this-should-be-a-random-string-for-security-purpose

    正しい管理者資格情報を使用して確実にサインインするには、シークレット ブラウザを使うことが重要です。ユーザーを作成できない権限の低いユーザーとしてすでにサインインしている場合、戻るベアラー トークンはユーザーを作成できます。

  2. 表示される [Webex サインイン] ページから、組織のフル管理者アカウントでログインします。

    サイトに到達できないという内容のエラーページが表示されますが、これは通常のものです。

    エラー ページの URL には生成されたベアラー トークンが含まれます。このトークンは 365 日間 (有効期限が切れます) 有効です。

    生成されたベアラー トークンが強調表示されたエラー ページ URL の例。 "access_token=" と "&token_type=Bearer" の間に見つかったベアラー トークン値をコピーしてください。

  3. このブラウザのアドレス バーにある URL から、ベアラー トークンの値を次の二者間でコピーします。 access_token= および &token_type=Bearer.

    たとえば、この URL にはトークンの値がハイライトされています。http://localhost:3000/auth/code#access_token={sample_token}&token_type=Bearer&expires_in=3887999&state=this-should-be-a-random-string-for-security-purpose。

    URL がもう利用できない場合に備え、この値をテキスト ファイルにトークンのレコードとして保存することを推奨します。

6

ポータルに戻り、トークン値を次に貼り付けます: Secret Token.

7

オプション Test Connection を選択して、Entra ID が組織とトークンを認識していることを確認します。

正常な結果として、ユーザーのプロビジョニングを有効にするための資格情報が承認されたことが示されます。

8

次を入力: Notification Email プロビジョニング エラーが発生したときに メールを受け取るには チェックボックスをオンにします

9

オプション Save.

この時点で、Entra ID を使用して Webex ユーザーのプロビジョニングと同期を正常に承認し、同期を設定するための手順を完了しました。

次に行うこと

さらに Entra ID ユーザー属性を Webex 属性にマッピングする場合は、次のセクションに進みます。

同期された組織に変更を加える方法については、同期された Entra ID ユーザーの管理 のヘルプ記事を参照してください。

ユーザー属性を Entra ID から Webex にマッピング

追加のユーザー属性を Entra ID から Webex にマッピングするか、既存のユーザー属性のマッピングを変更するには、次の手順に従います。

Entra ID から Webex へのマッピングでは、すべてのユーザーの詳細が同期されるわけではありません。ユーザーデータのいくつかの面は同期化されません。

  • アバター

  • 件の会議室

  • 下記のテーブルにリストされていない属性

デフォルトの属性マッピングは、どうしても必要でない限り、変更しないようお勧めします。ユーザー名としてマッピングする値は特に重要です。Webex はユーザーのメール アドレスをユーザー名として使用します。デフォルトでは、マップされます userPrincipalName Azure AD の (UPN) から Control Hub のメール アドレス (ユーザー名) に移動します。

もし userPrincipalName Control Hub のメールにマッピングされません。ユーザーは、既存のユーザーを照合する代わりに、新しいユーザーとして Control Hub にプロビジョニングされます。UPN の代わりにメール アドレス形式の別の Azure ユーザー属性を使用する場合は、Entra ID のデフォルト マッピングを userPrincipalName を適切な Entra ID ユーザー属性に追加します。

はじめる前に

Entra ID に Cisco Webex アプリを追加して構成し、接続をテストしました。

ユーザーの同期を開始する前または後に、ユーザー属性のマッピングを変更できます。

1

Azure ポータル にサインインして、 Enterprise applications > All applications...

2

追加した または 作成した Webex アプリケーションを開きます。

事前構築された Cisco Webex アプリケーションとカスタム SCIM 2.0 アプリケーションの違いについては、ここ をクリックしてください。
3

移動 Provisioning > Mappings をクリックし、 Provision Entra ID Users.

4

応答の Show advanced options チェックボックスをオンにして、 Edit attribute list.

5

Entra ID のユーザー属性から入力する Webex 属性を選択します。

6

オプション Save > Yes を確認します。

[属性マッピング] ページが開き、Entra ID のユーザー属性を選択した Webex ユーザー属性にマッピングできます。

7

ページの最下部で、 Add new mapping.

8

選択 Direct マッピング。必要に合って [ Source attribute (Entra 属性)および Target attribute (Webex 属性) をクリックし、 OK.

Table 2. Entra ID to Webex Mappings

Entra ID 属性(ソース)

Webex ユーザー属性 (ターゲット)

デフォルトで入力される属性

userPrincipalName

ユーザー名

Switch([IsSoftd], , "False", "True", "True", "False")

アクティブ

displayName

displayName

surname

name.familyName

givenName

name.givenName

objectId

externalId

その他の使用可能な属性

jobTitle

役職

usageLocation

addresses[type eq "work"].country

city

addresses[type eq "work"].locality

streetAddress

addresses[type eq "work"].streetAddress

state

addresses[type eq "work"].region

postalCode

addresses[type eq "work"].postalCode

telephoneNumber

phoneNumbers[type eq "work"].value

モバイル

phoneNumbers[type eq "mobile"].value

facsimileTelephoneNumber

phoneNumbers[type eq "fax"].value

雇用者

urn:ietf:params:scim:schemas:extension:enterprise:2.0:ユーザー

部門

urn:ietf:params:scim:schemas:extension:enterprise:2.0:ユーザー

manager

urn:ietf:params:scim:schemas:extension:enterprise:2.0:ユーザー

9

必要なすべてのマッピングを追加または変更するまで、前の 2 つの手順を繰り返し、 Save および Yes 新しいマッピングを確認します。

操作 Restore default mappings もう一度開始する場合。

これでマッピングは完了です。次の同期で Webex ユーザーが作成または更新されます。

サポートされている同期オブジェクト

次の表に、Entra ID の Enterprise App Store 同期、Control Hub 用の Entra ID ウィザード アプリ、Entra ID SCIM 2.0 の暗示の違いを示します。

Table 3. What you can synchronize

オブジェクト

SCIM ID 1 を入力します。1

Entra ID ウィザード アプリ

SCIM ID 2 を入力します。0

[ユーザー]

対応

対応

対応

グループ

未対応

対応*

対応

件の会議室

未対応

対応*

未対応

アバター

未対応

対応*

未対応

*:Microsoft Graph API を介した Entra ID ウィザード アプリ経由でのみグループ、ルーム、アバターを Control Hub に同期できます。

Table 4. Supported user attributes

属性(Attribute)

SCIM ID 1 を入力します。1

Entra ID ウィザード アプリ

SCIM 2。0

ユーザー名

対応

対応

対応

displayName

対応

対応

対応

name.familyName

対応

対応

対応

name.givenName

対応

対応

対応

外部 ID

対応

対応

対応

役職

対応

対応

対応

addresses[type eq "work"].country

対応

対応

対応

addresses[type eq "work"].locality

対応

対応

対応

addresses[type eq "work"].streetAddress

対応

対応

対応

addresses[type eq "work"].region

対応

対応

対応

addresses[type eq "work"].postalCode

対応

対応

対応

phoneNumbers[type eq "work"].value

対応

対応

対応

phoneNumbers[type eq "mobile"].value

対応

対応

対応

phoneNumbers[type eq "fax"].value

対応

対応

対応

manager

未対応

対応

未対応

部門

未対応

未対応

対応

従業員 ID

未対応

未対応

対応

この投稿記事は役に立ちましたか?
この投稿記事は役に立ちましたか?