Zum Inhalt springen

Eigener Speicher

Capgo unterstützt benutzerdefinierte Speicherlösungen für Ihre App-Bundles, sodass Sie Ihre Updates auf Ihrer eigenen Infrastruktur oder bei Drittanbieter-Speicherdiensten hosten können. Dies ist besonders nützlich für Organisationen mit spezifischen Sicherheitsanforderungen, Compliance-Bedarf oder bestehender Speicherinfrastruktur.

Benutzerdefinierter Speicher in Capgo funktioniert, indem Sie Ihr Bundle an einen externen Speicherort hochladen und Capgo die URL zur Verfügung stellen, um darauf zuzugreifen. Die Capgo SDK lädt Updates dann direkt von Ihrem benutzerdefinierten Speicherort herunter, anstatt den Standard-Cloud-Speicher von Capgo zu verwenden.

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

Terminalfenster
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.

Für sicheren externen Speicher können Sie Ihr Bundle verschlüsseln und die Entschlüsselungsschlüssel bereitstellen:

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

Capgo bietet integrierte Unterstützung für Amazon S3 und S3-kompatible Speicherdienste. Die CLI kann Ihr Bundle automatisch in S3 hochladen und Capgo so konfigurieren, dass die S3-URL verwendet wird.

Terminalfenster
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

Für S3-kompatible Dienste oder benutzerdefinierte Endpunkte:

Terminalfenster
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
ParameterBeschreibungErforderlich
--s3-regionAWS-Region für Ihren S3-BucketJa
--s3-apikeyS3 Access Key IDJa
--s3-apisecretS3 Secret Access KeyJa
--s3-bucket-nameName deines S3-BucketsJa
--s3-endpointEigene S3-Endpoint-URLNein
--s3-portPort für S3-EndpointNein
--no-s3-sslSSL für S3-Upload deaktivierenNein

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

Erstellen Sie zunächst eine Zip-Datei Ihres App-Bundles:

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

Der zip-Befehl gibt den Checksum der Zip-Datei zurück. Sie können diese Checksum verwenden, um die Zip-Datei bei Bedarf zu verschlüsseln. Verwenden Sie die --json Option, um strukturierte Ausgaben einschließlich der Checksum zu erhalten.

Terminalfenster
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
OptionBeschreibung
--pathPfad zum Ordner, der gezippt werden soll (Standard: webDir aus capacitor.config)
--bundleBundle-Versionsnummer für den Namen der Zip-Datei
--nameBenutzerdefinierter Name für die Zip-Datei
--jsonErgebnisse im JSON-Format ausgeben (inkl. Checksumme)
--no-code-checkPrüfung auf notifyAppReady()-Aufruf und Index-Datei überspringen
--key-v2Verschlüsselung v2 verwenden
--package-jsonPfade zu package.json-Dateien für Monorepos (kommagetrennt)

Verschlüsseln Sie Ihr Zip-Bundle vor dem Upload für mehr Sicherheit:

Terminalfenster
# 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 den Checksummenwert Ihrer Zip-Datei sein. Sie können die Checksumme aus der Ausgabe des zip-Befehls abrufen (verwenden Sie --json Option für strukturierte Ausgabe).

Standardmäßig verwendet der encrypt-Befehl Ihren lokalen privaten Signierungsschlüssel. Sie können einen benutzerdefinierten Schlüssel mit --key oder --key-data options.

Der encrypt-Befehl gibt die ivSessionKey für den Upload oder die Entschlüsselung erforderlich.

OptionBeschreibung
zipPathPfad zur zu verschlüsselnden Zip-Datei (erforderlich)
checksumChecksum der ZIP-Datei (erforderlich) – über den zip-Befehl ermitteln
--keyBenutzerdefinierter Pfad für den privaten Signing-Key (optional, nutzt standardmäßig den lokalen Key)
--key-dataDirekte Eingabe der privaten Signing-Key-Daten (optional)
--jsonAusgabe der Ergebnisse im JSON-Format
  1. Erstelle deine App:

    Terminalfenster
    npm run build
  2. Erstellen Sie ein ZIP-Bundle:

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

    Notieren Sie den von diesem Befehl zurückgegebenen Checksum.

  3. Verschlüsseln Sie das Bundle:

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

    Notiere dir die ivSessionKey aus der Ausgabe.

  4. Upload zu Ihrem Storage: Laden Sie die verschlüsselte ZIP-Datei auf Ihren Hosting-Dienst hoch.

  5. Registrieren bei Capgo:

    Terminalfenster
    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
  1. Erstelle deine App:

    Terminalfenster
    npm run build
  2. Direkt zu S3 hochladen:

    Terminalfenster
    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

Abschnitt: „Beispiel 3: S3 mit Verschlüsselung“
  1. Build und zippen:

    Terminalfenster
    npm run build
    npx @capgo/cli@latest bundle zip com.example.app --path ./dist --key-v2
  2. Verschlüsseln Sie das Bundle:

    Terminalfenster
    npx @capgo/cli@latest bundle encrypt ./com.example.app.zip CHECKSUM
  3. Upload nach S3 mit Verschlüsselung:

    Terminalfenster
    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

Bei der Verwendung von Custom Storage sollten Sie diese Sicherheitsbestpraktiken beachten:

  • Stellen Sie sicher, dass Ihre Storage-URLs für Ihre App-Nutzer zugänglich, aber nicht öffentlich auffindbar sind
  • Nutze nach Möglichkeit Signed URLs oder tokenbasierte Authentifizierung
  • Implementiere korrekte CORS-Header für Web-Apps
  • Verschlüssele sensible Bundles immer mit den Verschlüsselungstools von Capgo
  • Speichere Verschlüsselungsschlüssel sicher und rotiere sie regelmäßig
  • Nutze HTTPS für alle Bundle-URLs (erforderlich für Mobile- und Electron-Apps)
  • Überwache die Access Logs, um ungewöhnliche Download-Muster zu erkennen
  • Richte Alerts für fehlgeschlagene Bundle-Downloads ein
  • Prüfe regelmäßig deine Storage-Berechtigungen

Bundle wird nicht heruntergeladen:

  • Prüfen Sie, ob die URL öffentlich erreichbar 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:

  • Prüfen Sie, ob der 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 verwendet wird

S3-Upload-Fehler:

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

Bundle-Status prüfen:

Terminalfenster
npx @capgo/cli@latest app debug

Bundle-Integrität prüfen:

Terminalfenster
npx @capgo/cli@latest bundle list
  • Mehr über Kanäle um verschiedene Deployment-Umgebungen zu verwalten
  • Entdecken Update-Verhalten um anzupassen, wie Updates angewendet werden
  • Einrichten CI/CD-Integration um Ihren Custom-Storage-Workflow zu automatisieren

Wenn du es nutzt Eigener Speicher um Sicherheit und Compliance zu planen, verbinden Sie es mit Verschlüsselung für die Implementierungsdetails in Encryption, Konformität 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.