マイクロアプリ

Zoomの統合

Zoom向けのCitrix統合を展開して、任意の場所、および任意のデバイスまたはイントラネットからミーティングをスケジュールします。Zoomとの統合により、ユーザーは次のことができるようになります:

  • 1回限りのまたは定期的な会議の作成、共同主催者の追加、異なるタイムゾーンの選択。このマイクロアプリは、ユーザーがスケジュールしたミーティングの招待状の詳細も提供します。
  • 作成したミーティングの表示、編集、開始。
  • Zoomの業務時間ミーティングのスケジュール設定。
  • ミーティング終了後、ミーティング録画通知の受け取り、録画の再生。

注:

ご意見・ご要望をお待ちしています。この統合テンプレートに関するフィードバックをお送りください。また、問題についてはサポートチームが専用フォーラムを毎日確認いたします。

すぐに利用可能なZoom用のマイクロアプリの包括的な詳細については、「 Zoom用マイクロアプリの使用」 を参照してください。

必須条件の確認

これらの前提条件は、管理者が組織のZoom統合セットアップの一部であることを前提としています。このZoom管理者アカウントには、ユーザー情報の完全な読み取り権限が必要です。Zoomでこの統合をセットアップした後、Citrix Workspaceマイクロアプリに統合を追加するには、以下のアーティファクトが必要になります:

  • ベースURL:https://api.zoom.us/v2/
  • 認証URL:https://zoom.us/oauth/authorize
  • トークンURL:https://zoom.us/oauth/token
  • クライアントID:クライアントIDは、承認サーバーに固有のクライアント登録情報を表す文字列です。
  • シークレット:クライアントシークレットは、ターゲットアプリケーション統合のセットアップ時に発行される一意の文字列です。

注:

利用可能な場合は、サービス認証方法として常にOAuth 2.0を使用することをお勧めします。OAuth 2.0は、統合が、構成済みのマイクロアプリとの最大限のセキュリティコンプライアンスを満たすことを保証します。

Citrix GatewayがZoomのシングルサインオンに対応するように構成して、ユーザーがログインすると、再度資格情報を入力しなくても自動的に再ログインできるようにします。SSOの構成について詳しくは、「Citrix Gatewayサービスhttps://docs.citrix.com/en-us/citrix-gateway-service/」を参照してください。

統合ではZoomインスタンスへの定期的なアクセスが必要なので、Zoomで専用のユーザーアカウントを作成することをお勧めします。https://marketplace.zoom.us/docs/api-reference/other-references/privilegesで権限/特権を表示できます。このアカウントには、次の権限が必要です:

  • サービスアカウントに必要な権限:完全な管理者特権

特定のリソースに対して実行できるAPI要求の数は限られているため、以下をお勧めします:

新しいサービスアカウントの作成

次にサインインします: https://zoom.us/signin。新しいサービスアカウントについては、以下のURLを参照してください:https://marketplace.zoom.us/docs/guides/getting-started

OAuthサーバーの構成

Zoom統合を介してデータを読み取るようにOAuthサーバーを構成します。

  1. 次の場所にサービスアカウントでログインします:https://marketplace.zoom.us/
  2. 右上の [Develop] ドロップダウンメニューを選択します。
  3. [Build App] 選択します。
  4. OAuthアプリ用に [Create] を選択し、[Account-Level App] としてアプリタイプを選択します。
  5. アプリをマーケットプレイスに公開するためのトグルを無効にして、[Create] を選択します。
  6. この統合に対して次の許可されたリダイレクトURLを [Redirect URL] フィールドと [Whitelist URL] フィールドに入力します。次に、[Continue] を選択します。

    • https://{yourmicroappserverurl}/admin/api/gwsc/auth/serverContext
  7. 必須フィールドに入力して、[Continue] を選択します。
  8. [Scopes]セクションで、[Add Scopes] を選択し、[Add Scopes][Recording]、および [User] を選択します。次に、[Done] を選択します。
  9. [Install] を選択します。アプリを承認するための新しいタブが開き、[Install] を選択してタブを閉じます。
  10. 画面に表示されているClientIdSecretをコピーして保存します。統合を構成するときに、これらの詳細をサービス認証に使用します。

OAuthクライアントの構成

Zoom統合を通じてデータをライトバックするようにOAuthクライアントを構成します。

  1. 上記のように、サービスアカウントでログインします: https://marketplace.zoom.us/
  2. 右上の [Develop] ドロップダウンメニューを選択します。
  3. [Build App] 選択します。
  4. OAuthアプリ用に [Create] を選択し、[User-Managed App] としてアプリタイプを選択します。
  5. アプリをマーケットプレイスに公開するためのトグルを無効にして、[Create] を選択します。
  6. この統合に対して次の許可されたリダイレクトURLを [Redirect URL] フィールドと [Whitelist URL] フィールドに入力します。次に、[Continue] を選択します。

    • <https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback>
  7. 必須フィールドに入力して、[Continue] を選択します。
  8. [Scopes]セクションで、[Add Scopes] を選択し、[Add Scopes][Recording]、および [User] を選択します。次に、[Done] を選択します。
  9. [Install] を選択します。アプリを承認するための新しいタブが開き、[Install] を選択してタブを閉じます。
  10. 画面に表示されているClientIdSecretをコピーして保存します。統合を構成するときに、これらの詳細をサービスアクション認証に使用します。

統合の追加

Zoomミーティング統合をCitrix Workspaceマイクロアプリに追加して、アプリケーションに接続します。認証オプションは事前に選択されています。プロセスの完了時に、これらのオプションが選択されていることを確認してください。これにより、通知とアクションが設定済みとなっている追加設定不要のマイクロアプリを、Workspace内で使用できるようになります。

次の手順を実行します:

  1. [マイクロアプリ統合] ページで [新しい統合を追加] および [Citrix提供のテンプレートから新しい統合を追加する] を選択します。
  2. Zoomミーティングタイルを選択します。
  3. 統合の [統合名] を入力します。
  4. コネクタのパラメーターを入力します。
    • インスタンスの [ベースURL] を入力します:https://api.zoom.us/v2/
    • アイコンライブラリから統合のアイコンを選択するか、デフォルトのアイコンのままにしておきます。

    名前とベースURL

  5. [サービス認証][認証方法] メニューから [OAuth 2.0] を選択して認証の詳細を完了します。認証オプションは事前に選択されています。プロセスの完了時に、これらのオプションが選択されていることを確認してください。OAuth 2.0セキュリティプロトコルを使用して、委任されたアクセスの要求/承認トークンを生成します。利用可能な場合は、サービス認証方法として常にOAuth 2.0を使用することをお勧めします。OAuth 2.0は、統合が、構成済みのマイクロアプリとの最大限のセキュリティコンプライアンスを満たすことを保証します。

    1. [許可の種類] メニューで [認証コード] を選択します。これによって、クライアントが交換するアクセストークン用の一時コードが付与されます。コードは認証サーバーから取得され、そこでクライアントが要求している情報を確認できます。この許可の種類のみが、安全なユーザーの偽装を有効にします。これにより、アプリケーションの登録時に使用する [コールバックURL] が表示されます
    2. [トークン認証] メニューから [認証ヘッダー] を選択します。
    3. [認証URL] は事前に入力されています: https://zoom.us/oauth/authorize
    4. [トークンURL] は事前に入力されています: https://zoom.us/oauth/token
    5. スコープに以下が入力されていることを確認します:meeting:read:admin,recording:read:admin,user:read:admin meeting:read,meeting:write

      注:

      「Create a Meeting」マイクロアプリを有効にする場合:meeting:read,meeting:write, meeting:read:admin 、Upcoming Meetings(Current Week)」マイクロアプリを有効にする場合:meeting:read,meeting:write, meeting:read:admin 、「My Office Hours」マイクロアプリを有効にする場合:meeting:read,meeting:write, meeting:read:admin 、「Meeting Recordings」マイクロアプリを有効にする場合:recording:read:admin

    6. [クライアントID] を入力します。クライアントIDは、承認サーバーに固有のクライアント登録情報を表す文字列です。OAuthサーバーを構成したときに、クライアントIDとシークレットを収集します。統合構成ページに表示される [コールバックURL] を追加する必要があります。
    7. [クライアントシークレット] を入力します。クライアントシークレットは、ターゲットアプリケーション統合のセットアップ時に発行される一意の文字列です。

    サービス認証

  6. [サービスアクション認証][[アクション]で個別のユーザー認証を使用する] トグルを有効にします。サービスアクション認証は、サービスアクションレベルで認証します。認証オプションは事前に選択されています。プロセスの完了時に、これらのオプションが選択されていることを確認してください。

    1. [認証方法] メニューから [OAuth 2.0] を選択して認証の詳細を完了します。
    2. [許可の種類] メニューで [認証コード] を選択します。これによって、クライアントが交換するアクセストークン用の一時コードが付与されます。コードは認証サーバーから取得され、そこでクライアントが要求している情報を確認できます。この許可の種類のみが、安全なユーザーの偽装を有効にします。これにより、アプリケーションの登録時に使用する [コールバックURL] が表示されます
    3. [トークン認証] メニューから [認証ヘッダー] を選択します。
    4. [認証URL] は事前に入力されています: https://zoom.us/oauth/authorize
    5. [トークンURL] は事前に入力されています: https://zoom.us/oauth/token
    6. [クライアントID] を入力します。クライアントIDは、承認サーバーに固有のクライアント登録情報を表す文字列です。OAuthクライアントを構成したときに、クライアントIDとシークレットを収集します。統合構成ページに表示される [コールバックURL] を追加する必要があります。
    7. [クライアントシークレット] を入力します。クライアントシークレットは、ターゲットアプリケーション統合のセットアップ時に発行される一意の文字列です。

    サービスアクション認証

  7. [要求レート制限を有効にする] トグルを有効にします。[要求数]「55」 と入力し、[時間間隔]「1秒」と入力します。

    レート制限とログの切り替え

  8. (オプション)サポートのために24時間のログを保持するには、[ログ] を有効にします。
  9. [保存] を選択して続行します。
  10. [OAuth認証][承認] を選択して、サービスアカウントにログインします。Zoomのログイン画面がポップアップで表示されます。
    1. サービスアカウントのユーザー名とパスワードを入力し、[ログイン] を選択します。
    2. [同意] を選択します。 サービス認証

[マイクロアプリ統合] ページが開き、追加した統合とそのマイクロアプリが表示されています。ここから別の統合を追加したり、追加設定不要のマイクロアプリのセットアップを続行したり、この統合用の新しいマイクロアプリを作成したりできます。

これで、最初のデータ同期を設定して実行する準備ができました。統合アプリケーションからマイクロアプリプラットフォームに大量のデータをプルできるので、[テーブル] ページを使用して、最初のデータ同期のエンティティをフィルタリングし、同期を高速化することをお勧めします。詳しくは、「必要なエンティティの確認」を参照してください。同期ルール、スケジュールを満たさない同期、および拒否ルールの詳細については、「データの同期」を参照してください。

APIエンドポイントとテーブルエンティティについて詳しくは、「Zoom HTTPコネクタの仕様」を参照してください。アクセスと利用者の管理について詳しくは、「利用者を割り当てる」を参照してください 。統合を削除するには、[マイクロアプリ統合] ページから、アンインストールする統合の横にあるメニューを選択します。[統合の削除] を選択して確認します。

Zoom用マイクロアプリの使用

既存のアプリケーション統合には、追加設定不要のマイクロアプリが付属しています。これらのマイクロアプリから開始して、ニーズに合わせてカスタマイズします。

ミーティングの作成: 好みに応じてミーティングをスケジュールします。ユーザーは、ミーティングのタイトル、期間、開始日、共同ホストなどを選択できます。

通知またはページ ユースケースワークフロー
ミーティングの作成ページ ユーザー設定に従って、次の詳細情報でミーティングをスケジュールするためのフォームを提供します:ミーティングのタイトル、開始時間、期間、繰り返し(1回、毎日、毎週、毎月)、パスワード、共同ホスト、ミーティングのダイヤルイン番号。
新しい1回限りのミーティングページ このページには、1回限りのミーティングを [詳細を表示] ボタンを使用して作成した場合の成功メッセージが表示されます。
新しい定期的なミーティングページ このページには、作成されたミーティングの成功メッセージと、定期的なミーティングの [詳細を表示] ボタンが表示されます。
招待ページ ミーティングのトピック、パスワード、カレンダーの詳細、頻度の詳細、参加URL、開始時間、ミーティングID、ダイヤルイン番号など、ミーティングの作成後すぐに招待状の詳細を提供します。

近日中の会議(今週): 今週予定されているすべてのミーティングを表示します。ユーザーはミーティングを編集して開始できます。

通知またはページ ユースケースワークフロー
1回限りの会議リマインダー通知 1回限りのミーティングの開始時間が1時間未満の場合、ミーティングのホストは通知を受け取ります。
定期的な会議リマインダー通知 定期的なミーティングの開始時間が1時間未満の場合、ミーティングのホストは通知を受け取ります。
すべての会議ページ トピックに基づいてミーティングをフィルタリングする検索オプションを使用して、今週の1回限りのミーティングおよび定期的なミーティングの今後のすべてのミーティングに関する情報を提供します。
1回限りの会議詳細ページ [Edit]ボタンと[Start]ボタンのオプションを使用して、ミーティングのトピック、パスワード、カレンダーの詳細、参加URL、開始時間、ミーティングID、ダイヤルイン番号など、今後の1回限りのミーティングの招待状の詳細を提供します。
定期的な会議詳細ページ [Edit]ボタンと[Start]ボタンのオプションを使用して、ミーティングのトピック、パスワード、カレンダーの詳細、定期的な詳細、参加URL、開始時間、ミーティングID、ダイヤルイン番号など、今後の1回限りのミーティングの招待状の詳細を提供します。
1回限りの会議編集ページ ユーザー設定に従って、次の詳細情報で1回限りのミーティングを編集するためのフォームを提供します:ミーティングのタイトル、開始時間、期間、タイムゾーン、頻度(1回、毎日、毎週、毎月)、パスワード、共同ホスト。
定期的な会議編集ページ ユーザー設定に従って、次の詳細情報で1回限りのミーティングを編集するためのフォームを提供します:ミーティングのタイトル、開始時間、期間、タイムゾーン、頻度(1回、毎日、毎週、毎月)、パスワード、共同ホスト。この頻度を保存し、すべての頻度を保存するオプション付き。
1回限りの会議リマインダーページ ミーティングのトピック、パスワード、カレンダーの詳細、参加URL、開始時間、ミーティングID、[Start]ボタンと[Close]ボタンのオプションを備えたダイヤルイン番号など、今後の1回限りのミーティングに関する招待状の詳細を提供します。
定期的な会議リマインダーページ ミーティングのトピック、パスワード、カレンダーの詳細、参加URL、開始時間、ミーティングID、[Start]ボタンと[Close]ボタンのオプションを備えたダイヤルイン番号など、今後の定期的なミーティングに関する招待状の詳細を提供します。

自分の業務時間: 好みに応じて、業務時間ミーティングをスケジュール設定します。ユーザーは、期間、開始日、ダイヤルイン番号などを選択できます。

通知またはページ ユースケースワークフロー
Virtual Office Hours 今月のテーブルにスケジュールされた業務時間ミーティングの詳細を提供します。このページは、今月のミーティングをスケジュールしなかった場合に、ユーザーがその分の業務時間を作成するのにも役立ちます。
Setup Virtual Hours ユーザー設定に従って、次の詳細情報で常務時間ミーティングをスケジュールするためのフォームを提供します:開始時間、日付、期間、タイムゾーン、頻度(1回、毎日、毎週、毎月)、パスワード、ミーティングのダイヤルイン番号。
新しいミーティング 「View Detail」ボタンを使用してミーティングが正常に作成されると、成功メッセージが表示されます。
招待 ミーティングのトピック、パスワード、カレンダーの詳細、頻度の詳細、参加URL、開始時間、ミーティングID、ダイヤルイン番号など、ミーティングの作成後すぐに招待状の詳細を提供します。
Edit Office Hours 開始時刻、期間、日付などの次のフィールドのユーザー設定に従って、スケジュールされた業務時間ミーティングをユーザーが編集できるようにします。

会議録画: 過去7日間のすべての会議の録画を表示します。また、ユーザーは任意のデバイスから録画を再生できます。

通知またはページ ユースケースワークフロー
会議録画通知 新しいミーティングの録画が使用可能になると、ミーティングのホストは通知を受け取ります。
録画表ページ 過去7日間のホストのすべてのミーティング録画を表示する表が表示されます。
Recording Details [Play Recording]ボタンのオプションを使用して、ミーティングのトピック、日付、時刻、ダウンロードURLなどのレコーディングの詳細情報を提供します。
Zoomの統合