HIPAA-Compliance
Kopiere einen Setup-Prompt mit den Installationsschritten und dem vollständigen Markdown-Guide für dieses Plugin.
Diese Seite erklärt die technischen Optionen, die Teams nutzen, wenn eine HIPAA-Prüfung das Senden von live update-Statistiken an Capgo Cloud nicht zulässt.
Capgo Cloud wird derzeit nicht als HIPAA-konformer, gehosteter Statistik-Processor beworben. Viele HIPAA-sensible Apps nutzen dennoch Capgo, da die Updater-Daten minimal sind, gerätebezogen und standardmäßig nicht mit einem bekannten App-Nutzer verknüpft werden. Wenn Ihre Unternehmensrichtlinie, Ihr Prüfer oder ein Kundenvertrag strengere Kontrolle erfordert, können Sie den Plugin-Traffic geolokalisieren, den Statistik-Endpoint deaktivieren, nur den Statistik-Endpoint selbst hosten oder auf eine lizenzierte Self-Hosting-Lösung umsteigen.
Was Capgo standardmäßig empfängt
Abschnitt mit dem Titel „Was Capgo standardmäßig empfängt“Das Updater-Plugin sendet Betriebsdaten, die für die Bereitstellung und Überwachung von Live Updates erforderlich sind. Die Statistik-Payload kann diese Felder enthalten:
app_id- Ihre Capacitor-App-Kennungdevice_id- eine zufällige, app-spezifische Geräte-Kennung, die vom Updater-Plugin generiert wirdplatform-ios,android, oderelectronversion_name- die installierte Web-Bundle-Versionversion_build- der Name der nativen App-Versionversion_code- die native Build-Nummerversion_os- die Betriebssystemversionplugin_version- die installierte@capgo/capacitor-updaterVersionaction- das Update-Lebenszyklusereignis, z. B. install, download, failure, rollback oder app-readyis_emulatorundis_prod- Umgebungsflags, sofern verfügbarcustom_id- nur, wenn Ihre App es explizit mit setztCapacitorUpdater.setCustomId(...)- IP-Adresse – wird auf Transportebene für regionale Routing, Missbrauchsschutz und CDN-Optimierung verwendet
Standardmäßig sind diese Daten für den App-Nutzer anonym. Capgo erhält keine Namen, E-Mails, Konten-IDs, Patientenaktennummern, Zugangsdaten, Nutzerinhalte, App-Analytics-Events oder Verhaltensanalysen vom Updater. Die einzige stabile Kennung ist die zufällige, app-spezifische device_id, die keine Werbe-ID ist und nicht mit einem bekannten Nutzer verknüpft wird, es sei denn, Sie setzen custom_id selbst.
Falls Ihre HIPAA-Prüfung überhaupt keine gehosteten Update-Statistiken zulässt, setzen Sie statsUrl auf einen leeren String. Das deaktiviert die Übermittlung von Updater-Statistiken an Capgo Cloud vollständig, während Update-Checks weiterhin updateUrl und channelUrl nutzen können, wenn Sie sie aktiviert lassen.
Legen Sie keine benutzerdefinierte ID fest
Abschnitt „Legen Sie keine benutzerdefinierte ID fest“Verwenden Sie bei HIPAA-sensiblen Deployments nicht CapacitorUpdater.setCustomId(...).
Die benutzerdefinierte ID wird in den Updater-Statistiken übermittelt, wenn sie konfiguriert ist. Wenn Sie sie auf eine E-Mail-Adresse, User-ID, Patienten-ID, Mitarbeiter-ID, Account-ID oder einen anderen Wert setzen, der sich einer Person zuordnen lässt, verknüpfen Sie die Updater-Telemetrie mit personenbezogenen Daten in Ihrem App-Kontext.
Falls Ihre Prüfung erfordert, dass die gehostete Capgo Telemetrie gerätebezogen bleibt, lassen Sie custom_id nicht gesetzt.
Option 1: Plugin-Traffic von Capgo Cloud geolokalisieren
Abschnitt „Option 1: Plugin-Traffic von Capgo Cloud geolokalisieren“Wenn Ihre Prüfung Capgo Cloud erlaubt, aber eine EU-Datenresidenz für Plugin-Daten erfordert, konfigurieren Sie alle drei Updater-Endpoints auf den EU-Host:
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;Verwenden Sie die EU-URLs gemeinsam. Eine Mischung plugin.capgo.app und plugin.eu.capgo.app kann einen Teil des Plugin-Datenpfads außerhalb des EU-Hosts routen.
Dadurch bleiben das gehostete Update-Monitoring, die Statistiken, Alerts und Troubleshooting-Daten von Capgo verfügbar, während der Plugin-Datenpfad in Europa liegt.
Option 2: Statistics-Endpoint deaktivieren
Abschnitt mit dem Titel „Option 2: Statistics-Endpoint deaktivieren“Wenn Ihr Review das Senden von Statistiken an Capgo Cloud nicht erlaubt, setzen Sie statsUrl auf einen leeren String:
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;Dies deaktiviert das Senden von Statistiken durch das Updater-Plugin. Update-Checks und Downloads können weiterhin Capgo Cloud nutzen, wenn Sie die Standardeinstellung beibehalten updateUrl und channelUrl.
Nach dem Ändern capacitor.config.ts, synchronisieren Sie die nativen Projekte und veröffentlichen Sie einen neuen Store-Build. Bestehende Installationen nutzen weiterhin ihre bisherige native Konfiguration, bis sie das neue Binary erhalten.
Was entfällt, wenn Statistiken deaktiviert sind
Abschnitt mit dem Titel „Was entfällt, wenn Statistiken deaktiviert sind“Das Deaktivieren statsUrl entfernt das gehostete Signal, das Capgo nutzt, um zu erklären, was nach einem angebotenen oder heruntergeladenen Update in Ihrer App passiert ist.
Das verlierst du:
- Dashboard-Einblick in erfolgreiche Installs, fehlgeschlagene Installs, Download-Fehler, Rollbacks und App-ready-Events
- Fehler-Alerts, die auf gehosteten Statistiken basieren
- Die Möglichkeit, schnell zu erkennen, welche App-, OS-, Plattform- oder Plugin-Versionen von einem Update-Problem betroffen sind
- Troubleshooting-Spuren auf Geräteebene in der Capgo Cloud
- Aggregierte Statistiken zur Update-Adoption und App-Nutzung im Capgo Dashboard
- Besserer Support-Kontext vom Capgo Team, da der gehostete Service keine Events mehr empfängt, die den Update-Pfad auf dem Gerät erklären
Die automatische Update-Bereitstellung funktioniert weiterhin, aber die Observability ist eingeschränkt. Plane dein eigenes Monitoring, bevor du Statistiken in der Produktion deaktivierst.
Option 3: Statistik-Endpoint selbst hosten
Abschnitt mit dem Titel „Option 3: Statistik-Endpoint selbst hosten“Wenn dein Review Update-Checks über die Capgo Cloud erlaubt, aber die Statistiken in deiner Infrastruktur bleiben müssen, verweise statsUrl auf deinen eigenen 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;Ihr Endpoint sollte das Updater-Statistik-Payload akzeptieren und zurückgeben:
{ "status": "ok" }Verwenden Sie diesen Pfad, wenn Sie interne Alarmierung, Audit-Logs und Incident-Analysen beibehalten möchten, ohne Geräte-Update-Statistiken an Capgo Cloud zu senden.
Option 4: Lizenziertes Self-Hosting
Abschnitt mit dem Titel „Option 4: Lizenziertes Self-Hosting“Falls Capgo Cloud, EU-Datenresidenz, deaktivierte Statistiken oder ein selbst gehosteter Statistik-Endpoint Ihre HIPAA-Prüfung nicht erfüllen, kann Capgo Ihnen helfen, auf eine lizenzierte Self-Hosted-Deployment umzusteigen.
Dies ist die strengste Option, da Ihre Organisation den Updater-Backend, den Statistik-Endpoint, Logs, Retention, Infrastruktur und Netzwerk-Grenzen kontrolliert. Das bedeutet auch, dass Sie mehr der operativen Arbeit übernehmen müssen, die Capgo Cloud normalerweise für Sie erledigt.
Praktische Review-Checkliste
Abschnitt mit dem Titel „Praktische Prüfungsliste“Bevor eine HIPAA-Prüfung stattfindet, entscheiden Sie:
- Ob gehostetes Capgo Cloud für Update-Checks erlaubt ist
- Ob gehostetes Capgo Cloud für Statistiken erlaubt ist
- Welche Region der Plugin-Verkehr verwenden muss
- Ob
custom_idin Ihrer App deaktiviert ist - Wer Update-Fehler überwacht, wenn gehostete Statistiken deaktiviert sind
- Ob Ihr Team eine lizenzierte Self-Hosted-Deployment benötigt
Capgo arbeitet mit Unternehmen zusammen, die eine HIPAA-Compliance-Prüfung durchlaufen, einschließlich Unternehmen in den USA, die Capgo in HIPAA-konformen Programmen einsetzen. Wenden Sie sich an Capgo, wenn Ihr Prüfer ein Deployment-Modell, einen Datenfluss oder einen Lizenzweg benötigt, der strenger ist als die gehosteten Standardwerte.
Weiter mit HIPAA Compliance
Abschnitt mit dem Titel „Weiter von HIPAA Compliance“Wenn du es nutzt HIPAA-Compliance um einen regulierten live update-Rollout zu planen, verknüpfen Sie ihn mit Konformität für Details zu Datenschutz und Datenerfassung, Datenstandort für die Konfiguration von EU-Endpunkten, API Statistik-Endpoint für selbst gehostete Telemetrie und Selbst gehosteter Updater für die Planung lizenzierter Deployments.