| Weboberfläche der STARFACE | Menüpunkt "Admin" | Menüpunkt "Erweiterte Einstellungen" | Reiter "Microsoft Presence" |
|---|---|---|---|
|  |  |
|
Der Presence-Sync-Service ermöglicht die Synchronisierung von Präsenzinformationen zwischen Microsoft und STARFACE. Der Service bildet die technische Grundlage für Cloud Federation Presence. In diesem Reiter muss der Lese- und Schreibzugriff für die Synchronisation konfiguriert werden.
Für den Schreibzugriff muss die folgende Konfiguration vorgenommen werden:
| Feldname | Beschreibung |
|---|---|
| Verzeichnis-ID (Mandant) | In diesem Feld muss die Verzeichnis-ID bzw. Mandanten-ID eingetragen werden, die in der Microsoft Anwendung für den OAuth Zugriff generiert worden ist. |
| Client-ID | In diesem Feld muss die eindeutige Anwendungs-ID bzw. Client-ID eingetragen werden, die in der Microsoft Anwendung für den OAuth Zugriff generiert worden ist. |
| Client Geheimnis | In diesem Feld muss das Client Geheimnis eingetragen werden das für den Zugriff generiert worden ist. |
Nach der Konfiguration des Zugriffs kann durch Auswahl der Schaltfläche "Starte OAuth-Flow für Schreib-Zugriff" aktiviert werden. Die erfolgreiche Einrichtung des Schreibzugriffs wird durch eine entsprechende Meldung bestätigt.
Für den Schreibzugriff der STARFACE müssen im Entra Portal Berechtigungen zugewiesen werden. Die Konfigurationsseite findet sich im Entra Portal unter „Anwendungen“ und dann „App-Registrierungen“. Dort muss die App, deren Client-ID auf der STARFACE hinterlegt worden ist, bearbeitet werden.
Der API "Microsoft Graph" der ausgewählten App müssen die folgenden Anwendungsberechtigungen zugeordnet werden:
- Organization.ReadWrite.All
- Presence.ReadWrite.All
Sind diese Berechtigungen nicht erteilt, wird ein entsprechender Hinweis nach dem Start des OAuth-Flows ausgegeben.
Für den Lesezugriff muss die folgende Konfiguration vorgenommen werden:
| Feldname | Beschreibung |
|---|---|
| Client-ID | In diesem Feld muss die eindeutige Anwendungs-ID bzw. Client-ID eingetragen werden, die in der Microsoft Anwendung für den OAuth Zugriff generiert worden ist. |
| Client Geheimnis | In diesem Feld muss das Client Geheimnis eingetragen werden das für den Zugriff generiert worden ist. |
| Callback-URL | Aus diesem Feld heraus kann die Callback-URL kopiert werden. Diese Angabe wird für die Konfiguration auf der Seite von Microsoft benötigt und kann nicht direkt verändert werden. Die hier angezeigte Callback-URL, setzt sich aus dem Hostnamen der aktuell vom Anwender verwendet wird zusammen. Die Callback-URL wird also aus der aktuellen URL extrahiert, mit der der jeweilige Anwender auf die STARFACE zugegriffen hat. |
Hinweis: Es muss beachtet werden, dass die kopierte Callback-URL auch von allen Benutzern inner- und außerhalb des eigenen Netzwerks korrekt zu erreichen ist. Es wird empfohlen einen extern via HTTPS erreichbaren FQDN für den Zugriff zu nutzen.
Nach der Konfiguration des Zugriffs kann durch Auswahl der Schaltfläche "Starte OAuth-Flow für Lese-Zugriff" aktiviert werden. Die erfolgreiche Einrichtung des Lesezugriffs wird durch eine entsprechende Meldung bestätigt.
Für den Lesezugriff der STARFACE müssen im Entra Portal delegierte Berechtigungen zugewiesen werden. Die Konfigurationsseite findet sich im Entra-Portal unter „Anwendungen“ und dann „App-Registrierungen“. Dort muss die App, deren Client-ID auf der STARFACE hinterlegt worden ist, bearbeitet werden.
Der API "Microsoft Graph" der ausgewählten App müssen die folgenden delegierten Berechtigungen zugeordnet werden:
- User.Read.All
Umsetzung des Status zwischen Microsoft und STARFACE
Die aktuellen Regeln zur Synchronisation des Status zwischen Microsoft und STARFACE sind nicht frei konfigurierbar. Die Synchronisation funktioniert nur für Benutzer, die in beiden Systemen (Microsoft und STARFACE) die genau gleiche E-Mail-Adresse verwenden. Ändert sich die E-Mail-Adresse für einen Benutzer, muss die STARFACE neu gestartet werden. Alle anderen Änderungen an einem Benutzer werden ohne Neustart übernommen.
Es muss beachtet werden, dass der Status des Microsoft Benutzers von verschiedensten Anwendungen beeinflusst werden kann. Darum wird empfohlen im Fehlerfall zuerst eine Übersicht der Anwendungen zu erstellen die den Status des Benutzers auf Seite von Microsoft verändern können bzw. dürfen.
Der Synchronisierungsvorgang von Microsoft zur STARFACE findet alle 10 Sekunden statt.
Microsoft | Richtung | STARFACE |
|---|---|---|
Verfügbar | <---> | Verfügbar |
BUSY (in a call) | ---> | DND |
BUSY Meeting | Kein Mapping | |
BUSY manuell | Kein Mapping | |
BUSY (in a call) | <-- | Im Gespräch |
DND (Teams) | ---> | DND |
| Weboberfläche der STARFACE | Menüpunkt "Admin" | Menüpunkt "Erweiterte Einstellungen" | Reiter "Microsoft Presence" |
|---|---|---|---|
| | |
|
Der Presence-Sync-Service ermöglicht die Synchronisierung von Präsenzinformationen zwischen Microsoft und STARFACE. Der Service bildet die technische Grundlage für Cloud Federation Presence. In diesem Reiter muss der Lese- und Schreibzugriff für die Synchronisation konfiguriert werden.
Für den Schreibzugriff muss die folgende Konfiguration vorgenommen werden:
| Feldname | Beschreibung |
|---|---|
| Verzeichnis-ID (Mandant) | In diesem Feld muss die Verzeichnis-ID bzw. Mandanten-ID eingetragen werden, die in der Microsoft Anwendung für den OAuth Zugriff generiert worden ist. |
| Client-ID | In diesem Feld muss die eindeutige Anwendungs-ID bzw. Client-ID eingetragen werden, die in der Microsoft Anwendung für den OAuth Zugriff generiert worden ist. |
| Client Geheimnis | In diesem Feld muss das Client Geheimnis eingetragen werden das für den Zugriff generiert worden ist. |
Nach der Konfiguration des Zugriffs kann durch Auswahl der Schaltfläche "Starte OAuth-Flow für Schreib-Zugriff" aktiviert werden. Die erfolgreiche Einrichtung des Schreibzugriffs wird durch eine entsprechende Meldung bestätigt.
Für den Schreibzugriff der STARFACE müssen im Entra Portal Berechtigungen zugewiesen werden. Die Konfigurationsseite findet sich im Entra Portal unter „Anwendungen“ und dann „App-Registrierungen“. Dort muss die App, deren Client-ID auf der STARFACE hinterlegt worden ist, bearbeitet werden.
Der API "Microsoft Graph" der ausgewählten App müssen die folgenden Anwendungsberechtigungen zugeordnet werden:
- Organization.ReadWrite.All
- Presence.ReadWrite.All
Sind diese Berechtigungen nicht erteilt, wird ein entsprechender Hinweis nach dem Start des OAuth-Flows ausgegeben.
Für den Lesezugriff muss die folgende Konfiguration vorgenommen werden:
| Feldname | Beschreibung |
|---|---|
| Client-ID | In diesem Feld muss die eindeutige Anwendungs-ID bzw. Client-ID eingetragen werden, die in der Microsoft Anwendung für den OAuth Zugriff generiert worden ist. |
| Client Geheimnis | In diesem Feld muss das Client Geheimnis eingetragen werden das für den Zugriff generiert worden ist. |
| Callback-URL | Aus diesem Feld heraus kann die Callback-URL kopiert werden. Diese Angabe wird für die Konfiguration auf der Seite von Microsoft benötigt und kann nicht direkt verändert werden. Die hier angezeigte Callback-URL, setzt sich aus dem Hostnamen der aktuell vom Anwender verwendet wird zusammen. Die Callback-URL wird also aus der aktuellen URL extrahiert, mit der der jeweilige Anwender auf die STARFACE zugegriffen hat. |
Hinweis: Es muss beachtet werden, dass die kopierte Callback-URL auch von allen Benutzern inner- und außerhalb des eigenen Netzwerks korrekt zu erreichen ist. Es wird empfohlen einen extern via HTTPS erreichbaren FQDN für den Zugriff zu nutzen.
Nach der Konfiguration des Zugriffs kann durch Auswahl der Schaltfläche "Starte OAuth-Flow für Lese-Zugriff" aktiviert werden. Die erfolgreiche Einrichtung des Lesezugriffs wird durch eine entsprechende Meldung bestätigt.
Für den Lesezugriff der STARFACE müssen im Entra Portal delegierte Berechtigungen zugewiesen werden. Die Konfigurationsseite findet sich im Entra-Portal unter „Anwendungen“ und dann „App-Registrierungen“. Dort muss die App, deren Client-ID auf der STARFACE hinterlegt worden ist, bearbeitet werden.
Der API "Microsoft Graph" der ausgewählten App müssen die folgenden delegierten Berechtigungen zugeordnet werden:
- User.Read.All
Umsetzung des Status zwischen Microsoft und STARFACE
Die aktuellen Regeln zur Synchronisation des Status zwischen Microsoft und STARFACE sind nicht frei konfigurierbar. Die Synchronisation funktioniert nur für Benutzer, die in beiden Systemen (Microsoft und STARFACE) die genau gleiche E-Mail-Adresse verwenden. Ändert sich die E-Mail-Adresse für einen Benutzer, muss die STARFACE neu gestartet werden. Alle anderen Änderungen an einem Benutzer werden ohne Neustart übernommen.
Es muss beachtet werden, dass der Status des Microsoft Benutzers von verschiedensten Anwendungen beeinflusst werden kann. Darum wird empfohlen im Fehlerfall zuerst eine Übersicht der Anwendungen zu erstellen die den Status des Benutzers auf Seite von Microsoft verändern können bzw. dürfen.
Der Synchronisierungsvorgang von Microsoft zur STARFACE findet alle 10 Sekunden statt.
| Microsoft | Richtung | STARFACE |
|---|---|---|
Verfügbar | <---> | Verfügbar |
BUSY (Beschäftigt) Phone | ---> | DND (Do not disturb) |
BUSY (Beschäftigt) Meeting | ---> | DND (Do not disturb) |
BUSY (Beschäftigt) BUSY | ---> | DND (Do not disturb) |
BUSY (Beschäftigt) Phone | <--- | BUSY |