En esta página de documentación se describe la API que se usa al cambiar la contraseña del administrador de Horizon Connection Server en el sistema de Active Directory. En este caso práctico, se utiliza esta API para que Horizon Cloud Connector utilice el nuevo valor.
Esta función es compatible con Horizon Cloud Connector 2.4 y versiones posteriores.
Horizon Cloud Connector utiliza las credenciales de administrador que se introdujeron durante el proceso de incorporación y emparejamiento para comunicarse con Horizon Connection Server.
A lo largo del tiempo, es posible que esas credenciales de administrador cambien en el dominio de Active Directory, caduquen o dejen de ser válidas. Si el dispositivo de Horizon Cloud Connector no recibe información acerca de las credenciales nuevas cuando las credenciales de administrador se actualizan en el dominio de Active Directory, Horizon Cloud Connector perderá la conectividad con Horizon Connection Server.
Cuando necesite actualizar la contraseña del administrador, puede utilizar esta API para actualizar la que está almacenada en el dispositivo de modo que coincida con el valor configurado en la cuenta de dominio de Active Directory.
- Endpoint de API
-
El endpoint del dispositivo para actualizar la contraseña almacenada es
https://appliance-address/viewproxyadapter/local/config/rotate.
appliance-address puede ser una de las siguientes opciones:
- https://IP-address/viewproxyadapter/local/config/rotate, donde IP-address es la dirección IP del dispositivo.
- https://FQDN/viewproxyadapter/local/config/rotate, si asignó la dirección IP del dispositivo a un FQDN en el servidor DNS.
- Método de API
- PUT
- Carga útil de solicitud
-
La carga útil requiere el nombre de dominio DNS de Active Directory y la contraseña almacenada en el dispositivo (la contraseña anterior) y la nueva contraseña.
Para las contraseñas, entrecomille cada letra y sepárelas con comas. En el ejemplo siguiente, la contraseña almacenada en el dispositivo es abcd!efg y tuvw$xyz es la nueva contraseña.
{ "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"] } - Cuándo se invoca la API
-
Horizon Cloud Connector compara las credenciales existentes que se proporcionan en la carga útil de la API con las almacenadas en el dispositivo de
Horizon Cloud Connector.
Si la validación se realiza correctamente, el sistema intenta iniciar sesión en Horizon Connection Server con las nuevas credenciales proporcionadas en la carga útil de la API.
Si ese intento de inicio de sesión se realiza correctamente, los servicios del dispositivo se vuelven a cargar para obtener las nuevas credenciales y empezar a utilizarlas.
Nota: La frecuencia de esta API está limitada a una solicitud por minuto. Si los intentos superan el límite de frecuencia, se devuelve el error de HTTP 429 (Demasiadas solicitudes). - Autorización de API
- La comprobación de autorización se realiza comparando los valores de domain, userName y oldPassword proporcionados en la carga útil de solicitud con las credenciales que conoce Horizon Cloud Connector. Las credenciales conocidas son las que se proporcionaron durante el proceso de incorporación y emparejamiento o en una rotación de credenciales anterior mediante esta API.
Requisitos previos
Antes de emitir el comando de la API, compruebe que se dan las siguientes circunstancias.
- Horizon Cloud Connector se empareja con el pod de Horizon, con la instancia de Horizon Connection Server del pod.
- Tiene el nombre DNS del dominio de Active Directory y credenciales de administrador de Horizon Connection Server.
- En el dominio de Active Directory, actualizó la contraseña de la cuenta de administrador de Horizon Connection Server a la nueva contraseña que desea utilizar.
- Tiene la contraseña utilizada anteriormente, la existente que conoce el dispositivo de Horizon Cloud Connector, que utiliza actualmente el dispositivo.
Procedimiento
- ♦Envíe una solicitud PUT al endpoint de API https://appliance-address/viewproxyadapter/local/config/rotate con la carga útil de solicitud.
En el siguiente ejemplo, el dominio de AD es ejemplo.com, el nombre de la cuenta es CSadmin, la contraseña anterior es abcd!efg y la nueva contraseña es tuvw$xyz.
{ "domain":"example.com", "userName":"CSadmin", "oldPassword":["a","b","c","d","!","e","f","g"], "newPassword":["t","u","v","w","$","x","y","z"] }Cuando las contraseñas se rotan adecuadamente, se devuelve la respuesta 200 correcto.
