Vai al contenuto

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 presentato come un elaboratore di statistiche ospitato conforme a HIPAA. Molte app sensibili a HIPAA utilizzano comunque Capgo perché i dati dell'updater sono minimi, specifici per dispositivo e non associati di default a un utente dell'app noto. Se la policy aziendale, il revisore o il contratto con il cliente richiedono un controllo più rigoroso, è possibile geolocalizzare il traffico del plugin, disabilitare l'endpoint delle statistiche, auto-ospitare solo l'endpoint delle statistiche o passare a un setup auto-ospitato con licenza.

Il plugin dell'updater invia dati operativi necessari per consegnare e monitorare le live updates. Il payload delle statistiche può includere questi campi:

  • app_id - l'identificativo della tua 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 installato
  • 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 revisione HIPAA richiede di non raccogliere statistiche di aggiornamento ospitate, imposta statsUrl to an empty string. That fully disables updater statistics reporting to Capgo Cloud while update checks can still use updateUrl e channelUrl se li lasci abilitati.

Per le implementazioni sensibili HIPAA, non chiamare CapacitorUpdater.setCustomId(...).

L'ID personalizzato è incluso nelle statistiche dell'updater quando è configurato. Se lo imposti su un indirizzo email, un ID utente, un ID paziente, un ID dipendente, un ID account o qualsiasi altro valore che si ricolleghi a una persona, stai associando la telemetria dell'updater a dati personali nel contesto della tua app.

Se la tua revisione richiede che la telematica Capgo ospitata resti limitata al dispositivo, lascia custom_id non impostato.

Opzione 1: Geolocalizza il traffico del plugin Capgo Cloud

Sezione intitolata “Opzione 1: Geolocalizza 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 UE:

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 UE insieme. Mescolare plugin.capgo.app e plugin.eu.capgo.app può instradare parte del percorso dei dati dei plugin al di fuori dell'host UE.

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

Opzione 2: Disabilita l'endpoint delle statistiche

Sezione intitolata “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;

Disattiva la segnalazione delle statistiche dal plugin di aggiornamento. I controlli e i download degli aggiornamenti possono comunque usare Capgo Cloud se mantieni il valore predefinito updateUrl e channelUrl.

Dopo aver modificato capacitor.config.ts, sincronizza i progetti nativi e pubblica una nuova build per lo store. Le installazioni esistenti continueranno a utilizzare la configurazione nativa precedente finché non riceveranno quel nuovo binario.

Cosa perdi quando le statistiche sono disabilitate

Sezione intitolata “Cosa perdi quando le statistiche sono disabilitate”

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

Perdi:

  • Visibilità nel dashboard su installazioni riuscite, installazioni fallite, errori di download, rollback ed eventi di app pronta
  • 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

Sezione intitolata “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.

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.

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.

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