HIPAA準拠
インストール手順と、このプラグインの完全なMarkdownガイドを含むセットアッププロンプトをコピーします。
このページでは、HIPAAレビューでlive updateの統計情報をCapgo Cloudに送信できない場合に、チームが採用する技術的な選択肢について説明します。
Capgo Cloudは、現在、HIPAA準拠のホスト型統計処理サービスとして提供されていません。多くのHIPAA対応アプリでは、更新プログラムのデータが最小限であり、デバイス単位でスコープが限定され、デフォルトでは既知のアプリユーザーに紐付けられないため、Capgoを使用しています。会社のポリシー、レビュー担当者、または顧客契約によりより厳格な管理が求められる場合は、プラグインのトラフィックを地理的にローカライズしたり、統計エンドポイントを無効にしたり、統計エンドポイントのみをセルフホストしたり、ライセンス付きのセルフホスト環境に移行したりできます。
デフォルトで Capgo が受け取るデータ
セクション「Capgoがデフォルトで受信する情報」更新プログラムプラグインは、ライブアップデートの配信と監視に必要な運用データを送信します。統計ペイロードには、以下のフィールドが含まれる場合があります:
app_id- あなたのCapacitorアプリ識別子device_id- 更新プログラムプラグインによって生成される、ランダムなアプリスコープのデバイス識別子platform-ios,android、またはelectronversion_name- インストールされた Web バンドルのバージョンversion_build- ネイティブアプリのバージョン名version_code- ネイティブビルド番号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 設定した場合を除きます。
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 データレジデンスが求められる場合、3 つのアップデータエンドポイントをすべて EU ホストに設定してください:
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 を空文字列に設定します:
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;これにより、アップデータプラグインからの統計レポートが無効になります。デフォルトを維持している場合、アップデートの確認とダウンロードは引き続き Capgo Cloud を利用できます。 updateUrl と channelUrl.
を変更した後 capacitor.config.ts、ネイティブプロジェクトを同期し、新しいストアビルドをリリースしてください。既存のインストールは、その新しいバイナリを受信するまで、以前のネイティブ設定を继续使用します。
統計を無効にすると失われるもの
「統計が無効になると失われるもの」セクション無効化 statsUrl は、更新が提供またはダウンロードされた後にアプリ内で何が起きたかを説明するために Capgo が使用するホストされたシグナルを削除します。
失われるもの:
- インストール成功、失敗、ダウンロード失敗、ロールバック、アプリ準備完了イベントのダッシュボード可視性
- ホストされた統計に依存する障害アラート
- アップデートの問題がどのアプリバージョン、OSバージョン、プラットフォーム、またはプラグインバージョンに影響しているかを素早く特定する機能
- Capgo Cloud でのデバイスレベルのトラブルシューティング履歴
- Capgo ダッシュボードでの集計されたアップデート採用率とアプリ使用統計
- 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、EUデータレジデンス、統計無効化、セルフホスト統計エンドポイントのいずれもHIPAAレビューを満たさない場合、Capgoがライセンス付きセルフホストデプロイへの移行を支援します。
組織がアップデータバックエンド、統計エンドポイント、ログ、保持期間、インフラ、ネットワーク境界を管理するため、最も厳格なオプションです。ただし、通常Capgo Cloudが代行する運用作業の多くを自社で担う必要があります。
実践的なレビュー用チェックリスト
「実務的なレビューチェックリスト」セクションHIPAAレビューの前に、以下を決定してください:
- ホスト型 Capgo Cloud を更新チェックに使用できるかどうか
- ホスト型 Capgo Cloud を統計に使用できるかどうか
- プラグインのトラフィックが使用するリージョン
- かどうか
custom_idアプリ内で無効化されているかどうか - ホスト型統計が無効な場合、更新失敗を監視するのは誰か
- チームがライセンス付きのセルフホストデプロイメントを必要とするかどうか
Capgo は、HIPAAコンプライアンス審査を受けている企業を支援しています。HIPAA準拠プログラムで Capgo を使用する米国企業も含まれます。審査担当者がホスト型のデフォルトより厳格なデプロイモデル、データフロー、ライセンスの形態を必要とする場合は、Capgo までお問い合わせください。
HIPAA Compliance から続けて読む
「HIPAA Compliance から続ける」セクション使用している場合 HIPAA準拠 規制対象の live update ロールアウトを計画するには、これを以下と連携させてください コンプライアンス プライバシーとデータ収集の詳細については、 データの保存場所 EU エンドポイントの設定については、 統計 API エンドポイント セルフホスト型テレメトリについては、 セルフホスト型アップデーター ライセンス付きデプロイメントの計画については。