Mikroapps

Integration von Citrix Virtual Apps and Desktops Service

Mit der Integration von Citrix Virtual Apps and Desktops Service (CVADs) können Sie im Citrix Workspace nach Self-Service-Aktionen suchen und diese durchführen. Benutzer können den Status ihrer zugehörigen Maschinen überprüfen. Führen Sie Vorgänge wie Neustart, Trennen und Abmelden durch. Administratoren können auch den Wartungsmodus für Maschinen aktivieren.

Weitere Informationen zu Mikroapps finden Sie unter Verwenden von Citrix Virtual Apps and Desktops Service-Mikroapps. Weitere Informationen zum Aktualisieren dieser Citrix Virtual Apps and Desktops Service-Integration finden Sie unter Aktualisieren der Integration.

Prüfung der Voraussetzungen

Zum Einrichten dieser Integration müssen Sie Citrix Workspace mit Mikroapps und Citrix Virtual Apps and Desktops Service aktiviert haben. Diese Integration ist nicht mit on-premises CVAD kompatibel. Diese Integrationsvorlage unterstützt jedoch on-premises VDAs, wenn Sie den Citrix Virtual Apps and Desktops Service als Brokerdienst verwenden.

Dies sind die Werte, die Sie in Citrix Workspace-Mikroapps eingeben:

  • Basis-URL: https://api.cloud.com/cvadapis/. Weitere Informationen finden Sie unter Citrix Virtual Apps and Desktops REST APIs
  • Kunden-ID: Die Kunden-ID wird in den Rest-APIs verwendet und ist für den Zugriff auf alle Rest-APIs erforderlich. Die Kunden-ID finden Sie in Citrix Cloud. Informationen zum Erfassen Ihrer Kunden-ID finden Sie unter Generieren der Kunden-ID.
  • Token-URL: https://api-us.cloud.com/cctrustoauth2/{customerID}/tokens/clients. Siehe API-Proxy.
  • Client-ID: Die auf der Citrix Cloud-Website für Identitäts- und Zugriffsverwaltung erstellte clientID. Dies ist zum Abrufen des Bearertokens erforderlich, der zur Authentifizierung bei allen Rest-APIs benötigt wird. Siehe Generieren der Client-ID und des geheimen Clientschlüssels.
  • Geheimer Clientschlüssel: Der auf der Citrix Cloud-Website für Identitäts- und Zugriffsverwaltung erstellte geheime Schlüssel. Dies ist zum Abrufen des Bearertokens erforderlich, der zur Authentifizierung bei allen Rest-APIs benötigt wird.
  • Headerpräfix: Dieser Wert ist vorausgefüllt: CwsAuth bearer=

Berechtigungen

Beim Erstellen des sicheren Client über die Identitäts- und Zugriffsverwaltung muss das Konto, mit dem Sie beim Erstellen des sicheren Client angemeldet sind, über folgende Berechtigungen für den Citrix Virtual Apps and Desktops Service verfügen:

  • Administrator mit Lesezugriff, Alle - Zum Abrufen von Daten aus dem Citrix Virtual Apps and Desktops Service.
  • Sitzungsadministrator, Alle - Zum Durchführen von Abmelde- und Neustartaktionen.
  • Helpdeskadministrator, Alle - Zum Aktivieren und Deaktivieren des Wartungsmodus.

Die Anmeldeinformationen für den sicheren Client erben die Berechtigungen des angemeldeten Benutzers. Wenn sich die Berechtigungen des beim Erstellen des sicheren Client angemeldeten Benutzers ändern, gelten die neuen Berechtigungen auch für die Integration.

API-Proxy

Citrix bietet API-Proxys in mehreren Regionen. Wählen Sie den Proxy, der der Region mit Ihrer Citrix Cloud-Instanz am nächsten liegt:

  • Produktion (USA) https://api-us.cloud.com/cctrustoauth2/{CUSTOMER_ID}/tokens/clients
  • Produktion (EU) https://api-eu.cloud.com/cctrustoauth2/{CUSTOMER_ID}/tokens/clients
  • Produktion (AP-S) https://api-ap-s.cloud.com/cctrustoauth2/{CUSTOMER_ID}/tokens/clients

Generieren der Client-ID und des geheimen Clientschlüssels

Client-ID und geheimer Clientschlüssel (für den sicheren Client) sind erforderlich, um den für die Authentifizierung bei allen Rest-APIs erforderlichen Bearertoken zu erhalten. Erstellen Sie diese auf der Citrix Cloud-Seite zur Identitäts- und Zugriffsverwaltung. Weitere Informationen finden Sie unter Generieren der Kunden-ID, der Client-ID und des geheimen Schlüssels.

Hinzufügen der Integration

Fügen Sie die Citrix Virtual Apps and Desktops Service-Integration zu den Citrix Workspace-Mikroapps hinzu. Die Authentifizierungsoptionen sind vorausgewählt. Stellen Sie sicher, dass diese Optionen ausgewählt sind, wenn Sie den Vorgang abschließen. Dadurch werden vorkonfigurierte Mikroapps mit Benachrichtigungen und Aktionen bereitgestellt, die in Ihrem Workspace sofort einsatzbereit sind.

Führen Sie die folgenden Schritte aus:

  1. Wählen Sie auf der Seite Mikroappintegrationen die Optionen Neue Integration hinzufügen und Neue Integration aus Citrix-Vorlagen hinzufügen.
  2. Wählen Sie die Kachel des Citrix Virtual Apps and Desktops Service.
  3. Geben Sie einen Integrationsnamen ein.
  4. Geben Sie Connectorparameter ein.
    • Geben Sie die Basis-URL der Instanz ein: https://api.cloud.com/cvadapis/.
    • Wählen Sie ein Symbol für die Integration aus der Symbolbibliothek aus, oder belassen Sie das Standardsymbol.
  5. Geben Sie Ihre Kunden-ID ein. Die Kunden-ID wird in den Rest-APIs verwendet und ist für den Zugriff auf alle Rest-APIs erforderlich. Die Kunden-ID finden Sie in Citrix Cloud. Informationen zum Erfassen Ihrer Kunden-ID finden Sie unter Generieren der Kunden-ID. CVADs-Konfig 1

  6. Wählen Sie unter Dienstauthentifizierung im Menü Authentifizierungsmethode die Option OAuth 2.0 und füllen Sie die Authentifizierungsdetails aus. Die Authentifizierungsoptionen sind vorausgewählt. Stellen Sie sicher, dass diese Optionen ausgewählt sind, wenn Sie den Vorgang abschließen. Generieren Sie über das Sicherheitsprotokoll OAuth 2.0 einen Anforderungs-/Autorisierungstoken zum delegierten Zugriff. Sofern verfügbar, sollten Sie stets OAuth 2.0 zur Dienstauthentifizierung verwenden. OAuth 2.0 stellt sicher, dass Ihre Integration höchste Sicherheitsansprüche mit Ihrer konfigurierten Mikroapp erfüllt.

    1. Wählen Sie im Menü Gewährungstyp - Prozess die Option Clientanmeldeinformationen.
    2. Geben Sie im Feld Gewährungstyp - Wert den Wert client_credentials ein.
    3. Wählen Sie im Menü Tokenautorisierung die Option Anforderungstext.
    4. Wählen Sie im Menü Tokeninhaltstyp die Option URL-codiertes Formular.
    5. Bestätigen Sie das Feld Token-URL. Dieser Wert ist vorausgefüllt: https://api-us.cloud.com/cctrustoauth2/{customerID}/tokens/clients
    6. Geben Sie Ihre Client-ID ein. Die Client-ID ist die Zeichenfolge, die die eindeutigen Angaben des Autorisierungsservers zur Clientregistrierung darstellt.
    7. Geben Sie Ihren geheimen Clientschlüssel ein. Der geheime Clientschlüssel ist eine eindeutige Zeichenfolge, die mit der Client-ID ausgegeben wird.
    8. Das Headerpräfix ist vorausgefüllt: CwsAuth bearer=

    CVADs-Konfig 2

  7. Geben Sie im Feld Anforderungsratenlimit den Wert 120 ein.
  8. (Optional) Aktivieren Sie die Umschaltfläche Protokollierung, um 24-Stunden-Protokolle für Supportzwecke zu erstellen.
  9. Wählen Sie dann Speichern.

    CVADs-Konfig 3

Sie können nun die erste Datensynchronisierung festlegen und ausführen. Vollständige Informationen zu Synchronisierungsregeln, zeitlich fehlgeschlagenen Synchronisierungen und zu Vetoregeln finden Sie unter Synchronisieren von Daten.

Weitere Informationen zu API-Endpunkten und Tabellenentitäten finden Sie unter Citrix Virtual Apps and Desktops Service-Connectorspezifikationen.

Verwenden von CVADs-Mikroapps

Die Citrix Virtual Apps and Desktops Service-Integration enthält vorkonfigurierte Mikroapps. Beginnen Sie mit diesen Mikroapps und passen Sie sie an Ihre Erfordernisse an.

Meine Desktops: Suche nach virtuellen Citrix-Desktops und Ausführen von Self-Service-Aktionen wie “Neustart” über Citrix Workspace.

Benachrichtigung oder Seite Workflows für Anwendungsfälle
Seite “Virtueller Desktop - Details” Seite mit Desktopdetails und Optionen für Desktop neu starten und Neustart des Desktops erzwingen.
Seite “Virtuelle Desktops” Durchsuchbare Liste virtueller Citrix-Desktops, die dem Benutzer zugeordnet sind, mit einem Link zur Seite “Virtueller Desktop - Details”.

Meine Sitzungen: Suche nach virtuellen Citrix-Sitzungen und Ausführen von Self-Service-Aktionen wie “Abmelden” und “Trennen” in Citrix Workspace.

Benachrichtigung oder Seite Workflows für Anwendungsfälle
Seite “Liste der Sitzungen” Durchsuchbare Liste von Virtual Desktop-Sitzungen, die dem Benutzer zugeordnet sind, mit einem Link zur Seite “Sitzungsdetails”.
Seite “Sitzungsdetails” Seite mit Virtual Desktop-Sitzungs- und Maschinendetails sowie Optionen für Von Sitzung abmelden und Sitzung trennen.

Virtual Desktops (Admin-Modus): Hiermit können Citrix Workspace CVAD-Administratoren Maschinen suchen, ihre Details anzeigen, Maschinen in den Wartungsmodus versetzen und die Maschinen neu starten.

Benachrichtigung oder Seite Workflows für Anwendungsfälle
Benachrichtigung: Eine Maschine in einem Fehlerzustand Wenn ein neuer Datensatz über eine Maschine im Fehlerzustand vorliegt, erhalten alle Abonnenten eine Benachrichtigung mit Verknüpfung zur Seite “Virtueller Desktop - Details”.
Seite “Liste virtueller Desktops” Durchsuchbare Liste virtueller Citrix-Desktops mit Link zur Seite “Virtueller Desktop - Details”. Sie können nach Maschine oder Benutzer suchen.
Seite “Virtueller Desktop - Details” Seite mit Desktopdetails und Optionen für Desktop neu starten, Neustart des Desktops erzwingen, Wartungsmodus aktivieren und Wartungsmodus deaktivieren.

Aktualisieren der Integration

Wenn Sie die Citrix Virtual Apps und Desktops-Integration bereits verwenden, können Sie sie mit diesem Verfahren auf die neueste Version aktualisieren. Mit diesem Verfahren vermeiden Sie, dass Sie alle Benutzer erneut abonnieren müssen.

Zu den Verbesserungen gehören:

  • Die Site-ID wird automatisch abgerufen.
  • Nicht beschränkt auf fehlerhafte Maschinen.
  • Die inkrementelle Synchronisierung wird schneller ausgeführt. Gelöschte Sitzungen werden bei der Synchronisierung nicht gelöscht. Die Synchronisierung aktualisiert zudem keine Maschinen, sondern nur Sitzungen.
  • Aktualisierungen nach Aktionen hinzugefügt, die Sitzungen nach dem Abmelden löschen, Sitzungen nach dem Trennen aktualisieren und Neustartstatus für Maschinen festlegen.
  • Option hinzugefügt, um Informationen für Details zu Maschinen und Sitzungen zu aktualisieren, damit Benutzer sicherstellen können, dass ihre Anzeige mit dem Citrix Virtual Apps and Desktops Service übereinstimmt.

Führen Sie die folgenden Schritte aus:

  1. Laden Sie dieses Skript herunter und fügen Sie es auf der Registerkarte “Skripting” Ihrer alten Citrix Virtual Apps and Desktops Service-Integration hinzu.
    1. Wählen Sie im Konfigurationsbildschirm der Integration in der linken Navigation die Option Skripting.
    2. Laden Sie dieses Skript herunter: Upgrade Citrix-Virtual-Apps-and-Desktops-service
    3. Wählen Sie Skript hochladen. Alternativ können Sie Bearbeiten wählen und Ihr Skript direkt in den Textbereich eingeben.
    4. Ziehen Sie Ihr Skript auf das Import-Popupfenster. Wählen Sie Importieren.
  2. Fügen Sie die neue Citrix Virtual Apps and Desktops Service-Integration aus dem Katalog der von Citrix bereitgestellten Vorlagen hinzu, konfigurieren Sie die Integration jedoch nicht.
  3. Exportieren Sie nach dem Hinzufügen der Integrationen jede Mikroapp einzeln. Wählen Sie für jede Mikroapp im Menü neben der Mikroapp den Befehl Exportieren. Führen Sie dieses Verfahren für alle drei Mikroapps aus.
  4. Importieren Sie die soeben exportierten Dateien in die alte Integration (also die Integration, die Sie aktuell verwenden).
    1. Wählen Sie im Menü neben der Mikroapp den Befehl Neue Version importieren.
    2. Fügen Sie die Dateien per Drag & Drop oder über “Durchsuchen” von Ihrer Maschine hinzu, jeweils für die entsprechende Mikroapp.
    3. Aktivieren Sie die Umschaltfläche Vorhandene Feedkarten löschen, um die ursprüngliche Mikroapp zu ersetzen.
    4. Wählen Sie unten auf dem Bildschirm die Option Importieren.
  5. Löschen Sie alle Datenendpunkte mit Ausnahme der skriptbasierten Endpunkte.
    1. Wählen Sie neben der Integration die Option Bearbeiten.
    2. Wählen Sie auf der Seite zum Laden von Daten das Menü neben einer nicht skriptbasierten Integration, wählen Sie Löschen und bestätigen Sie die Auswahl.
  6. Aktualisieren Sie die Integrationskonfiguration. Dies gilt vor allem für die Basis-URL, die Kunden-ID und das Headerpräfix. Befolgen Sie hierfür die Anweisungen unter Hinzufügen der Integration. Wählen Sie Speichern, um den Vorgang abzuschließen.

Damit haben Sie die Citrix Virtual Apps and Desktops-Integration aktualisiert.

Integration von Citrix Virtual Apps and Desktops Service