Mikroapps

Integration von GoToMeeting

Mit der GoToMeeting-Integration können Sie GoToMeeting-Besprechungen von jedem Gerät oder Intranet aus planen. Mit der Mikroapp Besprechung erstellen von GoToMeeting kann jeder Benutzer einmalige Besprechungen organisieren.

Hinweis:

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

Eine Liste aller vorkonfigurierten GoToMeeting-Mikroapps finden Sie unter Verwenden von GoToMeeting-Mikroapps.

Prüfung der Voraussetzungen

Es wird hier davon ausgegangen, dass der Administrator zur GoToMeeting-Integration gehört, die von der Organisation eingerichtet wurde. Dieses GoToMeeting-Administratorkonto muss volle Leserechte für Benutzerinformationen besitzen.

Nachdem Sie diese Integration mit GoToMeeting eingerichtet haben, benötigen Sie diese Artefakte, um die Integration in Citrix Workspace-Mikroapps hinzuzufügen. Dies gilt insbesondere für die folgende Liste von Parametern zum Einrichten der OAuth-Integration:

  • Basis-URL: https://api.getgo.com/
  • Autorisierungs-URL: https://api.getgo.com/oauth/v2/authorize
  • Token-URL: https://api.getgo.com/oauth/v2/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.
  • Konto-ID: Dieser Wert ersetzt den Parameter your_accountId im Endpunkt Alle Organisatoren. Siehe Erfassen der Konto-ID.

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 GoToMeeting, 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.

Für die Integration ist ein regulärer Zugriff auf Ihre GoToMeeting-Instanz erforderlich. Wir empfehlen daher, ein dediziertes Benutzerkonto zu erstellen. Sie können die Berechtigungen mit https://goto-developer.logmeininc.com/admin/#section/Overview/Users-Roles-Licenses-and-Groups anzeigen.

  • 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:

Aktivieren von APIs

Die GoTo Meeting-APIs sind standardmäßig über Webdienste für kostenpflichtige Konten aktiviert.

Erstellen eines neuen Dienstkontos

Registrieren Sie sich hier: https://developer.goto.com/. Weitere Informationen zu neuen Dienstkonten finden Sie unter: https://support.goto.com/meeting/new-gotomeeting-guide.

Konfigurieren des OAuth-Servers

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

  1. Melden Sie sich hier mit Ihrem Dienstkonto an: https://developer.goto.com/GoToMeetingV1.
  2. Wählen Sie OAuth Clients in der oberen Navigationsleiste.
  3. Wählen Sie Create a new client.
  4. Geben Sie alle Details ein und geben Sie im Feld Redirect URL die folgenden autorisierten Umleitungs-URLs für diese Integration ein:

    • https://{yourmicroappserverurl}/admin/api/gwsc/auth/serverContext
  5. Aktivieren Sie im Abschnitt Scopes das Kontrollkästchen Scopes.
  6. Wählen Sie Speichern.
  7. 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 GoToMeeting-Integration zurückgeschrieben werden.

  1. Melden Sie sich wie oben mit Ihrem Dienstkonto an: https://developer.goto.com/GoToMeetingV1.
  2. Wählen Sie OAuth Clients in der oberen Navigationsleiste.
  3. Wählen Sie Create a new client.
  4. Geben Sie alle Details ein und geben Sie im Feld Redirect URL die folgenden autorisierten Umleitungs-URLs für diese Integration ein:

    • https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback
  5. Aktivieren Sie im Abschnitt Scopes das Kontrollkästchen Scopes.
  6. Wählen Sie Speichern.
  7. 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.

Erfassen der Konto-ID

Erfassen Sie die Konto-ID, und verwenden Sie diesen Wert, um damit den Parameter your_accountId im Endpunkt Alle Organisatoren zu ersetzen.

  1. Melden Sie sich als Administrator unter https://admin.logmeininc.com/portal/ an.
  2. Sehen Sie sich die URL auf der Startseite an. Die Konto-ID wird mit diesem Modell gefunden: https://admin.logmeininc.com/portal/#accounts/<accountID>/users?filterType=usertype
  3. Kopieren Sie die Konto-ID und speichern Sie sie, um sie später beim Einrichten zu verwenden. Siehe Ersetzen des Werts für “Daten laden”.

Hinzufügen der Integration zu Citrix Workspace-Mikroapps

Fügen Sie die GoToMeeting-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 GoToMeeting-Kachel aus.
  3. Geben Sie einen Integrationsnamen ein.
  4. Geben Sie Connectorparameter ein.
    • Geben Sie die Basis-URL der Instanz ein: https://api.getgo.com/.
    • 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://api.getgo.com/oauth/v2/token.
    4. Die Token-URL ist vorausgefüllt: https://api.getgo.com/oauth/v2/authorize.
    5. 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.
    6. 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://api.getgo.com/oauth/v2/token.
    5. Die Token-URL ist vorausgefüllt: https://api.getgo.com/oauth/v2/authorize.
    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 den Wert 100 und für Zeitintervall den Wert 1 Minute 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 Webex-Anmeldebildschirm wird angezeigt.
    1. Geben Sie Benutzernamen und Kennwort Ihres Dienstkontos ein und wählen Sie Anmelden.
    2. Wählen Sie Akzeptieren. Dienstauthentifizierung

Ersetzen des Werts für “Daten laden”

Ersetzen Sie den Parameter your_accountId im Endpunkt Alle Organisatoren. Verwenden Sie den Konto-ID-Wert, den Sie in Erfassen der Konto-ID erfasst haben.

  1. Wählen Sie auf der Seite Mikroappintegrationen das Menü neben der GoToMeeting-Integration und wählen Sie Bearbeiten. Der Bildschirm Laden von Daten wird geöffnet. Wenn das Konfigurationsfenster angezeigt wird, wählen Sie in der linken Navigationsspalte die Option Laden von Daten.
  2. Wählen Sie das Menü neben dem Endpunkt Alle Organisatoren und wählen Sie Bearbeiten oder wählen Sie den Endpunkt Alle Organisatoren.
  3. Suchen Sie im Bildschirm Datenendpunkt bearbeiten den Wert, wie im Screenshot gezeigt. Ersetzen Sie diesen Wert durch Ihre zuvor erfasste Konto-ID.
  4. Wählen Sie am unteren Bildschirmrand Übernehmen und bestätigen Sie.

    Umschaltflächen für Ratenlimit und Protokollierung

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 GoToMeeting-HTTP-Connectorspezifikationen.

Verwenden von GoToMeeting-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. Der Benutzer kann Datum, Startzeit und Endzeit, Kennwort und Co-Organisatoren wählen.

Benachrichtigung oder Seite Workflows für Anwendungsfälle
Seite “Besprechung erstellen” Formular zum Planen einer Besprechung mit folgenden benutzerdefinierten Details: Thema der Besprechung, Start- und Endzeit, Kennwort und Co-Organisatoren der Besprechung.
Seite “Neue Besprechung” Erfolgsmeldung und eine Option zum Anzeigen der Besprechungsdetails (mit Schaltfläche “Details anzeigen”), sobald eine Besprechung erfolgreich geplant wurde.
Seite “Besprechungsdetails” Detaillierte Informationen über die vom Benutzer geplante Besprechung.
Integration von GoToMeeting