Citrix Endpoint Management™

API REST

  • Avec l’API REST Citrix Endpoint Management, vous pouvez :

  • Appeler des services qui s’affichent dans la console Citrix Endpoint Management
  • Appeler des services REST à l’aide de n’importe quel client REST

L’API ne vous oblige pas à vous connecter à la console Citrix Endpoint Management pour appeler les services.

Autorisations requises pour accéder à l’API REST

L’accès à l’API REST nécessite l’une des autorisations suivantes :

  • Administrateur Citrix Cloud
  • Autorisation d’accès à l’API publique définie dans le cadre de la configuration de l’accès basé sur les rôles. Pour plus d’informations, consultez Configuration des rôles avec RBAC.
  • Autorisation Super utilisateur

Pour accéder à l’API REST à l’aide de votre compte Citrix Cloud, générez les clés API :

  1. Dans le menu Citrix Cloud, sélectionnez Gestion des identités et des accès.
  2. Sélectionnez Accès API > Clients sécurisés.
  3. Saisissez un nom pour votre client sécurisé et cliquez sur Créer un client.

Citrix Cloud crée ensuite l’ID client sécurisé et le secret client. Téléchargez une copie de ces informations et enregistrez-les en toute sécurité hors ligne pour votre référence. Citrix Cloud ne stocke pas les identifiants uniques après la fermeture de la boîte de dialogue.

Pour invoquer les services de l’API REST

Vous pouvez appeler les services de l’API REST à l’aide du client REST ou des commandes cURL. Les exemples suivants utilisent le client REST avancé pour Chrome.

Remarque :

Dans les exemples suivants, modifiez le nom d’hôte et le numéro de port pour qu’ils correspondent à votre environnement.

Connexion

L’exemple présenté ici couvre la connexion à l’aide d’un jeton récupéré via l’API Citrix Cloud.

  • URL : https://<host-name>:<port-number>/xenmobile/api/v1/authentication/login/cloud

Type de méthode : POST

Type de contenu : application/json

Exemple de requête :

{
 "bearerToken": "eyJ0eOiJSUzJiibGcI1AiONiJ9.eyJkIjoMDExN1c2VIXiMzNDc1OTk4...qf0iQ"
}
<!--NeedCopy-->

Vous devez récupérer le jeton du porteur à l’aide de l’API Citrix Cloud https://trust.citrixworkspacesapi.net/Help/Api/POST-customer-tokens-clients. Pour plus d’informations, consultez la documentation du développeur.

Exemple de réponse :

{
 "auth_token": "q483409eu82mkfrcdiv90iv0gc:q483409eu82mkfrcdiv90iv0gc"
}
<!--NeedCopy-->

Informations connexes

API REST