Mikroapps

Integration von Zoom

Stellen Sie die Citrix Zoom-Integration bereit, um Besprechungen von überall und von jedem Gerät oder Intranet zu planen. Mit unserer Zoom-Mikroapp kann jeder Benutzer einmalige und wiederkehrende Besprechungen erstellen, Co-Organisatoren hinzufügen und verschiedene Zeitzonen auswählen. Die Mikroapp bietet auch Einladungsdetails zur geplanten Besprechung.

Hinweis:

Diese Integrationsvorlage ist als Preview erhältlich und in der Vorlagenliste, die beim Hinzufügen einer neuen Integration im Produkt angezeigt wird, als Preview markiert. In der Previewphase unterstützt der Entwickler die Vorlage nach bestem Bemühen, es besteht jedoch keine Supportverpflichtung. Als Preview erhältliche Integrationsvorlagen werden zum Testen und Validieren freigegeben. Wir raten davon ab, sie in Produktionsumgebungen bereitzustellen. Weitere Informationen finden Sie unter Wartungserklärung für Mikroapps-Integrationsvorlagen.

Senden Sie uns Ihr Feedback! Wir freuen uns über Ihr Feedback zu dieser Preview-Integrationsvorlage. Unser Team überprüft unser zugehöriges Forum täglich auf gemeldete Probleme.

Ausführliche Details zur vorkonfigurierten Mikroapp für Zoom finden Sie unter Verwenden von Mikroapps für Zoom.

Prüfung der Voraussetzungen

Es wird hier davon ausgegangen, dass der Administrator zur Zoom-Integration gehört, die von der Organisation eingerichtet wurde. Dieses Zoom-Administratorkonto muss volle Leserechte für Benutzerinformationen besitzen. Nach dem Einrichten dieser Integration mit Zoom benötigen Sie diese Artefakte, um die Integration in Citrix Workspace-Mikroapps hinzuzufügen:

  • BASIS-URL: https://api.zoom.us/v2/
  • AUTORISIERUNGS-URL: https://zoom.us/oauth/authorize
  • TOKEN-URL: https://zoom.us/oauth/token
  • CLIENT-ID: Die Client-ID ist die Zeichenfolge, die die eindeutigen Angaben des Autorisierungsservers zur Clientregistrierung darstellt.
  • GEHEIMER CLIENTSCHLÜSSEL: Der geheime Clientschlüssel ist eine eindeutige Zeichenfolge, die beim Einrichten der Zielanwendungsintegration ausgegeben wird.

Hinweis:

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.

Konfigurieren Sie in Citrix Gateway die Unterstützung für Single Sign-On für Zoom, damit Benutzer sich nur einmal anmelden und ihre Anmeldeinformationen nicht erneut eingeben müssen. Weitere Hinweise zum Konfigurieren von SSO finden Sie unter Citrix Gateway Service https://docs.citrix.com/en-us/citrix-gateway-service/.

Für die Integration ist ein regulärer Zugriff auf Ihre Zoom-Instanz erforderlich. Wir empfehlen daher, ein dediziertes Benutzerkonto zu erstellen. Sie können die Berechtigungen mit https://marketplace.zoom.us/docs/api-reference/other-references/privileges anzeigen. Dieses Konto muss über die folgenden Berechtigungen verfügen:

  • Erforderliche Berechtigungen für Dienstkonto: Volle Administratorrechte

Sie können nur eine begrenzte Anzahl an API-Anforderungen an bestimmte Ressourcen stellen. Daher empfehlen wir Folgendes:

Erstellen eines neuen Dienstkontos

Melden Sie sich hier an: https://zoom.us/signin. Weitere Informationen finden Sie unter der folgenden URL für neue Dienstkonten: https://marketplace.zoom.us/docs/guides/getting-started

Konfigurieren des OAuth-Servers

Konfigurieren Sie den OAuth-Server so, dass Daten über die Zoom-Integration gelesen werden.

  1. Melden Sie sich hier mit Ihrem Dienstkonto an: https://marketplace.zoom.us/.
  2. Wählen Sie das Dropdownmenü Develop rechts oben.
  3. Wählen Sie Build App.
  4. Wählen Sie Create for die OAuth-App, und wählen Sie Account-Level App als Apptyp.
  5. Deaktivieren Sie die Umschaltfläche zum Veröffentlichen der App auf der Marketplace-Site und wählen Sie Create.
  6. Geben Sie die folgenden autorisierten Umleitungs-URLs für diese Integration im Feld Redirect URL und im Feld Whitelist URL ein: Wählen Sie dann Continue.

    • https://{yourmicroappserverurl}/admin/api/gwsc/auth/serverContext
  7. Füllen Sie die erforderlichen Felder aus und wählen Sie Weiter.
  8. Wählen Sie im Abschnitt “Scopes” die Option Add Scopes und wählen Sie die Bereiche für Meeting, Recording und User. Wählen Sie dann Done.
  9. Wählen Sie Install. Eine neue Registerkarte wird geöffnet, um die App zu autorisieren. Wählen Sie dann Authorize und schließen Sie die Registerkarte.
  10. Kopieren und speichern Sie die angezeigten Angaben für ClientId und Secret. Verwenden Sie diese Details für die Dienstauthentifizierung, während Sie die Integration konfigurieren.

Konfigurieren des OAuth-Client

Konfigurieren Sie den OAuth-Client so, dass Daten über die Zoom-Integration zurückgeschrieben werden.

  1. Melden Sie sich wie oben mit Ihrem Dienstkonto an: https://marketplace.zoom.us/.
  2. Wählen Sie das Dropdownmenü Develop rechts oben.
  3. Wählen Sie Build App.
  4. Wählen Sie Create for die OAuth-App, und wählen Sie User-Managed App als Apptyp.
  5. Deaktivieren Sie die Umschaltfläche zum Veröffentlichen der App auf der Marketplace-Site und wählen Sie Create.
  6. Geben Sie die folgenden autorisierten Umleitungs-URLs für diese Integration im Feld Redirect URL und im Feld Whitelist URL ein: Wählen Sie dann Continue.

    • <https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback>
  7. Füllen Sie die erforderlichen Felder aus und wählen Sie Weiter.
  8. Wählen Sie im Abschnitt “Scopes” die Option Add Scopes und wählen Sie die Bereiche für Meeting, Recording und User. Wählen Sie dann Done.
  9. Wählen Sie Install. Eine neue Registerkarte wird geöffnet, um die App zu autorisieren. Wählen Sie dann Authorize und schließen Sie die Registerkarte.
  10. Kopieren und speichern Sie die angezeigten Angaben für ClientId und Secret. Verwenden Sie diese Details für die Dienstaktionsauthentifizierung, während Sie die Integration konfigurieren.

Hinzufügen der Integration zu Citrix Workspace-Mikroapps

Fügen Sie die Zoom Meeting-Integration zu Citrix Workspace-Mikroapps hinzu, um eine Verbindung zu Ihrer Anwendung herzustellen. 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 Zoom Meetings-Kachel.
  3. Geben Sie einen Integrationsnamen ein.
  4. Geben Sie Connectorparameter ein.
    • Geben Sie die Basis-URL der Instanz ein: https://api.zoom.us/v2/.
    • Wählen Sie ein Symbol für die Integration aus der Symbolbibliothek aus, oder belassen Sie das Standardsymbol.

    Name und Basis-URL

  5. 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 die Option Autorisierungscode. Dadurch wird ein temporärer Code gewährt, den der Client gegen einen Zugriffstoken tauscht. Der Code wird vom Autorisierungsserver abgerufen, wo Sie die vom Client angeforderten Informationen sehen. Nur dieser Gewährungstyp ermöglicht einen sicheren Benutzeridentitätswechsel. Dadurch wird die Rückruf-URL angezeigt, die Sie bei der Registrierung Ihrer Anwendung verwenden.
    2. Wählen Sie im Menü Tokenautorisierung die Option Autorisierungsheader.
    3. Die Autorisierungs-URL ist vorausgefüllt: https://zoom.us/oauth/authorize
    4. Die Token-URL ist vorausgefüllt: https://zoom.us/oauth/token
    5. Stellen Sie sicher, dass Folgendes als Bereich eingegeben ist: account:write:adminDelete account:read:adminDelete account:masterDelete meeting:master meeting:read:adminDelete meeting:write:adminDelete recording:masterDelete recording:read:adminDelete recording:write:adminDelete user:masterDelete user:read:adminDelete user:write:adminDelete.
    6. Geben Sie Ihre Client-ID ein. Die Client-ID ist die Zeichenfolge, die die eindeutigen Angaben des Autorisierungsservers zur Clientregistrierung darstellt. Sie erfassen dies und den geheimen Clientschlüssel beim Konfigurieren des OAuth-Servers. Sie müssen die Rückruf-URL hinzufügen, die Sie auf der Konfigurationsseite der Integration sehen.
    7. Geben Sie Ihren geheimen Clientschlüssel ein. Der geheime Clientschlüssel ist eine eindeutige Zeichenfolge, die beim Einrichten der Zielanwendungsintegration ausgegeben wird.

    Dienstauthentifizierung

  6. Aktivieren Sie unter Dienstaktionsauthentifizierung die Umschaltfläche Separate Benutzerauthentifizierung in Aktionen verwenden. Mit der Dienstaktionsauthentifizierung authentifizieren Sie sich auf der Dienstaktionsebene. Die Authentifizierungsoptionen sind vorausgewählt. Stellen Sie sicher, dass diese Optionen ausgewählt sind, wenn Sie den Vorgang abschließen.

    1. Wählen Sie im Menü Authentifizierungsmethode die Option OAuth 2.0 und geben Sie die Authentifizierungsdetails ein.
    2. Wählen Sie im Menü Gewährungstyp die Option Autorisierungscode. Dadurch wird ein temporärer Code gewährt, den der Client gegen einen Zugriffstoken tauscht. Der Code wird vom Autorisierungsserver abgerufen, wo Sie die vom Client angeforderten Informationen sehen. Nur dieser Gewährungstyp ermöglicht einen sicheren Benutzeridentitätswechsel. Dadurch wird die Rückruf-URL angezeigt, die Sie bei der Registrierung Ihrer Anwendung verwenden.
    3. Wählen Sie im Menü Tokenautorisierung die Option Autorisierungsheader.
    4. Die Autorisierungs-URL ist vorausgefüllt: https://zoom.us/oauth/authorize
    5. Die Token-URL ist vorausgefüllt: https://zoom.us/oauth/token
    6. Geben Sie Ihre Client-ID ein. Die Client-ID ist die Zeichenfolge, die die eindeutigen Angaben des Autorisierungsservers zur Clientregistrierung darstellt. Sie erfassen diese Angaben und den geheimen Clientschlüssel beim Konfigurieren des OAuth-Client. Sie müssen die Rückruf-URL hinzufügen, die Sie auf der Konfigurationsseite der Integration sehen.
    7. Geben Sie Ihren geheimen Clientschlüssel ein. Der geheime Clientschlüssel ist eine eindeutige Zeichenfolge, die beim Einrichten der Zielanwendungsintegration ausgegeben wird.

    Dienstaktionsauthentifizierung

  7. Aktivieren Sie die Umschaltfläche Anforderungsratenlimit aktivieren. Geben Sie für Anzahl der Anforderungen 55 und als Zeitintervall 1 Sekunde ein.

    Umschaltflächen für Ratenlimit und Protokollierung

  8. (Optional) Aktivieren Sie die Umschaltfläche Protokollierung, um 24-Stunden-Protokolle für Supportzwecke zu erstellen.
  9. Wählen Sie dann Speichern.
  10. Wählen Sie unter OAuth-Autorisierung die Option Autorisieren, um sich mit Ihrem Dienstkonto anzumelden. Ein Popupfenster mit dem Zoom-Anmeldebildschirm wird angezeigt.
    1. Geben Sie Benutzernamen und Kennwort Ihres Dienstkontos ein und wählen Sie Anmelden.
    2. Wählen Sie Akzeptieren. Dienstauthentifizierung

Die Seite Mikroappintegrationen wird geöffnet und zeigt die hinzugefügte Integration mit zugehörigen Mikroapps an. Hier können Sie eine weitere Integration hinzufügen, vorkonfigurierte Mikroapps einrichten oder eine neue Mikroapp für diese Integration erstellen.

Sie können nun die erste Datensynchronisierung festlegen und ausführen. Da unter Umständen eine große Datenmenge von Ihrer integrierten Anwendung zur Mikroapps-Plattform übermittelt wird, empfehlen wir, für die erste Datensynchronisierung auf der Seite Tabelle Entitäten zu filtern, um die Synchronisierung zu beschleunigen. Weitere Informationen finden Sie unter Überprüfen erforderlicher Entitäten. 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 Zoom-HTTP-Connectorspezifikation.

Verwenden von Mikroapps für Zoom

Vorhandene Anwendungsintegrationen werden mit vorkonfigurierten Mikroapps geliefert. Beginnen Sie mit diesen Mikroapps und passen Sie sie an Ihre Erfordernisse an.

Besprechung erstellen: Planen Sie Besprechungen nach Ihren Wünschen. Benutzer können für die Besprechung Titel, Dauer, Startdatum, Co-Organisatoren usw. festlegen.

Benachrichtigung oder Seite Workflows für Anwendungsfälle
Seite “Besprechung erstellen” Formular zum Planen einer Besprechung mit folgenden benutzerdefinierten Details: Besprechungstitel, Startzeit, Dauer, Zeitzone, Wiederholung (einmal, täglich, wöchentlich, monatlich), Kennwort, Co-Organisatoren, Einwahlnummern für die Besprechung.
Seite “Neue Besprechungen (einmalig)” Diese Seite enthält die Erfolgsmeldung für die erstellten Besprechungen und die Schaltfläche Details anzeigen für die einmal stattfindenden Besprechungen.
Seite “Neue wiederkehrende Besprechungen” Diese Seite enthält die Erfolgsmeldung für die erstellten Besprechungen und die Schaltfläche Details anzeigen für die wiederkehrenden Besprechungen.
Seite “Einladungen” Stellt unmittelbar nach dem Erstellen der Besprechung die Einladungsdetails bereit, z. B. Besprechungsthema, Kennwort, Kalenderdetails, Wiederholungsdetails, Teilnahme-URL, Startzeit, Besprechungs-ID, Einwahlnummern.
Integration von Zoom