Zendesk の構成

このページでは、Zendesk データストアを作成する前に認証と権限を設定する方法について説明します。

トークン アクセスを有効にする

Zendesk が認証を行い、Zendesk インスタンスとやり取りできるようにするには、トークン アクセスを有効にする必要があります。トークン アクセスを有効にする手順は次のとおりです。

  1. Zendesk インスタンスに移動し、管理者アカウントでログインします。
  2. ナビゲーション メニューで [アプリとインテグレーション] を開き、[API] から [API 構成] を選択します。
  3. [API トークン アクセスを許可] チェックボックスをオンにします。
  4. [保存] をクリックします。

認証と権限を設定する

OAuth 2.0 を使用して安全に統合するには、Zendesk にアプリケーションを登録して、必要なクライアント ID とクライアント シークレットを取得する必要があります。

OAuth クライアントを作成して認証情報を取得する

Zendesk で OAuth クライアントを作成して認証情報を取得する手順は次のとおりです。

  1. Zendesk インスタンスに移動し、管理者アカウントでログインします。

  2. Zendesk Products アイコンをクリックし、[Admin Center] を選択します。

    Zendesk 管理センターのインターフェース。
    Zendesk 管理センター

  3. ナビゲーション メニューで [アプリと統合] を展開し、[API] から [OAuth クライアント] を選択します。

  4. [OAuth クライアントを追加] をクリックします。

  5. 次のクライアントの詳細を入力します。

    • 名前: アプリケーションのわかりやすい名前を入力します。
    • 省略可: 説明: 簡単な説明を入力します。
    • 省略可: 会社: 会社名を入力します。
    • 省略可: ロゴ: 同意画面に表示されるロゴを指定します。
    • 一意の識別子（クライアント ID）: クライアントの一意の名前を指定します。最初の候補は編集できますが、一意である必要があります。
    • クライアントの種類: ブラウザまたはモバイル デバイスで実行されるアプリケーションの場合は [公開] を選択し、安全なサーバーで実行されるアプリケーションの場合は [機密] を選択します。
    • リダイレクト URL（必須）: https://vertexaisearch.cloud.google.com/oauth-redirect と入力します。これは、認証後に Zendesk がリダイレクトする URL で、認証コードを受け取ります。

  6. [保存] をクリックして、クライアント シークレットを取得します。

    • クライアント ID: [一意の識別子] フィールドの値。
    • クライアント シークレット: 新しい [シークレット] フィールドが表示されます。このシークレットをコピーして、すぐに安全な場所に保存します。セキュリティのため、シークレット全体は 1 回だけ表示されます。紛失した場合は、再生成する必要があります。
    生成されたクライアント シークレットがインターフェースに表示されます。
    生成されたクライアント認証情報

  7. もう一度 [保存] をクリックして、変更を確定します。

権限を設定する

必要な権限を設定する手順は次のとおりです。

  1. Zendesk インスタンスに移動し、管理者アカウントでログインします。
  2. Zendesk Products アイコンをクリックし、[Admin Center] を選択します。
  3. ナビゲーション メニューで [アプリと統合] を展開し、[接続] から [OAuth クライアント] を選択します。
  4. [クライアントを追加] をクリックします。

  5. 次のクライアントの詳細を入力します。

    • 名前: わかりやすい名前を入力します。これは変更できません。
    • OAuth 付与タイプ: [認証コード] を選択します。
    • クライアント ID: Zendesk で OAuth クライアントを作成するセクションで取得したクライアント ID を入力します。
    • クライアント シークレット: Zendesk で OAuth クライアントを作成するセクションで取得したクライアント シークレットの値を入力します。
    • Authorize URL: 認証エンドポイントは通常、https://<var>your-subdomain</var>.zendesk.com/oauth/authorize の形式です。<var>your-subdomain</var> は、実際の Zendesk サブドメインに置き換えます。
    • トークン URL: トークン エンドポイントは通常、https://<var>your-subdomain</var>.zendesk.com/oauth/token の形式です。<var>your-subdomain</var> は、実際の Zendesk サブドメインに置き換えます。
      Zendesk 管理センターで API スコープを入力するためのフィールド。
      スコープを追加
    • スコープ: 接続モードに基づいて、次のスコープをスペースで区切って入力します。
    接続モード スコープ 目的
    連携検索 read、users:read Zendesk データ全体で検索を実行するために必要です。
    連携検索とアクション tickets:write 検索とチケットの作成に必要です。

  6. [保存] をクリックします。