Vai al contenuto

Storage personalizzato

Capgo supporta soluzioni di storage personalizzate per i bundle della tua app, consentendoti di ospitare gli aggiornamenti sulla tua infrastruttura o su servizi di storage di terze parti. Questo è particolarmente utile per le organizzazioni con requisiti di sicurezza specifici, esigenze di conformità o infrastrutture di storage esistenti.

Lo storage personalizzato in Capgo funziona caricando il tuo bundle in una posizione esterna e fornendo a Capgo l'URL per accedervi. Il Capgo SDK scaricherà quindi gli aggiornamenti direttamente dalla tua posizione di storage personalizzata anziché dallo storage cloud predefinito di Capgo.

Il modo più semplice per utilizzare lo storage personalizzato è caricare il bundle su un URL pubblicamente accessibile e fornire tale URL a Capgo.

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

Questo comando istruisce Capgo a fare riferimento al bundle all'URL specificato anziché caricarlo nello storage cloud di Capgo.

Per uno storage esterno sicuro, puoi crittografare il bundle e fornire le chiavi di decrittazione:

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

Capgo offre supporto integrato per Amazon S3 e servizi di storage compatibili con S3. CLI può caricare automaticamente il tuo bundle su S3 e configurare Capgo per utilizzare l'URL S3.

Finestra del terminale
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

Per servizi compatibili con S3 o endpoint personalizzati:

Finestra del terminale
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
ParametroDescrizioneObbligatorio
--s3-regionRegione AWS per il tuo bucket S3Sì
--s3-apikeyID chiave di accesso S3Sì
--s3-apisecretChiave di accesso segreta S3Sì
--s3-bucket-nameNome del tuo bucket S3Sì
--s3-endpointURL endpoint S3 personalizzatoNo
--s3-portPorta per l'endpoint S3No
--no-s3-sslDisabilita SSL per l'upload su S3No

Quando usi lo storage personalizzato, soprattutto con crittografia, devi preparare i bundle correttamente. Questo richiede di creare un file zip e, facoltativamente, di crittificarlo.

Innanzitutto, crea un file zip del bundle della tua app:

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

Il comando zip restituirà il checksum del file zip. Puoi usare questo checksum per crittografare il file zip se necessario. Usa l'opzione --json per ottenere un output strutturato che includa il checksum.

Finestra del terminale
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
OpzioneDescrizione
--pathPercorso della cartella da comprimere (predefinito: webDir da capacitor.config)
--bundleNumero di versione del bundle per nominare lo zip
--nameNome personalizzato per il file zip
--jsonOutput dei risultati in formato JSON (include checksum)
--no-code-checkIgnora il controllo della chiamata notifyAppReady() e del file index
--key-v2Usa la crittografia v2
--package-jsonPercorsi dei file package.json per monorepo (separati da virgola)

Per una maggiore sicurezza, crittografa il bundle zip prima dell'upload:

Finestra del terminale
# 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"

Il CHECKSUM Il parametro è obbligatorio e deve essere il checksum del tuo file zip. Puoi ottenere il checksum dall'output del comando zip (usa --json opzione per un output strutturato).

Di default, il comando encrypt utilizza la tua chiave di firma privata locale. Puoi specificare una chiave personalizzata usando le --key oppure --key-data opzioni.

Il comando encrypt restituirà il ivSessionKey necessario per l'upload o la decrittazione.

OpzioneDescrizione
zipPathPercorso del file zip da crittografare (obbligatorio)
checksumChecksum del file zip (obbligatorio) - ottienilo dal comando zip
--keyPercorso personalizzato per la chiave di firma privata (opzionale, usa la chiave locale di default)
--key-dataDati della chiave di firma privata direttamente (facoltativo)
--jsonOutput dei risultati in formato JSON
  1. Esegui il build della tua app:

    Finestra del terminale
    npm run build
  2. Crea un bundle zip:

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

    Annota il checksum restituito da questo comando.

  3. Crittografa il bundle:

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

    Annota il ivSessionKey dall'output.

  4. Upload sul tuo storage: Carica il file zip crittografato sul tuo servizio di hosting.

  5. Registra con Capgo:

    Finestra del terminale
    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. Esegui il build della tua app:

    Finestra del terminale
    npm run build
  2. Upload diretto su S3:

    Finestra del terminale
    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
  1. Build e zip:

    Finestra del terminale
    npm run build
    npx @capgo/cli@latest bundle zip com.example.app --path ./dist --key-v2
  2. Crittografa il bundle:

    Finestra del terminale
    npx @capgo/cli@latest bundle encrypt ./com.example.app.zip CHECKSUM
  3. Upload su S3 con crittografia:

    Finestra del terminale
    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

Quando si utilizza un archiviazione personalizzata, considera queste best practice di sicurezza:

  • Assicurati che gli URL di storage siano accessibili agli utenti della tua app ma non pubblicamente individuabili
  • Usa URL firmati o autenticazione basata su token quando possibile
  • Implementa le intestazioni CORS corrette per le app web
  • Crittografa sempre i bundle sensibili utilizzando gli strumenti di crittografia di Capgo
  • Conserva le chiavi di crittografia in modo sicuro e ruotalle regolarmente
  • Usa HTTPS per tutti gli URL dei bundle (obbligatorio per app mobile ed Electron)
  • Monitora i log di accesso per rilevare pattern di download insoliti
  • Configura avvisi per i download di bundle non riusciti
  • Esegui regolarmente un audit dei permessi di storage

Il bundle non viene scaricato:

  • Verifica che l'URL sia accessibile pubblicamente e utilizzi HTTPS (obbligatorio per app mobile ed Electron)
  • Controlla le intestazioni CORS per le app web
  • Assicurati che il formato del bundle sia corretto

Errori di crittografia:

  • Verifica il ivSessionKey corrisponde al bundle crittografato
  • Verifica che il bundle sia stato crittografato con la chiave corretta
  • Assicurati di usare encryption v2 per i nuovi bundle

Errori di upload su S3:

  • Verifica le credenziali e i permessi S3
  • Controlla le policy del bucket e la configurazione CORS
  • Assicurati che la regione specificata sia corretta

Verifica lo stato del bundle:

Finestra del terminale
npx @capgo/cli@latest app debug

Verifica l'integrità del bundle:

Finestra del terminale
npx @capgo/cli@latest bundle list

Se stai usando Storage personalizzato per pianificare sicurezza e compliance, collegalo a Crittografia per i dettagli di implementazione della crittografia, Conformità per i dettagli di implementazione in Compliance, Security Scanner di Capgo per il workflow del prodotto in Capgo Security Scanner, Sicurezza Capgo per il workflow del prodotto in Capgo Security, e Trust Center di Capgo per il workflow del prodotto in Capgo Trust Center.