본문 바로가기

HIPAA 준수

이 페이지에서는 HIPAA 검토에서 live update 통계를 Capgo Cloud로 전송하는 것을 허용하지 않을 때 팀이 사용하는 기술 옵션을 설명합니다.

Capgo Cloud는 현재 HIPAA 준수 호스팅 통계 프로세서로 제공되지 않습니다. 많은 HIPAA 민감 앱은 업데이트 데이터가 최소한이며, 디바이스 범위로 제한되고 기본적으로 알려진 앱 사용자와 연결되지 않기 때문에 여전히 Capgo을 사용합니다. 회사 정책, 리뷰어 또는 고객 계약에서 더 엄격한 통제가 필요하면 플러그인 트래픽을 지리적으로 제한하거나, 통계 엔드포인트를 비활성화하거나, 통계 엔드포인트만 셀프 호스팅하거나, 라이선스가 있는 셀프 호스팅 구성으로 전환할 수 있습니다.

Capgo가 기본적으로 수신하는 데이터

섹션 제목: “Capgo이 기본적으로 수신하는 내용”

업데이터 플러그인은 라이브 업데이트를 전달하고 관찰하는 데 필요한 운영 데이터를 전송합니다. 통계 페이로드에는 다음 필드가 포함될 수 있습니다:

  • app_id - Capacitor 앱 식별자
  • device_id - 업데이터 플러그인이 생성한 무작위 앱 범위 디바이스 식별자
  • platform - ios, android, 또는 electron
  • version_name - 설치된 웹 번들 버전
  • version_build - 네이티브 앱 버전 이름
  • 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 사용은 허용하지만 플러그인 데이터에 EU 데이터 레지던시를 요구하는 경우, 세 가지 updater 엔드포인트를 모두 EU 호스트로 설정하세요:

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;

EU URL을 함께 사용하세요. 혼용하면 plugin.capgo.app 및 plugin.eu.capgo.app 플러그인 데이터 경로의 일부가 EU 호스트 외부로 라우팅될 수 있습니다.

이렇게 하면 플러그인 데이터 경로는 유럽에 유지하면서, Capgo에서 호스팅하는 업데이트 모니터링, 통계, 알림 및 트러블슈팅 데이터는 그대로 사용할 수 있습니다.

옵션 2: 통계 엔드포인트 비활성화

섹션 제목: “옵션 2: 통계 엔드포인트 비활성화”

검토에서 통계를 Capgo Cloud로 전송하는 것을 허용하지 않는 경우, statsUrl 을 빈 문자열로 설정하세요:

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;

이 설정은 updater 플러그인의 통계 보고를 비활성화합니다. 기본값을 유지하면 업데이트 확인과 다운로드는 계속 Capgo Cloud를 사용할 수 있습니다. updateUrl 및 channelUrl.

변경 후 capacitor.config.ts, 네이티브 프로젝트를 동기화하고 새 스토어 빌드를 배포하세요. 기존 설치본은 새 바이너리를 받기 전까지 이전 네이티브 설정을 계속 사용합니다.

통계를 비활성화하면 잃는 것

“통계를 비활성화하면 잃는 것” 섹션

비활성화하면 statsUrl 업데이트가 제공되거나 다운로드된 뒤 앱 안에서 무슨 일이 있었는지 설명하는 데 Capgo가 사용하는 호스팅 시그널이 제거됩니다.

잃게 되는 것:

  • Dashboard에서 설치 성공, 설치 실패, 다운로드 실패, 롤백, app-ready 이벤트에 대한 가시성
  • 호스팅된 통계에 의존하는 장애 알림
  • 업데이트 이슈에 영향을 받는 앱 버전, OS 버전, 플랫폼 또는 플러그인 버전을 빠르게 식별하는 기능
  • Capgo Cloud의 디바이스 수준 트러블슈팅 트레일
  • Capgo 대시보드에서 집계된 업데이트 채택률 및 앱 사용 통계
  • 호스팅 서비스가 디바이스 측 업데이트 경로를 설명하는 이벤트를 더 이상 수신하지 않으므로 Capgo 팀으로부터 더 나은 지원 컨텍스트를 제공받기 어려움

자동 업데이트 배포는 계속 작동할 수 있지만, 가시성이 낮아진 상태로 운영됩니다. 프로덕션에서 통계를 비활성화하기 전에 자체 모니터링을 계획하세요.

옵션 3: 통계 엔드포인트 셀프 호스팅

“옵션 3: 통계 엔드포인트 셀프 호스팅” 섹션

리뷰에서 Capgo Cloud를 통한 업데이트 체크는 허용하되 통계를 인프라 내부에 유지해야 하는 경우, 다음을 statsUrl 자체 엔드포인트로 지정하세요:

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;

엔드포인트는 업데이터 통계 페이로드를 수신하고 다음을 반환해야 합니다:

{ "status": "ok" }

기기 업데이트 통계를 Capgo Cloud로 전송하지 않고 내부 알림, 감사 로그 및 장애 분석을 유지하려면 이 경로를 사용하세요.

옵션 4: 라이선스 기반 셀프 호스팅

“옵션 4: 라이선스 기반 셀프 호스팅” 섹션

Capgo Cloud, EU 데이터 레지던시, 통계 비활성화 또는 셀프 호스팅 통계 엔드포인트로도 HIPAA 검토를 여전히 충족하지 못한다면, Capgo에서 라이선스 기반 셀프 호스팅 배포로 전환하도록 도와드릴 수 있습니다.

조직에서 업데이터 백엔드, 통계 엔드포인트, 로그, 보존, 인프라 및 네트워크 경계를 직접 제어하므로 가장 엄격한 옵션입니다. 또한 Capgo Cloud가 일반적으로 처리하던 운영 작업을 더 많이 직접 책임져야 합니다.

실무 검토 체크리스트

“실무 검토 체크리스트” 섹션

HIPAA 검토 전에 결정하세요:

  • 업데이트 확인에 호스팅된 Capgo Cloud를 허용할지 여부
  • 통계 수집에 호스팅된 Capgo Cloud를 허용할지 여부
  • 플러그인 트래픽이 사용해야 하는 리전
  • 여부 custom_id 앱에서 비활성화되어 있는지
  • 호스팅 통계가 비활성화된 경우 업데이트 실패를 모니터링하는 주체
  • 팀에 라이선스가 있는 셀프 호스팅 배포가 필요한지 여부

Capgo는 HIPAA 컴플라이언스 리뷰를 진행하는 기업과 함께하며, HIPAA 준수 프로그램에서 Capgo을 사용하는 미국 기업도 포함됩니다. 검토자가 호스팅 기본값보다 엄격한 배포 모델, 데이터 흐름, 라이선스 경로를 필요로 한다면 Capgo에 문의하세요.

사용 중이라면 HIPAA 준수 규제 대상 live update 배포를 계획하려면, 다음과 연결하세요: 컴플라이언스 개인정보 및 데이터 수집 세부 사항은 데이터 위치 EU 엔드포인트 구성은 API 통계 엔드포인트 자체 호스팅 텔레메트리는 Self-hosted 업데이터 라이선스 배포 계획은