Stockage personnalisé

Capgo prend en charge des solutions de stockage personnalisées pour vos ensembles de l'application, vous permettant de héberger vos mises à jour sur votre propre infrastructure ou sur des services de stockage tiers. Cela est particulièrement utile pour les organisations ayant des exigences de sécurité spécifiques, des besoins de conformité ou une infrastructure de stockage existante.

Vue d'ensemble

Le stockage personnalisé dans Capgo fonctionne en téléchargeant votre ensemble sur un emplacement externe et en fournissant à Capgo l'URL pour y accéder. Les Capgo SDK téléchargeront ensuite les mises à jour directement de votre emplacement de stockage personnalisé au lieu de l'infrastructure de stockage cloud par défaut de Capgo.

Conseil

Le stockage personnalisé est idéal pour :

• Les organisations ayant des exigences de résidence de données strictes
• Les équipes ayant une infrastructure de CDN ou de stockage existante
• Les applications nécessitant des couches de sécurité supplémentaires
• Optimisation des coûts pour de grandes tailles de paquet

Téléchargement d'URL externe

La manière la plus simple d'utiliser le stockage personnalisé est de télécharger votre paquet sur n'importe quelle URL accessible au public et de fournir cette URL à Capgo.

Téléchargement d'URL externe de base

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

Cette commande indique à Capgo de référencer le bundle à l'adresse URL spécifiée au lieu de l'uploader dans le stockage cloud de Capgo.

Avec chiffrage

Pour un stockage externe sécurisé, vous pouvez chiffrer votre bundle et fournir les clés de déchiffrement :

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

Intégration S3

Capgo fournit un support intégré pour Amazon S3 et les services de stockage S3 compatibles. CLI peut uploader automatiquement votre bundle sur S3 et configurer Capgo pour utiliser l'URL S3.

Options d'upload S3

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

Configuration S3 complète

Pour les services S3 compatibles ou les points de terminaison personnalisés :

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

Paramètres de la configuration S3

Paramètre	Description	Requis
--s3-region	Région AWS pour votre dossier S3	Oui
--s3-apikey	ID de clé d'accès S3	Oui
--s3-apisecret	Clé secrète d'accès S3	Oui
--s3-bucket-name	Nom de votre dossier S3	Oui
--s3-endpoint	URL de point de terminaison S3 personnalisée	Non
--s3-port	Port pour point de terminaison S3	Non
--no-s3-ssl	Désactiver SSL pour l'upload S3	Non

Préparation et chiffrement du paquet

Lorsque vous utilisez un stockage personnalisé, notamment avec le chiffrement, vous devez préparer vos paquets correctement. Cela implique la création d'un fichier zip et le chiffrement optionnel.

Étape 1 : Créer un paquet Zip

Créez d'abord un fichier zip de votre paquet d'application :

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

La commande zip renverra le checksum du fichier zip. Vous pouvez utiliser ce checksum pour chiffrer le fichier zip si nécessaire. Utilisez le --json option pour obtenir un résultat structuré incluant le checksum.

Options du Commande Zip

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	Description
--path	Chemin du dossier à zipper (par défaut webDir de capacitor.config)
--bundle	Numéro de version du bundle pour nommer le fichier zip
--name	Nom personnalisé pour le fichier zip
--json	Résultats de sortie en format JSON (inclut le checksum)
--no-code-check	Ignorer la vérification de l'appel de notifyAppReady() et du fichier index
--key-v2	Utilisez l'encryption v2
--package-json	Chemins vers les fichiers package.json pour les monorepos (séparés par des virgules)

Étape 2 : Chiffrer le Bundle (Facultatif)

Pour une sécurité renforcée, chifrez votre zip bundle avant de l'uploader :

# 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"

Le CHECKSUM ce paramètre est obligatoire et doit être le checksum de votre fichier zip. Vous pouvez obtenir le checksum à partir de la sortie de la commande zip (utilisez --json l'option pour un format de sortie structuré).

Par défaut, la commande de chiffrement utilisera votre clé privée de signature locale. Vous pouvez spécifier une clé personnalisée en utilisant le --key ou --key-data options.

La commande de chiffrement renverra le ivSessionKey nécessaire pour l'upload ou la déchiffrement.

Options de la commande de chiffrement

Option	Description
zipPath	Chemin du fichier zip à chiffrer (obligatoire)
checksum	Coche de somme du fichier zip (obligatoire) - obtenez-le de la commande zip
--key	Chemin personnalisé pour la clé de signature privée (facultatif, utilise la clé locale par défaut)
--key-data	Données de la clé de signature privée directement (facultatif)
--json	Résultats de sortie sous format JSON

Attention

La commande de chiffrement affichera un ivSessionKey que vous devrez fournir lors de l'upload avec l' --iv-session-key option.

Exemples de flux de travail complets

Exemple 1 : URL externe avec chiffrement

1. Construire votre application :

   npm run build

2. Créez un fichier zip :

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

   Notez le checksum retourné par cette commande.

3. Chiffrer le fichier :

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

   Notez le ivSessionKey à partir de l'output.

4. Télécharger sur votre stockage : Téléchargez le fichier zip chiffré sur votre service de hébergement.

5. Inscrivez-vous avec Capgo:

   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

Exemple 2 : Téléchargement direct S3

1. Construire votre application :

   npm run build

2. Télécharger directement sur S3 :

   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

Exemple 3 : S3 avec chiffrement

1. Construire et zipper :

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

2. Chiffrer le bundle :

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

3. Charger sur S3 avec chiffrage :

   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

Considérations de sécurité

Lors de l'utilisation d'un stockage personnalisé, considérez ces bonnes pratiques de sécurité :

Contrôle d'accès

• Assurez-vous que les URL de stockage soient accessibles à vos utilisateurs d'application mais pas découvertes publiquement
• Utilisez des URL signées ou une authentification basée sur des jetons lorsque cela est possible
• Mettez en œuvre les en-têtes CORS appropriés pour les applications web

Encryption

• Encryptez toujours les bundles sensibles à l'aide des outils d'Capgo de cryptage
• Stockez les clés de cryptage de manière sécurisée et les rourez régulièrement
• Utilisez HTTPS pour toutes les URL de bundle (obligatoire pour les applications mobiles et Electron)

Surveillance

• Surveillez les journaux d'accès pour détecter des modèles de téléchargement inhabituels
• Configurer des alertes pour les téléchargements de bundles échoués
• Auditer régulièrement vos permissions de stockage

Résolution des problèmes

Problèmes courants

Le bundle ne télécharge pas :

• Vérifiez que l'URL est accessible au public et utilise HTTPS (obligatoire pour les applications mobiles et Electron)
• Vérifiez les en-têtes CORS pour les applications web
• Assurez-vous que le format du bundle est correct

Erreurs d'encryption :

• Vérifiez que ivSessionKey correspond à l'ensemble de fichiers chiffrés
• Vérifiez que l'ensemble de fichiers a été chiffré avec la bonne clé
• Assurez-vous que l'encryption v2 est utilisé pour les nouveaux ensembles de fichiers

Échecs d'upload S3 :

• Vérifiez vos identifiants et vos permissions S3
• Vérifiez les politiques de la boîte à archives et la configuration CORS
• Assurez-vous que la région spécifiée est correcte

Commandes de débogage

Vérifiez l'état de l'ensemble de fichiers :

npx @capgo/cli@latest app debug

Vérifiez l'intégrité du bundle :

npx @capgo/cli@latest bundle list

Étapes suivantes

• En savoir plus sur Canaux pour gérer différents environnements de déploiement
• Explorer Mise à jour de la comportement pour personnaliser la façon dont les mises à jour sont appliquées
• Configurer Intégration CI/CD pour automatiser votre flux de stockage personnalisé

Continuez depuis Stockage personnalisé

Si vous utilisez Stockage personnalisé pour planifier la sécurité et la conformité, connectez-le avec Chiffrement pour les détails d'implémentation dans Chiffrement, Conformité pour les détails d'implémentation dans Conformité, Capgo Scanner de sécurité pour le flux de workflow du produit dans Capgo Scanner de sécurité, Capgo Sécurité pour le flux de workflow du produit dans Capgo Sécurité, et Capgo Centre de confiance pour le flux de workflow du produit dans Capgo Centre de confiance.