Webexの統合
Webex統合を展開して、任意のデバイスまたはイントラネットからWebexミーティングをスケジュールします。ユーザーは、1回限りの/定期的なミーティングをホストしたり、招待者や共催者を追加したり、異なるタイムゾーンから選択することができます。また、マイクロアプリは、カレンダーとの統合を容易にするために、対応するミーティングオブジェクトを持つホストと招待者にメールでフォローアップします。
注：
ご意見・ご要望をお待ちしています。この統合テンプレートに関するフィードバックをお送りください。また、問題についてはサポートチームが専用のフォーラムを毎日確認いたします。
追加設定不要のWebexマイクロアプリの一覧については、「Webexマイクロアプリの使用」を参照してください。
必須条件の確認
これらの前提条件は、管理者が組織のWebex統合セットアップの一部であることを前提としています。このWebex管理者アカウントには、ユーザー情報の完全な読み取り権限が必要です。
Webexとのこの統合を設定した後、Citrix Workspaceマイクロアプリに統合を追加するには、これらのアーティファクト、特にOAuth統合を設定するための次のパラメーターの一覧が必要になります：
- ベースURL：
https://webexapis.com/v1/ - 認証URL：
https://webexapis.com/v1/authorize - トークンURL：
https://webexapis.com/v1/access_token - クライアントID：クライアントIDは、承認サーバーに固有のクライアント登録情報を表す文字列です。
- シークレット：クライアントシークレットは、ターゲットアプリケーション統合のセットアップ時に発行される一意の文字列です。
注：
利用可能な場合は、サービス認証方法として常にOAuth 2.0を使用することをお勧めします。OAuth 2.0は、統合が、構成済みのマイクロアプリとの最大限のセキュリティコンプライアンスを満たすことを保証します。
Citrix GatewayがWebexのシングルサインオンに対応するように構成して、ユーザーがログインすると、再度資格情報を入力する必要がなく自動的に再ログインできるようにします。SSOの構成について詳しくは、「Citrix Gatewayサービス」を参照してください。
統合ではWebexインスタンスへの定期的なアクセスが必要なので、Webexで専用のユーザーアカウントを作成することをお勧めします。このアカウントには、次の権限が必要です。
- サービスアカウントに必要な権限：完全な管理者特権
特定のリソースに対して実行できるAPI要求の数は限られているため、以下をお勧めします：
- Webex API制限フォームのリンク： https://developer.webex.com/docs/api/basics#rate-limiting
- 推奨プラン：Webex Plus
APIの有効化
Webex APIは、有料アカウントのWebサービスを通じてデフォルトで有効になっています。
新しいサービスアカウントの作成
ここから登録します： https://web.webex.com/。新しいサービスアカウントについては、以下のURLを参照してください：https://help.webex.com/en-us/nkhozs6/Get-Started-with-Cisco-Webex-Control-Hub。
OAuthサーバーの構成
Webex統合を介してデータを読み取るようにOAuthサーバーを構成します。
- 次の場所にサービスアカウントでログインします：https://developer.webex.com/docs/platform-introduction。
- 右上にあるユーザー名を選択します。
- ［My Webex Apps］ を選択し、［Create a New App］ を選択します。
- 統合タイルの下にある ［Create an Integration］ を選択します。
-
必須フィールドに入力し、［Redirect URL］ フィールドにこの統合用の次の承認済みリダイレクトURLを入力します：
https://{yourmicroappserverurl}/admin/api/gwsc/auth/serverContext
- ［スコープ］ セクションで、［spark:all］ および ［spark-admin:people_read］ チェックボックスをオンにします。
- すべての必須項目に入力したら、［Add Integration］ を選択します。
- 画面に表示されているClientIdとSecretをコピーして保存します。統合を構成するときに、これらの詳細をサービス認証に使用します。
OAuthクライアントの構成
Webex統合を通じてデータをライトバックするようにOAuthクライアントを構成します。
- 上記のように、サービスアカウントでログインします： https://developer.webex.com/docs/platform-introduction。
- 右上にあるユーザー名を選択します。
- ［My Webex Apps］ を選択し、［Create a New App］ を選択します。
- 統合タイルの下にある ［Create an Integration］ を選択します。
-
必須フィールドに入力し、［Redirect URL］ フィールドにこの統合用の次の承認済みリダイレクトURLを入力します：
https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback
- ［Scopes］ セクションで ［meeting:schedules_write］ チェックボックスをオンにします。
- すべての必須項目に入力したら、［Add Integration］ を選択します。
- 画面に表示されているClientIdとSecretをコピーして保存します。統合を構成するときに、これらの詳細をサービスアクション認証に使用します。
Citrix Workspaceマイクロアプリへの統合の追加
Webex統合をCitrix Workspaceマイクロアプリに追加して、アプリケーションに接続します。認証オプションは事前に選択されています。プロセスの完了時に、これらのオプションが選択されていることを確認してください。これにより、通知とアクションが設定済みとなっている追加設定不要のマイクロアプリを、Workspace内で使用できるようになります。
次の手順を実行します：
- ［マイクロアプリ統合］ ページで ［新しい統合を追加］ および ［Citrix提供のテンプレートから新しい統合を追加する］ を選択します。
- Webex Meetingsタイルを選択します。
- 統合の統合名を入力します。
-
コネクタのパラメーターを入力します。
- インスタンスの ［ベースURL］ を入力します：
https://webexapis.com/v1/。 - アイコンライブラリから統合のアイコンを選択するか、デフォルトのアイコンのままにしておきます。
- インスタンスの ［ベースURL］ を入力します：
-
［サービス認証］ で ［認証方法］ メニューから ［OAuth 2.0］ を選択して認証の詳細を完了します。認証オプションは事前に選択されています。プロセスの完了時に、これらのオプションが選択されていることを確認してください。OAuth 2.0セキュリティプロトコルを使用して、委任されたアクセスの要求/承認トークンを生成します。利用可能な場合は、サービス認証方法として常にOAuth 2.0を使用することをお勧めします。OAuth 2.0は、統合が、構成済みのマイクロアプリとの最大限のセキュリティコンプライアンスを満たすことを保証します。
- ［許可の種類］ メニューで ［認証コード］ を選択します。これによって、クライアントが交換するアクセストークン用の一時コードが付与されます。コードは認証サーバーから取得され、そこでクライアントが要求している情報を確認できます。この許可の種類のみが、安全なユーザーの偽装を有効にします。これにより、アプリケーションの登録時に使用する ［コールバックURL］ が表示されます
- ［トークン認証］ メニューから ［要求の本文］ を選択します。
-
［認証URL］ は事前に入力されています：
https://webexapis.com/v1/authorize -
［トークンURL］ は事前に入力されています：
https://webexapis.com/v1/access_token - スコープに次のように入力されていることを確認します：spark:all spark-admin:people_read
- ［クライアントID］ を入力します。クライアントIDは、承認サーバーに固有のクライアント登録情報を表す文字列です。OAuthサーバーを構成したときに、クライアントIDとシークレットを収集します。統合構成ページに表示される ［コールバックURL］ を追加する必要があります。
- ［クライアントシークレット］ を入力します。クライアントシークレットは、ターゲットアプリケーション統合のセットアップ時に発行される一意の文字列です。
-
［サービスアクション認証］ で ［［アクション］で個別のユーザー認証を使用する］ トグルを有効にします。サービスアクション認証は、サービスアクションレベルで認証します。認証オプションは事前に選択されています。プロセスの完了時に、これらのオプションが選択されていることを確認してください。
- ［認証方法］ メニューから ［OAuth 2.0］ を選択して認証の詳細を完了します。
- ［許可の種類］ メニューで ［認証コード］ を選択します。これによって、クライアントが交換するアクセストークン用の一時コードが付与されます。コードは認証サーバーから取得され、そこでクライアントが要求している情報を確認できます。この許可の種類のみが、安全なユーザーの偽装を有効にします。これにより、アプリケーションの登録時に使用する ［コールバックURL］ が表示されます
- ［トークン認証］ メニューから ［要求の本文］ を選択します。
-
［認証URL］ は事前に入力されています：
https://webexapis.com/v1/authorize -
［トークンURL］ は事前に入力されています：
https://webexapis.com/v1/access_token - スコープに次のように入力されていることを確認します：meeting:schedules_write
- ［クライアントID］ を入力します。クライアントIDは、承認サーバーに固有のクライアント登録情報を表す文字列です。OAuthクライアントを構成したときに、クライアントIDとシークレットを収集します。統合構成ページに表示される ［コールバックURL］ を追加する必要があります。
- ［クライアントシークレット］ を入力します。クライアントシークレットは、ターゲットアプリケーション統合のセットアップ時に発行される一意の文字列です。
- ［要求レート制限を有効にする］ トグルを有効にします。［要求数］に「100」 と入力し、［時間間隔］ に「1分」と入力します。
-
（オプション）サポートのために24時間のログを保持するには、［ログ］ を有効にします。
- ［保存］ を選択して続行します。
-
［OAuth認証］で ［承認］ を選択して、サービスアカウントにログインします。Webexのログイン画面がポップアップで表示されます。
- サービスアカウントのユーザー名とパスワードを入力し、［ログイン］ を選択します。
-
［同意］ を選択します。
［マイクロアプリ統合］ ページが開き、追加した統合とそのマイクロアプリが表示されています。ここから別の統合を追加したり、追加設定不要のマイクロアプリのセットアップを続行したり、この統合用の新しいマイクロアプリを作成したりできます。
これで、最初のデータ同期を設定して実行する準備ができました。統合アプリケーションからマイクロアプリプラットフォームに大量のデータをプルできるので、［テーブル］ ページを使用して、最初のデータ同期のエンティティをフィルタリングし、同期を高速化することをお勧めします。詳しくは、「必要なエンティティの確認」を参照してください。同期ルール、スケジュールを満たさない同期、および拒否ルールについて詳しくは、「データの同期」を参照してください。
APIエンドポイントとテーブルエンティティについて詳しくは、「Webex HTTPコネクタの仕様」を参照してください。
Webex Meetingsマイクロアプリの使用
既存のアプリケーション統合には、追加設定不要のマイクロアプリが付属しています。これらのマイクロアプリから開始して、ニーズに合わせてカスタマイズします。
ミーティングの作成： 期間、タイムゾーン、招待者、および共同ホストを選択するオプションを使用してミーティングをスケジュールします。
| 通知またはページ | ユースケースワークフロー |
|---|---|
| ミーティングの作成ページ | ユーザー設定に従って、次の詳細情報でミーティングをスケジュールするためのフォームを提供します：ミーティングの件名、開始時間と終了時間、タイムゾーン、繰り返し（1回、毎日、毎週、毎月）、パスワード、ミーティングの参加者、およびミーティングの共同主催者。 |