Saltar al contenido

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 conforme a HIPAA. Muchas apps sensibles a HIPAA siguen usando Capgo porque los datos del actualizador son mínimos, acotados al dispositivo y, por defecto, no están vinculados a un usuario conocido de la app. Si la política de tu empresa, el revisor o el contrato con el cliente exigen un control más estricto, puedes geolocalizar el tráfico del plugin, deshabilitar el endpoint de estadísticas, autoalojar solo el endpoint de estadísticas o pasar a una configuración autoalojada con licencia.

El plugin de updater envía datos operativos necesarios para entregar y observar las actualizaciones en vivo. El payload de estadísticas puede incluir estos campos:

  • app_id - el identificador de tu app de Capacitor
  • device_id - un identificador de dispositivo aleatorio y acotado a la app, generado por el plugin de actualizaciones
  • platform - ios, android, o electron
  • version_name - la versión del web bundle instalado
  • version_build - el nombre de la versión de la app nativa
  • version_code - el número de build nativo
  • version_os - la versión del sistema operativo
  • plugin_version - lo instalado @capgo/capacitor-updater versión
  • action - el evento del ciclo de vida de la actualización, como install, download, failure, rollback o app-ready
  • is_emulator y is_prod - los 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 de la app. Capgo no recibe nombres, emails, IDs de cuenta, números de historial médico, credenciales, contenido del usuario, eventos de analytics de la app ni analytics de comportamiento del updater. El único identificador estable es el aleatorio, con alcance de app, device_id, que 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.

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

Sección titulada “Opción 1: Geolocalizar el tráfico del plugin Capgo Cloud”

Si tu revisión permite Capgo Cloud pero exige residencia de datos en la UE para los datos de plugins, configura los tres endpoints del updater en el 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;

Use las URLs de la UE en conjunto. Mezclarlas plugin.capgo.app y plugin.eu.capgo.app puede enrutar parte de la ruta de datos del plugin fuera del host de la UE.

Esto mantiene disponibles el monitoreo de actualizaciones, las estadísticas, las alertas y los datos de resolución de problemas alojados por Capgo, mientras sitúa la ruta de datos del plugin en Europa.

Si su revisión no permite enviar estadísticas a Capgo Cloud, establezca statsUrl en 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.

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 fallo que dependen de estadísticas alojadas
  • La capacidad de identificar rápidamente qué versiones de la app, del sistema operativo, plataformas o de plugins se ven afectadas por un problema de actualización
  • Rastros de solución de problemas a nivel de dispositivo en Capgo Cloud
  • Agrega estadísticas de adopción de actualizaciones y uso de la app 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 la ruta de actualización en el dispositivo

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

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

Sección titulada “Opción 3: Autoalojar el endpoint de estadísticas”

Si tu revisión permite comprobar actualizaciones a través de Capgo Cloud pero requiere que las estadísticas permanezcan dentro de 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.

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.

Antes de una revisión de HIPAA, decide:

  • Si se permite que Capgo Cloud alojado realice comprobaciones de actualizaciones
  • Si se permite que Capgo Cloud alojado recopile estadísticas
  • Región que debe usar el tráfico del plugin
  • Si custom_id está deshabilitado en tu app
  • Quién supervisa los fallos de actualización si las estadísticas alojadas están deshabilitadas
  • Si tu equipo necesita una implementación self-hosted con licencia

Capgo funciona con empresas que pasan por una revisión de cumplimiento HIPAA, incluidas las empresas en EE. UU. que usan Capgo en programas compatibles con HIPAA. Contacta con Capgo si tu revisor necesita un modelo de implementación, flujo de datos o ruta de licenciamiento más estricto que los valores predeterminados alojados.

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