Mikroapps

Integration von Webex

Mit der Webex-Integration können Sie Webex-Besprechungen von jedem Gerät oder Intranet planen. Benutzer können einmalige oder wiederkehrende Besprechungen planen, Teilnehmer und Co-Organisatoren hinzufügen und verschiedene Zeitzonen auswählen. Organisator und eingeladene Personen erhalten zudem automatisch eine E-Mail, die das entsprechende Besprechungsobjekt zur Integration im Kalender enthält.

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 Webex-Mikroapps finden Sie unter Verwenden von Webex-Mikroapps.

Prüfung der Voraussetzungen

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

Nachdem Sie diese Integration mit Webex 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://webexapis.com/v1/
  • AUTORISIERUNGS-URL: https://webexapis.com/v1/authorize
  • TOKEN-URL: https://webexapis.com/v1/access_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 Webex, 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 Webex-Instanz erforderlich. Wir empfehlen daher, ein dediziertes Benutzerkonto zu erstellen. Dieses Konto muss über die folgenden Berechtigungen verfügen: Sie können die Berechtigungen mit Webex Control Hub unter 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 Webex-APIs sind standardmäßig über Webdienste für kostenpflichtige Konten aktiviert.

Erstellen eines neuen Dienstkontos

Registrieren Sie sich hier: https://web.webex.com/. Verwenden Sie folgende URL für neue Dienstkonten: https://help.webex.com/en-us/nkhozs6/Get-Started-with-Cisco-Webex-Control-Hub.

Konfigurieren des OAuth-Servers

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

  1. Melden Sie sich hier mit Ihrem Dienstkonto an: https://developer.webex.com/docs/platform-introduction.
  2. Wählen Sie rechts oben den Benutzernamen aus.
  3. Wählen Sie My Webex Apps und dann Create a New App.
  4. Wählen Sie unter der Integrationskachel die Option Create an Integration.
  5. Füllen Sie die erforderlichen Felder aus und geben Sie im Feld Redirect URL die folgenden autorisierten Umleitungs-URLs für diese Integration ein:

    • https://{yourmicroappserverurl}/admin/api/gwsc/auth/serverContext
  6. Aktivieren Sie im Abschnitt Scopes die Kontrollkästchen spark:all und spark-admin:people_read.
  7. Wählen Sie Add Integration, nachdem Sie alle erforderlichen Felder ausgefüllt haben.
  8. 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 Webex-Integration zurückgeschrieben werden.

  1. Melden Sie sich wie oben mit Ihrem Dienstkonto an: https://developer.webex.com/docs/platform-introduction.
  2. Wählen Sie rechts oben den Benutzernamen aus.
  3. Wählen Sie My Webex Apps und dann Create a New App.
  4. Wählen Sie unter der Integrationskachel die Option Create an Integration.
  5. Füllen Sie die erforderlichen Felder aus und geben Sie im Feld Redirect URL die folgenden autorisierten Umleitungs-URLs für diese Integration ein:

    • https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback
  6. Aktivieren Sie im Abschnitt Scopes das Kontrollkästchen meeting:schedules_write.
  7. Wählen Sie Add Integration, nachdem Sie alle erforderlichen Felder ausgefüllt haben.
  8. 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 Webex 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 Webex Meetings-Kachel aus.
  3. Geben Sie einen Integrationsnamen ein.
  4. Geben Sie Connectorparameter ein.
    • Geben Sie die Basis-URL der Instanz ein: https://webexapis.com/v1/.
    • 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 Anforderungstext.
    3. Die Autorisierungs-URL ist vorausgefüllt: https://webexapis.com/v1/authorize
    4. Die Token-URL ist vorausgefüllt: https://webexapis.com/v1/access_token
    5. Stellen Sie sicher, dass Folgendes als Bereich eingegeben ist: spark:all spark-admin:people_read
    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 Anforderungstext.
    4. Die Autorisierungs-URL ist vorausgefüllt: https://webexapis.com/v1/authorize
    5. Die Token-URL ist vorausgefüllt: https://webexapis.com/v1/access_token
    6. Stellen Sie sicher, dass Folgendes als Bereich eingegeben ist: meeting:schedules_write
    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

  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.
  8. (Optional) Aktivieren Sie die Umschaltfläche Protokollierung, um 24-Stunden-Protokolle für Supportzwecke zu erstellen.

    Umschaltflächen für Ratenlimit und Protokollierung

  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

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

Verwenden der Webex Meetings-Mikroapp

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 Besprechung, und definieren Sie optional die Dauer, Zeitzonen, Teilnehmer und Co-Organisatoren.

Benachrichtigung oder Seite Workflows für Anwendungsfälle
Seite “Besprechung erstellen” Formular zum Planen einer Besprechung mit folgenden benutzerdefinierten Details: Besprechungstitel, Start- und Endzeit, Zeitzone, Wiederholung (einmal, täglich, wöchentlich, monatlich), Kennwort, Teilnehmer und Co-Organisator für die Besprechung.
Integration von Webex