Conformité HIPAA

Cette page explique les options techniques utilisées par les équipes lorsqu'une revue HIPAA interdit l'envoi de statistiques live update vers le cloud Capgo.

Capgo Cloud n'est pas actuellement présenté comme un processeur de statistiques hébergé conforme à la norme 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 liées par défaut à un utilisateur d'application connu. Si la politique de votre entreprise, un réviseur 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 configuration auto-hébergée sous licence.

Remarque

Cette page est un guide d'implémentation et non un conseil juridique. Votre responsable de la conformité décidera si Capgo Cloud, une configuration de télémétrie réduite ou l'auto-hébergement convient à votre audit HIPAA.

Ce que Capgo reçoit par défaut

Le plugin updater envoie les données opérationnelles nécessaires pour livrer et observer les live updates. Le payload de statistiques peut inclure ces champs :

• app_id - votre identifiant d'application Capacitor
• device_id - un identifiant d'appareil aléatoire, propre à l'application, généré par le plugin updater
• platform - ios, android, ou electron
• version_name - la version du bundle web installée
• version_build - le nom de la version de l'application native
• version_code - le numéro de build natif
• version_os - la version du système d'exploitation
• plugin_version - la version @capgo/capacitor-updater installée
• action - l'événement du cycle de vie de la mise à jour, comme l'installation, le téléchargement, l'échec, le rollback ou l'état prêt de l'app
• is_emulator et is_prod - les flags d'environnement, si disponibles
• custom_id - uniquement si votre app le définit explicitement avec CapacitorUpdater.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'app. Capgo ne reçoit ni noms, e-mails, IDs de compte, numéros de dossier médical, identifiants, contenu utilisateur, événements d'analytics d'app ou d'analytics comportementale de la part de l'updater. Le seul identifiant stable est l'identifiant aléatoire propre à l'app device_id, qui n'est pas un ID publicitaire et n'est lié à aucun utilisateur connu, sauf si vous configurez custom_id vous-même.

Si votre audit HIPAA exige qu'aucune statistique de mise à jour ne soit hébergée, réglez statsUrl à une chaîne vide. Cela désactive complètement l'envoi des statistiques de l'updater vers le cloud de Capgo, tout en permettant aux vérifications de mise à jour d'utiliser updateUrl et channelUrl si vous les laissez activées.

Ne définissez pas d'ID personnalisé

Pour les déploiements sensibles aux normes HIPAA, n'appelez pas CapacitorUpdater.setCustomId(...).

L'ID personnalisé est inclus dans les statistiques de l'updater lorsqu'il est configuré. Si vous le définissez avec 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 liez la télémétrie de l'updater à des données personnelles dans le contexte de votre propre application.

Si votre audit 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

Si votre examen autorise Capgo Cloud mais exige la résidence des données de plugin dans l'UE, configurez les trois endpoints de l'updater sur l'hôte EU :

capacitor.config.ts

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 de l'UE ensemble. Mélanger plugin.capgo.app et plugin.eu.capgo.app peut router une partie du chemin des données du plugin en dehors de l'hôte EU.

Cela permet de garder les données de monitoring, de statistiques, d'alertes et de troubleshooting de Capgo disponibles, tout en plaçant le chemin des données du plugin en Europe.

Localisation des données

Option 2 : Désactiver l'endpoint de statistiques

Si votre audit n'autorise pas l'envoi de statistiques vers Capgo Cloud, définissez statsUrl sur une chaîne vide :

capacitor.config.ts

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 téléchargements de mises à jour peuvent toujours utiliser Capgo Cloud si vous conservez le réglage par défaut. updateUrl et channelUrl.

Après avoir modifié capacitor.config.ts, synchronisez les projets natifs et publiez un nouveau build pour les stores. Les installations existantes conserveront leur configuration native précédente jusqu'à ce qu'elles reçoivent ce nouveau binaire.

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 échecs 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

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 :

capacitor.config.ts

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 des statistiques de l'updater et retourner :

{ "status": "ok" }

Utilisez ce chemin si vous souhaitez conserver l'alerte interne, les logs d'audit et l'analyse d'incidents sans envoyer les statistiques de mise à jour des appareils au Cloud Capgo.

Endpoint de statistiques API

Option 4 : Auto-hébergement sous licence

Si le Cloud Capgo, la résidence des données en UE, la désactivation des statistiques ou un endpoint de statistiques auto-hébergé ne satisfont toujours pas votre audit 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 de l'updater, l'endpoint de statistiques, les logs, la rétention, l'infrastructure et la limite réseau. Cela signifie également que vous devez assumer une plus grande partie du travail opérationnel que le Cloud Capgo gère normalement pour vous.

Updater auto-hébergé

Checklist de revue pratique

Avant un audit HIPAA, décidez :

• Si l'hébergement Capgo Cloud est autorisé pour les vérifications de mise à jour
• Si l'utilisation du Capgo Cloud hébergé est autorisée pour les statistiques
• La région que le trafic du plugin doit utiliser
• Si custom_id est 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 nécessite un déploiement auto-hébergé sous licence

Capgo collabore avec des entreprises en cours de certification HIPAA, y compris des entreprises aux États-Unis utilisant Capgo dans le cadre de programmes conformes à HIPAA. Contactez Capgo si votre auditeur exige un modèle de déploiement, un flux de données ou un mode de licence plus strict que les options par défaut hébergées.

Continuer la section Conformité HIPAA

Si vous utilisez Conformité HIPAA pour planifier un déploiement progressif live update réglementé, connectez-l’à Conformité for privacy and data collection details, Localisation des données pour la configuration des endpoints de l'UE, Endpoint de statistiques API pour la télémétrie auto-hébergée, et Updater auto-hébergé for licensed deployment planning.