Eigener Speicher

Capgo unterstützt benutzerdefinierte Storage-Lösungen für deine App-Bundles. So kannst du deine Updates auf deiner eigenen Infrastruktur oder bei Drittanbietern hosten. Das ist besonders nützlich für Unternehmen mit speziellen Sicherheitsanforderungen, Compliance-Vorgaben oder bestehender Storage-Infrastruktur.

Übersicht

Custom Storage in Capgo funktioniert so, dass du dein Bundle an einen externen Ort hochlädst und Capgo die URL zum Zugriff bereitstellst. Der Capgo SDK lädt Updates dann direkt von deinem benutzerdefinierten Speicherort herunter, anstatt den Standard-Cloud-Speicher von Capgo zu nutzen.

Tipp

Custom Storage ist ideal für:

• Organisationen mit strengen Data-Residency-Anforderungen
• Teams mit vorhandener CDN- oder Storage-Infrastruktur
• Apps, die zusätzliche Security-Layer benötigen
• Kostenoptimierung bei großen Bundle-Größen

Upload via externer URL

Der einfachste Weg, Custom Storage zu nutzen, ist, dein Bundle auf eine öffentlich erreichbare URL hochzuladen und diese URL an Capgo zu übergeben.

Einfacher Upload via externer URL

npx @capgo/cli@latest bundle upload --external https://your-domain.com/bundles/v1.2.3.zip

Dieser Befehl weist Capgo an, auf das Bundle unter der angegebenen URL zu verweisen, anstatt es in den Cloud-Storage von Capgo hochzuladen.

Mit Verschlüsselung

Für sicheren externen Speicher kannst du dein Bundle verschlüsseln und die Entschlüsselungsschlüssel angeben:

npx @capgo/cli@latest bundle upload --external https://your-domain.com/bundles/v1.2.3.zip --iv-session-key YOUR_IV_SESSION_KEY

S3-Integration

Capgo bietet integrierten Support für Amazon S3 und S3-kompatible Speicherdienste. Der CLI kann dein Bundle automatisch zu S3 hochladen und Capgo so konfigurieren, dass die S3-URL verwendet wird.

S3-Upload-Optionen

npx @capgo/cli@latest bundle upload \
  --s3-region us-east-1 \
  --s3-apikey YOUR_ACCESS_KEY \
  --s3-apisecret YOUR_SECRET_KEY \
  --s3-bucket-name your-bucket-name

S3-Konfiguration abschließen

Für S3-kompatible Dienste oder benutzerdefinierte Endpunkte:

npx @capgo/cli@latest bundle upload \
  --s3-region us-east-1 \
  --s3-apikey YOUR_ACCESS_KEY \
  --s3-apisecret YOUR_SECRET_KEY \
  --s3-endpoint https://s3.your-provider.com \
  --s3-bucket-name your-bucket-name \
  --s3-port 443 \
  --no-s3-ssl  # Only if your endpoint doesn't support SSL

S3-Konfigurationsparameter

Parameter	Beschreibung	Erforderlich
--s3-region	AWS-Region für deinen S3-Bucket	Ja
--s3-apikey	S3 Access Key ID	Ja
--s3-apisecret	S3 Secret Access Key	Ja
--s3-bucket-name	Name deines S3-Buckets	Ja
--s3-endpoint	Eigene S3-Endpoint-URL	Nein
--s3-port	Port für S3-Endpoint	Nein
--no-s3-ssl	SSL für S3-Upload deaktivieren	Nein

Bundle-Vorbereitung und Verschlüsselung

Bei der Verwendung von Custom Storage, insbesondere mit Verschlüsselung, müssen Sie Ihre Bundles korrekt vorbereiten. Dazu gehört das Erstellen einer Zip-Datei und optional deren Verschlüsselung.

Schritt 1: Ein Zip-Bundle erstellen

Erstellen Sie zuerst eine Zip-Datei Ihres App-Bundles:

npx @capgo/cli@latest bundle zip com.example.app --path ./dist

Der zip-Befehl gibt den Checksum-Wert der Zip-Datei zurück. Diesen Checksum können Sie bei Bedarf verwenden, um die Zip-Datei zu verschlüsseln. Nutzen Sie die --json Option, um strukturierte Ausgaben inklusive des Checksums zu erhalten.

Optionen des Zip-Befehls

npx @capgo/cli@latest bundle zip [appId] \
  --path ./dist \
  --bundle 1.2.3 \
  --name myapp-v1.2.3 \
  --json \
  --no-code-check \
  --key-v2 \
  --package-json ../../package.json,./package.json

Option	Beschreibung
--path	Pfad zum zu zippenden Ordner (Standardwert ist webDir aus capacitor.config)
--bundle	Bundle-Versionsnummer für den Namen der ZIP-Datei
--name	Benutzerdefinierter Name für die Zip-Datei
--json	Ausgabe im JSON-Format (inkl. Checksumme)
--no-code-check	Prüfung von notifyAppReady() und der Index-Datei überspringen
--key-v2	Verschlüsselung v2 verwenden
--package-json	Pfade zu package.json-Dateien für Monorepos (kommagetrennt)

Schritt 2: Bundle verschlüsseln (Optional)

Für mehr Sicherheit verschlüssle dein Zip-Bundle vor dem Upload:

# Using default local key
npx @capgo/cli@latest bundle encrypt ./myapp.zip CHECKSUM

# Using custom key file
npx @capgo/cli@latest bundle encrypt ./myapp.zip CHECKSUM --key ./path/to/.capgo_key_v2

# Using key data directly
npx @capgo/cli@latest bundle encrypt ./myapp.zip CHECKSUM --key-data "PRIVATE_KEY_CONTENT"

Der CHECKSUM Der Parameter ist erforderlich und sollte der Checksumme deiner ZIP-Datei entsprechen. Die Checksumme kannst du aus der Ausgabe des zip-Befehls erhalten (verwende --json für eine strukturierte Ausgabe).

Standardmäßig verwendet der `encrypt`-Befehl deinen lokalen privaten Signing-Key. Du kannst einen benutzerdefinierten Key angeben, indem du den --key oder --key-data options.

Der encrypt-Befehl gibt den folgenden Wert zurück: ivSessionKey wird für den Upload oder die Entschlüsselung benötigt.

Optionen für den Verschlüsselungs-Befehl

Option	Beschreibung
zipPath	Pfad zur zu verschlüsselnden Zip-Datei (erforderlich)
checksum	Checksum der ZIP-Datei (erforderlich) – über den zip-Befehl ermitteln
--key	Benutzerdefinierter Pfad für den privaten Signing-Key (optional, nutzt standardmäßig den lokalen Key)
--key-data	Direkte Übergabe der privaten Signing-Key-Daten (optional)
--json	Ausgabe der Ergebnisse im JSON-Format

Achtung

Der encrypt-Befehl gibt ein ivSessionKey that you’ll need to provide when uploading with the --iv-session-key option.

Vollständige Workflow-Beispiele

Beispiel 1: Externe URL mit Verschlüsselung

1. Erstelle deine App:

   npm run build

2. Zip-Bundle erstellen:

   npx @capgo/cli@latest bundle zip com.example.app --path ./dist --bundle 1.2.3

   Notiere dir den Checksum-Wert dieses Befehls.

3. Bundle verschlüsseln:

   npx @capgo/cli@latest bundle encrypt ./com.example.app-1.2.3.zip CHECKSUM_FROM_STEP_2

   Notiere den ivSessionKey aus der Ausgabe.

4. In deinen Storage hochladen: Lade die verschlüsselte ZIP-Datei in deinen Hosting-Service hoch.

5. Bei Capgo registrieren:

   npx @capgo/cli@latest bundle upload \
     --external https://your-cdn.com/bundles/com.example.app-1.2.3.zip \
     --iv-session-key IV_SESSION_KEY_FROM_STEP_3

Beispiel 2: Direkter S3-Upload

1. Erstelle deine App:

   npm run build

2. Direkt zu S3 hochladen:

   npx @capgo/cli@latest bundle upload \
     --s3-region us-west-2 \
     --s3-apikey YOUR_ACCESS_KEY \
     --s3-apisecret YOUR_SECRET_KEY \
     --s3-bucket-name your-app-bundles \
     --channel Production

Beispiel 3: S3 mit Verschlüsselung

1. Build und zippen:

   npm run build
   npx @capgo/cli@latest bundle zip com.example.app --path ./dist --key-v2

2. Bundle verschlüsseln:

   npx @capgo/cli@latest bundle encrypt ./com.example.app.zip CHECKSUM

3. Mit Verschlüsselung zu S3 hochladen:

   npx @capgo/cli@latest bundle upload \
     --s3-region us-west-2 \
     --s3-apikey YOUR_ACCESS_KEY \
     --s3-apisecret YOUR_SECRET_KEY \
     --s3-bucket-name your-app-bundles \
     --iv-session-key IV_SESSION_KEY_FROM_STEP_2 \
     --channel Production

Sicherheitshinweise

Beachte bei der Nutzung von Custom Storage diese Best Practices für die Sicherheit:

Zugriffskontrolle

• Stelle sicher, dass deine Storage-URLs für App-Nutzer erreichbar, aber nicht öffentlich auffindbar sind
• Nutze nach Möglichkeit Signed URLs oder Token-basierte Authentifizierung
• Implementiere korrekte CORS-Header für Web-Apps

Verschlüsselung

• Verschlüssele sensible Bundles immer mit den Capgo Verschlüsselungstools
• Speichere Encryption Keys sicher und rotiere sie regelmäßig
• Nutze HTTPS für alle Bundle-URLs (erforderlich für Mobile- und Electron-Apps)

Monitoring

• Überwache Access Logs auf ungewöhnliche Download-Muster
• Richte Alerts für fehlgeschlagene Bundle-Downloads ein
• Prüfe regelmäßig deine Storage-Berechtigungen

Fehlerbehebung

Häufige Probleme

Bundle wird nicht heruntergeladen:

• Prüfen Sie, ob die URL öffentlich zugänglich ist und HTTPS verwendet (erforderlich für Mobile- und Electron-Apps)
• CORS-Header für Web-Apps prüfen
• Sicherstellen, dass das Bundle-Format korrekt ist

Verschlüsselungsfehler:

• Überprüfe die ivSessionKey mit dem verschlüsselten Bundle übereinstimmt
• Prüfen Sie, ob das Bundle mit dem richtigen Key verschlüsselt wurde
• Sicherstellen, dass Encryption v2 für neue Bundles genutzt wird

S3-Upload-Fehler:

• S3-Credentials und Berechtigungen prüfen
• Bucket-Policies und CORS-Konfiguration prüfen
• Sicherstellen, dass die angegebene Region korrekt ist

Debug-Commands

Bundle-Status prüfen:

npx @capgo/cli@latest app debug

Bundle-Integrität verifizieren:

npx @capgo/cli@latest bundle list

Nächste Schritte

• Mehr über Channels um verschiedene Deployment-Umgebungen zu verwalten
• Entdecken Update-Verhalten um anzupassen, wie Updates angewendet werden
• Einrichten CI/CD-Integration um deinen Custom-Storage-Workflow zu automatisieren

Weiter mit Custom Storage

Wenn du es nutzt Eigener Speicher um Sicherheit und Compliance zu planen, verbinden Sie es mit Verschlüsselung für die Implementierungsdetails in Encryption, Compliance für das Implementierungsdetail in Compliance, Capgo Security Scanner für den Produkt-Workflow im Capgo Security Scanner, Capgo Sicherheit für den Produkt-Workflow in Capgo Security und Capgo Trust Center für den Produkt-Workflow im Capgo Trust Center.