Azure Blob Storage einrichten
Diese Anleitung beschreibt Schritt für Schritt, wie Sie den Dateibezug für den Jarltech-Preis- und Lagerimport über Azure Blob Storage einrichten.
Wann wird das benötigt?
Azure Blob Storage ist nur für den Preis- und Lagerimport erforderlich (siehe Datenimport). Wenn Sie ausschließlich die Bestellabwicklung über die Jarltech-API nutzen (Bestellungen, Rechnungen, Tracking), benötigen Sie kein Blob Storage. Der Bestellteil läuft vollständig über die REST-API (OAuth2-Zugangsdaten von Jarltech).
Hintergrund
Jarltech stellt die vollständige Preisliste und die Lagerbestände als CSV-Dateien bereit. Der Connector lädt diese Dateien herunter und schreibt sie in die zentrale Tabelle ALN MC Supplier Data des merchantCENTRAL Hub. Von dort stehen sie der Preis-Engine, der Bestandsberechnung und den Marktplatz-Angeboten zur Verfügung.
Die CSV-Dateien liegen in einem Azure-Blob-Container. Für den Zugriff darauf gibt es drei Verfahren:
| Verfahren | Empfehlung | Authentifizierung | Konfiguriert in |
|---|---|---|---|
| OAuth2 Blob | ✅ Empfohlen | Microsoft Entra ID (App-Registrierung) | Zentral in der merchantCENTRAL-Einrichtung (Hub) |
| Azure Blob (SAS) | Legacy | SAS-Token über eine Azure Function + Function Key | Je Import im Jarltech-Importeinrichtung |
| HTTP Direct | Sonderfall | Öffentliche/geschützte HTTPS-URL | Je Import im Jarltech-Importeinrichtung |
Wer stellt das Speicherkonto bereit?
Je nach Vertrag erhalten Sie Speicherkontoname, Container und Zugangsdaten von ALTENBRAND (zentral bereitgestellt) — dann genügt Variante A, Schritt 6–8. Möchten Sie ein eigenes Speicherkonto betreiben, folgen Sie der vollständigen Variante A ab Schritt 1.
Variante A: OAuth2 Blob (empfohlen)
Bei diesem Verfahren authentifiziert sich der Hub über eine Microsoft Entra ID App-Registrierung (Service Principal) gegen das Azure-Speicherkonto. Es werden keine SAS-Token oder Function Keys benötigt; die Zugangsdaten werden einmal zentral in der merchantCENTRAL-Einrichtung hinterlegt und von allen Lieferanten-Importen genutzt.
Voraussetzungen
- Zugriff auf das Azure-Portal mit Berechtigung zum Anlegen von App-Registrierungen und Rollenzuweisungen.
- Ein Azure-Abonnement (eigenes oder das von ALTENBRAND bereitgestellte).
Schritt 1 — Speicherkonto anlegen
Überspringen, wenn bereitgestellt
Wenn Sie Speicherkonto und Container von ALTENBRAND erhalten haben, fahren Sie mit Schritt 5 fort.
- Azure-Portal → Speicherkonten → Erstellen.
- Ressourcengruppe wählen, Speicherkontoname vergeben (z. B.
stmcsupplierdata), Region wählen. - Leistung Standard, Redundanz LRS genügt für Importdateien.
- Überprüfen + erstellen → Erstellen.
Schritt 2 — Container anlegen
- Im Speicherkonto → Container → + Container.
- Name vergeben (z. B.
jarltech), Zugriffsebene Privat (kein anonymer Zugriff). - Erstellen.
Schritt 3 — CSV-Dateien ablegen
Legen Sie die von Jarltech bereitgestellten Dateien im Container ab, z. B.:
| Datei | Inhalt |
|---|---|
jarltech-catalog.csv |
Preisliste / Katalog |
jarltech-stock.csv |
Lagerbestände |
Aktualisierung der Dateien
Die Dateien werden in der Regel von Jarltech bzw. einem automatisierten Prozess regelmäßig aktualisiert. Der Import liest beim Lauf jeweils den aktuellen Stand (inkl. „Zuletzt geändert"-Zeitstempel).
Schritt 4 — Entra ID App-Registrierung erstellen
- Azure-Portal → Microsoft Entra ID → App-Registrierungen → + Neue Registrierung.
- Name vergeben (z. B.
merchantCENTRAL Supplier Import), Kontotyp Nur dieses Verzeichnis (Single Tenant). - Registrieren.
- Notieren Sie auf der Übersichtsseite:
- Anwendungs-(Client-)ID → später Entra-Client-ID
- Verzeichnis-(Mandanten-)ID → später Entra-Mandanten-ID
Schritt 5 — Client Secret erstellen
- In der App-Registrierung → Zertifikate & Geheimnisse → + Neuer geheimer Clientschlüssel.
- Beschreibung und Ablauf wählen, Hinzufügen.
- Kopieren Sie den Wert (Secret) sofort — er wird später nur einmal angezeigt.
Ablauf des Secrets beachten
Client Secrets haben ein Ablaufdatum. Tragen Sie sich eine Erinnerung ein, das Secret rechtzeitig zu erneuern und in der merchantCENTRAL-Einrichtung zu aktualisieren, sonst schlägt der Import fehl.
Schritt 6 — Zugriffsrolle zuweisen (RBAC)
Die App-Registrierung benötigt Lesezugriff auf die Blobs:
- Wechseln Sie zum Speicherkonto (oder direkt zum Container) → Zugriffssteuerung (IAM).
- + Hinzufügen → Rollenzuweisung hinzufügen.
- Rolle Storage Blob Data Reader auswählen.
- Mitglied = die in Schritt 4 erstellte App-Registrierung (über den Namen suchen).
- Überprüfen + zuweisen.
Lesezugriff genügt
Der Import liest die Dateien nur. Storage Blob Data Reader ist ausreichend — vergeben Sie keine Schreib-/Eigentümerrollen.
Schritt 7 — Zugangsdaten in der merchantCENTRAL-Einrichtung eintragen
Öffnen Sie die merchantCENTRAL-Einrichtung (Hub) → Abschnitt Entra ID & Azure Blob Storage (siehe Einrichtung – Referenz) und tragen Sie ein:
| Feld | Wert |
|---|---|
| Entra Mandanten-ID | Verzeichnis-(Mandanten-)ID aus Schritt 4 |
| Entra Client-ID | Anwendungs-(Client-)ID aus Schritt 4 |
| Speicherkontoname | Name des Speicherkontos (z. B. stmcsupplierdata) |
| Clientgeheimnis | Secret-Wert aus Schritt 5 (per Klick eingeben; verschlüsselt im Isolated Storage gespeichert) |
Schritt 8 — Import auf OAuth2 Blob umstellen
Öffnen Sie das Jarltech-Importeinrichtung (siehe Datenimport) und konfigurieren Sie je Import (JARLTECH-CATALOG, JARLTECH-STOCK):
- Quellentyp = OAuth2 Blob.
- Quell-URL = vollständige Blob-URL der Datei, z. B.
https://stmcsupplierdata.blob.core.windows.net/jarltech/jarltech-catalog.csv - Aktiv aktivieren.
- Verbindung testen ausführen — bei Erfolg wird im Feld Authentifizierung „Central OAuth2 connection configured" angezeigt.
Variante B: Azure Blob über SAS-Token (Legacy)
Bei diesem Verfahren wird je Download ein zeitlich begrenzter SAS-Token über eine Azure Function bezogen. Es wird nur noch für Bestandsinstallationen empfohlen.
Konfiguration
- Jarltech-Importeinrichtung öffnen, je Import Quellentyp = Azure Blob.
- Quell-URL = Blob-URL der Datei (ohne SAS-Token).
- Authentifizierung anklicken und den Function Key eingeben (verschlüsselt gespeichert) — siehe Set Function Key.
- Optional: Im Jarltech API-Einrichtung das Feld SAS-Funktions-URL anpassen. Standard:
https://VendorDataDownload.azurewebsites.net/api/GetSasTokenLeer lassen, um den eingebauten Standard zu verwenden. - Verbindung testen ausführen.
Funktionsweise
Der Connector ruft die Azure Function (abgesichert über den Function Key) auf, erhält einen SAS-Token und lädt damit die Datei per HTTPS herunter. Der Token wird nicht dauerhaft gespeichert.
Variante C: HTTP Direct
Liegt die Datei unter einer direkt erreichbaren HTTPS-URL (z. B. einem geschützten Webserver), wählen Sie Quellentyp = HTTP Direct und tragen die Quell-URL ein. Diese Variante eignet sich für Quellen ohne Azure-Blob-Authentifizierung.
Dateiformat der CSV-Dateien
Der Importprozessor erwartet die Jarltech-Formate (Details siehe Datenimport):
| Import | Trennung | Kodierung |
|---|---|---|
Preisliste (JARLTECH-CATALOG) |
";" (in Anführungszeichen eingeschlossen) |
Windows-1252 (ANSI) |
Lager (JARLTECH-STOCK) |
; (ohne Anführungszeichen) |
Windows-1252 (ANSI) |
Zeichenkodierung
Verwenden Sie Windows-1252 (ANSI), damit Umlaute korrekt eingelesen werden. UTF-8-Dateien können zu falsch dargestellten Sonderzeichen führen.
Verbindung testen & Import ausführen
- Im Jarltech-Importeinrichtung je Import Verbindung testen ausführen.
- Den Import über das Jarltech Dashboard → Import ausführen starten.
- Ergebnis prüfen: Das Feld Status zeigt „Imported \<n> records on \<Datum>".
Fehlerbehebung
| Symptom | Mögliche Ursache | Lösung |
|---|---|---|
| Authentication: „not configured" (OAuth2) | Hub-Setup unvollständig | Entra Mandanten-ID, Entra Client-ID, Clientgeheimnis und Speicherkontoname in der merchantCENTRAL-Einrichtung prüfen |
| 403 / Zugriff verweigert | Rollenzuweisung fehlt | App-Registrierung benötigt Storage Blob Data Reader auf Konto/Container (Schritt 6) |
| 404 / Datei nicht gefunden | Falsche Source URL oder Datei fehlt | Container- und Dateinamen in der Source URL prüfen |
| Authentifizierung schlägt nach einiger Zeit fehl | Client Secret abgelaufen | Neues Secret erstellen und in der merchantCENTRAL-Einrichtung aktualisieren |
| Umlaute falsch dargestellt | Falsche Kodierung der Quelldatei | Datei als Windows-1252 bereitstellen |
| Function Key ungültig (SAS) | Falscher/abgelaufener Key | Function Key über Authentifizierung neu setzen |