Daten teilen über SFTP

Diese Seite beschreibt, wie Sie einen neuen Onedot SFTP Endpunkt einrichten um automatisiert Daten mit der Onedot Plattform auszutauschen.

Um Daten mit neuen Benutzern auszutauschen, folgen Sie bitte den Anweisungen unter Benutzer für Datenaustausch einladen.

Benötigte Applikationen

Um Daten mit SFTP auszutauschen, ist entweder ein System notwendig welches SFTP Protokoll unterstützt oder eine Klient-Applikation wie ein SFTP Browser.

Für die folgende Anleitung wurde der SFTP Klient FileZilla 3.67.0 verwendet, welcher für alle gängigen Betriebssysteme verfügbar ist. Alternative dazu können Sie unter Linux/MacOS auch den eingebauten sftp Befehl in der Eingabeaufforderung ihres Terminals nutzen.

Die Bilder für die Anleitung wurden unter Apple MacOS Sonoma erstellt. Unter anderen Betriebssystemen sieht die Oberfläche von FileZilla analog aus.

Endpunkt konfigurieren

Bevor Sie Daten mit Onedot austauschen können über SFTP, muss ein Onedot SFTP Endpunkt eingerichtet werden.

Dazu wird auch ein SSH Schlüsselpaar benötigt, welcher die Verschlüsselung für die sichere Datenübertragung ermöglicht.

Ein SSH Schlüsselpaar besteht aus einem privaten und öffentlichen Schlüssel. Der öffentliche Schlüssel wird mit Onedot geteilt. Der private Schlüssel darf nie ausserhalb ihrer Organisation geteilt werden und muss sorgfältig aufbewahrt werden, zum Beispiel in einem Passwort-Manager oder ähnlichen Applikationen welche ihre Organisation bereitstellt.

Der Onedot Support wird Benutzer der Onedot Plattform niemals nach Passwörtern oder privaten SSH Schlüsseln fragen. Falls Sie eine solche Anfrage erhalten von einer Person welche vorgibt unter Onedot Namen zu agieren, kontaktieren Sie uns bitte unter security@onedot.com.

Geben Sie wie folgt vor um einen SSH Schlüsselpaar zu generieren:

Verwenden Sie den Befehlt ssh-keygen in der Eingabeaufforderung ihres Terminals (Linux, MacOS) oder die Applikation PuTTY (Windows).
1. Verwenden Sie den RSA Algorithmus für das Schlüsselpaar
2. Verwenden Sie eine Schlüssellänge von 4096 Bits

Falls Sie ssh-keygen verwenden, kann der Befehl zur Generierung des Schlüsselpaars wie folgt aussehen:

ssh-keygen -t rsa -b 4096

Danach können Sie einen neuen Onedot SFTP Endpunkt einrichten:

Gehen Sie zu der Endpunkt Übersicht
Klicken Sie auf das Plus Symbol um einen neuen Endpunkt zu erstellen.
Alternativ können Sie auch einen bereits bestehenden Endpunkt auswählen, kopieren, und die Kopie entsprechend anpassen.

Geben Sie die folgenden Information an:

Label: Geben Sie dem Endpunkt einen Namen, zum Beispiel eine Kombination von ihrer Organisation und der Organisation mit welcher Sie zusammenarbeiten möchten
Username: Verwenden Sie dieselbe Information wie für Label
Public Key: Geben Sie hier den oben generieren öffentlichen SSH Schlüssen an

Bitte stellen Sie sicher dass der öffentliche Schlüssel exakt kopiert wird und während des Kopierens nicht verändert wird, zum Beispiel hinsichtlich Leerzeichen, Sonderzeichen, Zeilenumbrüche, etc.

Home Directory: Verwenden Sie standardmässig dieselbe Information wie für Username

Klicken Sie auf Create um den Endpunkt zu erstellen.

Mit Endpunkt verbinden

Nachdem der Endpunkt mit den gewünschten Informationen wie Benutzer und öffentlicher Schlüssel erstellt wurde, kann nun eine erste Verbindung mit Onedot SFTP erstellt werden.

Gehen Sie dazu wie folgt vor:

Öffnen Sie die FileZilla Applikation
Konfigurieren Sie eine Verbindung mit den folgenden Angaben:
1. Protocol: SFTP - SSH File Transfer Protocol
2. Host: sftp.onedot.com
3. Logon Type: Key file
4. Key file: Verwenden Sie die Datei welche den privaten SSH Schlüssels enthält der oben erstellt wurde

Sie können sich nun mit Onedot SFTP verbinden.

Erstellen eines Verzeichnisses

Mit der funktionierenden Onedot SFTP Verbindung können Sie nun einen Ordner erstellen und Daten hochladen um mit Onedot zu teilen.

Gehen Sie dabei wie folgt vor:

Öffnen Sie die FileZilla Applikation
Klicken Sie mit der rechten Maustaste innerhalb des Remote site Fensters
Wählen Sie aus dem Kontextmenü die Aktion Create directory aus

Alle Änderungen die Sie von nun an in ihrem Verzeichnis vornehmen sind ebenfalls in der Onedot App sichtbar:

Hochladen von Daten

Mit einem neuen Verzeichnis wie oben erstellt können Sie nun beginnen, Daten wie Produktdatenkataloge zu teilen.

Gehen Sie dabei wie folgt vor:

Öffnen Sie die FileZilla Applikation
Browsen Sie die zu teilenden Dateien innerhalb des Local site Fensters
Wählen Sie die gewünschten Dateien und Ordner aus
Klicken Sie mit der rechten Maustaste innerhalb des Local site Fensters
Wählen Sie aus dem Kontextmenü die Aktion Upload aus

Die Dateien und Ordner werden nun hochgeladen und sind danach auch in der Onedot App verfügbar.

Teilen der Zugriffsinformation

Endpunkte wie Onedot SFTP sind aus Sicherheitsgründen nicht automatisch auch für Benutzer in Gruppen mit denen Sie zusammenarbeiten verfügbar, zum Beispiel Lieferanten und Zulieferer.

Um solchen Benutzern Zugriff zu gewähren, teilen Sie bitte mit diesen die folgende Zugriffsinformation auf einem sicheren Kanal, wie zum Beispiel verschlüsselte Email oder eine Applikation zum Teilen von Passwörtern:

Protocol: SFTP
Host: sftp.onedot.com
User: Verwenden Sie hier den Benutzernamen wie oben gewählt an
Private Key: Verwenden Sie hier die Datei welche den privaten SSH Schlüssels enthält der oben erstellt wurde

Benutzer welche von Ihnen diese Zugriffsinformationen erhalten haben können mit ihrem erstellten Endpunkt ebenfalls interagieren und Daten mit ihrem Onedot Konto teilen.