Zum Hauptinhalt springen
Verfügbar im Tarif Enterprise. Nur Organisationsinhaber können die Verzeichnissynchronisierung konfigurieren.

Übersicht

SCIM (System for Cross-domain Identity Management) 2.0 verbindet Wave Connect mit Ihrem Identity Provider, sodass Benutzerkonten automatisch verwaltet werden. Wenn Sie einen Benutzer in Ihrem IdP hinzufügen, aktualisieren oder entfernen, wird die Änderung ohne manuelle Aktion in Wave Connect übernommen. Wave Connect stellt die SCIM-Ressourcen Users und Groups mit GET, POST, PUT, PATCH und DELETE bereit. Filter unterstützen einen einzelnen eq-Vergleich auf oberster Ebene, den Identity Provider verwenden, um einen Benutzer anhand von userName oder externalId zu suchen.

Einrichtung

1

Verzeichnissynchronisierung öffnen

Gehen Sie zu Einstellungen → Sicherheit. Klicken Sie auf der Karte Verzeichnis-Synchronisierung auf Konfigurieren, um das Modal SCIM konfigurieren zu öffnen.
2

SCIM-Endpunkt kopieren

Der SCIM-Endpunkt ist https://app.wavecnct.com/api/scim. Kopieren Sie ihn. Ihr Identity Provider nennt ihn Mandanten-URL oder Basis-URL.
3

SCIM-Token erstellen

Klicken Sie auf Token erstellen, geben Sie dem Token einen Namen und klicken Sie auf Erstellen. Kopieren Sie das Token sofort. Es wird nur einmal angezeigt. Ihr IdP sendet das Token als Bearer-Token.
4

Identity Provider konfigurieren

Richten Sie in Ihrem IdP die automatische Bereitstellung für Wave Connect mit dem Endpunkt und dem Token ein. Ordnen Sie Ihre Benutzerattribute den SCIM-Attributen unten zu.
5

Bereitstellung testen

Weisen Sie einen Testbenutzer in Ihrem IdP zu und prüfen Sie, ob sein Wave Connect-Konto unter Benutzer mit dem richtigen Namen, der richtigen E-Mail und dem richtigen Team erscheint.
SCIM-Tokens erscheinen auch auf der Karte Tokens unter Einstellungen → Sicherheit mit dem Bereich SCIM verwalten. Dort können Sie ein Token löschen, um Ihren IdP abzuschneiden. Tokens werden automatisch gelöscht, wenn die Organisation den Tarif Enterprise verlässt.

Anleitungen für Identity Provider

Microsoft Entra ID

Schritt-für-Schritt-Einrichtung der Unternehmensanwendung, Attributzuordnungen und Offboarding.

Okta und Google Workspace

Folgen Sie den allgemeinen Schritten auf dieser Seite. Verwenden Sie den Endpunkt als Basis-URL und das Token als Bearer-Token.

Attributzuordnung

Wave Connect liest diese Attribute aus der SCIM-Ressource User: Telefonnummern werden validiert und im internationalen Format gespeichert. Ungültige Werte und Platzhalter, die nur aus einer Durchwahl bestehen, werden verworfen, statt die Anfrage fehlschlagen zu lassen. Ein locale-Wert, den Wave Connect nicht unterstützt, fällt auf Englisch zurück. Die Enterprise-Erweiterung department wird nicht im Profil gespeichert. Eine abteilungsbasierte Team-Zuweisung kann vom Wave Connect-Support aktiviert werden. Wenn ein Benutzer erstellt wird und die E-Mail bereits einem Mitglied Ihrer Organisation gehört, wird stattdessen das vorhandene Mitglied aktualisiert. Gehört die E-Mail zu einem persönlichen Wave Connect-Konto auf einer Ihrer verifizierten Domains, wird dieses Konto in Ihre Organisation verschoben und bleibt erhalten, einschließlich seiner Karte und Kontakte.

Team-Zuordnung

Wenn SCIM aktiviert ist, werden Gruppen in Ihrem Identity Provider als Teams in Wave Connect synchronisiert. Zum Beispiel werden Gruppen, die der Wave Connect-Anwendung in Microsoft Entra ID zugewiesen sind, automatisch als Teams in Wave Connect erstellt. Mitglieder, die einer Gruppe zugewiesen sind, werden dem entsprechenden Team hinzugefügt. Der displayName der Gruppe wird zum Teamnamen und die externalId der Gruppe wird im Team gespeichert. Wenn bereits ein Team mit demselben Namen existiert, wird die Gruppe darin zusammengeführt. Ein Benutzer gehört zu einem Team. Ist ein Benutzer also in mehreren Gruppen, gewinnt die zuletzt bereitgestellte. Eine Organisation kann bis zu 75 Teams haben. Das Löschen einer Gruppe löscht das Team. Seine Benutzer bleiben erhalten und seine Kontakte werden in die Organisation verschoben. Damit können Sie Ihre Wave Connect-Teamstruktur direkt aus Ihrem IdP verwalten, ohne manuelle Team-Einrichtung in Wave Connect. Jedem Wave Connect-Team kann eine andere Vorlage zugewiesen werden, sodass Benutzer in verschiedenen Gruppen automatisch das richtige Kartenlayout, Branding und die richtigen gesperrten Felder für ihre Abteilung oder Rolle erhalten. Weitere Informationen finden Sie unter Vorlagen.

Deprovisionierung

Wenn die Zuweisung eines Benutzers zur Wave Connect-Anwendung in Ihrem IdP aufgehoben wird, setzt der IdP active auf false. Wave Connect deaktiviert das Konto:
  • Der Benutzer kann sich nicht mehr anmelden und seine Sitzungen werden widerrufen.
  • Er erscheint mit dem Badge SUSPENDED unter Benutzer.
  • Seine NFC-Karte bleibt verknüpft, und sein Profil und seine Kontakte bleiben erhalten.
  • Er zählt weiterhin als Lizenz, bis er gelöscht wird.
Wird active wieder auf true gesetzt (zum Beispiel durch erneutes Zuweisen des Benutzers), wird das Konto reaktiviert. Wenn Ihr IdP eine DELETE-Anfrage sendet, löscht Wave Connect den Benutzer dauerhaft: Sein Profil und seine Kontakte werden entfernt und seine NFC-Karte wird getrennt, damit sie jemand anderem zugewiesen werden kann.
Einige Identity Provider (wie Microsoft Entra ID) sperren Benutzerkonten für eine 30-tägige Kulanzfrist, bevor sie dauerhaft gelöscht werden. Standardmäßig folgt Wave Connect diesem Verhalten und deaktiviert das Konto während dieses Zeitraums. Um die Kulanzfrist zu überspringen, öffnen Sie Einstellungen → Sicherheit → Verzeichnis-Synchronisierung → Konfigurieren und aktivieren Sie Benutzer sofort löschen, anstatt ihn zu sperren. Die Deaktivierung löscht den Benutzer dann sofort dauerhaft.