Eigener Speicher
Kopiere einen Setup-Prompt mit den Installationsschritten und dem vollständigen Markdown-Guide für dieses Plugin.
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.
Übersicht
Abschnitt: „Übersicht“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.
Upload via externer URL
Abschnitt mit dem Titel „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
Abschnitt mit dem Titel „Einfacher Upload via externer URL“npx @capgo/cli@latest bundle upload --external https://your-domain.com/bundles/v1.2.3.zipDieser 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
Abschnitt mit dem Titel „Mit Verschlüsselung“Für sicheren externen Speicher können Sie Ihr Bundle verschlüsseln und die Entschlüsselungsschlüssel bereitstellen:
npx @capgo/cli@latest bundle upload --external https://your-domain.com/bundles/v1.2.3.zip --iv-session-key YOUR_IV_SESSION_KEYS3-Integration
Abschnitt mit dem Titel „S3-Integration“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.
S3-Upload-Optionen
Abschnitt mit dem Titel „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-nameVollständige S3-Konfiguration
Abschnitt mit dem Titel „Vollständige S3-Konfiguration“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 SSLS3-Konfigurationsparameter
Abschnitt mit dem Titel „S3-Konfigurationsparameter“| Parameter | Beschreibung | Erforderlich |
|---|---|---|
--s3-region | AWS-Region für Ihren 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
Abschnitt mit dem Titel „Bundle-Vorbereitung und Verschlüsselung“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.
Schritt 1: Zip-Bundle erstellen
Abschnitt mit dem Titel „Schritt 1: Zip-Bundle erstellen“Erstellen Sie zunächst eine Zip-Datei Ihres App-Bundles:
npx @capgo/cli@latest bundle zip com.example.app --path ./distDer 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.
Optionen des zip-Befehls
Abschnitt mit dem Titel „Zip-Befehlsoptionen“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 Ordner, der gezippt werden soll (Standard: webDir aus capacitor.config) |
--bundle | Bundle-Versionsnummer für den Namen der Zip-Datei |
--name | Benutzerdefinierter Name für die Zip-Datei |
--json | Ergebnisse im JSON-Format ausgeben (inkl. Checksumme) |
--no-code-check | Prüfung auf notifyAppReady()-Aufruf und 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)
Abschnitt mit dem Titel „Schritt 2: Bundle verschlüsseln (optional)“Verschlüsseln Sie Ihr Zip-Bundle vor dem Upload für mehr Sicherheit:
# Using default local keynpx @capgo/cli@latest bundle encrypt ./myapp.zip CHECKSUM
# Using custom key filenpx @capgo/cli@latest bundle encrypt ./myapp.zip CHECKSUM --key ./path/to/.capgo_key_v2
# Using key data directlynpx @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.
Optionen für den encrypt-Befehl
Abschnitt mit dem Titel „Optionen für den encrypt-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 Eingabe der privaten Signing-Key-Daten (optional) |
--json | Ausgabe der Ergebnisse im JSON-Format |
Vollständige Workflow-Beispiele
Abschnitt mit dem Titel „Vollständige Workflow-Beispiele“Beispiel 1: Externe URL mit Verschlüsselung
Abschnitt mit dem Titel „Beispiel 1: Externe URL mit Verschlüsselung“-
Erstelle deine App:
Terminalfenster npm run build -
Erstellen Sie ein ZIP-Bundle:
Terminalfenster npx @capgo/cli@latest bundle zip com.example.app --path ./dist --bundle 1.2.3Notieren Sie den von diesem Befehl zurückgegebenen Checksum.
-
Verschlüsseln Sie das Bundle:
Terminalfenster npx @capgo/cli@latest bundle encrypt ./com.example.app-1.2.3.zip CHECKSUM_FROM_STEP_2Notiere dir die
ivSessionKeyaus der Ausgabe. -
Upload zu Ihrem Storage: Laden Sie die verschlüsselte ZIP-Datei auf Ihren Hosting-Dienst hoch.
-
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
Beispiel 2: Direkter S3-Upload
Abschnitt: „Beispiel 2: Direkter S3-Upload“-
Erstelle deine App:
Terminalfenster npm run build -
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“-
Build und zippen:
Terminalfenster npm run buildnpx @capgo/cli@latest bundle zip com.example.app --path ./dist --key-v2 -
Verschlüsseln Sie das Bundle:
Terminalfenster npx @capgo/cli@latest bundle encrypt ./com.example.app.zip CHECKSUM -
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
Sicherheitsaspekte
Abschnitt mit dem Titel „Sicherheitsaspekte“Bei der Verwendung von Custom Storage sollten Sie diese Sicherheitsbestpraktiken beachten:
Zugriffskontrolle
Abschnitt: „Zugriffskontrolle“- 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üsselung
Abschnitt mit dem Titel „Verschlüsselung“- 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)
Monitoring
Abschnitt mit dem Titel „Monitoring“- Ü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
Fehlerbehebung
Abschnitt mit dem Titel „Troubleshooting“Häufige Probleme
Abschnitt „Häufige Probleme“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
ivSessionKeymit 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
Debug-Commands
Abschnitt mit dem Titel „Debug Commands“Bundle-Status prüfen:
npx @capgo/cli@latest app debugBundle-Integrität prüfen:
npx @capgo/cli@latest bundle listNächste Schritte
Abschnitt „Nächste Schritte“- 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
Weiter mit Custom Storage
Abschnitt mit dem Titel „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, 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.