Mikroapps

Integration von Google Meet

Stellen Sie die Google Meet-Integrationen bereit, um Google Meet-Besprechungen zu planen und Aufzeichnungen von jedem Gerät oder Intranet aufzulisten. Diese Integration gilt für zwei Anwendungsfälle:

  • Mit der Mikroapp “Besprechung erstellen” können Benutzer einmalige oder wiederkehrende Besprechungen organisieren, Teilnehmer hinzufügen und verschiedene Zeitzonen auswählen. Alle eingeladenen Personen erhalten zudem eine E-Mail mit dem entsprechenden Besprechungsobjekt zur einfachen Integration im Kalender.
  • Mit der Mikroapp “Besprechungsaufzeichnungen” können Benutzer alle Besprechungsaufzeichnungen anzeigen, auf die sie Zugriff haben.

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.

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

Prüfung der Voraussetzungen

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

  • BASIS-URL: https://www.googleapis.com/
  • TOKEN-URL: https://oauth2.googleapis.com/token
  • AUTORISIERUNGS-URL: https://accounts.google.com/o/oauth2/v2/auth?access_type=offline&prompt=consent
  • 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 Google Meet, 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 Google Meet-Instanz erforderlich. Wir empfehlen daher, ein dediziertes Benutzerkonto zu erstellen. Dieses Konto muss über die folgenden Berechtigungen verfügen:

  • Erforderliche Berechtigungen für Dienstkonto: Volle Administratorrechte

  • Erforderliche Bereiche für Dienstkonto:

    https://www.googleapis.com/auth/calendar https://www.googleapis.com/auth/calendar.events https://www.googleapis.com/auth/admin.directory.user

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://workspace.google.co.in/intl/en_in/pricing.html

Aktivieren von APIs

Google Meet-APIs sind standardmäßig für den Zugriff über Webdienste für kostenpflichtige Konten aktiviert.

Konfigurieren von OAuth

  1. Melden Sie sich hier mit dem Dienstkonto an: https://console.cloud.google.com
  2. Wählen Sie im linken Menü APIs and Services.
  3. Wählen Sie das entsprechende Projekt aus der Projektliste im Navigationsmenü aus.
  4. Wählen Sie Enable APIs and Services und aktivieren Sie alle erforderlichen APIs von G Suite. Empfohlene APIs: Google Calendar API und Admin SDK.
  5. Gehen Sie zurück zur Seite APIs and Services und wählen Sie im linken Fenster die Option OAuth consent screen.
  6. Wählen Sie unter User Type den gewünschten Benutzertyp (wir empfehlen: Internal), und wählen Sie Create.
  7. Füllen Sie die erforderlichen Felder aus, und geben Sie unter Scopes required for Service Accountdie Bereiche für das Dienstkonto ein. Speichern Sie dann die Details. Dies sind die erforderlichen Bereiche:

Konfigurieren des Rückruf-URL-Servers

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

  1. Melden Sie sich hier mit dem Dienstkonto an: https://console.cloud.google.com
  2. Wählen Sie im linken Menü APIs and Services.
  3. Wählen Sie das entsprechende Projekt aus der Projektliste im Navigationsmenü aus.
  4. Wählen Sie auf dem linken Bildschirm Credentials.
  5. Wählen Sie Create Credentials und dann in der Liste OAuth client ID.
  6. Wählen Sie in der Liste Application type die Option Web Application und geben Sie einen Namen ein.
  7. Wählen Sie unter Authorized redirect URIs die Option Add URI.
  8. Geben Sie im Feld URIs die folgenden autorisierten Umleitungs-URLs für diese Integration ein:

    • https://{yourmicroappserverurl}/admin/api/gwsc/auth/serverContext
  9. Wählen Sie Create.
  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 Rückruf-URL-Clients

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

  1. Melden Sie sich hier mit dem Dienstkonto an: https://console.cloud.google.com
  2. Wählen Sie im linken Menü APIs and Services.
  3. Wählen Sie das entsprechende Projekt aus der Projektliste im Navigationsmenü aus.
  4. Wählen Sie auf dem linken Bildschirm Credentials.
  5. Wählen Sie Create Credentials und dann in der Liste OAuth client ID.
  6. Wählen Sie in der Liste Application type die Option Web Application und geben Sie einen Namen ein.
  7. Wählen Sie unter Authorized redirect URIs die Option Add URI.
  8. Geben Sie im Feld URIs die folgenden autorisierten Umleitungs-URLs für diese Integration ein:

    • https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback
  9. Wählen Sie Create.
  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 Google Meet-Integration zu Citrix Workspace-Mikroapps hinzu, um eine Verbindung zu Ihrer Anwendung herzustellen. 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 Google Meet-Kachel.
  3. Geben Sie einen Namen für die Integration ein.
    • Geben Sie die Basis-URL der Instanz ein: https://www.googleapis.com/.
    • Wählen Sie ein Symbol für die Integration aus der Symbolbibliothek aus, oder belassen Sie das Standardsymbol.

    Name und Basis-URL

  4. 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 Anforderungstext.
    3. Die Autorisierungs-URL ist vorausgefüllt: https://accounts.google.com/o/oauth2/v2/auth?access_type=offline&prompt=consent
    4. Die Token-URL ist vorausgefüllt: https://oauth2.googleapis.com/token
    5. Stellen Sie sicher, dass Folgendes als Bereich eingegeben ist: https://www.googleapis.com/auth/calendar https://www.googleapis.com/auth/calendar.events https://www.googleapis.com/auth/admin.directory.user
    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

  5. 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 Anforderungstext.
    4. Die Autorisierungs-URL ist vorausgefüllt: https://accounts.google.com/o/oauth2/v2/auth?access_type=offline&prompt=consent
    5. Die Token-URL ist vorausgefüllt: https://oauth2.googleapis.com/token
    6. Stellen Sie sicher, dass Folgendes als Bereich eingegeben ist: https://www.googleapis.com/auth/calendar https://www.googleapis.com/auth/calendar.events
    7. 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.
    8. Geben Sie Ihren geheimen Clientschlüssel ein. Der geheime Clientschlüssel ist eine eindeutige Zeichenfolge, die beim Einrichten der Zielanwendungsintegration ausgegeben wird.

    Dienstaktionsauthentifizierung

  6. Aktivieren Sie die Umschaltfläche Anforderungsratenlimit aktivieren. Geben Sie für Anzahl der Anforderungen den Wert 100 und für Zeitintervall den Wert 1 Minute ein.
  7. (Optional) Aktivieren Sie die Umschaltfläche Protokollierung, um 24-Stunden-Protokolle für Supportzwecke zu erstellen.

    Umschaltflächen für Ratenlimit und Protokollierung

  8. Wählen Sie dann Speichern.
  9. Wählen Sie unter OAuth-Autorisierung die Option Autorisieren, um sich mit Ihrem Dienstkonto anzumelden. Ein Popupfenster mit dem Google-Anmeldebildschirm wird angezeigt.
    1. Geben Sie Benutzernamen und Kennwort Ihres Dienstkontos ein und wählen Sie Anmelden.
    2. Wählen Sie Akzeptieren.

    Autorisieren

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.

Hinweis:

Die Citrix Google Meet-Integration verwendet Datenaktualisierung nach Aktion, um die neuesten Daten für den angemeldeten Benutzer über die Schaltfläche Liste aktualisieren in der Dienstaktion Besprechungsaufzeichnungen abzurufen. Wir empfehlen, diesen Ansatz unverändert zu verwenden. Führen Sie alle zwei (2) Monate manuell eine vollständige Synchronisierung aus, um eine optimale Datenmenge für den Benutzer beizubehalten. Die Integration unterstützt zudem keine inkrementellen Synchronisierungen und verwendet nur Datenaktualisierung nach Aktion zum Abrufen der neuesten Daten.

Weitere Informationen zu API-Endpunkten und Tabellenentitäten finden Sie unter Google Meet-Connectorspezifikationen.

Verwenden von Google Meet-Mikroapps

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

Besprechung erstellen: Planen Sie eine benutzerdefinierte Besprechung.

Benachrichtigung oder Seite Workflows für Anwendungsfälle
Seite “Besprechung erstellen” Formular zum Planen einer Besprechung, mit Details wie Besprechungstitel, Start- und Endzeit, Zeitzone, Wiederholung (einmal, täglich, wöchentlich, monatlich), Kennwort und Besprechungsteilnehmern.|

Besprechungsaufzeichnungen: Liste aller aufgezeichneten Besprechungen, auf die ein Benutzer zugreifen kann, und Wiedergabe der Aufzeichnungen.

Benachrichtigung oder Seite Workflows für Anwendungsfälle
Seite “Aufzeichnungen” Liste aller verfügbaren Besprechungsaufzeichnungen für den Benutzer und eine Schaltfläche Liste aktualisieren. Zur Anzeige der Aufzeichnungsdetails klicken Sie auf die Aufzeichnungen in der Liste.
Seite “Aufzeichnungsdetails” Seite mit Details zu Besprechungsaufzeichnungen und einer Wiedergabeoption Aufzeichnung wiedergeben. Klicken Sie auf die Schaltfläche, um die Aufzeichnung anzusehen.