Citrix Endpoint Management

API REST

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

  • Appeler les services qui sont affichés dans la console Citrix Endpoint Management
  • Appeler les services REST à l’aide d’un client REST quelconque

L’API n’exige pas de connexion à la console Citrix Endpoint Management pour appeler les services.

Pour consulter une liste complète des API actuellement disponibles, téléchargez le PDF Public API for REST Services.

Des API sont disponibles pour gérer vos terminaux mobiles et de bureau et configurer les paramètres de vos applications Workspace. Accédez à https://developer.cloud.com/citrixworkspace, puis à Citrix Endpoint Management > Intégration d’applications mobiles.

Autorisations requises pour accéder à l’API REST

Pour accéder à l’API REST, vous devez disposer de 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 rôle. Pour plus d’informations, veuillez consulter la section Configuration de rôles avec RBAC.
  • Autorisation de super utilisateur

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

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

Citrix Cloud crée ensuite l’ID client sécurisé et la clé secrète 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 identificateurs uniques après la fermeture de la boîte de dialogue.

Pour appeler les services D’API REST

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

Remarque :

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

Connexion

L’exemple illustré 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 des développeurs.

Exemple de réponse :

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

Informations connexes

API REST