4.20 Verbunddienste über Identitätsanbieter
Wenn Ihr Unternehmen die Dienste des Identitätsanbieters Auth0 oder Microsoft Entra ID nutzt, können Sie die von diesen Providern angebotene Funktionalität in Swyx integrieren.
Identitätsanbieter
URL zur Benutzerdokumentation
Auth0
Microsoft Entra ID
Funktionalität
Auth0 und Entra ID unterstützen die Verbundauthentifizierung. Dies ermöglicht eine automatische Anmeldung an SwyxServer, siehe 9.2 Authentifizierung für Clients.
 
Die Verbundauthentifizierung kann nur von Benutzern mit dem Funktionsprofil „Premium“ oder „Professional“ verwendet werden.
Wenn die Verbundauthentifizierung für den Server aktiviert ist, ist die Anmeldung mit einem Windows-Benutzerkonto nicht möglich: Benutzer ohne Lizenz können sich nur mit Benutzername und Kennwort anmelden.
 
Weitere Funktionen mit Microsoft Entra ID
*Kontakt-Synchronisierung
Die Kontakte der Entra ID Identität werden aufgelöst:
*Microsoft 365-Kontakte,
*Personen-Liste „relevant für“ oder „arbeiten mit“.
(Weitere Informationen zur Personen-API: learn.microsoft.com/de-de/graph/people-insights-overview).
Die synchronisierten Kontakte werden zur Auflösung von Rufnummern zu Namen verwendet, ähnlich wie persönliche Telefonbucheinträge.
*Kalender-Synchronisierung.
Die Verfügbarkeitsinformationen für den aktuellen und den nächsten Tag werden auf der Kontaktkarte in SwyxIt! Classic angezeigt (z.B. „Frei bis 13:30. Dann gebucht bis 14:30“).
Die Verfügbarkeitsinformationen können als Parameter für das Call-Routing verwendet werden.
Der Benutzer muss die Optionen
*„Als „Abwesend“ anzeigen, wenn ich lt. Kalender einen Termin habe.“ (standardmäßig aktiviert) und
*„Den Betreff meines Termins als Statustext anzeigen“
in SwyxIt! aktiviert haben.
*Teams Präsenz-Synchronisierung
Die Anzeige der Statusinformationen („Abgemeldet“, „Erreichbar“, „Spricht gerade“, „Nicht stören“, „Abwesend“) wird entsprechend den Daten aus Microsoft Teams angepasst. Die Synchronisierung kann je nach Einstellung in beide Richtungen erfolgen, für ausführlichere Informationen, siehe 4.20.1 Microsoft Teams Präsenz-Synchronisierung.
 
Die Synchronisierung der Kontakte erfolgt stündlich für jeden einzelnen Benutzer.
Kalender- und Teams-Präsenzinformationen werden alle 3 bis 5 Minuten für jeden einzelnen Benutzer synchronisiert.
Unter Allgemeine Einstellungen | Verbunddienste können Sie die Synchronisierung der von Ihnen aktivierten Funktionen manuell und für alle Benutzer zugleich anstoßen. Klicken Sie dazu auf die Schaltfläche oben Synchronisierung starten.
 
Voraussetzungen:
*Sie müssen ein Konto bei einem Identitätsanbieter besitzen, das Sie selber verwalten können.
*Die Swyx Anwendung muss in Ihrem Identitätsanbieter-Konto konfiguriert sein und über die entsprechenden Berechtigungen verfügen, siehe 4.20.2 Entra ID für Verbunddienste im Azure Portal einrichten.
*Alle Swyx Benutzer, welche die Verbundauthentifizierung und ggf. weitere Funktionen verwenden sollen, müssen im Benutzerverzeichnis bei Ihrem Identitätsanbieter konfiguriert und der Swyx Anwendung zugeordnet sein.
 
Clients müssen zum Identitätsanbieter-Dienst direkten Zugriff erhalten.
Stellen Sie sicher, dass der Port 443 nach außen geöffnet ist.
 
Nur Auth0
*Bei der SwyxIt! Installation muss die Option Auth0 Authentisierung aktiviert werden.
Nur Entra ID - Teams Präsenz
*Für die Funktion Teams Präsenz muss die Option „MS Teams Benutzerstatus“ während der SwyxServer Installation aktiviert werden. Als Folge wird der entsprechende SwyxServer Dienst "SwyxMsTeamsPresenceSync" installiert.
help.enreach.com/cpe/latest.version/Administration/Swyx/de-DE/#context/help/run_setup_$
 
Die Funktion „MS Teams Benutzerstatus“ wird bei der ersten Installation oder Aktualisierung standardmäßig nicht installiert.
 
 
Wenn der SwyxMsTeamsPresenceSync-Dienst noch nicht installiert wurde, führen Sie die SwyxServer Installationsdatei erneut aus: Wählen Sie im ersten Schritt die Option Ändern und aktivieren Sie im nächsten Schritt unter Telefonie die Funktion MS Teams Benutzerstatus. Anschließend lassen Sie den Konfigurationsassistenten erneut durchlaufen.
 
Konfiguration in Swyx Control Center:
*Sie müssen eine Identitätsanbieter-Konfiguration in Swyx Control Center erstellen, siehe 4.20.3 Identitätsanbieter-Konfiguration erstellen.
*Die gewünschte Identitätsanbieter-Konfiguration muss aktiviert sein, siehe 4.20.4 Identitätsanbieter-Konfiguration aktivieren/löschen.
*Für die gewünschten Swyx Benutzer mit dem Funktionsprofil „Premium“ oder „Professional“ muss die Verbundauthentifizierung aktiviert sein (über die Option Verbundauthentifizierung zulassen), siehe 9.5 Authentifizierungs-Einstellungen bearbeiten.
*Die Benutzernamen (UPN) beim Identitätsanbieter müssen den E-Mail-Adressen der Swyx Benutzer entsprechen.
 
Für die Teams Präsenz-Synchronisierung erkennt das System anhand der übereinstimmenden E-Mail-Adressen, welchem Verbundidentität der Swyx Benutzer zugeordnet wird. Stellen Sie sicher, dass die in der Benutzerkonfiguration eingegebene E-Mail-Adresse mit der E-Mail-Adresse (name.surname@company.com) des entsprechenden Identitätsanbieter-Kontos übereinstimmt, siehe 9.3 Benutzer erstellen.
 
 
Wenn die Entra ID Verbund aktiviert ist und sich der UPN des Benutzers ändert, wird die E-Mail-Adresse des Swyx-Benutzers entsprechend aktualisiert.
 
 
Wenn der Entra ID Verbund aktiviert ist und das Entra ID Benutzerkonto gelöscht wird, wird auch der entsprechende Swyx-Benutzer gelöscht.
Diese Option (Auszuführende Aktion, wenn die Entra ID Identität entfernt wird) kann geändert werden, siehe 4.20.6 Identitätsanbieter-Konfiguration bearbeiten.