MS Teams Integration für STARFACE konfigurieren

1) Zusammenfassung

Die STARFACE Microsoft Teams Integration besteht aus den folgenden Komponenten:

• STARFACE Modul für MS Teams (Version 20230504) für 7.1 bis 8.0
• STARFACE Modul für MS Teams (Version20230921) für 8.1
• STARFACE App für MS Teams (Version 1.0.4)
• STARFACE Lizenz für Microsoft Teams

2) Allgemeine Technische Voraussetzungen

Damit die Anbindung der STARFACE an MS Teams durchgeführt werden kann, müssen die folgenden Voraussetzungen erfüllt sein:

• Es wird die Version 7.1.0.3 oder höher der STARFACE genutzt.
• Für jeden Benutzer, der die Integration nutzen soll, ist eine Lizenz vom Typ "Premium App" auf der STARFACE eingespielt.
• Für jeden Benutzer, der die Integration nutzen soll, ist eine Lizenz vom Typ "MS Teams Integration" auf der STARFACE eingespielt.

• Bei jedem Benutzer, der die Integration nutzen soll, muss jeweils die STARFACE App für Windows oder die STARFACE App für macOS aktiv sein.

• Chrome wird mit der Version 90.0.4430.72 oder höher genutzt

Die STARFACE und die genutzten Endgeräte haben unbeschränkten Zugriff via HTTPS (Port 443) auf die folgenden Serveradressen. Zusätzlich müssen die folgenden Serveradressen auch eingehend via HTTPS (Port 443) auf die STARFACE und die genutzten Endgeräte zugreifen können:

• login.microsoftonline.com
• teams.starface.com

Für das NATS-Protokoll muss der Port 4222 für eingehende und ausgehende Daten freigegeben sein.

3) Support

In den folgenden Bereichen kann Sie der STARFACE Support während der Einrichtung der Teams Integration unterstützen:

• Einrichtung und Lizenzierung des STARFACE Teams Integration Moduls

Zu folgenden Komponenten können wir Ihnen keinen Support anbieten:

• MS Teams und dessen Konfiguration

4) Lizenzen auf der STARFACE einspielen

Für jeden Benutzer, der die Integration nutzen soll, muss eine Lizenz vom Typ "MS Teams Integration" und eine Lizenz vom Typ "Premium App" auf der STARFACE zur Verfügung stehen. Darum sollten immer zuerst die notwendigen Lizenzen eingespielt werden (siehe Neue Lizenzen in die STARFACE einspielen). Die Lizenzen für die "MS Teams Integration für STARFACE" können im Lizenzmanagement erworben werden. Lizenzen, die über den Lizenzmanager erworben werden, sind nach der Bestellung automatisch auf der STARFACE hinterlegt.

5) Berechtigungen für die Benutzer konfigurieren

Jeder Benutzer, der die Integration nutzen soll, muss das Recht "App Premium-Funktionen" und das Recht "Integration mit Microsoft Teams" zugewiesen bekommen (siehe Rechte eines Benutzer konfigurieren).

6) Modulkonfiguration erstellen

Nachdem das Modul "Teams Integration" (Link zum Download) eingespielt worden ist (siehe Import von neuen Modulen), kann eine neue Modulkonfiguration erstellt werden (siehe Neue Konfiguration für ein Modul erstellen).

7) Modul konfigurieren

In dem Reiter "Allgemein" ist der Name der Modulkonfiguration hinterlegt.

In dem Reiter "Moduleinstellungen" und dem Unterreiter "Grundeinstellungen" werden die allgemeinen Einstellungen für das Modul konfiguriert. Hier können folgende Einstellungen vorgenommen werden:

Name der Anlage: In diesem Eingabefeld muss ein eindeutiger Schlüssel in Textform eingegeben werden. Wir empfehlen dafür den FQDN der STARFACE zu nutzen. Die Angabe aus diesem Textfeld muss später in der STARFACE App für MS Teams beim Login in dem Feld „STARFACE Hostname“ eingetragen werden.

Schlüssel zur Anlage: In diesem Feld wird der aktuelle Schlüssel der STARFACE für die Integration angezeigt. Aus Sicherheitsgründen kann der Schlüssel nicht manuell eingetragen werden, sondern nur über die Schaltfläche "Neuen Schlüssel eintragen" automatisch generiert werden. Nachdem die Konfiguration gespeichert wurde, kann auch die Schlüsseldatei heruntergeladen werden. Die Schlüsseldatei kann später in der STARFACE App für Teams hochgeladen werden. Die Nutzung der Schlüsseldatei ist aber nicht zwingend notwendig. Alle Nutzer benötigen zwingend für die Anmeldung der Integration den Namen und Schlüssel der Anlage. Daher muss dieser den Nutzern bereitgestellt werden.

Logging: In diesem Bereich können die Logs der STARFACE MS Teams Integration in verschiedenen LOG Levels herunterladen werden.

UCI Connector: Der UCI Connector ist ein lokaler Dienst zur Anbindung von Teams an die STARFACE. Um die STARFACE in Teams zu verwenden, muss der UCI Connector aktiviert sein.

In dem Reiter "Moduleinstellungen" und dem Unterreiter "Autoprovisionierung" kann flächendeckend die Rechteverwaltung für die gesamte Organisation über das eigene Microsoft Tenant freigeben werden. Hierfür muss der Systemadministrator sich einmalig mit seinem Microsoft Konto anmelden. Sind mehrere STARFACE in Betrieb kann in diesem Unterreiter auch die primäre STARFACE via Checkbox ausgewählt werden.

8) STARFACE App für MS Teams installieren

Die Installation der STARFACE App für Microsoft Teams erfolgt in drei Schritten:

1. Nachdem die App heruntergeladen worden ist (Link zum Download) muss sie von einem Administrator auf alle gewünschten Zielsysteme verteilt werden. Eine Anleitung dafür findet sich direkt In der Wissensdatenbank von Microsoft (Link zur Dokumentation von Microsoft).
2. In der STARFACE App für MS Teams muss nach der Installation der konfigurierte Name der Anlage und der generierte Schlüssel hinterlegt werden. Alternativ kann die Schlüsseldatei via Drag&Drop in das Anmeldefenster gezogen werden.
3. Zuletzt müssen Zugangsdaten des Benutzers auf der STARFACE eingetragen werden.

Alternativ zu Schritt 1 kann die STARFACE App für MS Teams auch manuell als benutzerdefinierte App vom jeweiligen Benutzer hochgeladen werden. Wird dies für die gesamte Organisation durchgeführt, ist zu beachten das es bis zu 24 Stunden dauern kann, bis die App allen Mitgliedern zur Verfügung steht.

9) Migration auf neue Infrastruktur

Wenn die STARFACE MS Teams Integration von Fluxpunkt in der Vergangenheit genutzt wurde, sollte dringend ein Umzug auf die neue STARFACE Infrastruktur vorgenommen werden. Hierfür gibt es einen ausführlichen Migrationspfad im Support Forum (Link zum Support Forum).