Zoom スポーク の設定

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：5分

    • Zoom アカウントを ServiceNow インスタンスと統合し、Zoom スポークを使用して Zoom アカウントでさまざまなアクションを実行できるようにします。Zoom アカウントでカスタム OAuth アプリケーションを作成して、 インスタンスからの要求の認証を可能にすることもできます。

    始める前に

    • 統合ハブ サブスクリプションの要求。
    • Zoom スポーク のアクティブ化。

    必要なロール：admin

    Zoomに接続済みアプリを作成

    Zoom アカウントに接続済みアプリを作成し、Zoom API と Zoom スポーク の Now Platform の間で OAuth 2.0 レベルの認証を確立します。接続済みアプリを作成したら、Zoom スポーク からさまざまなアクションを実行できるようにするスコープを追加できます。

    始める前に

    1. Zoom アカウントを作成します
    2. 必要なロール：Zoom admin

    このタスクについて

    接続済みアプリの作成は 1 回限りのアクティビティです。

    手順

    1. Zoom マーケットプレイスにログインします。
    2. 移動先 開発 > アプリをビルド.
    3. OAuth カードで、[作成] をクリックします。
    4. [アプリ名] ボックスに、カスタムアプリ名を入力します。
    5. [アカウントレベルのアプリ (Account-level app)] をクリックします。
    6. トグルボタンを使用して、[Zoom App Marketing にこのアプリを公開しますか？(Would you like to publish this app on Zoom App Marketplace?)] オプションを無効にします。
    7. [作成] をクリックします。
    8. [アプリの認証情報 (App Credentials)] 画面で、次のアクションを実行します。
      1. 自動生成されたクライアント ID をコピーするには、[クライアント ID] フィールドで [コピー] をクリックします。
        クライアント ID は、Zoom API へのアクセスを許可する前に OAuth アプリが検証する Zoom スポーク の ID です。ID を安全な場所に保存します。
      2. クライアントシークレットをコピーするには、[クライアントシークレット] フィールドで [コピー] をクリックします。
        クライアントシークレットを使用して新しいトークンを取得します。シークレットを安全な場所に保存します。
      3. オプション: クライアントシークレットを再生成するには、[クライアントシークレット] フィールドで [再生成] をクリックします。
      4. [OAuth の URL をリダイレクト (Redirect URL for OAuth)] フィールドで、ServiceNow インスタンス名を https://<ServiceNow-Instance-Name>.service-now.com/oauth_redirect.do の形式で入力します。
      5. [OAuth 許可リスト (OAuth Allow List)] で、ServiceNow インスタンスのリダイレクト URL を https://<ServiceNow-Instance-Name>.service-now.com/oauth_redirect.do の形式で追加します。
        トークンが生成されます。このトークンは、Zoom スポークに Zoom API へのアクセス権を付与するために OAuth アプリで使用されます。
      6. オプション: 許可リストに別の URL を追加するには、[新しいリストを追加] をクリックします。
      次の例は、OAuth アプリの認証情報を生成するために使用する画面を示しています。
      図 : 1. Zoom スポークの OAuth 認証情報構成
      Zoom スポークの OAuth 認証情報構成。
      注:
      OAuth のリダイレクト URL と [OAuth 許可リスト (OAuth Allow List)] に表示される URL の違いについては、「Zoom Developer Forum (Zoom 開発者フォーラム)」を参照してください。
    9. 次の例に示すように、[スコープ] をクリックします。
      図 : 2. 接続済みアプリ画面のスコープオプション
      接続済みアプリ画面のスコープオプション。
    10. [スコープの追加 (Add Scopes)] 画面で、[スコープの追加 (Add Scopes)] をクリックします。
    11. 次の図に示すように、スコープ名をクリックしてからスコープを選択します。
      次の例は、Zoom スポークでさまざまなアクションを実行できるようにするさまざまなスコープの追加方法を示しています。
      図 : 3. Zoom 会議のスコープを追加
      Zoom 会議のスコープを追加する。
      図 : 4. Zoom 会議の記録スコープを追加
      Zoom 会議の記録スコープを追加する。
      図 : 5. ユーザーの Zoom アカウントの情報を表示および管理するためのスコープを追加
      ユーザーの Zoom アカウントの情報を表示および管理するためのスコープを追加する。
      注:
      図 : 6. Zoom チャットのスコープを追加
      Zoom チャットのスコープを追加する。
      選択したスコープのアクションが Zoom スポーク で使用できるようになります。
    12. [完了] をクリックします。

    ServiceNow インスタンスに Zoom 接続を追加

    Zoom アカウントの構成中に生成された情報を使用し、Zoom スポーク を OAuth プロバイダーとして登録して、インスタンスが OAuth 2.0 トークンを要求できるようにします。ワークフロースタジオ で Zoom 接続を追加して、Zoom のアクションを実行します。

    始める前に

    必要なロール：admin

    手順

    1. ServiceNowインスタンスから、 プロセスの自動化 > Flow Designer.
      フローデザイナーが新しいタブで起動します。
    2. [接続] タブをクリックします。
    3. [Zoom] 接続エイリアスを見つけて、[詳細を表示] をクリックします。
      • Zoom スポークに付属するデフォルトの接続および資格情報エイリアスレコードを構成するには、[詳細を表示] をクリックします。
      • 複数の Zoom スポーク接続レコードを管理するには、[接続を追加] をクリックして新しい子エイリアスレコードを作成する必要があります。複数の接続の使用の詳細については、「複数接続のサポート」を参照してください。
      スポークを初めて設定する場合は、[設定 (Configure)] をクリックします。それ以外の場合は、[編集] をクリックします。
    4. フォームに、これらの値を入力します。
      フィールド 説明
      接続名 接続レコードを識別する名前です。
      接続 URL Zoom インスタンスに接続するためのベース URL 「https://api.zoom.us」と入力します。
      OAuth エンティティ名 アプリケーションレジストリレコードを識別する名前です。
      OAuth クライアント ID アプリケーション登録時に作成したクライアント ID。
      OAuth クライアントシークレット アプリケーション登録時に作成したクライアントシークレット
      OAuth リダイレクト URL OAuth コールバックエンドポイント。https://<instance-name>.service-now.com/oauth_redirect.do と入力します。

      OAuth トークンを生成します。

    5. [OAuth トークンを設定して取得 (Configure and get OAuth Token)] をクリックします。
      トークンが利用可能である旨の確認メッセージが表示されます。リフレッシュトークンが利用可能である旨の確認。