Zendesk 設定

本頁說明如何先設定驗證和權限,再建立 Zendesk 資料儲存庫。

啟用權杖存取權

如要允許 Zendesk 驗證及與 Zendesk 執行個體互動,您必須啟用權杖存取權。請按照下列步驟啟用權杖存取權:

  1. 前往 Zendesk 執行個體,然後使用管理員帳戶登入。
  2. 在導覽選單中展開「應用程式和整合」,然後從「API」選取「API 設定」
  3. 勾選「允許 API 權杖存取」核取方塊
  4. 按一下 [儲存]

設定驗證和權限

如要使用 OAuth 2.0 安全地整合應用程式,您必須在 Zendesk 中註冊應用程式,才能取得必要的用戶端 ID 和用戶端密碼。

建立 OAuth 用戶端並取得驗證憑證

如要在 Zendesk 中建立 OAuth 用戶端並取得驗證憑證,請按照下列步驟操作:

  1. 前往 Zendesk 執行個體,然後使用管理員帳戶登入。

  2. 按一下 Zendesk 產品圖示,然後選取「管理中心」

    Zendesk 管理中心介面。
    Zendesk 管理中心
  3. 在導覽選單中展開「應用程式和整合」,然後從「API」選取「OAuth 用戶端」

  4. 按一下「新增 OAuth 用戶端」

  5. 輸入下列用戶端詳細資料:

    • 名稱:輸入應用程式的描述性名稱。
    • 選用:說明:輸入簡短說明。
    • 選填:公司:輸入公司名稱。
    • 選填:標誌:提供標誌,這會顯示在同意畫面中。
    • 專屬 ID (用戶端 ID):為用戶端提供專屬名稱。你可以編輯初始建議,但必須是獨一無二的名稱。
    • 用戶端類型:如果應用程式在瀏覽器或行動裝置上執行,請選取「公開」;如果應用程式在安全伺服器上執行,請選取「機密」
    • 重新導向網址 (必填):輸入 https://vertexaisearch.cloud.google.com/oauth-redirect。這是 Zendesk 在授權後重新導向的網址,用於接收授權碼。
  6. 按一下「儲存」即可取得用戶端密鑰。

    • 用戶端 ID:「專屬 ID」欄位中的值。
    • 用戶端密碼:系統會顯示新的「密碼」欄位。複製這組密鑰,並立即儲存在安全的位置。為確保安全,完整密鑰只會顯示一次,如果遺失,就必須重新產生。
    介面中顯示產生的用戶端密鑰。
    產生的用戶端憑證
  7. 再次按一下「儲存」,即可完成變更。

設定權限

如要設定必要權限,請按照下列步驟操作:

  1. 前往 Zendesk 執行個體,然後使用管理員帳戶登入。
  2. 按一下 Zendesk 產品圖示,然後選取「管理中心」
  3. 在導覽選單中展開「應用程式和整合」,然後從「連線」選取「OAuth 用戶端」
  4. 按一下「Add client」
  5. 輸入下列用戶端詳細資料:

    • 名稱:輸入描述性名稱。設定後即無法變更。
    • OAuth 授權類型:選取「授權碼」
    • 用戶端 ID:輸入從「在 Zendesk 中建立 OAuth 用戶端」一節取得的用戶端 ID。
    • 用戶端密鑰:輸入從「在 Zendesk 中建立 OAuth 用戶端」一節取得的用戶端密鑰值。
    • 授權網址:授權端點通常採用 https://<var>your-subdomain</var>.zendesk.com/oauth/authorize 格式。請將 <var>your-subdomain</var> 替換成實際的 Zendesk 子網域。
    • 權杖網址:權杖端點通常採用 https://<var>your-subdomain</var>.zendesk.com/oauth/token 格式。請將 <var>your-subdomain</var> 替換成實際的 Zendesk 子網域。
      在 Zendesk 管理中心輸入 API 範圍的欄位。
      新增範圍
    • 範圍:根據連線模式,以空格分隔輸入下列範圍:
    連線模式 範圍 目的 需要管理員同意
    聯合搜尋 readusers:read 可搜尋 Zendesk 資料。
  6. 按一下 [儲存]