HIPAA 合规
复制包含安装步骤和该插件完整 Markdown 指南的配置 prompt。
本文介绍当 HIPAA 审核不允许将 live update 统计数据发送到 Capgo Cloud 时,团队可采用的技术方案。
Capgo Cloud 目前并未作为符合 HIPAA 的托管统计数据处理器提供。许多涉及 HIPAA 敏感数据的应用仍在使用 Capgo,因为更新器数据很少、按设备范围划分,且默认不与已知的应用用户关联。如果您的公司政策、审核人员或客户合同要求更严格的控制,您可以按地域限制插件流量、禁用统计端点、仅自托管统计端点,或迁移到获得许可的自托管方案。
Capgo 默认接收的内容
章节标题:“Capgo 默认接收的内容”更新器插件会发送交付和监控 Live Updates 所需的运行数据。统计数据负载可能包含以下字段:
app_id- 您的 Capacitor 应用标识符device_id- 由更新器插件生成的随机、按应用划分的设备标识符platform-ios,android,或electronversion_name- 已安装的 web bundle 版本version_build- 原生 App 的版本名称version_code- 原生构建版本号version_os- 操作系统版本plugin_version- 已安装的@capgo/capacitor-updater版本action- 更新生命周期事件,例如 install、download、failure、rollback 或 app-ready 事件is_emulator以及is_prod- 环境标志(如有)custom_id- 仅当你的应用通过以下方式显式设置它时CapacitorUpdater.setCustomId(...)- IP 地址 - 用于传输层的区域路由、滥用防护和 CDN 优化
默认情况下,这些数据对应用用户是匿名的。Capgo 不会从更新器接收姓名、电子邮件、账号 ID、病历号、凭据、用户内容、应用分析事件或行为分析数据。唯一的稳定标识符是随机的、应用级的 device_id,它不是广告 ID,也不会与已知用户关联,除非你自行设置 custom_id 。
如果您的 HIPAA 审查完全不需要托管更新统计数据,请将 statsUrl 设置为空字符串。这将完全禁用向 Capgo Cloud 报告更新器统计数据,同时更新检查仍可使用 updateUrl 以及 channelUrl (如果您保持其启用状态)。
请勿设置自定义 ID
标题为“不要设置自定义 ID”的章节对于 HIPAA 敏感部署,请勿调用 CapacitorUpdater.setCustomId(...).
配置后,自定义 ID 会包含在更新器统计数据中。如果您将其设置为电子邮件地址、用户 ID、患者 ID、员工 ID、账户 ID 或任何其他可映射到个人的值,您就在自己的应用上下文中将更新器遥测数据与个人数据关联了起来。
如果您的审查要求托管 Capgo 遥测数据保持设备范围,请保持 custom_id 未设置。
方案 1:按地理位置本地化 Capgo Cloud 插件流量
标题为“选项 1:地理定位 Capgo Cloud 插件流量”的章节如果您的审核允许使用 Capgo Cloud,但要求插件数据驻留在欧盟,请将所有三个更新器端点配置为欧盟主机:
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;请一起使用欧盟 URL。混合使用 plugin.capgo.app 以及 plugin.eu.capgo.app 可能会将部分插件数据路径路由到欧盟主机之外。
这可以保留 Capgo 的托管更新监控、统计、警报和故障排除数据,同时将插件数据路径置于欧洲。
方案 2:禁用统计端点
标题为“选项 2:禁用统计端点”的章节如果您的审核不允许将统计信息发送到 Capgo Cloud,请设置 statsUrl 为空字符串:
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;这会禁用 updater 插件的统计上报。如果保留默认设置,更新检查和下载仍可使用 Capgo Cloud updateUrl 以及 channelUrl.
更改后 capacitor.config.ts,请同步原生项目并发布新的商店构建。现有安装会继续使用之前的原生配置,直到收到新的二进制文件。
禁用统计后会失去什么
标题为“禁用统计后会失去什么”的章节禁用 statsUrl 会移除 Capgo 用来解释更新推送或下载后应用内发生了什么所依赖的托管信号。
您将失去:
- 在 Dashboard 中查看成功安装、安装失败、下载失败、回滚以及应用就绪事件的能力
- 依赖托管统计数据的故障警报
- 快速识别受更新问题影响的 App 版本、操作系统版本、平台或插件版本的能力
- Capgo Cloud 中的设备级故障排查轨迹
- Capgo dashboard 中的更新采用率和 App 使用统计数据
- 来自 Capgo 团队的支持上下文更完善,因为托管服务不再接收解释设备端更新路径的事件
自动更新分发仍可正常工作,但您是在可观测性降低的情况下运行。请在生产环境中禁用统计功能之前规划好自定义监控。
方案 3:自托管统计端点
标题为“选项 3:自托管统计端点”的章节如果您的审查允许通过 Capgo Cloud 进行更新检查,但要求统计数据保留在您的基础设施内,请将 statsUrl 指向您自己的端点:
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;您的端点应接受更新器统计负载并返回:
{ "status": "ok" }如果您希望保留内部告警、审计日志和事件分析,而不向 Capgo Cloud 发送设备更新统计,请使用此路径。
方案 4:授权自托管
标题为“选项 4:许可自托管”的章节如果 Capgo Cloud、欧盟数据驻留、禁用统计或自托管统计端点仍无法满足您的 HIPAA 审查,Capgo 可以帮助您迁移到许可自托管部署。
这是最严格的选项,因为您的组织控制更新器后端、统计端点、日志、保留策略、基础设施和网络边界。这也意味着您必须承担更多通常由 Capgo Cloud 为您处理的工作。
实用审查清单
“实用审查清单”部分在 HIPAA 审查之前,请确定:
- 是否允许使用托管 Capgo Cloud 进行更新检查
- 是否允许使用托管 Capgo Cloud 进行数据统计
- 插件流量必须使用的区域
- 是否
custom_id在您的应用中已禁用 - 如果禁用了托管统计功能,由谁负责监控更新失败
- 您的团队是否需要获得许可的自托管部署
Capgo 与正在接受 HIPAA 合规审查的公司合作,包括在美国境内、在 HIPAA 合规项目中使用 Capgo 的公司。如果您的审核人员需要比托管默认配置更严格的部署模式、数据流或许可路径,请联系 Capgo。
继续探索 HIPAA 合规性
标题为“从 HIPAA 合规继续”的部分如果你正在使用 HIPAA 合规 要规划受监管的 live update 发布,请结合 合规性 了解隐私与数据收集详情, 数据位置 了解 EU 端点配置, API 统计端点 了解自托管遥测,以及 自托管更新器 用于授权部署规划。