HIPAA-Compliance

Auf dieser Seite werden die technischen Optionen erläutert, die Teams nutzen, wenn eine HIPAA-Prüfung das Senden von live update Statistiken an Capgo Cloud nicht erlaubt.

Capgo Cloud wird derzeit nicht als HIPAA-konformer, gehosteter Statistik-Prozessor beworben. Viele HIPAA-relevante Apps nutzen weiterhin Capgo, da die Updater-Daten minimal sind, gerätespezifisch bleiben und standardmäßig nicht mit einem bekannten App-Nutzer verknüpft sind. Falls Ihre Unternehmensrichtlinien, Reviewer oder Kundenverträge strengere Kontrollen erfordern, können Sie den Plugin-Traffic geolokalisieren, den Statistics-Endpoint deaktivieren, den Endpoint selbst hosten oder auf ein lizenziertes Self-Hosting-Setup umsteigen.

Hinweis

Diese Seite dient als Implementierungshilfe, nicht als Rechtsberatung. Ihr Compliance-Verantwortlicher entscheidet, ob Capgo Cloud, eine reduzierte Telemetrie-Konfiguration oder Self-Hosting für Ihre HIPAA-Prüfung geeignet ist.

Was Capgo standardmäßig erhält

Das Updater-Plugin sendet Betriebsdaten, die für die Bereitstellung und Überwachung von Live Updates benötigt werden. Die Statistics-Payload kann folgende Felder enthalten:

• app_id - Ihre Capacitor App-Identifier
• device_id - eine zufällige, app-spezifische Device-ID, die vom Updater-Plugin generiert wird
• platform - ios, android, oder electron
• version_name - die installierte Web-Bundle-Version
• version_build - den Namen 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-Lifecycle-Event, wie z. B. install, download, failure, rollback oder app-ready Events
• is_emulator und is_prod - Umgebung-Flags, sofern verfügbar
• custom_id - nur wenn deine App dies explizit mit setzt CapacitorUpdater.setCustomId(...)
• IP-Adresse – wird auf Transport-Ebene für regionales Routing, Missbrauchsprävention und CDN-Optimierung genutzt

Standardmäßig sind diese Daten für den App-Nutzer anonym. Capgo erhält vom Updater keine Namen, E-Mails, Account-IDs, Krankenaktennummern, Anmeldedaten, Nutzerinhalte, App-Analytics-Events oder Verhaltensanalysen. Der einzige stabile Identifier ist der zufällige, app-spezifische device_id, der keine Werbe-ID ist und nicht mit einem bekannten Nutzer verknüpft ist, es sei denn, du setzt 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

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

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 Teile 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.

Datenstandort

Option 2: Statistics-Endpoint deaktivieren

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.

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.

Verlust von:

• 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

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;

Dein Endpoint sollte das Payload der Updater-Statistiken akzeptieren und Folgendes zurückgeben:

{ "status": "ok" }

Nutze diesen Pfad, wenn du internes Alerting, Audit-Logs und Incident-Analysen behalten möchtest, ohne Geräte-Update-Statistiken an die Capgo Cloud zu senden.

API Statistik-Endpoint

Option 4: Lizenziertes Self-Hosting

Falls Capgo Cloud, EU-Data-Residency, deaktivierte Statistiken oder ein selbst gehosteter Statistik-Endpoint deine HIPAA-Prüfung immer noch nicht erfüllen, kann Capgo dir beim Wechsel zu einem lizenzierten Self-Hosted-Deployment helfen.

Dies ist die strengste Option, da deine Organisation das Updater-Backend, den Statistik-Endpoint, Logs, Retention, die Infrastruktur und die Netzwerk-Grenzen kontrolliert. Das bedeutet auch, dass du mehr von der operativen Arbeit übernehmen musst, die Capgo Cloud normalerweise für dich erledigt.

Self-hosted Updater

Praktische Checkliste für die Prüfung

Entscheide vor einer HIPAA-Prüfung:

• Ob die Nutzung der gehosteten Capgo Cloud für Update-Checks erlaubt ist
• Ob die Nutzung der gehosteten Capgo Cloud für Statistiken erlaubt ist
• Welche Region der Plugin-Traffic nutzen muss
• Ob custom_id in deiner App deaktiviert ist
• Wer Update-Fehler überwacht, wenn gehostete Statistiken deaktiviert sind
• Ob dein Team eine lizenzierte Self-Hosted-Deployment benötigt

Capgo arbeitet mit Unternehmen zusammen, die eine HIPAA-Compliance-Prüfung durchlaufen, einschließlich US-Unternehmen, die Capgo in HIPAA-konformen Programmen nutzen. Kontaktiere Capgo, falls dein Auditor ein Deployment-Modell, einen Datenfluss oder Lizenzierungspfade benötigt, die strenger als die gehosteten Standardeinstellungen sind.

Weiter zu HIPAA Compliance

Wenn du es nutzt HIPAA-Compliance Um einen regulierten live update Rollout zu planen, verbinde ihn mit Compliance für Details zu Datenschutz und Datenerfassung, Datenstandort für die EU-Endpoint-Konfiguration, API Statistik-Endpoint für selbst gehostete Telemetrie und Self-hosted Updater für die Planung von Lizenz-Deployments.