ユーザー管理

Control Hub の基礎となる一元化されたユーザー管理システムがあります。ここで、ユーザーは組織全体 (およびすべての Webex) 内で区別され固有です。サイト管理では、ユーザー プロファイルがミーティング サイトごとに異なります。

自動アカウント作成でのシングル サインオン (SSO)

サイト管理では、SSO により認証するときにユーザーを作成する「自動アカウント作成」機能があります。

この機能は Control Hub でも利用できます。詳細については、 Control Hub の SAML 自動アカウント作成および更新 を参照してください。

SSO を使用する多くの組織は、Microsoft^® Active Directory および Microsoft Azure などの外部ディレクトリ ツールでユーザーを一元的に管理し、外部 ID プロバイダーとの認証を必要とすることを希望する場合があります。

詳細:

• Control Hub にユーザーを追加する。

• Control Hub 組織を ID プロバイダーと統合します。

必須のプロファイル データとトラッキング コード

サイト管理では、新規ユーザーに必要なプロファイル フィールドを指定することができます (前のスクリーンショット)。これを拡張してユーザー作成のためのトラッキング コードを要求することができます (下のスクリーンショット)。これらの追加要件を構成する場合、これらを使用せずユーザーをサイトに追加することはできません。

Control Hub では、ユーザーを作成するのに必要なのは表示名とメール アドレスのみです。

Control Hub で新しいユーザーを作成する際には、他のすべてのユーザー フィールドはオプションであるため、Control Hub への追加のプロファイル データ提供は強制されません。

サイトを Control Hub に更新する前に、必須のプロファイル フィールドとトラッキング コードを無効にする必要があります。

パスワード管理とロックアウト

サイト管理には、何回か試行した後にサインインに失敗した場合に、ユーザーを一時的にロックする機能があります。

Control Hub には以下のオプションがあり、不正アクセスを防ぎます。

• 最初の数回の試行失敗後に自動タイムアウト。

• CAPCHA メカニズム（(コンピューターと人間を区別するための完全に自動化されたパブリック チューリング テスト)。

• 正当なユーザーには、忘れてしまったパスワードを変更するセルフサービスのオプションがあります。

主催者のライセンス

主催者は Control Hub 組織に所属している必要があります

サイト管理で、任意のユーザーにホスト ライセンスを割り当てできます。Control Hub のサイトを管理する場合、同じ Control Hub 組織のユーザーに対して、主催者ライセンス (および出席者の役割) のみを割り当てすることができます。

主催者アカウントにセルフ サインアップする

サイト管理で、ユーザーがサイト上で (主催者) アカウントを要求できるよう許可することができます。アカウントを持つユーザーがサイト上で追加サービスを要求することもできます。(スクリーンショットを参照)。

Control Hub でミーティング サイトを管理している場合、ユーザーはサイトに対して自分の主催者アカウントを要求できません。

Control Hub には、新しいユーザーにミーティング ライセンスを割り当てる一元化された自動的な方法があります。https://help.webex.com/n3ijtao をお読みください。

API または CSV を使用して一括でユーザー ライセンスを管理することもできます。

ユーザーが彼らの主催者アカウントを要求する場合、ポインタを使ってサイトのヘルプ/サポートを構成し、管理者に連絡したり、他のツールにリンクしたりします。

サイトから Control Hub に更新する前に、[サイトの管理] で [主催者アカウントのサインアップ許可] および [ユーザーに付加サービスの要求を許可] を無効にする必要があります。

Control Hub には、自動割り当てテンプレートなど、他のライセンス管理オプションがあります。非アクティブな主催者のレポートを取得して、個々に、または一括で、または API で、これらのユーザーからライセンスを削除するのに役立ちます。

この自動非アクティブ化オプションは必要でも、Control Hub の他のオプションが不適当な場合は、現時点でサイトを Control Hub に更新することは避けてください。

新規ユーザーのための自動アカウント作成

サイト管理で Webex サイトで自動アカウント作成を有効にしている場合、SAML 自動アカウント作成機能を持つ Control Hub でも同様の機能を有効にできます。また、新規ユーザーが Control Hub 組織でアカウントを作成すると、自動的にライセンスが割り当てられるので、自動ライセンス テンプレートを設定してください。

ディレクトリ同期を持つ組織

組織がディレクトリ同期に構成されている場合、組織内に所属させるすべてのユーザーがサイトに存在するようにします。サイトの更新プロセスを開始する 24 時間前に実行する必要があります。これにより、サイトのユーザーは Control Hub 組織の新しいユーザーにリンクすることができます。

更新後の Webex サイトへの管理者アクセス

Control Hub で組織全体の管理者ロールを持つユーザーは、サイト管理者から Control Hub に更新されるサイトに自動的にアクセスできるようになります。たとえば、組織のフル管理者は Webex サイトのフル管理者になり、組織のユーザー管理者は Webex サイトのユーザー管理者になり、組織の読み取り専用管理者は Webex サイトの読み取り専用管理者になります。

XML API

XML API は Control Hub 管理対象サイトと互換性があります。XML API 41.11.0 Updates で詳細と問題についてお読みください。

サイトがサイト管理者から Control Hub 管理に更新された後も、XML API サービス URL は変更されません。同じ API URL は引き続き利用できます。Cisco では、すべての API 統合で認証に OAUTH を使用することを推奨しています。

XML APIでの認証

認証に Webex OAUTH を使用しない統合は、サイトが Control Hub に更新された後に失敗する可能性があります。次の表は、サイトの更新後も引き続き機能する管理者認証の種類を示しています。

表1. サイト更新後に XML API で機能する管理者認証の種類

サイト更新前の XML API での管理者認証の種類	サイト更新後の SSO 組織の管理者	サイトの更新後、管理者が SSO 組織に存在しない
ユーザー名 (webExID)/password	動作します*	動作します*
ユーザー名 (webExID)/sessionTicket	うまくいく	うまくいく
username/OAUTH （ウェブエクスアクセストークン）	うまくいく	うまくいく
email/password	動作します*	動作します*
email/sessionTicket	うまくいく	うまくいく
email/OAUTH （ウェブエクスアクセストークン）	うまくいく	うまくいく

Username サイトが Control Hub に更新されると、すべてのユーザーにメールが送信されるように設定されます。API ペイロードに username が使用されている場合、サイトの更新後はペイロードで代わりに電子メールを使用する必要があります。

API統合のためのControl Hubの管理者ロール

サイト管理者ロールのみを持つ管理者は、サイトが Control Hub サイトに更新された後にユーザーの電子メール アドレスや表示名を変更するなど、XML API を使用して一部の操作を実行できない場合があります。API 統合に資格情報を使用する管理者の場合、Control Hub のフル管理者を組織に昇格することをお勧めします。理想的には、サイトを Control Hub に更新する前です。

統合の実行内容によっては、統合を機能させるために、管理者に Control Hub サイトで会議ホスト アカウントを割り当てる必要がある場合もあります (これはサイト管理サイトの管理者には必要ありませんでした)。

Control Hub での XML API の違い

ほとんどの XML API 統合は、サイト更新後に変更を加えなくても機能します。しかし、次のリストで詳細を示している一部の例外があります。

• CreateUser—Control Hub 管理対象サイトでは、この操作により、ライセンスを割り当てる前にサイト所有組織にユーザーが作成されることもあります。ユーザーが別の組織にすでに存在している場合、この操作は失敗します。PMR ID parameter は、Control Hub で アクティブ ステータスになっていないユーザーに対しては有効になりません。

  createuser API は Control Hub 管理対象サイトでの完了に時間がかかります。パフォーマンスを向上させるには、 createuser 呼び出しを並列化するために追加のスレッドを追加できます。

• SetUser—API パラメータまたはペイロードに応じて、ユーザーに会議サイト ライセンスを割り当てたり削除したりする可能性があります。
• DelUser—会議サイトのライセンスを削除しますが、Control Hub 組織からユーザーは削除されません。
• LstsummaryUser—ユーザーの objectGUIDも返します。
• AuthenticateUser—Control Hub 管理対象サイトでは、各 XML API にユーザー名とパスワードを使用するのではなく、 AuthenticateUser を使用してセッション チケットを作成することをお勧めします。コントロール ハブで管理されているサイトに対するこの通話では、本文の SAML 応答の使用はサポートされていません。

REST API

Control Hub には、ユーザーを作成したり、ライセンスを供与したりするためのユーザー API や License REST API など独自の API があり、次の場所からアクセスできます。

• https://developer.webex.com/docs/api/v1/people

• https://developer.webex.com/docs/api/v1/licenses

セッション タイプとトラッキング コードは、次の REST API でも利用できます。

• https://developer.webex.com/docs/api/v1/session-types
• https://developer.webex.com/docs/api/v1/tracking-codes

しかし、上記の REST API は、XML API で使用できるすべてのユーザー管理機能をサポートしているわけではありません。たとえば、サイトを所有する組織外のユーザーに会議ライセンスを割り当てるには、引き続き XML API を使用する必要があります。ユーザー API は、ユーザーへのサイト管理 ロールの割り当てを サポートされていません。API 経由でサイト管理の役割を割り当てる場合、引き続き XML API を使用する必要があります。

People API を使用して、完全な権限 (または読み取り専用権限) を持つ組織管理者を作成することができます。これらの管理者は、Control Hub で管理される会議サイトを管理 (または表示) することもできます。

今後の予定（変更の可能性あり）

• サイトを作成した組織に属さない外部ユーザーにも会議サイト ライセンスを付与できる新しいライセンス API。外部ユーザーライセンスは、現在 Control Hub で手動で利用できます 。
• 組織内のユーザーを作成および削除するための SCIM API。
• Cisco の長期的な方向性は、REST API のみを使用することです (ユーザーと会議サイトでのすべての操作に)。ユーザー管理のための XML API は、すべてのユーザー管理操作専用の REST API が使用されるまでは引き続きサポートされます。ユーザー管理 XML API も廃止される予定です (日付は未定)。

リリース43.6の今後の変更点

これまでは、サイトを Control Hub に更新する前に、次の 2 つの機能を無効にする必要がありました。

• 必須のホストプロファイルフィールド
• 必要な追跡コード

43.6 のリリース以降、カスタム属性および必須ホスト プロファイル フィールド機能のベータ版に参加しているサイトでは、サイトを Control Hub に更新する前にそれらの機能を無効にする必要がなくなります。代わりに、現在の構成が Control Hub 組織にコピーされるため、ウィザードではこれら 2 つの機能を確認するように通知されます。

必須ホスト プロファイル フィールド ベータ版に参加している場合は、次の警告が表示されます。

必須のトラッキング コードとカスタム属性 ベータ版に参加している場合は、次のアクション アイテムが表示されます。

これらのベータ版に参加していない場合は、次のセクションを読み続けてください。

サイトの更新をブロックする機能を無効にする

Webex サイトを Control Hub に更新する前に、一部の機能を無効にする必要があります。無効にする必要がある機能を示すリストをご確認ください。赤い丸の × 印のアイコンがついている機能は完了する必要があります。黄色い三角の感嘆符アイコンがついている機能は情報提供のみを目的としており、対応は必要ありません。

サイトを Control Hub に更新する方法のデモについては、このビデオをご 覧ください。

1. Webex サイト管理にログインし、[構成] > [共通のサイト設定] > [オプション] の順に選択します。

   • [主催者アカウントのサインアップ許可] オプションを見つけて無効 にします。

   • [アカウント サインアップ時の要求項目:] を探します。 そして、必須ユーザー プロファイル フィールドのすべてのボックスの選択を解除します。

2. [アップデート] をクリックします。

3. [構成] > [共通サイト設定] > [トラッキング コード] の順に選択します。

4. [ホスト プロファイル] 列で、[必須] のマークが付いたすべてのトラッキング コードの行を [管理設定] または [オプション] に変更します。

   • https://help.webex.com/izu2ty でトラッキング コードの詳細を参照してください。

   ユーザーのすべてのトラッキング コード値は、サイトを Control Hub に更新する際に保存されます。

将来的には、この制限は解除され、同等の機能を実現するために、Control Hub でトラッキング コードを必要なカスタム ユーザー属性にマッピングできるようになります。

サイトの更新をブロックするユーザーがいないか確認する方法

1. ログインし、[サイト管理更新] ページ を開 きます。

2. [管理を更新するための前提条件を確認する] コントロールを開き、[影響を受けるユーザーをCSV でエクスポートする] をクリックします。

3. エクスポートが完了するのを待ちます。開始時刻とサイト内のユーザー数によっては、このプロセスに時間がかかる場合があります。エクスポートは毎時6分間停止されます（ xx:57 に xx:03).

4. エクスポートが完了したら [CSV のダウンロード] をクリックします。

   ブラウザは users-to-review.csvをダウンロードします。

5. CSV ファイルを開き、[推奨されるアクション] 列 (最後の列) を確認します。ファイル内の各ユーザーに対し、推奨されるアクションを実行します。

一致しないメール アドレスを持つユーザー

一部のユーザーは、サイト管理と Control Hub でメール アドレスが異なります。これは、ユーザーがこのサイトから Control Hub にリンクされた後で、ユーザーのメールが 2 つの場所のうち 1 つでのみ変更された場合に可能です。

これらのアクションを試して、電子メール アドレスが一致しないユーザーを修正します。

• サイト管理のユーザーのメール アドレスを変更して、Control Hub メール アドレスに一致させる

  ユーザーはサイト管理者のプロファイルを編集することができます。 https://help.webex.com/nmig1kcb

• Control Hub のユーザーのメール アドレスを、サイト管理者のメール アドレス https://help.webex.com/nsi3kgbと一致するように変更します。

  ユーザーは Control Hub 組織で自分のメール アドレスを変更できます。 https://help.webex.com/nme40aeb

ベーシックミーティングライセンスを持つ外部ユーザー

Basic Meetings ライセンス を持つ外部ユーザーは、サイトをサイト管理から Control Hub に更新する前に、非アクティブ化するか、有料の Webex Meetings ライセンスにアップグレードする必要があります。

ユーザーを非アクティブにする方法

サイト管理での個別ユーザーの非アクティブ化:

1. [ユーザー管理] > [ユーザーの>編集] にアクセスします。

2. インデックス、検索、フィルター管理を使ってユーザーを探します。

3. [アクティブ] ボックスのチェックを 外します。

4. 変更を送信 します。

   詳細については、 Webex サイト管理でのユーザー アカウントの管理 を参照してください。

サイト管理でのバッチ ユーザーの非アクティブ化:

1. ユーザーを CSV ファイルにエクスポートします。

2. CSV ファイルを開き、影響を受けるすべてのユーザーの Active 列の値を N に変更します。

3. 変更された CSV ファイルをインポートします。

   変更されたユーザーは非アクティブになりました。

   詳細については、「Webex サイト管理で Webex ユーザーをバッチインポートまたはエクスポートする」を参照します。

ディレクトリの同期を持つ組織のユーザー

組織内にリストされているはずの、まだ追加されていないユーザーがリンクされていない場合、まず組織にユーザーを追加する必要があります。これは、ディレクトリ同期 (ディレクトリ コネクタ または Azure AD を通じて) に構成されている組織にとって特に重要です。ディレクトリ同期によってサイトの更新プロセスがユーザーを追加できないためです。

アップデートを開始する前にユーザーの問題を修正する

users-to-review ファイル内のユーザーの問題を解決せずにサイトを Control Hub に更新しようとすると、更新管理プロセスが失敗する可能性があります。最終更新が開始されるまで、ツールでは問題が修正済みどうか確認されません。

SSO 組織にリンクされた SSO サイトと非 SSO サイトの更新

コントロール ハブ組織は、SSO 用に複数の ID プロバイダー (IdP) をサポートでき、そのうちの 1 つは Webex IdP (ローカル認証) です。

Control Hub の複数の IdP は次の点で役立ちます。

• サイト管理の SSO サイトの IdP が Control Hub の SSO IdP と異なる場合。
• サイト内のユーザーが組織で設定されている SSO IdP に存在しない場合は、それらのユーザーをローカル Webex IdP に追加できるようになりました。その後、これらのユーザーを構成済みの SSO IdP に移動できます。

複数の IdP を設定すると、サイト管理者から Control Hub に更新されるサイトのすべてのユーザーが、Control Hub 組織で構成された認証方法を使用してサインインできるようになります。これを実現するには、次の操作を行います。

• Control Hub 組織に追加の SSO IdP を追加します。
• すでに設定されている IdP にユーザーを追加します。
• ローカル Webex IdP にユーザーを追加します。

Control Hub の複数の IdP の詳細については、 この記事 を参照してください。