Cumplimiento HIPAA

Esta página explica las opciones técnicas que usan los equipos cuando una revisión de HIPAA no permite enviar estadísticas de live update a Capgo Cloud.

Capgo Cloud no se presenta actualmente como un procesador de estadísticas alojado con cumplimiento HIPAA. Muchas apps con datos sensibles de HIPAA siguen usando Capgo porque los datos del updater son mínimos, se limitan al dispositivo y no están vinculados a un usuario de la app por defecto. Si la política de tu empresa, un revisor o un contrato con clientes exige un control más estricto, puedes geolocalizar el tráfico del plugin, desactivar el endpoint de estadísticas, auto-alojar solo el endpoint de estadísticas o pasar a una configuración self-hosted con licencia.

Nota

Esta página es una guía de implementación, no asesoría legal. Tu responsable de cumplimiento decidirá si Capgo Cloud, una configuración de telemetría reducida o el self-hosting se ajustan a tu revisión de HIPAA.

Lo que Capgo recibe por defecto

El plugin updater envía los datos operativos necesarios para entregar y observar los Live Update. El payload de estadísticas puede incluir estos campos:

• app_id - tu identificador de app de Capacitor
• device_id - un identificador de dispositivo aleatorio y exclusivo de la app, generado por el plugin de updater
• platform - ios, android, o electron
• version_name - la versión del web bundle instalada
• version_build - el nombre de la versión de la app nativa
• version_code - el número de Native Build
• version_os - la versión del sistema operativo
• plugin_version - la versión @capgo/capacitor-updater instalada
• action - el evento del ciclo de vida de la Live Update, como install, download, failure, rollback o app-ready
• is_emulator y is_prod - flags de entorno cuando estén disponibles
• custom_id - solo si tu app lo establece explícitamente con CapacitorUpdater.setCustomId(...)
• Dirección IP: se usa a nivel de transporte para enrutamiento regional, prevención de abusos y optimización de CDN

Por defecto, estos datos son anónimos para el usuario. Capgo no recibe nombres, emails, IDs de cuenta, números de historial médico, credenciales, contenido del usuario, eventos de analytics de la app o analytics de comportamiento del updater. El único identificador estable es el aleatorio, con scope de la app, device_idel cual no es un ID de publicidad y no está vinculado a un usuario conocido a menos que configures custom_id tú mismo.

Si tu revisión de HIPAA exige que no haya estadísticas de actualizaciones alojadas, establece statsUrl como una cadena vacía. Esto desactiva por completo el reporte de estadísticas del updater a Capgo Cloud, aunque las comprobaciones de actualización pueden seguir usando updateUrl y channelUrl si las dejas habilitadas.

No configures un ID personalizado

Para despliegues con sensibilidad HIPAA, no llames a CapacitorUpdater.setCustomId(...).

El ID personalizado se incluye en las estadísticas del updater cuando está configurado. Si lo estableces con un email, un ID de usuario, un ID de paciente, un ID de empleado, un ID de cuenta o cualquier otro valor que se corresponda con una persona, estarás vinculando la telemetría del updater a datos personales en el contexto de tu propia app.

Si su revisión requiere que la telemetría de Capgo se mantenga limitada al dispositivo, deje custom_id unset.

Opción 1: Geolocalizar el tráfico del plugin Capgo Cloud

Si tu revisión permite Capgo Cloud pero requiere residencia de datos en la UE para los datos de los plugins, configura los tres endpoints del updater al host de la 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 las URLs de la UE juntas. Mezclarlas plugin.capgo.app y plugin.eu.capgo.app puede desviar parte de la ruta de datos del plugin fuera del host de la UE.

Esto mantiene disponibles el monitoreo de actualizaciones, estadísticas, alertas y datos de troubleshooting de Capgo, mientras ubica la ruta de datos del plugin en Europa.

Ubicación de datos

Opción 2: Desactivar el endpoint de estadísticas

Si tu revisión no permite enviar estadísticas a Capgo Cloud, establece statsUrl como una cadena vacía:

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;

Esto desactiva el envío de estadísticas del plugin de actualización. Las comprobaciones y descargas de Capgo seguirán usando Cloud si mantienes la configuración por defecto. updateUrl y channelUrl.

Después de cambiar capacitor.config.ts, sincroniza los proyectos nativos y publica un nuevo build en la tienda. Las instalaciones existentes seguirán usando su configuración nativa anterior hasta que reciban ese nuevo binario.

Qué pierdes al desactivar las estadísticas

Desactivar esto statsUrl elimina la señal alojada que Capgo usa para explicar qué ocurrió dentro de tu app tras ofrecer o descargar una actualización.

Pierdes:

• Visibilidad en el dashboard de instalaciones exitosas, fallidas, errores de descarga, rollbacks y eventos de app-ready
• Alertas de error que dependen de estadísticas alojadas
• La capacidad de identificar rápidamente qué versiones de app, OS, plataformas o plugins se ven afectados por un problema de actualización
• Trazas de troubleshooting a nivel de dispositivo en Capgo Cloud
• Agrega estadísticas de adopción de Capgo y uso de apps en el dashboard de Capgo
• Mejor contexto de soporte del equipo de Capgo, ya que el servicio alojado ya no recibe los eventos que explican el flujo de actualización en el dispositivo

La entrega automática de actualizaciones puede seguir funcionando, pero operarás con menor observabilidad. Planifica tu propio monitoreo antes de desactivar las estadísticas en producción.

Opción 3: Autoalojar el endpoint de estadísticas

Si tu revisión permite comprobaciones de actualización mediante Capgo Cloud pero requiere que las estadísticas permanezcan en tu infraestructura, apunta statsUrl a tu propio 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;

Tu endpoint debe aceptar el payload de estadísticas del updater y devolver:

{ "status": "ok" }

Usa esta ruta si quieres mantener las alertas internas, los logs de auditoría y el análisis de incidentes sin enviar las estadísticas de actualización de dispositivos a Capgo Cloud.

Endpoint de estadísticas API

Opción 4: Self-hosting con licencia

Si Capgo Cloud, la residencia de datos en la UE, las estadísticas desactivadas o un endpoint de estadísticas self-hosted sigue sin satisfacer tu revisión de HIPAA, Capgo puede ayudarte a pasar a un despliegue self-hosted con licencia.

Esta es la opción más estricta porque tu organización controla el backend del updater, el endpoint de estadísticas, los logs, la retención, la infraestructura y el perímetro de red. También implica que debes asumir más trabajo operativo del que Capgo Cloud suele gestionar por ti.

Updater autoalojado

Checklist de revisión práctica

Antes de una revisión de HIPAA, decide:

• Si se permite Capgo Cloud para las comprobaciones de actualizaciones
• Si se permite Capgo Cloud para estadísticas
• La región que debe usar el tráfico del plugin
• Si custom_id está desactivado en tu app
• Quién monitoriza los fallos de actualización si las estadísticas alojadas están desactivadas
• Si tu equipo necesita un despliegue self-hosted con licencia

Capgo funciona con empresas en procesos de revisión de cumplimiento HIPAA, incluyendo empresas en EE. UU. que usan Capgo en programas compatibles con HIPAA. Contacta con Capgo si tu auditor requiere un modelo de despliegue, flujo de datos o esquema de licencias más estricto que los valores predeterminados de la versión alojada.

Continuar desde HIPAA Compliance

Si estás usando Cumplimiento HIPAA para planificar un despliegue regulado de live update, conéctalo con Cumplimiento para detalles de privacidad y recolección de datos, Ubicación de datos para la configuración de endpoints en la UE, Endpoint de estadísticas API para telemetría self-hosted, y Updater autoalojado for licensed deployment planning.