Conformité HIPAA
Copiez un prompt de configuration incluant les étapes d'installation et le guide markdown complet pour ce plugin.
Cette page explique les options techniques que les équipes utilisent lorsqu’une revue HIPAA n’autorise pas l’envoi des statistiques live update vers Capgo Cloud.
Capgo Cloud n'est pas actuellement présenté comme un service hébergé de traitement de statistiques conforme HIPAA. De nombreuses applications sensibles à HIPAA utilisent toujours Capgo car les données de l'updater sont minimales, limitées à l'appareil et ne sont pas rattachées par défaut à un utilisateur connu de l'application. Si la politique de votre entreprise, un évaluateur ou un contrat client exige un contrôle plus strict, vous pouvez géolocaliser le trafic du plugin, désactiver l'endpoint de statistiques, auto-héberger uniquement l'endpoint de statistiques ou passer à une installation auto-hébergée sous licence.
Ce que Capgo reçoit par défaut
Section intitulée « Ce que Capgo reçoit par défaut »Le plugin updater envoie les données opérationnelles nécessaires pour fournir et observer les live updates. Le payload de statistiques peut inclure ces champs :
app_id- votre identifiant d'application Capacitordevice_id- un identifiant d'appareil aléatoire et propre à l'application, généré par le plugin updaterplatform-ios,android, ouelectronversion_name- la version du bundle web installéeversion_build- le nom de la version de l'application nativeversion_code- le numéro de build natifversion_os- la version du système d'exploitationplugin_version- la version@capgo/capacitor-updaterinstalléeaction- l'événement du cycle de vie de la mise à jour, comme l'installation, le téléchargement, l'échec, le rollback ou les événements app-readyis_emulatoretis_prod- les flags d'environnement, si disponiblescustom_id- uniquement si votre application le définit explicitement avecCapacitorUpdater.setCustomId(...)- Adresse IP - utilisée au niveau du transport pour le routage régional, la prévention des abus et l'optimisation du CDN
Par défaut, ces données sont anonymes pour l'utilisateur de l'application. Capgo ne reçoit ni noms, ni e-mails, ni IDs de compte, ni numéros de dossier médical, ni identifiants, ni contenu utilisateur, ni événements d'analytics d'application, ni analytics comportemental de la part de l'updater. Le seul identifiant stable est l'identifiant aléatoire propre à l'application device_id, qui n'est pas un ID publicitaire et n'est lié à aucun utilisateur connu, sauf si vous définissez custom_id vous-même.
Si votre revue HIPAA n’exige aucune statistique de mise à jour hébergée, définissez statsUrl à une chaîne vide. Cela désactive entièrement l’envoi des statistiques de l’updater vers Capgo Cloud, tandis que les vérifications de mises à jour peuvent toujours utiliser updateUrl et channelUrl si vous les laissez activées.
Ne pas définir d’ID personnalisé
Section intitulée « Ne pas définir d’ID personnalisé »Pour les déploiements sensibles HIPAA, n’appelez pas CapacitorUpdater.setCustomId(...).
L’ID personnalisé est inclus dans les statistiques du module de mise à jour lorsqu’il est configuré. Si vous le définissez sur une adresse e-mail, un ID utilisateur, un ID patient, un ID employé, un ID de compte ou toute autre valeur permettant d’identifier une personne, vous associez la télémétrie du module de mise à jour à des données personnelles dans le contexte de votre propre application.
Si votre revue exige que la télémétrie Capgo hébergée reste limitée à l’appareil, laissez custom_id non défini.
Option 1 : Géolocaliser le trafic du plugin Capgo Cloud
Section intitulée « Option 1 : géolocaliser le trafic du plugin Cloud Capgo »Si votre audit autorise Capgo Cloud mais exige la résidence UE des données de plugin, configurez les trois endpoints de l'updater sur l'hôte UE :
import type { CapacitorConfig } from '@capacitor/cli';
const config: CapacitorConfig = { appId: 'com.example.app', appName: 'My App', webDir: 'dist', plugins: { CapacitorUpdater: { autoUpdate: 'atBackground', updateUrl: 'https://plugin.eu.capgo.app/updates', statsUrl: 'https://plugin.eu.capgo.app/stats', channelUrl: 'https://plugin.eu.capgo.app/channel_self', }, },};
export default config;Utilisez les URL UE ensemble. Le mélange plugin.capgo.app et plugin.eu.capgo.app peut router une partie du chemin des données de plugin en dehors de l'hôte UE.
Cela permet de conserver la surveillance des mises à jour, les statistiques, les alertes et les données de dépannage de Capgo, tout en plaçant le chemin des données du plugin en Europe.
Option 2 : Désactiver l'endpoint de statistiques
Section intitulée « Option 2 : désactiver l'endpoint de statistiques »Si votre audit n'autorise pas l'envoi des statistiques vers Capgo Cloud, définissez statsUrl sur une chaîne vide :
import type { CapacitorConfig } from '@capacitor/cli';
const config: CapacitorConfig = { appId: 'com.example.app', appName: 'My App', webDir: 'dist', plugins: { CapacitorUpdater: { autoUpdate: 'atBackground', statsUrl: '', }, },};
export default config;Ceci désactive l'envoi de statistiques par le plugin d'updater. Les vérifications et les téléchargements de mises à jour peuvent toujours utiliser Capgo Cloud si vous conservez les paramètres par défaut. updateUrl et channelUrl.
Après avoir modifié capacitor.config.ts, synchronisez les projets natifs et publiez un nouveau build sur les stores. Les installations existantes continueront d'utiliser leur configuration native précédente jusqu'à ce qu'elles reçoivent ce nouveau binaire.
Ce que vous perdez en désactivant les statistiques
Section intitulée « Ce que vous perdez lorsque les statistiques sont désactivées »La désactivation statsUrl supprime le signal hébergé que Capgo utilise pour expliquer ce qui s'est passé dans votre application après qu'une mise à jour a été proposée ou téléchargée.
Vous perdez :
- Visibilité via le dashboard sur les installations réussies, les échecs d'installation, les erreurs de téléchargement, les rollbacks et les événements app-ready
- Alertes d'échec reposant sur les statistiques hébergées
- La possibilité d'identifier rapidement quelles versions d'app, d'OS, de plateformes ou de plugins sont affectées par un problème de mise à jour
- Traces de dépannage au niveau de l'appareil dans Capgo Cloud
- Statistiques agrégées sur l'adoption des mises à jour et l'usage de l'app dans le dashboard Capgo
- Un meilleur support contextuel de l'équipe Capgo, car le service hébergé ne reçoit plus les événements expliquant le chemin de mise à jour côté appareil
La livraison automatique des mises à jour peut toujours fonctionner, mais votre observabilité est réduite. Prévoyez votre propre monitoring avant de désactiver les statistiques en production.
Option 3 : Auto-héberger l'endpoint de statistiques
Section intitulée « Option 3 : Auto-héberger l'endpoint de statistiques »Si votre audit autorise les vérifications de mise à jour via Capgo Cloud mais exige que les statistiques restent dans votre infrastructure, pointez statsUrl vers votre propre endpoint :
import type { CapacitorConfig } from '@capacitor/cli';
const config: CapacitorConfig = { appId: 'com.example.app', appName: 'My App', webDir: 'dist', plugins: { CapacitorUpdater: { autoUpdate: 'atBackground', statsUrl: 'https://updates.example.com/capgo/stats', }, },};
export default config;Votre endpoint doit accepter le payload de statistiques du live update et renvoyer :
{ "status": "ok" }Utilisez ce chemin si vous souhaitez conserver l’alerte interne, les logs d’audit et l’analyse des incidents sans envoyer les statistiques de mise à jour des appareils à Capgo Cloud.
Option 4 : Auto-hébergement sous licence
Section intitulée « Option 4 : auto-hébergement sous licence »Si Capgo Cloud, la résidence des données en UE, les statistiques désactivées ou un endpoint de statistiques auto-hébergé ne suffisent pas à votre revue HIPAA, Capgo peut vous aider à passer à un déploiement auto-hébergé sous licence.
C’est l’option la plus stricte, car votre organisation contrôle le backend du live update, l’endpoint de statistiques, les logs, la rétention, l’infrastructure et la frontière réseau. Cela signifie aussi que vous devez assumer davantage du travail opérationnel que Capgo Cloud gère normalement pour vous.
Checklist de revue pratique
Section intitulée « Liste de contrôle pratique »Avant un audit HIPAA, décidez :
- Si l'hébergement Capgo Cloud est autorisé pour les vérifications de Live Update
- Si le Capgo Cloud hébergé est autorisé pour les statistiques
- La région à utiliser pour le trafic du plugin
- Si
custom_idest désactivé dans votre application - Qui surveille les échecs de mise à jour si les statistiques hébergées sont désactivées
- Si votre équipe a besoin d'un déploiement auto-hébergé sous licence
Capgo travaille avec des entreprises en cours d'audit de conformité HIPAA, y compris des entreprises aux États-Unis qui utilisent Capgo dans des programmes conformes HIPAA. Contactez Capgo si votre auditeur a besoin d'un modèle de déploiement, d'un flux de données ou d'un mode de licence plus strict que les options par défaut de l'offre hébergée.
Continuer depuis la conformité HIPAA
Section intitulée « Aller plus loin après la conformité HIPAA »Si vous utilisez Conformité HIPAA pour planifier un déploiement réglementé de live update, connectez-l’à Conformité for privacy and data collection details, Localisation des données pour la configuration du point d'accès UE, Endpoint de statistiques API pour la télémétrie auto-hébergée, et Metteur à jour auto-hébergé for licensed deployment planning.