Zendesk の構成

公開プレビュー版: 連携検索は公開プレビュー版です。この機能は、サービス固有規約の「一般サービス規約」セクションの「一般提供前サービス規約」の対象となります。pre-GA の機能は「現状のまま」で提供されるものであり、サポートが制限されることがあります。詳細については、リリース ステージの説明をご覧ください。

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

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

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

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

認証と権限を設定する

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

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

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

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

   注: インスタンス URL の形式は https://<var>your-subdomain</var>.zendesk.com です。

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

   

   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 サブドメインに置き換えます。

     

     スコープを追加

   • スコープ: 接続モードに基づいて、次のスコープをスペースで区切って入力します。

   接続モード	スコープ	目的	管理者の同意が必要
   連携検索	read、users:read	Zendesk データ全体を検索できます。	いいえ

   注: これらの詳細を構成する前に、Zendesk でトークン アクセスが有効になっていることを確認してください。

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