HIPAA 준수

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

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

참고

이 페이지는 구현 가이드이며 법적 조언이 아닙니다. Capgo Cloud, 축소된 텔레메트리 구성, 또는 셀프 호스팅 중 무엇이 귀사의 HIPAA 검토에 적합한지는 컴플라이언스 책임자가 결정해야 합니다.

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

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

• app_id - 귀하의 Capacitor 앱 식별자
• device_id - 업데이터 플러그인이 생성한 무작위 앱 범위 디바이스 식별자
• platform - ios, android, 또는 electron
• version_name - 설치된 웹 번들 버전
• version_build - 네이티브 앱 버전 이름
• version_code - Native Build 번호
• version_os - 운영체제(OS) 버전
• plugin_version - 설치된 @capgo/capacitor-updater 버전
• action - 설치, 다운로드, 실패, 롤백 또는 앱 준비 완료와 같은 업데이트 라이프사이클 이벤트
• is_emulator 및 is_prod - 사용 가능한 경우 환경 플래그
• custom_id - 앱에서 다음을 통해 명시적으로 설정한 경우에만 CapacitorUpdater.setCustomId(...)
• IP 주소 - 지역별 라우팅, 어뷰징 방지 및 CDN 최적화를 위한 전송 계층에서 사용됨

기본적으로 이 데이터는 앱 사용자에게 익명으로 처리됩니다. Capgo는 업데이트 과정에서 이름, 이메일, 계정 ID, 의료 기록 번호, 자격 증명, 사용자 콘텐츠, 앱 분석 이벤트 또는 행동 분석 데이터를 수집하지 않습니다. 유일한 고정 식별자는 무작위로 생성되는 앱 범위의 device_id이며, 이는 광고 ID가 아니며 사용자가 직접 설정하지 않는 한 custom_id yourself.

HIPAA 검토 시 호스팅된 업데이트 통계가 전혀 필요하지 않다면, statsUrl 빈 문자열로 설정하세요. 이렇게 하면 Capgo Cloud로의 업데이트 통계 보고가 완전히 비활성화되지만, 업데이트 확인은 여전히 updateUrl 및 channelUrl 설정을 유지할 경우 계속 사용할 수 있습니다.

사용자 정의 ID를 설정하지 마세요

HIPAA 민감 배포의 경우, 다음을 호출하지 마세요 CapacitorUpdater.setCustomId(...).

사용자 정의 ID가 구성되면 업데이트 통계에 포함됩니다. 이 값을 이메일 주소, 사용자 ID, 환자 ID, 직원 ID, 계정 ID 또는 개인을 식별할 수 있는 다른 값으로 설정하면, 업데이트 텔레메트리가 앱 내의 개인 데이터와 연결됩니다.

검토 과정에서 호스팅된 Capgo 텔레메트리가 디바이스 범위 내로 유지되어야 한다면, custom_id unset.

옵션 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: 통계 엔드포인트 비활성화

검토에서 통계를 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 팀으로부터 더 나은 지원 컨텍스트를 제공받을 수 있습니다

자동 업데이트 배포는 여전히 작동하지만, 관측성(observability)이 제한됩니다. 프로덕션 환경에서 통계를 비활성화하기 전에 자체 모니터링 계획을 세우세요.

옵션 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로 전송하지 않고 내부 알림, 감사 로그 및 장애 분석을 유지하려면 이 경로를 사용하세요.

API 통계 엔드포인트

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

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

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

Self-hosted 업데이터

실무 검토 체크리스트

HIPAA 검토 전에 결정하세요:

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

Capgo는 HIPAA 준수 검토를 진행 중인 기업을 지원하며, 여기에는 Capgo을 HIPAA 준수 프로그램에서 사용하는 미국 기업도 포함됩니다. 검토 기관에서 호스팅 기본 설정보다 더 엄격한 배포 모델, 데이터 흐름 또는 라이선스 경로를 요구하는 경우 Capgo로 문의하세요.

HIPAA 준수 다음 단계로 이동

사용 중이라면 HIPAA 준수 규제 대상인 live update 롤아웃을 계획하려면, 다음을 연결하세요: 컴플라이언스 개인정보 보호 및 데이터 수집 상세 정보: 데이터 위치 EU 엔드포인트 설정: API 통계 엔드포인트 셀프 호스팅 텔레메트리: Self-hosted 업데이터 라이선스 배포 계획: