Horizon Cloud Connector 2.4 及更新版本 - 更新 Horizon Cloud Connector 用於 Horizon Connection Server 的已登錄 Active Directory 認證

本說明文件頁面說明當您在 Active Directory 系統中輪替 Horizon Connection Server 管理員密碼時使用的 API。在此使用案例中，您可以使用此 API 讓Horizon Cloud連接器使用新值。

此功能支援與 Horizon Cloud Connector 2.4 版和更新版本搭配使用。

Horizon Cloud Connector 會使用在上架和配對程序中輸入的管理員認證與 Horizon Connection Server 進行通訊。

隨著時間的推移，您的Active Directory域中的這些管理員憑據可能會更改，或者過期或變得無效。如果在 Active Directory 網域中更新管理員認證時，未向 Horizon Cloud Connector 應用裝置通知新認證，則 Horizon Cloud Connector 會中斷與 Horizon Connection Server 的連線。

當您需要更新管理員密碼時，可以使用此 API 更新儲存在應用裝置中的管理員密碼，以符合Active Directory網域帳戶中設定的值。

• API 端點

  用於更新所儲存密碼的應用裝置端點為 https://appliance-address/viewproxyadapter/local/config/rotate

  其中，appliance-address 是下列其中一項：

  • https://IP-address/viewproxyadapter/local/config/rotate，其中 IP-address 是應用裝置的 IP 位址。
  • https://FQDN/viewproxyadapter/local/config/rotate（如果您已將應用裝置的 IP 位址對應至 DNS 伺服器中的 FQDN）。

• API 方法 PUT

• 要求裝載

  裝載需要Active Directory DNS 網域名稱、帳戶名稱、儲存在應用裝置中的密碼 （以前的密碼） 和新密碼。

  請將密碼的每個字母分別用引號括起來，並使用逗號分隔所括住的字母。在以下範例中，儲存在應用裝置中的密碼為 abcd!efg ， tuvw$xyz 而新密碼亦為。

  
  {
     "domain":"AD-dns-domain-name",
     "userName":"admin-account-name",
     "oldPassword":["a","b","c","d","!","e","f","g"],
     "newPassword":["t","u","v","w","$","x","y","z"]
  }
  

• 叫用 API 時

  Horizon Cloud Connector 會將您在 API 裝載中提供的現有認證，與儲存在 Horizon Cloud Connector 應用裝置中的認證進行比較。

  如果驗證成功，系統會嘗試使用 API 裝載中提供的新認證登入 Horizon Connection Server。

  如果該登入嘗試成功，應用裝置中的服務將重新載入以取得並開始使用新認證。

  注： 此 API 的速率限制為每分鐘一個要求。如果嘗試超過速率限制，則會傳回 HTTP 錯誤 429 （要求太多）。

• API 授權

  授權檢查的進行方式是將要求裝載中提供的 、 userName和oldPassword 與 Horizon Cloud Connector 已知的認證進行比較domain。已知認證是在上架和配對程序期間提供的認證，或是之前使用此 API 進行認證輪替時提供的認證。

先決條件

在發出 API 命令之前，請驗證以下項目。

• Horizon Cloud Connector 會與 Horizon 網繭以及網繭的 Horizon Connection Server 配對。
• 您擁有Active Directory網域的 DNS 名稱和 Horizon Connection Server 管理員認證。
• 在您的Active Directory域中，您已將 Horizon Connection Server 管理員帳戶的密碼更新為您要使用的新密碼。
• 您有先前使用過的密碼，即 Horizon Cloud Connector 應用裝置已知且正在使用的現有密碼。

程序

1. 向具有要求裝載的 API 端點https://appliance-address/viewproxyadapter/local/config/rotate發出。PUT

   在以下示例中，AD 域為 example.com，帳戶名為 CSadmin，以前的密碼為 abcd!efg，新密碼為 tuvw$xyz。

   
   {
      "domain":"example.com",
      "userName":"CSadmin",
      "oldPassword":["a","b","c","d","!","e","f","g"],
      "newPassword":["t","u","v","w","$","x","y","z"]
   }
   

   密碼輪換成功后，返回的回應為 200 success。

後續步驟

若要確認 Horizon Cloud Connector 使用更新後的密碼連線至 Horizon Connection Server，您可以登入 Horizon Cloud Connector 組態入口網站、按一下重新整理箭頭，然後確認連線伺服器狀態顯示為綠色。