Zum Inhalt springen

HIPAA-Compliance

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.

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-Kennung
  • device_id - eine zufällige, app-spezifische Geräte-Kennung, die vom Updater-Plugin generiert wird
  • platform - ios, android, oder electron
  • version_name - die installierte Web-Bundle-Version
  • version_build - der Name der nativen App-Version
  • version_code - die native Build-Nummer
  • version_os - die Betriebssystemversion
  • plugin_version - die installierte @capgo/capacitor-updater Version
  • action - das Update-Lebenszyklusereignis, z. B. install, download, failure, rollback oder app-ready
  • is_emulator und is_prod - Umgebungsflags, sofern verfügbar
  • custom_id - nur, wenn Ihre App es explizit mit setzt CapacitorUpdater.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:

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;

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.

Wenn Ihr Review das Senden von Statistiken an Capgo Cloud nicht erlaubt, setzen Sie statsUrl auf einen leeren String:

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;

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.

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.

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:

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;

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.

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.

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_id in 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.

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.