Citrix Endpoint Management™

REST-APIs

  • Mit der Citrix Endpoint Management REST-API können Sie:

  • Dienste aufrufen, die in der Citrix Endpoint Management-Konsole angezeigt werden
  • REST-Dienste mit einem beliebigen REST-Client aufrufen

Die API erfordert keine Anmeldung an der Citrix Endpoint Management-Konsole, um die Dienste aufzurufen.

  • Für den vollständigen aktuellen Satz verfügbarer APIs laden Sie das PDF Public API for REST Services herunter.

  • Es sind APIs verfügbar, um Ihre mobilen und Desktop-Endpunktgeräte zu verwalten und Einstellungen für Ihre Workspace-Apps zu konfigurieren. Gehen Sie zu https://developer.cloud.com/citrixworkspace und navigieren Sie zu Citrix Endpoint Management > Mobile Application Integration.

Erforderliche Berechtigungen für den Zugriff auf die REST-API

Der Zugriff auf die REST-API erfordert eine der folgenden Berechtigungen:

  • Citrix Cloud-Administrator
  • Berechtigung für den öffentlichen API-Zugriff, die als Teil der rollenbasierten Zugriffskonfiguration festgelegt wurde. Weitere Informationen finden Sie unter Konfigurieren von Rollen mit RBAC.
  • Superuser-Berechtigung

Um mit Ihrem Citrix Cloud-Konto auf die REST-API zuzugreifen, generieren Sie die API-Schlüssel:

  1. Wählen Sie im Citrix Cloud-Menü Identity and Access Management aus.
  2. Wählen Sie API Access > Secure Clients aus.
  3. Geben Sie einen Namen für Ihren sicheren Client ein und klicken Sie auf Create Client.

Citrix Cloud erstellt dann die sichere Client-ID und das Client-Geheimnis. Laden Sie eine Kopie dieser Informationen herunter und speichern Sie sie sicher offline zu Ihrer Referenz. Citrix Cloud speichert die eindeutigen Bezeichner nicht, nachdem Sie das Dialogfeld geschlossen haben.

Aufrufen der REST-API-Dienste

Sie können die REST-API-Dienste mit dem REST-Client oder cURL-Befehlen aufrufen. Die folgenden Beispiele verwenden den Advanced REST Client für Chrome.

Hinweis:

Ändern Sie in den folgenden Beispielen den Hostnamen und die Portnummer entsprechend Ihrer Umgebung.

Anmelden

Das hier gezeigte Beispiel behandelt die Anmeldung mit einem Token, das über die Citrix Cloud-API abgerufen wurde.

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

Methodentyp: POST

Content-Typ: application/json

Anfragebeispiel:

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

Sie müssen das Bearer-Token mithilfe der Citrix Cloud-API https://trust.citrixworkspacesapi.net/Help/Api/POST-customer-tokens-clients abrufen. Weitere Informationen finden Sie in der Entwicklerdokumentation.

Antwortbeispiel:

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

Verwandte Informationen

REST-APIs