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 > API de service.

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 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 compte d’utilisateur local. Pour vous connecter à l’aide des informations d’identification du cloud, consultez le fichier PDF mentionné précédemment.

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

Requête : { "login":"administrator", "password":"password" }

Type de méthode : POST

Content-type : application/json

Charge utile de connexion et des en-têtes de requête et de réponse

Informations connexes

API REST