SFTP – Einrichtungsanleitung

INHALTSVERZEICHNIS

• SFTP – Einrichtungsanleitung
  • Hosting und Authentifizierung
  • Konfiguration
  • Häufigkeit und Zeitplanung
  • Berichte und Fehlerbehandlung
    • Verwandte FAQs
  • So erstellen Sie einen öffentlichen SSH-Schlüssel für den SFTP-Server
    • Format
    • Muster
    • SSH-Schlüssel erstellen
    • Beispielschlüssel
  • Anleitungen zu bestimmten Datensatztypen

Hosting und Authentifizierung

Ihr SFTP-Ordner wird auf einem eigenen SFTP-Server (über AWS) bereitgestellt. Jeder Kunde erhält ein separates Benutzerkonto mit direktem Zugriff auf seinen eigenen SFTP-Ordner. Wir unterstützen dieSchlüsselbasierte Authentifizierung. Daher müssen Sie ein Schlüsselpaar (öffentlich/privat) erzeugen und den öffentlichen Schlüssel im FeldPublic Keyeintragen, wenn Sie Ihren Ordner einrichten. Der Schlüssel muss imopenSSH RSA-Format. Wie Sie die Schlüssel erstellen, erfahren Sie unter „So erstellen Sie einen öffentlichen SSH-Schlüssel für den SFTP-Server“ weiter unten.

Konfiguration

1. Geben Sie den von Ihnen erstellten öffentlichen Schlüssel in das Feld Public KeyFeld. Sie können optional das Feld aktualisieren.Benutzernamen Feld anpassen. Der Wert im Benutzername Feld muss mit einem Buchstaben, einer Zahl oder einem Unterstrich beginnen und zwischen 3 und 100 Zeichen lang sein. Erlaubt sind Buchstaben, Zahlen, Unterstriche, At-Zeichen (@), Punkte (.) und Bindestriche (-).

2. Kopieren Sie den Benutzernamen, die Spotnana-Domain-URL sowie die Portnummer an einen sicheren Ort. Diese Angaben werden später vom Team in Ihrem Unternehmen benötigt, das den Versand von Dateien in den neu erstellten Ordner einrichtet. 
   Hinweis: Nachdem das SFTP-Verzeichnis eingerichtet wurde, können Sie diese Angaben jederzeit unter Verwalten abrufen.

3. Geben Sie im Feld SFTP-E-Mail-BenachrichtigungFeld. Weitere Informationen finden Sie unterBerichte und Fehlerbehandlungunten

4. Klicken Sie auf Verbinden.

Sobald ein öffentlicher Schlüssel hinzugefügt wurde, erhält der Status zunächst den Wert Unbestätigt. Dieser Status bleibt im OBT sichtbar, bis erstmals eine Datei im Verzeichnis eingegangen ist. Dabei kann es sich um eine Testdatei Ihrer Wahl oder um eine tatsächliche HR-Feed- oder Custom-Field-Datei handeln (nur unterstützte Dateiformate werden verarbeitet). Wird der öffentliche Schlüssel später geändert, wird der Status erneut auf Unbestätigt gesetzt, bis wieder eine Datei eingegangen ist.

Um Ihr SFTP-Verzeichnis zu entfernen, klicken Sie auf Trennen. Dadurch wird Ihr SFTP-Verzeichnis gelöscht. Wenn Sie es später erneut einrichten möchten, müssen Sie alle oben genannten Informationen erneut eingeben.

Häufigkeit und Zeitplanung

Sie legen selbst fest, wann und wie oft Dateien hochgeladen werden. Sobald Sie eine Datei in Ihren Ordner auf unserem SFTP-Server übertragen, erkennt unser System dies automatisch und startet direkt die Verarbeitung. Die Auslösung erfolgt dabei über das Erstellen des Dateiobjekts.

Empfehlungen zur optimalen Häufigkeit und zum Zeitplan für die einzelnen Datentypen (z. B. Benutzer, benutzerdefinierte Felder, juristische Personen) finden Sie im Abschnitt Häufigkeit und Zeitplan in den SFTP-Anweisungen für den jeweiligen Datentyp.

Berichte und Fehlerbehandlung

Wir erfassen Informationen zu Ihren Datei-Uploads und erstellen nach jedem Upload einen internen Bericht. Dieser Bericht wird an die E-Mail-Adresse(n) verschickt, die Sie im Feld SFTP-E-Mail-Benachrichtigung bei der Einrichtung hinterlegt haben. Für jede hochgeladene Datei enthält der Bericht:

• alle Gründe, warum ein Datei-Upload fehlgeschlagen ist (z. B. falsches Format, fehlende Spaltennamen usw.).

• alle Gründe, warum einzelne Zeilen innerhalb einer Datei nicht übernommen werden konnten. Teilweise Aktualisierungen einzelner Zeilen sind nicht möglich – tritt in einer Spalte ein Fehler auf oder fehlt ein Pflichtfeld, wird die gesamte Zeile abgelehnt.

• den Status des Uploads (ausstehend, erfolgreich, fehlgeschlagen).

Sie können den Bericht nutzen, um Fehlerursachen nachzuvollziehen und zu beheben. Sollten Sie das Problem nicht selbst lösen können, wenden Sie sich bitte an unseren technischen Support.

Häufig gestellte Fragen

1. Akzeptieren wir auch inkrementelle Dateien, die nur die zu aktualisierenden oder neu hinzuzufügenden Datensätze enthalten?

   • Ja

2. Müssen optionale Spalten in der Datei enthalten sein, auch wenn Sie diese nicht nutzen (egal ob per SFTP oder manueller Upload)?

   • Nein

So erstellen Sie einen öffentlichen SSH-Schlüssel für den SFTP-Server

Folgen Sie einfach den nachstehenden Anweisungen, um den öffentlichen SSH-Schlüssel zu erstellen, den Sie uns bereitstellen.

Format

• Typ: Zeichenkette

• Längenbeschränkung: Maximal 2048 Zeichen.

Muster

 ^ssh-rsa\s+[A-Za-z0-9+/]+[=]{0,3}(\s+.+)?\s*$

SSH-Schlüssel erstellen

Um ein SSH-Schlüsselpaar zu erzeugen, führen Sie diesen Befehl entweder in der Windows-Eingabeaufforderung oder im Terminal unter macOS, Linux oder UNIX aus:

ssh-keygen -t rsa -b 4096 -f key_name

Hierbei gilt:

• -t steht für den Verschlüsselungstyp

• -b gibt die Schlüssellänge in Bit an

• -f legt den Namen der Schlüsseldatei fest

Beispielschlüssel

ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQDDJB9oBRPrBegMDPEQo+HmNDb/jKUJL6q2kQpNNMDjNps9mhhwJ1dP/lOavMitBPAndeXlwaNEm2XbGaSrZtD/tbQTX1HQjP6pacy+Alf8kYBm5QFfl/Z6lGC8qHys10fpRXgYE7UhdSv6VyRqt1gELGFQwVBZ2kJJuBGJF1IRywwvG/h68B8iWU1+6KEWYQoUcT45r3j3otnx4NhhzpTiNgDbMk0ix+kar4/IstobRLcb7rt7FoUerTLNrVDi69DqbsGY5LN+NM8jVx0sPQLRC/ruil8pTHP3k4rDCc7a80+sH4sUTW+mHc7MTqbi/CcyyFAD8h7p6WqxEydOaJjMnvqAbE17BOj0TSxv3HMohTf3skzE7PbzVcjIfHTpFPGxmJkghAYAMi5l9VvAs91IpVylxjqPss3xQQJIZEmQdG2k7zk/UpsUFlmaOj6lCHRicFKCixKekzzm3nFuJvDEklurtydOQjZ8WkPzTSJfZBdKMuMUi0SQ9m9ZAw99t0=

Hinweise zu bestimmten Datensatztypen

Detaillierte Anleitungen zum Hochladen spezifischer Datensatztypen per SFTP finden Sie in den folgenden Themenbereichen:

• HR-Feeds (Benutzer)
• Benutzerdefinierte Felder
• Büros
• Rechtsträger