Langsung ke konten
Capgo - Build, rilis, dan update aplikasi Capacitor Capgo

Kepatuhan HIPAA

Halaman ini menjelaskan opsi teknis yang dapat digunakan tim jika tinjauan HIPAA tidak mengizinkan pengiriman statistik live update ke Capgo Cloud.

Capgo Cloud saat ini tidak diposisikan sebagai pemroses statistik terkelola yang patuh HIPAA. Banyak aplikasi sensitif HIPAA tetap menggunakan Capgo karena data updater sangat minimal, berbasis perangkat, dan secara default tidak terhubung ke pengguna aplikasi tertentu. Jika kebijakan perusahaan, reviewer, atau kontrak pelanggan Anda memerlukan kontrol yang lebih ketat, Anda dapat melakukan geo-lokalisasi trafik plugin, menonaktifkan endpoint statistik, melakukan self-host pada endpoint statistik saja, atau beralih ke setup self-hosted berlisensi.

Data yang diterima Capgo secara default

Bagian berjudul “Data yang diterima Capgo secara default”

Plugin updater mengirimkan data operasional yang diperlukan untuk mengirim dan memantau live updates. Payload statistik dapat mencakup field berikut:

  • app_id - identifier aplikasi Capacitor Anda
  • device_id - identifier perangkat acak berbasis aplikasi yang dibuat oleh plugin updater
  • platform - ios, android, atau electron
  • version_name - versi web bundle yang terinstal
  • version_build - nama versi native app
  • version_code - nomor Native Build
  • version_os - versi sistem operasi
  • plugin_version - yang terinstal @capgo/capacitor-updater versi
  • action - event lifecycle update, seperti install, download, failure, rollback, atau app-ready events
  • is_emulator dan is_prod - flag environment jika tersedia
  • custom_id - hanya jika aplikasi Anda mengaturnya secara eksplisit dengan CapacitorUpdater.setCustomId(...)
  • Alamat IP - digunakan pada level transport untuk routing regional, pencegahan abuse, dan optimasi CDN

Secara default, data ini anonim bagi pengguna aplikasi. Capgo tidak menerima nama, email, ID akun, nomor rekam medis, kredensial, konten pengguna, event analytics aplikasi, atau behavioral analytics dari updater. Satu-satunya identifier yang stabil adalah identifier acak berbasis scope aplikasi device_id, yang bukan merupakan advertising ID dan tidak terhubung ke user yang dikenal kecuali Anda mengatur custom_id sendiri.

Jika tinjauan HIPAA Anda tidak memperbolehkan statistik update tersimpan, atur statsUrl menjadi string kosong. Ini akan menonaktifkan pelaporan statistik updater ke Capgo Cloud, namun pengecekan update tetap bisa menggunakan updateUrl dan channelUrl jika Anda tetap mengaktifkannya.

Jangan gunakan custom ID

Bagian berjudul “Jangan gunakan custom ID”

Untuk deployment sensitif HIPAA, jangan panggil CapacitorUpdater.setCustomId(...).

Custom ID akan disertakan dalam statistik updater saat dikonfigurasi. Jika Anda mengaturnya ke alamat email, user ID, patient ID, employee ID, account ID, atau nilai lain yang merujuk ke individu, Anda telah menghubungkan telemetri updater dengan data pribadi dalam konteks aplikasi Anda.

Jika tinjauan Anda mengharuskan telemetri Capgo tetap berbasis perangkat, biarkan custom_id tidak diatur.

Opsi 1: Geo-lokalisasi trafik plugin Capgo Cloud

Bagian berjudul “Opsi 1: Geo-lokalisasi trafik plugin Capgo Cloud”

Jika peninjauan Anda mengizinkan Capgo Cloud tetapi mewajibkan residensi data EU untuk data plugin, konfigurasikan ketiga endpoint updater ke host 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;

Gunakan URL EU secara bersamaan. Mencampur plugin.capgo.app dan plugin.eu.capgo.app dapat mengarahkan sebagian jalur data plugin ke luar host EU.

Ini menjaga data monitoring update, statistik, alert, dan troubleshooting yang dihosting Capgo tetap tersedia, sembari menempatkan jalur data plugin di Eropa.

Lokasi Data

Opsi 2: Nonaktifkan endpoint statistik

Bagian berjudul “Opsi 2: Nonaktifkan endpoint statistik”

Jika peninjauan Anda tidak mengizinkan statistik dikirim ke Capgo Cloud, atur statsUrl menjadi string kosong:

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;

Ini menonaktifkan pelaporan statistik dari plugin updater. Pengecekan dan download update tetap bisa menggunakan Capgo Cloud jika Anda tetap menggunakan default updateUrl dan channelUrl.

Setelah mengubah capacitor.config.ts, sinkronkan proyek native dan rilis build store baru. Instalasi yang sudah ada akan tetap menggunakan konfigurasi native sebelumnya sampai mereka menerima binary baru tersebut.

Apa yang hilang saat statistik dinonaktifkan

Bagian berjudul “Apa yang hilang saat statistik dinonaktifkan”

Menonaktifkan statsUrl menghapus hosted signal yang digunakan Capgo untuk menjelaskan apa yang terjadi di dalam aplikasi Anda setelah update ditawarkan atau didownload.

Anda kehilangan:

  • Visibilitas Dashboard untuk instalasi berhasil, instalasi gagal, kegagalan download, rollback, dan event app-ready
  • Alert kegagalan yang bergantung pada statistik terhosting
  • Kemampuan untuk cepat mengetahui versi app, versi OS, platform, atau versi plugin mana yang terdampak masalah update
  • Jejak troubleshooting tingkat perangkat di Capgo Cloud
  • Statistik agregat adopsi update dan penggunaan app di dashboard Capgo
  • Dukungan konteks yang lebih baik dari tim Capgo, karena layanan terhosting tidak lagi menerima event yang menjelaskan jalur update di sisi perangkat

Pengiriman update otomatis tetap bisa berjalan, namun observabilitas Anda akan berkurang. Rencanakan monitoring sendiri sebelum menonaktifkan statistik di produksi.

Opsi 3: Self-host endpoint statistik

Bagian berjudul “Opsi 3: Self-host endpoint statistik”

Jika review Anda mengizinkan pengecekan update melalui Capgo Cloud tetapi mewajibkan statistik tetap di dalam infrastruktur Anda, arahkan statsUrl ke endpoint Anda sendiri:

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;

Endpoint Anda harus menerima payload statistik updater dan mengembalikan:

{ "status": "ok" }

Gunakan jalur ini jika Anda ingin menjaga alerting internal, audit logs, dan analisis insiden tanpa mengirim statistik update perangkat ke Capgo Cloud.

Endpoint Statistik API

Opsi 4: Self-hosting berlisensi

Bagian berjudul “Opsi 4: Self-hosting berlisensi”

Jika Capgo Cloud, residensi data EU, statistik yang dinonaktifkan, atau endpoint statistik self-hosted masih belum memenuhi tinjauan HIPAA Anda, Capgo dapat membantu Anda beralih ke deployment self-hosted berlisensi.

Ini adalah opsi paling ketat karena organisasi Anda mengontrol backend updater, endpoint statistik, logs, retensi, infrastruktur, dan batas jaringan. Ini juga berarti Anda harus menangani lebih banyak pekerjaan operasional yang biasanya ditangani oleh Capgo Cloud.

Updater self-hosted

Checklist tinjauan praktis

Bagian berjudul “Checklist tinjauan praktis”

Sebelum tinjauan HIPAA, tentukan:

  • Apakah Capgo Cloud yang di-host diizinkan untuk pengecekan update
  • Apakah Capgo Cloud yang di-host diizinkan untuk statistik
  • Region mana yang harus digunakan oleh trafik plugin
  • Apakah custom_id dinonaktifkan di aplikasi Anda
  • Siapa yang memantau kegagalan update jika statistik yang di-host dinonaktifkan
  • Apakah tim Anda memerlukan deployment self-hosted berlisensi

Capgo bekerja sama dengan perusahaan yang sedang menjalani tinjauan kepatuhan HIPAA, termasuk perusahaan di AS yang menggunakan Capgo dalam program patuh HIPAA. Hubungi Capgo jika peninjau Anda membutuhkan model deployment, alur data, atau jalur lisensi yang lebih ketat dari default yang di-host.

Lanjutkan dari Kepatuhan HIPAA

Bagian berjudul “Lanjutkan dari Kepatuhan HIPAA”

Jika Anda menggunakan Kepatuhan HIPAA untuk merencanakan rollout live update yang teregulasi, hubungkan dengan Kepatuhan untuk detail privasi dan pengumpulan data, Lokasi Data untuk konfigurasi endpoint EU, Endpoint Statistik API untuk telemetry self-hosted, dan Updater self-hosted untuk perencanaan deployment berlisensi.