[0-20] INBOUND / OUTBOUND via SFTP

Transportverfahren	SFTP (von PEIQ bereitgestellter SFTP Zugang)
Objekt	Diverse Formate wie XML, PDF, JSON, CSV, Bildformate (JPG, PNG), etc.
Trigger	Typischerweise festgelegt in den auf sFTP basierenden Schnittstellen
Unterstützte Drittsysteme	SFTP-Clients

PEIQ PRINT NGEN enthält Mechanismen, die Im- und Exporte verschiedenster Daten automatisch auf Windows-Dateifreigaben durchführen. Diese Im- und Export-Verzeichnisse (Hotfolder) können über einen von PEIQ gestellten SFTP-Server auch außerhalb der Cloud-Umgebung zur Verfügung gestellt werden, z. B. um Agenturmeldungen kontinuierlich in PEIQ PRINT NGEN zu importieren oder Print-Daten für Dienstleister:innen bereitzustellen.

Funktionalitäten der Schnittstelle

Generische Schnittstelle zum Austausch von Bewegungsdaten
Verschlüsselter Transport
Externe Rechteverwaltung und Zugriff per SFTP auf Verzeichnisebene (Eigener SFTP-Zugang pro Verzeichnis möglich)
Ausgehende Daten werden von PEIQ zum Abruf bereitgestellt (OUTBOUND, Richtung bezieht sich auf Perspektive von PEIQ); OUTBOUND = ausgehende Daten werden im SFTP-Verzeichnis abgespeichert, um von dort abgeholt zu werden
Eingehende Daten schreibt ein Drittsystem auf den SFTP Bereich in der PEIQ Cloud (INBOUND, Richtung bezieht sich auf Perspektive von PEIQ); INBOUND = eingehende Daten werden von außen in den Ordner kopiert und regelmäßig durch PEIQ eingelesen und interpretiert

Inhaltsverzeichnis

Inhaltsverzeichnis anzeigen

Zugriffswege

Der Zugriff auf die Verzeichnisse erfolgt über folgende Protokolle und Clients:

Protokoll: SFTP (SSH File Transfer Protocol/Secure File Transfer Protocol)
Port: 22
Authentifizierung: Benutzername/Passwort oder Benutzername/Zertifikat
Clients (Auswahl):
GUI: Z. B. FileZilla
Kommandozeile/Skript: OpenSSH, verfügbar unter Windows 10 und Server 2019 nativ, ältere Windows-Versionen per Installation von OpenSSH, Linux, MacOS
Eigenes Programm: SSH/SFTP-Bibliotheken sind für verschiedenste Programmiersprachen verfügbar
SFTP-Verzeichnis:
Das SFTP-Verzeichnis ist (technisch bedingt) immer das Unterverzeichnis “/sftp”. Deshalb muss beim Zielverzeichnis (“entferntes Verzeichnis”) immer “sftp” oder “/sftp” eingetragen werden, damit der Upload funktioniert.

Hinweis:

Linux ist case-sensitive und der SFTP-Server läuft unter Linux. Demzufolge lautet der Ordner /sftp.

Der Up- oder Download über das jeweilige SFTP-Rootverzeichnis (/) ist nicht möglich.

Workflow

Import

Importe werden per SFTP im SFTP-Eingangsverzeichnis angeliefert
Ein Workflowdämon überwacht dieses Verzeichnis und importiert in einem definierten Zeitintervall (z. B. jede Minute) neu eingelaufene Daten nach PEIQ PRINT NGEN (“Abräumen”)

Export

Exporte werden als XML, PDF oder ähnliches im SFTP-Ausgangsordner aus PEIQ PRINT NGEN abgelegt
Dort können die Daten vom externen Anbieter je nach eingesetztem Workflow automatisiert oder manuell abgeholt werden. Dabei ist “abzuräumen”.

Im folgenden Video werden die Importworkflows (TV, Börse, Karikatur, Rätsel etc.) erklärt:

https://www.youtube.com/watch?v=LVpNSRurT6A&t=1s

Ordnerstruktur

Abhängig vom vereinbarten Funktionsumfangs der PEIQ Cloud und den aktivierten Schnittstellen werden gewisse Ordner bereitgestellt, um diese den entsprechenden externen Dienstleister (Inhaltelieferanten oder Inhalteverarbeiter) freigeben zu können. Dies erfolgt sowohl auf dem Test- als auch auf dem Prod-System.

Die genaue Benamung und Ordnerstruktur ergibt sich aus den jeweiligen Schnittstellen-Dokus und den Mitwirkungs-Werte-Listen.

Die Ordnerstruktur orientiert sich an folgender Illustration. Dabei bilden die nachfolgend eingefärbten Ordner jeweils einen separat verschlüsselten Zugang.

Hierarchie	2. Hierarchie	3. Hierarchie	4. Hierarchie
repro (separater Zugang)	in
	out
ppi (separater Zugang)	Import	Planungsdaten	Objekt1
			Objekt2
		Anzeigen	Objekt1
			Objekt2
		Bilder	Objekt1
			Objekt2
		Reply	Objekt1
			Objekt2
	Export	Objekt1
		Objekt2
AgnBilder	AFP (separater Zugang)
	DPA (separater Zugang)
	IMAGO (separater Zugang)
	SID (separater Zugang)
AgnTexte	AFP (separater Zugang)
	DPA (separater Zugang)
	EPD (separater Zugang)
	KNA (separater Zugang)
	SID (separater Zugang)
Events	LeoEvent (separater Zugang)	Objekt1
		Objekt2
Sporttabellen	MSU (separater Zugang)	Objekt1
		Objekt2
Wetter (separater Zugang)	Objekt1
	Objekt2
TVProgramm (separater Zugang)	Objekt1
	Objekt2
Raetsel (separater Zugang)	Objekt1
	Objekt2
Karikatur (separater Zugang)	Objekt1
	Objekt2
Horoskope (separater Zugang)	Objekt1
	Objekt2
Boerse (separater Zugang)	Objekt1
	Objekt2
Grafiken (separater Zugang)	Objekt1
	Objekt2

Mitwirkungspflichten zum Setup

Die Mitwirkung, die für dieses Setup erforderlich ist, finden Sie hier:

Mitwirkungspflichten: INBOUND / OUTBOUND via SFTP

Mitwirkungspflichten zum Betrieb

Der/die Kund:in muss die zeitnahe Abholung bereitgestellter Export-Daten sicherstellen
Der/die Kund:in muss sicherstellen, dass nur die verabredeten Dateiformate in die jeweiligen Verzeichnisse hochgeladen werden und keine zusätzlichen oder nicht-importierbaren Dateien
Der verwendete SFTP-Client muss fehlertolerant sein, um auch kurze Ausfälle des SFTP-Servers z. B. bei Wartungsarbeiten oder durch Schwenks im Loadbalancer ohne Ausfall zu überbrücken
Der/die Kund:in muss sicherstellen, dass der SFTP-Client für die hochgeladenen Dateien den Zeitstempel des Upload-Vorgangs verwendet (wichtig für das Monitoring)

Bekannte Fehlerquellen

Der/die Kund:in versucht sich per FTP-Protokoll zu verbinden (anderes, veraltetes Protokoll)
Der/die Kund:in versucht sich per FTPS-Protokoll zu verbinden (anderes Protokoll)
Der/die Kund:in stellt im Client nicht Port 22 ein.

Optionale weitere Informationen (auf Anfrage)

/wiki/spaces/CORE/pages/906133524

Disclaimer

Für die vorliegende Systemübersicht/Publikation behalten wir uns alle Rechte vor. Nachdruck, Vervielfältigung und Verbreitung (auch auszugsweise) ist nur mit schriftlicher Genehmigung der PEIQ GmbH erlaubt. Wir behalten uns vor, die Systemübersicht/Publikation jederzeit ohne vorherige Ankündigung zu ändern und/oder zu erweitern. Die vorliegenden Angaben dienen lediglich Informationszwecken. Die PEIQ GmbH übernimmt keinerlei Haftung und/oder Garantie für Fehler und/oder unvollständige Angaben in der Systemübersicht/Publikation, mit Ausnahme von vorsätzlich falschen oder arglistig verschwiegenen Angaben. Da unsere Software laufend weiter entwickelt wird, handelt es sich bei den vorliegenden nur um allgemeine Angaben. Es handelt sich weder um eine Zusicherung von Mindestvertragsinhalten, noch um Beschaffenheitsgarantien im Sinne des § 443 BGB.