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. Es ist zu beachten das für für den Lesezugriff und den Schreibzugriff zwei getrennte Apps auf Microsoft Seite angelegt werden müssen.

Eintrag der Verzeichnis-ID

Unter "Identität" → "Übersicht" wird die Mandanten-ID (1) angezeigt. Diese ist in der Starface in das Feld "Verzeichnis-ID (Mandant)" (2) einzutragen.

Folgende Angaben sind innerhalb des Azure-Portals unter dem Reiter "App-Registrierung" einzutragen:

Schreib-Zugriff App in Entra konfigurieren

1. Auswahl der Schaltfläche "Neue Registrierung".
   
2. Funktionaler Name in das Feld "Name" eingeben.
3. In dem Auswahlfeld "Unterstütze Kontotypen" ist der Punkt "Nur Konten in diesem Organisationsverzeichnis" auszuwählen.
4. In dem Auswahlfeld "Umleitungs-URI (optional)" ist "Web" auszuwählen.
5. In das Textfeld "Umleitungs-URI (optional)" ist die Callback-URI einzutragen. Die Callback-URL findet sich auf der  STARFACE im Adminbereich in dem Reiter "Microsoft Presence" befindet (siehe Screenshot).

Klicke auf den Button "Registrieren".

Bei erfolgreicher Speicherung erscheint folgende Meldung:

Berechtigungen für die Schreib-Zugriff App hinzufügen

Für den Schreibzugriff der STARFACE müssen im Entra Portal Berechtigungen zugewiesen werden. Die Konfigurationsseite findet sich im Entra Portal unter „API-Berechtigungen“ -> „Berechtigung hinzufügen" Dort müssen die Berechtigungen für die Schreib-Zugriff App, deren Client-ID auf der STARFACE hinterlegt worden ist, bearbeitet werden.

Die Einrichtung der Berechtigungen für die API "Microsoft Graph" wird folgendermaßen durchgeführt:

1. Klicke zuerst auf die Schaltfläche "Microsoft Graph".

2. Dann auf "Anwendungsberechtigung".

3. Im Suchfeld sind die aufgelisteten Berechtigungbezeichnungen einzugeben und mit dem Kontrollhäkchen auf der linken Seite auszuwählen.

• Organization.ReadWrite.All
• Presence.ReadWrite.All
• User.Read

4. Klicke auf den Button "Berechtigung hinzufügen."

5. Es erscheint anschließend folgende erfolgreiche Meldung:

6. Es erscheint anschließend folgende Meldung:

Sind diese Berechtigungen nicht erteilt, wird ein entsprechender Hinweis nach dem Start des OAuth-Flows ausgegeben.

Weitere Berechtigungen konfigurieren

1. Unter "Verwalten" → "Authentifizierung" sind zwei Häkchen bei "Zugriffstoken (werden für implizite Flows verwendet)" und bei "ID-Token (werden für implizite und Hybridflows verwendet" zu setzen (siehe Screenshot).

2. Unter "Verwalten" → "Authentifizierung" ist der Toggle-Button bei "Erweiterte Einstellungen" → "Öffentliche Clientflows zulassen" auf "Ja" zu setzen.

3. Klicke auf den Button "Speichern".

Clientschlüssel-Generierung für die Schreib-Zugriff App konfigurieren

Um einen neuen Clientschlüssel zu generieren, ist im Entra Portal der Reiter "Zertifikate & Geheimnisse" aufzurufen.

1. Dies erfolgt über die Schaltfläche "Neuer geheimer Clientschlüssel".
2. Für den neuen Clientschlüssel muss zunächst eine Beschreibung und eine beliebig lange Gültigkeitsdauer definiert werden. Es wird empfohlen eine möglichst lange Gültigkeitsdauer auszuwählen.
3. Klicke auf den Button "Hinzufügen".

Es erscheint folgende Meldung:

Anschließend ist der rot markierte Bereich des Feldes "Wert" (1) zu kopieren und auf der STARFACE in das Feld "Client Geheimnis" (2) einzufügen.

Der Vorgang ist mit der Schaltfläche "Übernehmen" auf der STARFACE  abzuschließen.

Um die Anwendung zu starten, die Schaltfläche "Start OAuth-Flow für Schreib-Zugriff" auswählen.

Schreib-Zugriff auf der STARFACE konfigurieren

 In das Feld "Client-ID" auf der STARFACE ist folgender Eintrag aus dem Microsoft Entra Portal einzutragen (ablesbar aus dem Reiter "Übersicht"):

Berechtigungen der Schreib-Zugriffs einstellen 

Für den Schreibzugriff muss die folgende Konfiguration vorgenommen werden:

Lese-Zugriff App in Entra konfigurieren

1. Auswahl der Schaltfläche "Neue Registrierung".
   
2. Funktionaler Name in das Feld "Name" eingeben.
3. In dem Auswahlfeld "Unterstütze Kontotypen" ist der Punkt "Nur Konten in diesem Organisationsverzeichnis" auszuwählen.
4. In dem Auswahlfeld "Umleitungs-URI (optional)" ist "Web" auszuwählen.
5. In das Textfeld "Umleitungs-URI (optional)" ist die Callback-URI einzutragen. Die Callback-URL findet sich auf der  STARFACE im Adminbereich in dem Reiter "Microsoft Presence" befindet (siehe Screenshot).

Folgende Kriterien müssen für die Umleitungs-URI beachtet werden:

Klicke auf den Button "Registrieren".

Bei erfolgreicher Speicherung erscheint folgende Meldung:

Berechtigungen für die Lese-Zugriff App hinzufügen

Für den Lesezugriff der STARFACE müssen im Entra Portal Berechtigungen zugewiesen werden. Die Konfigurationsseite findet sich im Entra Portal unter „API-Berechtigungen“ -> „Berechtigung hinzufügen" Dort müssen die Berechtigungen für die Lese-Zugriff App, deren Client-ID auf der STARFACE hinterlegt worden ist, bearbeitet werden.

Die Einrichtung der Berechtigungen für die API "Microsoft Graph" wird folgendermaßen durchgeführt:

1. Klicke zuerst auf die Schaltfläche "Microsoft Graph".

2. Dann auf "Delegierte Berechtigungen".

3. Im Suchfeld sind die aufgelisteten Berechtigungbezeichnungen einzugeben und mit dem Kontrollhäkchen auf der linken Seite auszuwählen.

• offline_access
• openid
• User.Read
• User.Read.All

4. Klicke auf den Button "Berechtigung hinzufügen."

5. Es erscheint anschließend folgende erfolgreiche Meldung:

6. Es erscheint anschließend folgende erfolgreiche Meldung:

Sind diese Berechtigungen nicht erteilt, wird ein entsprechender Hinweis nach dem Start des OAuth-Flows ausgegeben.

Clientschlüssel-Generierung für die Lese-Zugriff App konfigurieren

Um einen neuen Clientschlüssel zu generieren, ist im Entra Portal der Reiter "Zertifikate & Geheimnisse" aufzurufen.

Dies erfolgt über die Schaltfläche "Neuer geheimer Clientschlüssel".

Für den neuen Clientschlüssel muss zunächst eine Beschreibung und eine beliebig lange Gültigkeitsdauer definiert werden. Es wird empfohlen eine möglichst lange Gültigkeitsdauer auszuwählen.

Klicke auf den Button "Hinzufügen".

Es erscheint folgende Meldung:

Anschließend ist der rot markierte Bereich des Feldes "Wert" (1) zu kopieren und auf der STARFACE in das Feld "Client Geheimnis" (2) einzufügen.

Der Vorgang ist mit der Schaltfläche "Übernehmen" auf der STARFACE  abzuschließen.

Um die Anwendung zu starten, die Schaltfläche "Start OAuth-Flow für Lese-Zugriff" auswählen.

Lese-Zugriff auf der STARFACE konfigurieren

 In das Feld "Client-ID" auf der STARFACE ist folgender Eintrag aus dem Microsoft Entra Portal einzutragen (ablesbar aus dem Reiter "Übersicht"):

Berechtigungen der Lese-Zugriffs einstellen 

Für den Schreibzugriff muss die folgende Konfiguration vorgenommen werden:

Weitere Konfigurationsschritte

Die STARFACE muss nach allen vorherigen Schritten neu gestartet werden (siehe VERWEIS AUF PASSENDE ONLINEDOKUMENTATION).

Nach dem Neustart müssen in dem Logfile "Name des Logfiles" (siehe Log-Dateien auf der Weboberfläche der STARFACE einsehen) die folgenden Meldungen ausgeführt werden: "Microsoft user list refreshed: 0 users found."

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.

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:

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:

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.