Conformità HIPAA

Questa pagina spiega le opzioni tecniche che i team usano quando una revisione HIPAA non consente di inviare le statistiche live update a Capgo Cloud.

Capgo Cloud non è attualmente configurato come processore di statistiche ospitato conforme a HIPAA. Molte app sensibili utilizzano ancora Capgo poiché i dati dell'updater sono minimi, limitati al dispositivo e non associati di default a un utente noto. Se la policy aziendale, il revisore o il contratto con il cliente richiedono un controllo più rigoroso, puoi geo-localizzare il traffico del plugin, disabilitare l'endpoint delle statistiche, ospitare autonomamente l'endpoint o passare a una configurazione self-hosted con licenza.

Nota

Questa pagina fornisce indicazioni tecniche, non consulenza legale. Il responsabile della compliance deciderà se Capgo Cloud, una configurazione di telemetria ridotta o l'auto-hosting siano adatti alla tua revisione HIPAA.

Cosa riceve Capgo di default

Il plugin dell'updater invia i dati operativi necessari per erogare e monitorare i Live Update. Il payload delle statistiche può includere questi campi:

• app_id - il tuo identificativo app Capacitor
• device_id - un identificativo dispositivo casuale e specifico per l'app, generato dal plugin dell'updater
• platform - ios, android, o electron
• version_name - la versione del web bundle installata
• version_build - il nome della versione dell'app nativa
• version_code - il numero di build nativo
• version_os - la versione del sistema operativo
• plugin_version - la versione @capgo/capacitor-updater installata
• action - l'evento del ciclo di vita dell'update, come install, download, failure, rollback o app-ready
• is_emulator e is_prod - i flag di ambiente, quando disponibili
• custom_id - solo se la tua app lo imposta esplicitamente con CapacitorUpdater.setCustomId(...)
• Indirizzo IP - usato a livello di trasporto per il routing regionale, la prevenzione degli abusi e l'ottimizzazione della CDN

Per impostazione predefinita, questi dati sono anonimi per l'utente dell'app. Capgo non riceve nomi, email, ID account, numeri di cartella clinica, credenziali, contenuti dell'utente, eventi di analytics dell'app o analytics comportamentali dall'updater. L'unico identificatore stabile è quello casuale e limitato all'app device_id, che non è un ID pubblicitario e non è collegato a un utente noto a meno che non lo imposti custom_id tu stesso.

Se la tua revisione HIPAA non richiede alcuna statistica sugli update ospitata, imposta statsUrl a una stringa vuota. Questo disabilita completamente l'invio delle statistiche dell'updater a Capgo Cloud, pur permettendo ai controlli degli update di utilizzare updateUrl e channelUrl se decidi di lasciarli attivi.

Non impostare un ID personalizzato

Per deployment sensibili a HIPAA, non chiamare CapacitorUpdater.setCustomId(...).

L'ID personalizzato viene incluso nelle statistiche dell'updater quando configurato. Se lo imposti come indirizzo email, user ID, patient ID, employee ID, account ID o qualsiasi altro valore riconducibile a una persona, collegherai la telemetria dell'updater a dati personali nel contesto della tua app.

Se la revisione richiede che la telemetria Capgo ospitata rimanga limitata al dispositivo, lascia custom_id non impostato.

Opzione 1: Geolocalizzare il traffico del plugin Capgo Cloud

Se la tua revisione consente Capgo Cloud ma richiede la residenza dei dati dei plugin nell'UE, configura tutti e tre gli endpoint dell'updater sull'host 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;

Usa gli URL EU insieme. Mescolare plugin.capgo.app e plugin.eu.capgo.app può instradare parte del percorso dei dati dei plugin fuori dall'host EU.

In questo modo, i dati di monitoraggio degli update, statistiche, alert e troubleshooting ospitati da Capgo rimangono disponibili, mantenendo il percorso dei dati dei plugin in Europa.

Ubicazione dati

Opzione 2: Disabilita l'endpoint delle statistiche

Se la tua revisione non consente l'invio di statistiche a Capgo Cloud, imposta statsUrl a una stringa vuota:

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;

Questo disabilita l'invio delle statistiche dal plugin updater. I controlli e i download degli update possono ancora usare Capgo Cloud se mantieni l'impostazione predefinita updateUrl e channelUrl.

Dopo aver modificato capacitor.config.ts, sincronizza i progetti nativi e rilascia una nuova build sugli store. Le installazioni esistenti continueranno a usare la vecchia configurazione nativa finché non riceveranno il nuovo binario.

Cosa si perde disabilitando le statistiche

Disabilitando statsUrl rimuove il segnale ospitato che Capgo usa per spiegare cosa è successo all'interno della tua app dopo che un update è stato proposto o scaricato.

Perderai:

• La visibilità sul dashboard di installazioni completate, fallite, errori di download, rollback ed eventi app-ready
• Alert di errore basati sulle statistiche ospitate
• La possibilità di identificare subito quali versioni di app, sistema operativo, piattaforme o plugin sono interessate da un problema di update
• Tracce di troubleshooting a livello di dispositivo in Capgo Cloud
• Statistiche aggregate sull'adozione degli update e sull'uso dell'app nella dashboard di Capgo
• Migliore supporto contestuale dal team Capgo, poiché il servizio ospitato non riceve più gli eventi che spiegano il percorso di aggiornamento lato dispositivo

La consegna automatica degli update può ancora funzionare, ma stai operando con osservabilità ridotta. Pianifica il tuo monitoraggio prima di disabilitare le statistiche in produzione.

Opzione 3: Self-host dell'endpoint delle statistiche

Se la tua revisione permette i controlli degli update tramite Capgo Cloud ma richiede che le statistiche restino nella tua infrastruttura, punta statsUrl al tuo 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;

Il tuo endpoint deve accettare il payload delle statistiche dell'updater e restituire:

{ "status": "ok" }

Usa questo percorso se vuoi mantenere alert interni, audit log e analisi degli incidenti senza inviare le statistiche di aggiornamento dei dispositivi a Capgo Cloud.

Endpoint statistiche di API

Opzione 4: Self-hosting con licenza

Se Capgo Cloud, la data residency in UE, le statistiche disabilitate o un endpoint self-hosted per le statistiche non soddisfano ancora la tua revisione HIPAA, Capgo può aiutarti a passare a un deployment self-hosted con licenza.

È l'opzione più restrittiva perché la tua organizzazione controlla il backend dell'updater, l'endpoint delle statistiche, i log, la retention, l'infrastruttura e il perimetro di rete. Significa anche che dovrai farti carico di più lavoro operativo che Capgo Cloud gestisce normalmente per te.

Updater self-hosted

Checklist pratica di revisione

Prima di una revisione HIPAA, decidi:

• Se è consentito usare Capgo Cloud ospitato per i controlli degli aggiornamenti
• Se è consentito usare Capgo Cloud ospitato per le statistiche
• Quale regione deve usare il traffico del plugin
• Se custom_id è disabilitato nella tua app
• Chi monitora gli errori di aggiornamento se le statistiche ospitate sono disabilitate
• Se il tuo team ha bisogno di un deployment self-hosted con licenza

Capgo lavora con aziende in fase di revisione di conformità HIPAA, comprese quelle negli Stati Uniti che usano Capgo in programmi conformi a HIPAA. Contatta Capgo se chi esamina la tua conformità richiede un modello di deployment, un flusso dati o un percorso di licenza più restrittivo dei default ospitati.

Continua da HIPAA Compliance

Se stai usando Conformità HIPAA per pianificare un rollout live update regolamentato, connettilo a Conformità per i dettagli su privacy e raccolta dati, Ubicazione dati per la configurazione degli endpoint EU, Endpoint statistiche di API per la telemetria self-hosted, e Updater self-hosted per la pianificazione di deployment con licenza.