Secure FTP (SFTP)

Du kannst Deine Nutzerimporte mithilfe von SFTP automatisieren. Das ermöglicht es Dir, Deine Nutzerdaten in für Dein Unternehmen geeigneten Zeitabständen zu aktualisieren, und bietet dennoch die gesamte Funktionalität des Nutzerimports über den Admin-Bereich, darunter:

• Nutzer erstellen
• Bestehende Nutzer aktualisieren
• Gruppenmitgliedschaften verwalten
• Automatische Aktivierung oder Sperrung von Nutzern

Indem Du die Nutzerimporte über SFTP automatisierst, kannst Du Daten, die in anderen Systemen als Deinem Hauptnutzerverzeichnis gespeichert sind, zusammenführen, um die Profile Deiner Nutzer zu vervollständigen.

Vorraussetzungen

Um einen erfolgreichen Import der Benutzerdatei zu gewährleisten, musst Du darauf achten, dass die Datei nur Spalten enthält, die den Profilfeldern, Gruppen und Standorten zugeordnet werden können. Außerdem ist es wichtig, dass die Spaltenüberschriften die exakte, von Beekeeper geforderte Schreibweise aufweisen. Der beste Weg, um sicherzustellen, dass die Spaltenüberschriften korrekt sind, ist, die Vorlage herunterzuladen:

1. Wähle in der seitlichen Navigation des Admin-Bereichs das Register „Nutzer & Gruppen“.
2. Wähle das Unterregister „Nutzer“."
3. Klicke auf „Exportieren“, um die Nutzervorlage herunterzuladen."
4. Lösche alle Spalten mit blauen Überschriften, da diese für den Import nicht gebraucht werden.

Weitere Informationen zum direkten Upload von Excel/CSV-Dateien in Beekeeper findest Du in diesem Artikel.

Einrichtung

Das Diagramm unten gibt einen Überblick darüber, wie die Nutzersynchronisierung über SFTP funktioniert.

Die Einrichtung:

1. Exportiere die Nutzerdaten aus deinem Personalverwaltungssystem (z. B. Active Directory, SAP).
2. Bearbeite die Nutzerdatei entsprechend der Anforderungen von Beekeeper (das Format ist das gleiche wie beim CSV-Nutzerimport, das hier beschrieben wird).
3. (Optional) Verschlüssle die Datei für mehr Sicherheit mit PGP. Lade hier unseren öffentlichen PGP-Schlüssel herunter.
4. Schicke die Datei mittels eines FTP-Clients an die Beekeeper-Server. Wir unterstützen offiziell FileZilla, WinSCP, CoreFTP und Cyberduck. Manche unserer Nutzer hatten auch mit anderen FTP-Clients Erfolg, für diese können wir aber keine Unterstützung garantieren. (Bitte beachte, dass die Excel-Datei bei der Verwendung von FileZilla weder in der Tabelle noch im Dateinamen Sonderzeichen enthalten darf.)

Du kannst Deine Nutzerimporte automatisieren, indem Du — wenn Dein Personalverwaltungssystem das unterstützt — Berichte planst oder eine Workflow-Automatisierungslösung wie den Windows Task Scheduler oder CRON-Jobs auf OSX und Linux verwendest.

Einrichtung des FTP-Clients

Dein FTP-Client sollte mit den folgenden Einstellungen konfiguriert sein:

Schritt-für-Schritt-Anleitungen für die verschiedenen Anwendungen findest Du auf den folgenden Seiten:

• FileZilla
• WinSCP
• CoreFTP
• Cyberduck

Fehlerbehebung

Importe erscheinen nicht auf dem Dashboard: Überprüfe Deine Dateistruktur. Diese sollte den in diesem Artikel aufgeführten Anforderungen entsprechen.

Einige Profilfelder wurden beim Import nicht korrekt zugeordnet: Überprüfe Deine Platzhalter. Diese findest Du im Admin-Bereich unter Einstellungen > Profilfelder.

Welches Format muss für die CSV-Datei verwendet werden? UTF-8 mit Komma oder Semikolon als Trennzeichen. Tabs dürfen nicht als Trennzeichen verwendet werden. ASCII-Anführungszeichen (") um die Felder sind nicht erforderlich.

Gibt es Beschränkungen für die Länge der Felder? Das hängt von der Art des Profilfelds ab. Nutzernamen beispielsweise sind auf 32 Zeichen begrenzt, die Nutzer-ID kann aber beliebig lang sein.

Werden Nutzer, die nicht in der Importdatei aufgeführt sind, gelöscht? Nein, bei Nutzern, die nicht aufgeführt sind, werden keine Änderungen vorgenommen.

Wie kann ich Nutzer sperren? Füge in Deiner Datei eine Spalte mit der Überschrift „suspended“ hinzu und nutze die Werte „0“ für aktive und „1“ für gesperrte Nutzer.

Erhalten über SFTP erstellte Nutzer automatisch Zugangsdaten zugeschickt? Nein, aber Du kannst die Zugangsdaten über den Admin-Bereich verschicken. Du findest diese Funktion unter Engagement > Login-Instruktionen. (Weitere Informationen zum Verschicken von Login-Instruktionen findest Du auch in diesem Artikel.)

Meine Einstellungen stimmen, aber ich kann mich nicht mit dem Beekeeper-FTP-Server verbinden: Überprüfe, ob die Beekeeper-Domain (beekeeper.io) auf der Whitelist Deiner Firewall steht.

Ich erhalte einen SSH-Fehler: „Bad packet length“: Überprüfe Deine Verbindungseinstellungen. Dieser Fehler tritt üblicherweise auf, wenn Du Dich mit FTP anstatt mit SFTP verbindest und der Server beim Versuch, den ersten gesendeten Datenblock zu entschlüsseln, ein falsches Format feststellt.

Unterstützt ihr SSH2?: Ja.