Hilfe Die Plattform Import und SSO
Personen importieren und SSO einrichten
Auf dieser Seite
Wozu ein Import dient
Ein Import holt die Personen und Gruppen eines Verzeichnisses (Entra ID, LDAP / Active Directory, Google Workspace, Okta, Keycloak) in die Organisation und hält sie aktuell, oder jene einer CSV-Datei, die Sie hochladen. LDAP und CSV erlauben kein SSO. Mehrere Importe sind möglich, zum Beispiel einer pro Standort.
Nur der Administrator der Organisation erstellt, bearbeitet, startet oder löscht einen Import; die Berechtigung Personen verwalten gibt nur Lesezugriff. Was beim Anbieter vorzubereiten ist, steht in seinem Artikel:
Verbindung mit dem Anbieter
Nichts gelangt in die Organisation vor dem letzten Schritt, Start. Verbindung testen speichert nichts: Klicken Sie nach einem erfolgreichen Test auf Speichern und weiter.
- Das Geheimnis (Passwort, Client-Secret, Token oder Schlüssel) wird nie wieder angezeigt. Leer gelassen, bleibt es erhalten.
- Wenn Sie eine andere Verbindungseinstellung ändern, geben Sie auch das Geheimnis erneut ein, sonst wird das Speichern abgelehnt.
- Bei einem Fehlschlag nennt die Meldung die Ursache nicht: Prüfen Sie die Einstellungen und Rechte aus dem Artikel des Anbieters.
Wenn Ihre Organisation ihre Daten verschlüsselt, fragt der bei Ihnen installierte Bexxo Protected Agent das Verzeichnis ab, nicht unsere Server. Der Tresor muss entsperrt sein, um die Verbindung zu lesen oder zu ändern. Der Test und die Gruppensuche laufen über den Agenten: Kommt nach 10 Minuten keine Antwort, prüfen Sie, ob er gestartet ist. Eine Verbindung, die vor der Inbetriebnahme der Verschlüsselung gespeichert wurde, muss vollständig neu eingegeben werden, einschliesslich des Geheimnisses.
Wer importiert wird, mit welchen Daten
Importierte Gruppen
Nur die Mitglieder der ausgewählten Gruppen werden importiert; ohne ausgewählte Gruppe wird das ganze Verzeichnis importiert. Die Suche zeigt höchstens 50 Gruppen: Verfeinern Sie den Text, wenn Ihre nicht erscheint.
Wenn eine ausgewählte Gruppe im Verzeichnis nicht mehr vorhanden ist oder die ausgewählten Gruppen keine Mitglieder haben, schlägt die Synchronisierung fehl, ohne etwas zu importieren.
Filter
Filter behalten oder verwerfen Personen oder Gruppen anhand eines Attributs (Abteilung, Kontotyp…). Wichtig zu wissen:
- Gross- und Kleinschreibung werden ignoriert;
- das UND oder ODER einer Zeile verbindet sie mit dem Ergebnis der vorherigen Zeilen;
- In der Liste erwartet durch Semikolon getrennte Werte, zum Beispiel
Vertrieb;Marketing; - Ungleich, Enthält nicht und Nicht in der Liste gelten als erfüllt, wenn das Attribut fehlt;
- noch kein Anbieter wendet Bedingungen vom Typ Mitgliedschaft an.
Felder
Die Liste der Felder ist fest; ein Feld ohne Attribut wird nicht importiert. Die Attribute sind je nach Anbieter vorausgefüllt.
Wählen Sie in den erweiterten Optionen Nur bei der Erstellung für ein Feld, das von Hand zu korrigieren ist: Im Modus Synchronisiert überschreibt es jede Synchronisierung. Ein fehlendes Attribut ändert das Feld nicht; ein Attribut mit mehreren Werten liefert nur den ersten, auch in den Filtern. Für die Sprache werden nur fr, de, en und it übernommen («fr-CH» wird zu «fr»); eine andere Sprache wird ignoriert und im Protokoll vermerkt.
Zugang und Rechte
Ein neuer Import erstellt keinen Zugang: Die Personen kommen ohne Konto und ohne Einladung herein, und nur die PhishTrainer-Rolle Ziel kann ihnen vergeben werden, da sich ein Ziel nie anmeldet. Um ein Recht zu vergeben, das eine Anmeldung erfordert, schalten Sie den Schalter im Bereich Mit Anmeldung am Portal ein: Jede Person ohne Konto erhält dann eines, mit einer Einladung. Ein beiseitegelassener Dienst wird niemandem vergeben oder entzogen, und Sie können ihn danach unter Personen einstellen.
Simulieren, synchronisieren, planen
Die Schaltflächen des Schritts Start bleiben inaktiv, solange die Verbindung nicht gespeichert ist oder die Felder nicht festgelegt sind. Simulieren Sie vor der ersten Synchronisierung und nach jeder Änderung von Gruppen, Filtern oder Feldern: Die Simulation zeigt die vorgesehene Aktion für jedes Objekt, ohne etwas zu schreiben.
Eine von Hand gestartete Synchronisierung beginnt beim nächsten Durchlauf des Servers; ein Abbrechen macht das bereits Erledigte nicht rückgängig.
Wenn der Import Zugänge erstellt (Schritt Zugang und Rechte), erstellt eine echte Synchronisierung die Anmeldekonten der Personen, die keines haben, und sendet jeder eine Einladung per E-Mail; sind es viele, gehen die Einladungen in Stapeln hinaus. Ein Konto, das bereits ein Passwort hat, wird nie zurückgesetzt.
Personen, die nicht mehr im Verzeichnis sind
Was der Import hereingeholt hat und nicht mehr vorhanden ist (aus dem Verzeichnis gelöscht, aus den ausgewählten Gruppen entfernt oder durch einen Filter ausgeschlossen), folgt Ihrer Wahl: Mit Deaktivieren verliert die Person die vom Import vergebenen Zugänge; mit Löschen wird sie aus der Organisation und ihren Gruppen entfernt, und eine Gruppe wird mit ihren Mitgliedschaften gelöscht. Eine Person, die noch von einem anderen aktiven Import geliefert wird, bleibt unberührt.
Das Protokoll nennt den Grund für jede ignorierte Zeile. Eine Person wird abgelehnt, wenn ihre E-Mail-Adresse bereits für eine andere Organisation besteht oder wenn ihre Domain nicht zu den zugelassenen E-Mail-Domains Ihrer Organisation gehört: Wenden Sie sich an uns. Das Abwählen von Import aktiv setzt die automatische Synchronisierung aus.
Das Löschen eines Imports entfernt seine Konfiguration; die bereits synchronisierten Personen und Gruppen bleiben in der Organisation. Lesen Sie für einen Import mit SSO zuerst «SSO abschalten».
Import einer CSV-Datei
Ohne Verzeichnis laden Sie eine Datei hoch. Sie wird in Ihrem Browser gelesen: Nur die Werte der ausgewählten Spalten werden gesendet.
- Die Spaltennamen sind frei: Im Schritt Felder wählen Sie die Spalte jedes zu importierenden Feldes, und die der Vorlage werden automatisch erkannt.
- Eine Spalte muss der E-Mail zugeordnet sein: Sie identifiziert die Person, ausser die Datei enthält eine Spalte namens
externalId. Eine Person erneut zu importieren aktualisiert ihre Felder, ohne ein Duplikat zu erstellen. - Anrede:
Herr,FrauoderDoktor(auch Dr). Sprache:fr,de,enoderit. Ein anderer Wert wird ignoriert, ohne die Person auszuschliessen. - Gruppen: bis zu drei pro Person, eine Spalte pro Gruppe (
group1bisgroup3in der Vorlage). Der Name wird ohne Beachtung der Gross- und Kleinschreibung verglichen. Eine fehlende Gruppe wird beim Start erstellt und dann unter Gruppen wie eine von Hand erstellte Gruppe verwaltet. Eine von einem Verzeichnis gepflegte Gruppe wird nicht aus einer Datei gespeist.
Wenn der Import Zugänge erstellt (Schritt Zugang und Rechte), erstellt der Start die Anmeldekonten der Personen, die keines haben, und sendet ihnen eine Einladung. Vor dem Start zeigt der Schritt Start die Anzahl der zu importierenden Personen, die beiseitegelassenen Zeilen mit ihrem Grund und die Adressen, deren Domain nicht zugelassen ist; die Anzahl der erstellten oder aktualisierten Personen lesen Sie danach im Verlauf.
Ein Dateiimport hat weder Frequenz noch Simulation. Er fügt Personen hinzu und aktualisiert die ihm bekannten, ohne jemanden zu deaktivieren oder zu löschen und ohne jemanden aus einer Gruppe zu entfernen: Eine in der nächsten Datei fehlende Person bleibt in der Organisation; ist sie ausgeschieden, entziehen Sie ihr die Zugänge unter Personen. Die Einstellungen (Felder, Filter, Rechte) bleiben für die nächste Datei erhalten.
SSO-Anmeldung
SSO (OpenID Connect) ermöglicht die Anmeldung mit dem Firmenkonto. Es gibt es für Entra ID, Google Workspace, Okta und Keycloak und verlangt beim Anbieter eine Anmeldeanwendung, die von den Parametern des Schritts Verbindung getrennt ist (siehe den Artikel des Anbieters).
Standardwerte: Scopes openid profile email (openid erforderlich), Claims sub, email, given_name und family_name. Deklarieren Sie beim Anbieter alle angezeigten Redirect-URLs (Portal und Academy), und prüfen Sie dann mit Discovery testen: Der Aussteller muss aus dem Internet erreichbar sein.
SSO aktivieren
Das Speichern dieser Parameter aktiviert das SSO nicht: Wenden Sie sich zum Aktivieren an den Support. Danach erstellen die Synchronisierungen die Konten ohne Passwort und ohne Einladung, und eine Person ohne E-Mail im Verzeichnis erhält kein Konto.
SSO abschalten
Das Leeren des Aussteller (issuer), das Abwählen von Import aktiv beim SSO-Import oder das Löschen dieses Imports schaltet das SSO für die ganze Organisation ab.
Konten ohne Passwort verlieren den SSO-Zugang. Die nächste Synchronisierung stellt ihnen einen Zugang mit Passwort und Einladung wieder her. Eine Person, die vor dieser Synchronisierung «Passwort vergessen» nutzt, kann nie mehr mit dem SSO verbunden werden.
Keine Antwort gefunden? Kontakt aufnehmen