Citrix Endpoint Management

API REST

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

  • appeler les services qui sont exposés au travers de la console Endpoint Management
  • Appeler les services REST à l’aide d’un client REST quelconque

L’API n’exige pas de connexion à la console 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.

Pour les environnements Endpoint Management compatibles avec Workspace, nous disposons d’API pour gérer vos points de terminaison mobiles et de bureau, ainsi que pour 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 de plus amples informations, consultez 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 de plus amples informations, consultez la documentation du développeur.

Exemple de réponse :

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

Informations connexes

API REST