Citrix Endpoint Management

REST-APIs

Mit der Citrix Endpoint Management-REST-API haben Sie folgende Möglichkeiten:

  • Aufrufen von Diensten, die in der Citrix Endpoint Management-Konsole angezeigt werden
  • Aufrufen von REST-Diensten über einen beliebigen REST-Client

Die API erfordert zum Aufrufen der Dienste keine Anmeldung an der Citrix Endpoint Management-Konsole.

Eine umfassende, aktuelle Liste der verfügbaren APIs finden Sie in der PDF-Datei Public API for REST Services.

Zur Verwaltung Ihrer mobilen und Desktop-Endgeräte und zur Konfiguration der Einstellungen für Ihre Workspace-Apps stehen APIs zur Verfügung. 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

Für den Zugriff auf die REST API ist eine der folgenden Berechtigungen erforderlich:

  • Citrix Cloud-Administrator
  • Zugriffsberechtigung für öffentliche APIs, die bei der Konfiguration des rollenbasierten Zugriffs festgelegt wird Informationen finden Sie unter Konfigurieren von Rollen mit RBAC.
  • Superuser-Benutzerberechtigung

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

  1. Klicken Sie im Menü “Citrix Cloud” auf Identitäts- und Zugriffsverwaltung.
  2. Wählen Sie API-Zugriff > Sichere Clients.
  3. Geben Sie einen Namen für den sicheren Client ein und klicken Sie auf Client erstellen.

Citrix Cloud erstellt dann die Client-ID und den geheimen Clientschlüssel für den Client. Laden Sie eine Kopie der Informationen herunter und speichern Sie sie offline an einem sicheren Ort. Citrix Cloud speichert diese eindeutigen Bezeichner nicht, nachdem Sie das Dialogfeld geschlossen haben.

Aufrufen von REST-API-Diensten

Sie können REST-API-Dienste über den REST-Client oder cURL-Befehle aufrufen. Die folgenden Beispiele verwenden den Advanced REST-Client für Chrome.

Hinweis:

Ändern Sie für die folgenden Beispiele den Hostnamen und die Portnummer gemäß Ihrer Umgebung.

Anmeldung

Das folgende Beispiel zeigt die Anmeldung mit einem Token, der über die Citrix Cloud-API abgerufen wird.

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

Methodentyp: POST

Inhaltstyp: application/json

Anforderungsbeispiel:

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

Sie müssen den Bearertoken mit der Citrix Cloud-API https://trust.citrixworkspacesapi.net/Help/Api/POST-customer-tokens-clients abrufen. Informationen hierzu finden Sie in der Dokumentation für Entwickler.

Antwortbeispiel:

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

Verwandte Informationen

REST-APIs