OneDrive einrichten

Diese Anleitung erklärt Schritt für Schritt, wie du OneDrive mit Flowkom verbindest. Du brauchst dafür ca. 10 Minuten und keine technischen Vorkenntnisse.

Voraussetzungen

• Ein Microsoft 365-Konto mit OneDrive (privat oder Business)
• Admin-Rechte in deinem Flowkom-Workspace

Schritt 1: Microsoft-App registrieren

Damit Flowkom auf deine OneDrive-Dateien zugreifen kann, musst du einmalig eine “App” bei Microsoft registrieren. Das ist kostenlos und dauert ca. 5 Minuten.

1.1 Azure-Portal öffnen

1. Öffne portal.azure.com  in deinem Browser
2. Melde dich mit deinem Microsoft-Konto an (dasselbe Konto, das auch OneDrive nutzt)

Hinweis: Falls du noch keinen Azure-Account hast, wirst du aufgefordert einen kostenlosen Account zu erstellen. Das ist komplett kostenlos — du brauchst keine Kreditkarte für die App-Registrierung.

1.2 App-Registrierung starten

1. Suche oben in der Suchleiste nach “App-Registrierungen” und klicke darauf
2. Klicke auf “Neue Registrierung”

1.3 App-Details ausfüllen

Fülle das Formular wie folgt aus:

Wichtig: Ersetze DEINE-DOMAIN.de durch die tatsächliche Domain deiner Flowkom-Installation (z.B. app.flowkom.de).

3. Klicke auf “Registrieren”

1.4 Client-ID notieren

Nach der Registrierung landest du auf der Übersichtsseite der App. Hier findest du:

• Anwendungs-ID (Client) — eine lange ID wie dcec12b3-ae31-44be-a3e9-4019223a632d

Kopiere diese ID — du brauchst sie gleich als MICROSOFT_CLIENT_ID.

Schritt 2: Client-Secret erstellen

Das Client-Secret ist ein Passwort, mit dem sich Flowkom bei Microsoft ausweist.

1. Klicke im linken Menü auf “Zertifikate & Geheimnisse”
2. Klicke auf den Tab “Geheime Clientschlüssel”
3. Klicke auf “Neuer geheimer Clientschlüssel”
4. Gib eine Beschreibung ein (z.B. flowkom-cloud-storage)
5. Wähle als Ablauf 24 Monate
6. Klicke auf “Hinzufügen”

Sehr wichtig: Kopiere jetzt sofort den “Wert” (nicht die “Geheimnis-ID”!). Dieser Wert wird nur einmal angezeigt — wenn du die Seite verlässt, kannst du ihn nicht mehr sehen und musst ein neues Secret erstellen.

Dieser Wert wird dein MICROSOFT_CLIENT_SECRET.

Schritt 3: API-Berechtigungen setzen

Flowkom braucht die Berechtigung, auf deine OneDrive-Dateien zuzugreifen.

1. Klicke im linken Menü auf “API-Berechtigungen”
2. Klicke auf “Berechtigung hinzufügen”
3. Wähle “Microsoft Graph”
4. Wähle “Delegierte Berechtigungen”
5. Suche nach Files.ReadWrite.All und setze den Haken
6. Klicke auf “Berechtigungen hinzufügen”

Prüfe: Auf der Übersicht der API-Berechtigungen sollten jetzt mindestens diese zwei Einträge stehen:

• User.Read (wird automatisch hinzugefügt)
• Files.ReadWrite.All (hast du gerade hinzugefügt)

Schritt 4: Localhost-Redirect hinzufügen (optional)

Wenn du Flowkom auch lokal auf deinem Rechner entwickelst, brauchst du eine zusätzliche Redirect-URI:

1. Klicke im linken Menü auf “Authentifizierung”
2. Unter “Umleitungs-URIs” klicke auf “URI hinzufügen”
3. Trage ein: http://localhost:3000/api/cloud/auth/onedrive/callback
4. Klicke auf “Speichern”

Schritt 5: Umgebungsvariablen in Flowkom eintragen

Jetzt hast du alle Werte die Flowkom braucht. Trage sie als Umgebungsvariablen in deinem Hosting-Provider ein (z.B. Vercel, Coolify, Docker):

MICROSOFT_CLIENT_ID=deine-client-id-hier
MICROSOFT_CLIENT_SECRET=dein-client-secret-hier
MICROSOFT_REDIRECT_URI=https://DEINE-DOMAIN.de/api/cloud/auth/onedrive/callback
CLOUD_TOKEN_ENCRYPTION_KEY=dein-encryption-key-hier

Encryption Key generieren

Der CLOUD_TOKEN_ENCRYPTION_KEY verschlüsselt die OneDrive-Zugangsdaten in der Datenbank. Generiere ihn mit folgendem Befehl im Terminal:

openssl rand -hex 32

Das erzeugt eine 64 Zeichen lange Zeichenkette wie 45a1f3fec04fecc378e90e82b348caeff8f58c3c25d99caefba8d44adc96eb44.

Sicherheitshinweis: Bewahre den Encryption Key sicher auf. Wenn du ihn verlierst, musst du OneDrive in Flowkom neu verbinden.

Zusammenfassung der Variablen

Schritt 6: In Flowkom verbinden

Nach dem Deployment mit den neuen Umgebungsvariablen:

1. Öffne Flowkom und gehe zu Einstellungen → Integrationen
2. Klicke auf die OneDrive-Karte
3. Klicke auf “OneDrive verbinden”
4. Du wirst zu Microsoft weitergeleitet — melde dich an und erlaube den Zugriff
5. Du wirst zurück zu Flowkom geleitet — die Verbindung ist hergestellt

Schritt 7: Basis-Ordner auswählen

Der Basis-Ordner ist der Ordner in OneDrive, der deine Marken-Verzeichnisse enthält (z.B. “Marken”).

1. Auf der Cloud-Speicher-Einstellungsseite, klicke unter “Basis-Ordner” auf “Auswählen”
2. Navigiere zum richtigen Ordner (z.B. “Marken”)
3. Klicke auf “Ordner auswählen”

Schritt 8: Ordner-Vorlagen konfigurieren

Ordner-Vorlagen bestimmen, welche Unterordner bei jedem neuen Produkt automatisch erstellt werden.

Standard-Vorlagen:

• Bilder
• Verpackung
• PSD-Dateien
• Sonstiges

Du kannst Vorlagen hinzufügen, umbenennen oder löschen. Die Reihenfolge lässt sich per Drag & Drop anpassen.

Schritt 9: Produkte verknüpfen

Automatisch (empfohlen)

Klicke auf “Alle Produkte abgleichen” um alle Produkte auf einmal mit ihren Cloud-Ordnern zu verknüpfen. Flowkom sucht automatisch anhand der Marke und SKU:

1. Findet den Marken-Ordner im Basis-Ordner
2. Sucht darin nach dem “Produkte”-Unterordner
3. Findet den Ordner, dessen Name mit der SKU beginnt

Beispiel: Produkt mit SKU 100015 und Marke Pitlane Performance wird verknüpft mit: Marken/Pitlane Performance/Produkte/100015 Schlitten/

Manuell

Wenn die automatische Zuordnung nicht funktioniert (z.B. weil die Ordnerstruktur abweicht):

1. Öffne ein Produkt und gehe zum Tab “Dateien”
2. Klicke auf “Manuell verknüpfen”
3. Navigiere zum richtigen Ordner
4. Klicke auf “Ordner auswählen”

Ordner neu erstellen

Wenn noch kein Ordner existiert:

1. Öffne ein Produkt und gehe zum Tab “Dateien”
2. Klicke auf “Ordner erstellen”
3. Flowkom erstellt automatisch die komplette Ordnerstruktur in OneDrive (Marke → Produkte → SKU → Unterordner)

Dateien verwalten

Sobald ein Produkt mit einem Cloud-Ordner verknüpft ist, siehst du im “Dateien”-Tab:

• Ordner als klickbare Kacheln
• Bilder als Thumbnail-Vorschau
• Andere Dateien (PDF, PSD, DOCX etc.) als Liste

Aktionen pro Datei

Dateien hochladen

1. Klicke auf “Hochladen”
2. Ziehe Dateien in den Upload-Bereich oder klicke zum Auswählen
3. Maximale Dateigröße: 100 MB pro Datei

Aktualisieren

Wenn Dateien direkt in OneDrive hinzugefügt oder geändert wurden, klicke auf “Aktualisieren” um die Ansicht zu aktualisieren.

Fehlerbehebung

”OneDrive verbinden” funktioniert nicht

• Prüfe ob alle vier Umgebungsvariablen korrekt gesetzt sind
• Prüfe ob die Redirect-URI in der Azure-App exakt mit MICROSOFT_REDIRECT_URI übereinstimmt (inklusive https://)
• Starte Flowkom nach dem Setzen der Umgebungsvariablen neu

”Automatisch suchen” ist ausgegraut

• Das Produkt muss eine Marke zugewiesen haben (unter Basis → Marke)
• Es muss eine Cloud-Verbindung bestehen und ein Basis-Ordner ausgewählt sein

Produkt wird nicht automatisch gefunden

• Der Ordnername muss mit der SKU des Produkts beginnen (z.B. “100015 Schlitten”)
• Der Markenname in Flowkom muss exakt dem Ordnernamen in OneDrive entsprechen
• Der Ordner muss sich innerhalb eines “Produkte”-Unterordners befinden
• Flowkom sucht bis zu 3 Ebenen tief in Unterordnern

Token abgelaufen

Flowkom erneuert das Token automatisch. Falls die Verbindung trotzdem abbricht:

1. Gehe zu Einstellungen → Integrationen → OneDrive
2. Klicke auf “Trennen”
3. Verbinde OneDrive erneut

Client-Secret abgelaufen

Das Client-Secret hat eine begrenzte Gültigkeitsdauer (Standard: 24 Monate). Wenn es abläuft:

1. Gehe zum Azure Portal  → App-Registrierungen → deine App
2. Erstelle unter “Zertifikate & Geheimnisse” ein neues Secret
3. Aktualisiere MICROSOFT_CLIENT_SECRET in deinen Umgebungsvariablen
4. Starte Flowkom neu