java php laravel linux mysql sql bootstrap html css query java php laravel linux mysql sql bootstrap html css query

Tuesday, November 17, 2026

kerahasiaan data pasien uu pdp rme

๐Ÿ”๐Ÿฅ

Data Pasien Bukan Milik Sembarang Orang: Kerahasiaan, Hak Akses, UU PDP, UU Kesehatan, dan Permenkes RME

Artikel 13 dari 16 · Seri Pertukaran Informasi Kesehatan

#KerahasiaanData #UUPDP #UUKesehatan #PermenkesRME
⏱️
8 menit
Estimasi baca
๐ŸŽ“
Menengah
Level
๐Ÿ“…
2026
Tahun

Bayangkan kamu dirawat karena penyakit yang sangat pribadi. Seminggu kemudian, foto hasil lab-mu beredar di grup WhatsApp kantor. Siapa yang salah? Siapa yang bisa dihukum? Dan data kamu itu sebenarnya milik siapa?

Jawabannya ada di kerahasiaan data pasien UU PDP, UU Kesehatan, dan Permenkes tentang Rekam Medis. Kalau kamu calon perekam medis, manajer data, atau pengembang sistem informasi kesehatan, tiga aturan ini akan menentukan apa yang boleh dan tidak boleh kamu lakukan setiap hari. Artikel ini bagian dari seri Pertukaran Informasi Kesehatan. Kita bedah aturannya, lalu kita praktikkan di level sistem.

Kerahasiaan Data Pasien UU PDP: Mengapa Data Kesehatan Disebut "Spesifik"?

Anggap rekam medis seperti isi brankas bank. Daftar nasabah boleh diketahui petugas loket, tapi isi brankas hanya boleh dibuka orang tertentu, dengan kunci tertentu, dan setiap bukaan dicatat. UU PDP memperlakukan data kesehatan dengan logika yang sama.

Kenapa dibedakan? Alamat email yang bocor bisa kamu ganti. Diagnosis yang bocor tidak bisa kamu "reset". Orang bisa kehilangan pekerjaan, ditolak asuransi, atau dijauhi lingkungannya karena riwayat penyakit yang terbuka. Itu sebabnya UU PDP menyetarakan data kesehatan dengan data genetika dan biometrik: begitu bocor, kerusakannya sulit dipulihkan.

๐Ÿ“ Konsep Utama
Data kesehatan = data pribadi yang bersifat spesifik (Pasal 4 ayat 2 UU No. 27 Tahun 2022). Artinya, risikonya bagi pasien dianggap lebih besar, sehingga perlindungannya lebih ketat dan pemrosesannya wajib punya dasar yang sah.

UU PDP membagi peran dengan jelas. Subjek data adalah pasien. Pengendali data adalah fasilitas pelayanan kesehatan yang menentukan tujuan pemrosesan. Prosesor data adalah pihak yang memproses atas nama pengendali, misalnya vendor SIMRS. Pasien punya hak mengakses, memperbaiki, dan meminta penghapusan datanya (Pasal 5–15). Fasilitas kesehatan wajib menjaga keamanan data (Pasal 35 dan 47) dan memberi tahu pasien serta lembaga yang berwenang paling lambat 3 × 24 jam bila terjadi kegagalan pelindungan data (Pasal 46).

๐Ÿ”ฅ Fakta Menarik
Pada Mei 2021, muncul dugaan kebocoran data sekitar 279 juta penduduk yang disebut berasal dari BPJS Kesehatan dan dijual di forum daring. Kasus ini ikut mendorong percepatan pembahasan UU PDP, yang akhirnya disahkan pada 17 Oktober 2022.

UU Kesehatan dan Permenkes RME: Siapa Boleh Membuka Data Pasien?

UU PDP adalah "payung" lintas sektor. Aturan khusus kesehatan ada di dua tempat lain. UU No. 17 Tahun 2023 tentang Kesehatan menjamin hak setiap orang atas kerahasiaan data kesehatan pribadinya (Pasal 4 ayat 1 huruf i). Pasal 296 ayat (5) mewajibkan tenaga medis, tenaga kesehatan, dan pimpinan fasyankes menjaga kerahasiaan rekam medis, sedangkan Pasal 301 mengatur kewajiban menyimpan rahasia kesehatan pasien. Permenkes No. 24 Tahun 2022 menjabarkannya untuk RME.

Perhatikan pola yang sama di ketiganya: kerahasiaan adalah aturan umum, pembukaan adalah pengecualian. Kamu tidak perlu menghafal semua nomor pasal. Cukup ingat urutan berpikirnya: data ini milik siapa, siapa yang berwenang membukanya, dan apa dasar hukum pembukaannya.

RegulasiFokusRujukan kunci
UU No. 27/2022 (PDP)Hak subjek data, kewajiban pengendali, sanksiPasal 4 (2), 5–15, 35, 46, 47, 57, 67
UU No. 17/2023 (Kesehatan)Hak pasien, rahasia kesehatan, rekam medisPasal 4, 276, 296, 297, 301
Permenkes No. 24/2022Penyelenggaraan RME, keamanan, pembukaan isi rekam medisPasal 3, 29, 32, 33, 35, 38
⚡ Insight Penting
Dokumen rekam medis adalah milik fasilitas pelayanan kesehatan, tetapi isinya adalah rahasia pasien. Pasien berhak mengakses informasi dalam rekam medisnya (Pasal 276 huruf e jo. Pasal 297 UU Kesehatan). Jadi, jangan menjawab "itu milik rumah sakit" setiap kali pasien meminta datanya.
๐Ÿ”Ž Analisis: Kapan Isi Rekam Medis Boleh Dibuka?
✅ Dengan persetujuan pasien
Untuk kebutuhan seperti pelayanan lanjutan, klaim, atau kepentingan lain yang disetujui pasien, sebatas yang dibutuhkan (Permenkes 24/2022 Pasal 33).
⚖️ Tanpa persetujuan pasien
Hanya dalam hal yang diatur peraturan perundang-undangan, misalnya permintaan aparat penegak hukum untuk penegakan hukum (Pasal 4 ayat 4 UU Kesehatan; Permenkes Pasal 35).
๐Ÿ’ก Tips
Sebelum membuka data untuk pihak luar, tanyakan tiga hal: siapa yang meminta, untuk tujuan apa, dan apa dasar hukumnya? Kalau salah satunya tidak jelas, tahan dulu dan eskalasi ke atasan atau tim hukum.

Hak Akses di Sistem: Menerapkan Kerahasiaan Data Pasien UU PDP Langkah demi Langkah

Aturan di atas kertas tidak berguna kalau sistemmu membiarkan petugas pendaftaran membaca catatan psikiatri. Permenkes 24/2022 meminta fasyankes menjaga kerahasiaan, integritas, dan ketersediaan data RME, dan hak akses ditetapkan oleh pimpinan fasyankes. Bayangkan gedung rumah sakit: pasien umum tidak boleh masuk ruang arsip, dan petugas arsip tidak boleh masuk ruang operasi. Sistem informasimu harus punya "pintu" yang sama, hanya saja versi digital. Berikut langkah praktisnya.

1
Petakan data dan peran. Daftar semua jenis data (identitas, diagnosis, hasil lab, tagihan) dan siapa saja yang bekerja dengannya: dokter, perawat, kasir, coder, vendor.
2
Terapkan prinsip akses minimum. Setiap peran hanya melihat data yang ia butuhkan. Pecah akses sampai level kolom bila perlu.
3
Catat persetujuan pasien. Simpan siapa yang setuju, untuk tujuan apa, kapan, dan sampai kapan. Contohnya ada di kode kedua di bawah.
4
Catat setiap akses. Log akses menjawab pertanyaan "siapa membuka berkas pasien ini?". Kita bahas lebih dalam di artikel 14.
5
Siapkan prosedur insiden. Tentukan siapa yang menilai kebocoran dan siapa yang menghubungi pasien, supaya batas 3 × 24 jam tidak terlewat.

Dua kode di bawah ini sengaja dibuat pendek supaya mudah kamu praktikkan di laboratorium. Kode pertama menunjukkan siapa boleh melihat apa. Kode kedua menunjukkan pasien setuju datanya dipakai untuk apa. Keduanya saling melengkapi: izin teknis tanpa persetujuan pasien tetap berisiko, dan persetujuan tanpa kontrol akses hanyalah dokumen yang tidak ditegakkan oleh sistem. Di artikel berikutnya, kita menambah lapisan ketiga berupa audit trail dan enkripsi.

Kode 1. Pembatasan akses berbasis peran di PostgreSQL (contoh sederhana, sesuaikan dengan skema sistemmu):

sql · akses-berbasis-peran
CREATE ROLE dokter_dpjp;
CREATE ROLE petugas_pendaftaran;

-- Dokter: baca dan ubah catatan klinis
GRANT SELECT, UPDATE ON rme.catatan_klinis TO dokter_dpjp;

-- Pendaftaran: hanya kolom administratif
GRANT SELECT (no_rm, nama, tgl_lahir) ON rme.pasien
  TO petugas_pendaftaran;
REVOKE ALL ON rme.catatan_klinis FROM petugas_pendaftaran;

-- Log akses: siapa, melihat apa, kapan
CREATE TABLE rme.log_akses (
  id        BIGSERIAL PRIMARY KEY,
  user_id   TEXT NOT NULL,
  no_rm     TEXT NOT NULL,
  aksi      TEXT NOT NULL,
  waktu     TIMESTAMPTZ DEFAULT now()
);

Kode 2. Persetujuan pasien dalam format resource Consent HL7 FHIR R4:

json · fhir-consent
{
  "resourceType": "Consent",
  "status": "active",
  "scope": { "coding": [{
    "system": "http://terminology.hl7.org/CodeSystem/consentscope",
    "code": "patient-privacy" }] },
  "category": [{ "coding": [{
    "system": "http://loinc.org", "code": "59284-0" }] }],
  "patient": { "reference": "Patient/123" },
  "dateTime": "2026-11-17",
  "provision": {
    "type": "permit",
    "period": { "end": "2027-11-17" },
    "purpose": [{
      "system": "http://terminology.hl7.org/CodeSystem/v3-ActReason",
      "code": "TREAT" }]
  }
}
⚠️ Perhatian
Jangan membagikan akun dan kata sandi RME ke rekan kerja "biar cepat". Akses yang tercatat atas namamu menjadi tanggung jawabmu, termasuk kalau yang membuka berkas ternyata orang lain.

Satu lagi yang sering dilupakan: UU PDP juga meminta penilaian dampak pelindungan data untuk pemrosesan berisiko tinggi, termasuk pemrosesan data spesifik (Pasal 34). Untuk fasyankes besar, ini berarti ada dokumen analisis risiko yang ditulis sebelum sistem baru dipakai, bukan setelah terjadi masalah.

Konsekuensi Pelanggaran Kerahasiaan Data Pasien UU PDP

UU PDP menyiapkan dua jalur sanksi. Jalur administratif (Pasal 57) bisa berupa peringatan tertulis, penghentian sementara pemrosesan, penghapusan data, sampai denda administratif paling tinggi 2% dari pendapatan atau penerimaan tahunan. Jalur pidana (Pasal 67) mengancam orang yang memperoleh, mengungkapkan, atau menggunakan data pribadi yang bukan miliknya secara melawan hukum, dengan penjara sampai 4–5 tahun dan/atau denda sampai Rp4–5 miliar. Ancaman ini berlaku untuk individu, bukan hanya institusi. Jadi "saya cuma disuruh atasan" bukan perisai yang bisa kamu andalkan. Kalau kamu diminta membuka data tanpa dasar yang jelas, kamu berhak bertanya dan meminta instruksi tertulis.

๐Ÿ”Ž Analisis Kasus Mini
Seorang petugas memotret layar RME untuk dikirim ke grup keluarga pasien. Niatnya baik. Tetapi pengungkapan itu tanpa dasar yang sah, tanpa persetujuan pasien, dan lewat kanal yang tidak aman. Yang aman dilakukan: arahkan keluarga mengajukan permintaan resmi, verifikasi persetujuan pasien, lalu berikan informasi lewat prosedur fasyankes.
⚡ Insight Penting
Pasien yang membuka sendiri isi rekam medisnya di media massa dipandang melepaskan kerahasiaannya (Permenkes 24/2022 Pasal 38). Namun tenaga kesehatan tidak otomatis boleh ikut membicarakannya. Kewajiban menjaga rahasia tetap melekat padamu.

Tiga Kesalahan yang Sering Terjadi di Lapangan

Dari studi kasus mahasiswa dan pengalaman praktik, tiga pola ini paling sering muncul. Cek apakah tempat magangmu pernah melakukannya.

  • Berkas pasien dikirim lewat aplikasi chat pribadi. Cepat, tapi kamu kehilangan kendali atas siapa yang menyimpan dan meneruskannya. Gunakan kanal resmi fasyankes.
  • Satu akun untuk satu unit kerja. Kalau terjadi kebocoran, tidak ada yang bisa membuktikan siapa pelakunya. Beri akun individual untuk setiap petugas.
  • Data asli dipakai untuk latihan atau penelitian. Anonimkan lebih dulu, dan ikuti prosedur pembukaan isi rekam medis untuk pendidikan dan penelitian yang diatur Permenkes 24/2022.
๐Ÿ’ก Tips untuk Tugas Akhirmu
Kalau kamu butuh data pasien untuk skripsi atau proyek akhir, ajukan izin etik dan izin fasyankes sejak awal, lalu gunakan data yang sudah dianonimkan. Dosen penguji hampir pasti menanyakan aspek ini.

๐ŸŽฏ Kesimpulan

Kerahasiaan data pasien UU PDP bertumpu pada satu ide sederhana: data kesehatan itu spesifik, sensitif, dan hanya boleh dibuka dengan dasar yang sah. Ringkasnya:

  • UU PDP menetapkan hak pasien, kewajiban pengendali data, dan sanksi.
  • UU Kesehatan dan Permenkes 24/2022 menjabarkan kerahasiaan dan pembukaan isi rekam medis.
  • Di sistem, terapkan akses minimum, catat persetujuan, dan catat setiap akses.

Menurut kamu, bagian mana yang paling sulit diterapkan di fasilitas kesehatan tempatmu praktik atau magang? Tulis di kolom komentar, dan bagikan artikel ini ke teman satu angkatanmu.

๐Ÿ’ฌ Tulis Komentar ๐Ÿ“ค Bagikan Artikel
๐Ÿ“š Referensi
  1. Undang-Undang Republik Indonesia Nomor 27 Tahun 2022 tentang Pelindungan Data Pribadi.
  2. Undang-Undang Republik Indonesia Nomor 17 Tahun 2023 tentang Kesehatan.
  3. Peraturan Menteri Kesehatan Republik Indonesia Nomor 24 Tahun 2022 tentang Rekam Medis.
  4. HL7 International. FHIR R4: Consent. https://hl7.org/fhir/R4/consent.html
Catatan: ini materi edukasi, bukan nasihat hukum. Cek teks resmi terbaru di JDIH untuk keperluan praktik.
๐Ÿท️ Tag: #PertukaranData #PertukaranInformasi #Kesehatan #KerahasiaanDataPasienUUPDP
๐Ÿ“Œ Label: Kerahasiaan Data Pasien UU PDP Hak Akses RME Permenkes RME
๐Ÿ“š
Artikel ini bagian dari seri

Pertukaran Informasi Kesehatan

Lihat Daftar Isi Kuliah

request response resource bundle fhir

๐Ÿ“ฆ๐Ÿฅ
Artikel 12 dari 16 · Pertukaran Informasi Kesehatan

Request, Response, Resource, dan Bundle: Membedah Satu Transaksi FHIR dari Awal sampai Akhir

Ikuti perjalanan satu permintaan data pasien, dari ketukan tombol sampai paket JSON tiba di layar.

FHIR Resource Bundle REST API Interoperabilitas
⏱️
9 menit
Estimasi baca
๐ŸŽฏ
Menengah
Level
๐Ÿ“…
2026
Tahun

Pernah bertanya-tanya, apa yang terjadi di balik layar saat aplikasi RME di puskesmas menarik data pasien dari server pusat hanya dalam hitungan detik? Jawabannya ada pada FHIR Resource dan Bundle. Resource adalah "kartu data" kecil yang berisi satu potong informasi klinis. Bundle adalah "amplop" yang membungkus banyak kartu itu supaya terkirim sekaligus.

Kalau kamu mahasiswa D4 MIK yang kelak mengelola data rekam medis, artikel ini memang untukmu. Kita akan membedah satu transaksi FHIR dari awal sampai akhir. Artikel ini bagian dari seri Pertukaran Informasi Kesehatan, dan kita pakai contoh kode yang bisa kamu coba sendiri.

Mengapa FHIR Resource dan Bundle Perlu Kamu Kuasai Lebih Dulu?

FHIR (Fast Healthcare Interoperability Resources) adalah standar pertukaran data kesehatan buatan HL7 International. Bender dan Sartipi (2013) memperkenalkannya sebagai pendekatan yang gesit dan berbasis REST, sehingga pengembang web biasa pun bisa memakainya tanpa belajar format pesan yang rumit. Di Indonesia, Permenkes Nomor 24 Tahun 2022 tentang Rekam Medis mewajibkan fasilitas pelayanan kesehatan menyelenggarakan RME yang terhubung ke platform SATUSEHAT milik Kemenkes, dan platform itu memakai FHIR.

Bayangkan restoran. Kamu (klien) memesan lewat pelayan (API). Dapur (server) menyiapkan hidangan, lalu pelayan mengantarkannya. Di FHIR, pesananmu disebut request, hidangannya disebut response, bahan-bahannya adalah resource, dan nampan yang memuat banyak piring sekaligus adalah bundle.

๐Ÿ“ RUMUS KONSEP
Transaksi FHIR = Request (verba + alamat) → Server → Response (status + Resource atau Bundle)
Resource = satuan data tunggal. Bundle = Resource khusus yang berisi kumpulan Resource lain.

Request dan Response: Anatomi Transaksi Sebelum FHIR Resource dan Bundle Tiba

FHIR memakai HTTP, protokol yang sama dengan peramban webmu. Setiap request memuat tiga hal: verba (apa yang ingin dilakukan), alamat (resource mana yang dituju), dan header (format data serta token akses). Aturan lengkapnya ada di spesifikasi FHIR bagian RESTful API (HL7 International, 2019). Berikut padanan verba HTTP dan operasi data:

Verba HTTPOperasiContoh alamatStatus sukses
GETBaca / cari/Patient/123200 OK
POSTBuat baru/Patient201 Created
PUTGanti / perbarui/Patient/123200 OK
DELETEHapus/Patient/123204 No Content
๐Ÿ’ก Tips
Selalu tambahkan header Accept: application/fhir+json. Dengan begitu kamu minta JSON secara eksplisit, dan tidak bergantung pada format bawaan server.

Setelah server memproses request, ia mengirim response berisi kode status dan, biasanya, badan pesan. Kode 2xx berarti berhasil, 4xx berarti kesalahan di sisi kamu (misalnya 404 data tidak ditemukan atau 401 belum terautentikasi, topik artikel 11), dan 5xx berarti server bermasalah. Kalau gagal, server mengembalikan resource OperationOutcome yang menjelaskan penyebabnya.

FHIR Resource: Satuan Data Terkecil yang Bermakna

Resource adalah blok pembangun FHIR. Setiap resource mewakili satu konsep klinis atau administratif, misalnya Patient, Encounter, Observation, atau Condition. Analogi mudahnya: resource itu satu halaman formulir terpisah di map rekam medis, dan setiap halaman punya judul (resourceType) dan nomor identitas (id). Resource saling menunjuk lewat reference, seperti nomor RM yang tertulis di setiap halaman.

Coba kirim request ini untuk membaca satu pasien:

๐Ÿ“„ Request + Response (JSON)
GET https://contoh.id/fhir/Patient/123
Accept: application/fhir+json
Authorization: Bearer <token_akses>

HTTP/1.1 200 OK
Content-Type: application/fhir+json

{
  "resourceType": "Patient",
  "id": "123",
  "identifier": [{
    "system": "https://fhir.kemkes.go.id/id/nik",
    "value": "3171000000000001"
  }],
  "name": [{ "text": "Siti Aminah" }],
  "gender": "female",
  "birthDate": "1995-04-12"
}
⚡ Insight Penting
Perhatikan kata resourceType di baris pertama. Parser FHIR memakainya untuk mengenali jenis data. Kalau kamu lupa mengisinya, resource dianggap tidak valid. NIK di contoh ini fiktif.

Bundle: Cara FHIR Resource Dibungkus dan Dikirim Bersama

Mengirim satu resource per request itu boros, seperti membeli sepuluh barang dengan sepuluh kali antre di kasir. Bundle menyelesaikannya. Bundle sendiri adalah sebuah resource, dan isinya adalah daftar entry yang masing-masing membawa resource lain. Atribut type menentukan fungsi bundle tersebut (HL7 International, 2019):

Tipe BundleFungsiKapan dipakai
searchsetHasil pencarian dari serverCari pasien berdasarkan NIK
transactionSemua operasi berhasil atau semuanya batalSimpan kunjungan + diagnosis sekaligus
batchKumpulan operasi independenUnggah banyak data tak saling terkait
documentDokumen klinis utuh dan statisResume medis
collectionKumpulan resource tanpa aturan khususMengelompokkan data untuk dibagikan
๐Ÿ”ฅ Fakta Menarik
Hasil pencarian FHIR ternyata juga berbentuk Bundle. Jadi saat kamu mengetik GET /Patient?name=siti, server membalas dengan Bundle bertipe searchset, bukan daftar polos.
๐Ÿ” ANALYSIS BOX · Transaction vs Batch
Transaction
Bersifat atomik. Jika satu entri gagal, seluruh bundle ditolak dan tidak ada data setengah tersimpan. Cocok untuk data yang saling bergantung, seperti kunjungan dan diagnosisnya.
Batch
Setiap entri diproses sendiri-sendiri. Satu gagal tidak membatalkan yang lain, dan server mengembalikan status per entri. Cocok untuk pekerjaan massal yang tidak saling bergantung.

Dalam transaction, entri-entri bisa saling merujuk memakai fullUrl sementara berformat urn:uuid. Server lalu mengganti rujukan itu dengan ID asli setelah resource tersimpan.

Praktik: Membedah Satu Transaksi FHIR Resource dan Bundle Langkah demi Langkah

Skenario: pasien baru datang ke poli rawat jalan. Aplikasimu harus menyimpan data pasien dan data kunjungannya dalam satu kiriman. Ikuti urutan ini:

1
Dapatkan token akses. Autentikasi dulu lewat OAuth 2.0 (artikel 11). Tanpa token, server membalas 401.
2
Cek apakah pasien sudah ada. Kirim GET /Patient?identifier=...|NIK. Jika Bundle searchset berisi entri, pakai ID yang ada. Jika kosong, lanjut langkah 3.
3
Susun resource. Buat Patient dan Encounter. Beri keduanya fullUrl sementara.
4
Bungkus dalam Bundle transaction dan kirim dengan POST ke alamat dasar server, seperti kode di bawah.
5
Baca response. Server membalas Bundle transaction-response. Cek status tiap entri (misalnya 201 Created) dan simpan ID baru dari location.
๐Ÿ“ฆ POST https://contoh.id/fhir (Bundle transaction)
{
  "resourceType": "Bundle",
  "type": "transaction",
  "entry": [
    {
      "fullUrl": "urn:uuid:11111111-1111-4111-8111-111111111111",
      "resource": {
        "resourceType": "Patient",
        "name": [{ "text": "Siti Aminah" }],
        "gender": "female",
        "birthDate": "1995-04-12"
      },
      "request": { "method": "POST", "url": "Patient" }
    },
    {
      "fullUrl": "urn:uuid:22222222-2222-4222-8222-222222222222",
      "resource": {
        "resourceType": "Encounter",
        "status": "finished",
        "class": {
          "system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
          "code": "AMB"
        },
        "subject": { "reference": "urn:uuid:11111111-1111-4111-8111-111111111111" }
      },
      "request": { "method": "POST", "url": "Encounter" }
    }
  ]
}
⚠️ Perhatian
Jangan menaruh data pasien asli di contoh latihan atau repositori publik. Pakai data fiktif dan server uji. Pembahasan hukumnya ada di artikel 13 seri ini.

๐ŸŽฏ Kesimpulan

Satu transaksi FHIR selalu berjalan dalam pola yang sama: request membawa verba dan alamat, server menjawab dengan response berisi kode status, dan isi pesannya berupa resource tunggal atau bundle yang memuat banyak resource.

Kalau kamu menguasai FHIR Resource dan Bundle, kamu sudah memegang kunci membaca hampir semua dokumentasi API kesehatan modern, termasuk SATUSEHAT. Pilih transaction untuk data yang saling bergantung dan batch untuk pekerjaan massal.

๐Ÿ’ฌ Menurutmu, kasus apa di fasilitas kesehatan yang paling butuh Bundle transaction? Tulis di kolom komentar, lalu bagikan artikel ini ke teman satu angkatanmu.
๐Ÿ’ฌ Tulis Komentar ๐Ÿ”— Bagikan Artikel
๐Ÿท️ Tag:
#PertukaranData #PertukaranInformasi #Kesehatan #FHIRResourcedanBundle
๐Ÿ“‚ Label:
Pertukaran Informasi Kesehatan FHIR Resource dan Bundle Request dan Response
๐Ÿ“š Referensi
  1. Bender, D., & Sartipi, K. (2013). HL7 FHIR: An agile and RESTful approach to healthcare information exchange. Proceedings of the 26th IEEE International Symposium on Computer-Based Medical Systems (CBMS), 326–331.
  2. HL7 International. (2019). HL7 FHIR Release 4 (v4.0.1): RESTful API, Resource, dan Bundle. https://hl7.org/fhir/R4/
  3. Kementerian Kesehatan Republik Indonesia. (2022). Peraturan Menteri Kesehatan Nomor 24 Tahun 2022 tentang Rekam Medis.
๐Ÿ“– Artikel Utama Seri

Daftar Isi Kuliah Pertukaran Informasi Kesehatan

Lihat seluruh 16 artikel seri ini dalam satu peta belajar.

Buka Daftar Isi →

authentication authorization oauth2

๐Ÿ”๐Ÿ—️๐Ÿฅ
Pertukaran Informasi Kesehatan · Artikel 11 dari 16

Siapa Kamu, Boleh Akses Apa? Authentication, Authorization, dan OAuth 2.0

Cara aplikasi kesehatan mendapat izin membaca data pasien tanpa pernah memegang password-mu.

#OAuth2 #Authentication #Authorization #SMARTonFHIR
9 mnt
Estimasi baca
Menengah
Level
2026
Tahun

Bayangkan sebuah aplikasi kesehatan di ponselmu meminta izin untuk "membaca hasil laboratorium". Kamu menekan Setuju. Tapi apa persisnya yang baru saja kamu izinkan? Apakah aplikasi itu sekarang tahu password portal rumah sakitmu? Bisakah ia membaca seluruh rekam medismu, termasuk riwayat yang tidak ia perlukan?

Jawabannya ada pada OAuth 2.0 authentication authorization, yaitu cara sistem membedakan siapa kamu dari kamu boleh akses apa. Di artikel ke-11 seri Pertukaran Informasi Kesehatan ini, kamu akan belajar membedakan keduanya, menelusuri alur OAuth 2.0 langkah demi langkah, dan membaca kode permintaan token yang dipakai standar SMART on FHIR.

OAuth 2.0 Authentication Authorization: Apa Bedanya?

Pakai analogi hotel. Di meja resepsionis, petugas memeriksa KTP-mu dan mencocokkannya dengan data reservasi. Itu authentication: membuktikan bahwa kamu memang tamu yang terdaftar. Setelah itu kamu menerima kartu kunci. Kartu itu hanya membuka kamar 412 dan pintu gym, bukan ruang staf atau brankas hotel. Itu authorization: batas apa yang boleh kamu buka.

๐Ÿ“ Definisi Inti
Authentication (AuthN) = "Kamu siapa?" → bukti identitas.
Authorization (AuthZ) = "Boleh akses apa?" → izin yang diberikan.
OAuth 2.0 = kerangka delegasi otorisasi: aplikasi pihak ketiga memperoleh access token terbatas atas nama pemilik data, tanpa mengetahui password-nya (Hardt, 2012).
⚡ Insight Penting
OAuth 2.0 secara resmi adalah protokol otorisasi, bukan protokol autentikasi. Kalau kamu butuh bukti "siapa pengguna ini", lapisan OpenID Connect menambahkan ID token di atas OAuth 2.0 (Sakimura et al., 2014). Kebingungan inilah yang membuat banyak mahasiswa dan developer salah merancang sistem login.

Dalam konteks kesehatan, bedanya terasa nyata. Dokter yang login ke SIMRS sudah lolos autentikasi. Tapi apakah ia boleh membuka rekam medis pasien poli lain? Itu ranah otorisasi. Perbandingan ringkasnya:

Aspek Authentication Authorization
PertanyaanKamu siapa?Boleh melakukan apa?
BuktiPassword, OTP, biometrikToken, scope, peran (role)
UrutanTerjadi lebih duluTerjadi setelah identitas jelas
Contoh di RSDokter login ke SIMRSDokter hanya boleh membuka pasien di poli-nya
Standar terkaitOpenID ConnectOAuth 2.0 (RFC 6749)

Cara Kerja OAuth 2.0 Authentication Authorization: Authorization Code Flow

Sebelum masuk alurnya, kenali empat pemeran di dalam OAuth 2.0. Pada skenario aplikasi kesehatan, pembagiannya seperti ini:

๐Ÿ” Analisis: Empat Peran dalam OAuth 2.0
๐Ÿง‘ Resource Owner
Pasien, pemilik data kesehatan yang memberi izin.
๐Ÿ“ฑ Client
Aplikasi yang meminta akses, misalnya aplikasi pemantau gula darah.
๐Ÿ›‚ Authorization Server
"Resepsionis" yang memverifikasi pasien dan menerbitkan token.
๐Ÿ—„️ Resource Server
Server FHIR rumah sakit yang menyimpan data dan memeriksa token.

Alur yang paling dianjurkan untuk aplikasi pasien adalah Authorization Code yang dilengkapi PKCE. Ikuti lima langkahnya:

1
Aplikasi membuat PKCE. Aplikasi membuat code_verifier acak, lalu menghitung code_challenge dari verifier tersebut.
2
Pasien diarahkan ke Authorization Server. Browser membuka halaman login rumah sakit, bukan halaman aplikasi. Di sinilah authentication terjadi.
3
Pasien memberi persetujuan. Layar consent menampilkan daftar izin (scope). Pasien menyetujui atau menolak. Ini momen authorization.
4
Aplikasi menukar code dengan token. Authorization Server mengirim code sekali pakai ke aplikasi. Aplikasi menukarnya dengan access_token sambil membuktikan memegang code_verifier.
5
Aplikasi memanggil API FHIR. Token dikirim lewat header Authorization. Server FHIR memeriksanya, lalu mengembalikan hanya data yang diizinkan.

Berikut bentuk nyata langkah 2, 4, dan 5. Perhatikan bahwa password pasien tidak muncul sama sekali di kode aplikasi:

alur-oauth2-smart.http
# Langkah 2 — arahkan pasien ke halaman login & consent
GET /authorize?response_type=code
    &client_id=app-gula-darah
    &redirect_uri=https://app.contoh.id/callback
    &scope=openid fhirUser patient/Observation.read
    &state=xyz123
    &aud=https://fhir.rs-contoh.id/r4
    &code_challenge=E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM
    &code_challenge_method=S256

# Langkah 4 — tukar code dengan token
POST /token
Content-Type: application/x-www-form-urlencoded

grant_type=authorization_code
&code=SplxlOBeZQQYbYS6WxSbIA
&redirect_uri=https://app.contoh.id/callback
&client_id=app-gula-darah
&code_verifier=dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk

# Respons token (disederhanakan)
{
  "access_token": "eyJhbGciOi...",
  "token_type": "Bearer",
  "expires_in": 300,
  "scope": "openid fhirUser patient/Observation.read",
  "patient": "pasien-123"
}

# Langkah 5 — panggil API FHIR
GET /Observation?patient=pasien-123&category=laboratory
Authorization: Bearer eyJhbGciOi...

Kenapa PKCE penting? Aplikasi seluler tidak bisa menyimpan rahasia dengan aman, karena siapa pun bisa membongkar kode aplikasinya. Tanpa PKCE, penyerang yang berhasil mencegat code bisa menukarnya sendiri dengan token. Dengan PKCE, penukaran hanya berhasil kalau pemintanya memegang code_verifier asli yang tidak pernah dikirim lewat browser. Jadi seandainya code dicuri di tengah jalan, ia tidak berguna bagi pencuri.

Perhatikan juga nilai expires_in yang pendek (300 detik pada contoh). Token yang cepat kedaluwarsa membatasi kerugian bila bocor. Ketika token habis, aplikasi memakai refresh token bila server mengizinkannya, atau meminta pasien memberi persetujuan ulang. Di sistem kesehatan, kedua pilihan itu wajar: lebih baik pasien sesekali login ulang daripada token curian bisa membuka rekam medis berhari-hari.

๐Ÿ’ก Tips
Selalu kirim parameter state berisi nilai acak, lalu cocokkan saat pasien kembali ke aplikasi. Ini menangkal serangan CSRF, yaitu pihak lain menyuntikkan code miliknya ke sesi kamu. Praktik ini juga ditegaskan dalam panduan keamanan terbaru (Lodderstedt et al., 2025).
๐Ÿ”ฅ Fakta Menarik
Dalam RFC 7636, singkatan PKCE dilafalkan "pixy" seperti dalam bahasa Inggris untuk peri kecil (Sakimura et al., 2015). Untuk authorization code, RFC 6749 merekomendasikan masa berlaku maksimum 10 menit dan hanya sekali pakai. Jadi code itu semacam tiket konser yang langsung hangus setelah discan.

Scope dan Token: Batas Akses dalam OAuth 2.0 Authorization di Data Kesehatan

Kalau access token adalah kartu kunci hotel, maka scope adalah daftar pintu yang bisa dibuka kartu itu. Standar SMART on FHIR memakai OAuth 2.0 untuk mengatur aplikasi yang tersambung ke rekam medis elektronik, dan scope-nya mengikuti pola konteks/ResourceFHIR.izin (Mandel et al., 2016; HL7 International, n.d.).

Scope Artinya Cocok untuk
patient/Observation.readBaca observasi (misalnya hasil lab) milik satu pasienAplikasi pemantau pasien
patient/*.readBaca semua jenis resource milik satu pasienAplikasi rekam medis pribadi
user/Patient.readBaca data pasien sesuai hak pengguna yang loginAplikasi untuk tenaga kesehatan
openid fhirUserMinta identitas pengguna lewat OpenID ConnectMengetahui siapa yang login

Catatan: SMART App Launch versi 2 menulis izin dengan huruf c, r, u, d, s (misalnya patient/Observation.rs untuk baca dan cari). Cek versi yang didukung server FHIR-mu lewat dokumen /.well-known/smart-configuration.

⚠️ Perhatian
Token jenis Bearer bekerja seperti uang tunai: siapa pun yang memegangnya bisa memakainya (Jones & Hardt, 2012). Jangan taruh token di URL, jangan cetak di log, dan beri masa berlaku pendek. Data rekam medis juga termasuk data pribadi yang dilindungi UU No. 27 Tahun 2022 tentang Pelindungan Data Pribadi dan diatur kerahasiaannya dalam Permenkes No. 24 Tahun 2022 tentang Rekam Medis.

Bayangkan dua skenario. Pada aplikasi pasien, token hanya terikat ke satu pasien, sehingga mencoba membaca data pasien lain akan ditolak server FHIR. Pada aplikasi tenaga kesehatan, token terikat ke pengguna yang login, sehingga hasilnya mengikuti hak akses orang itu di rumah sakit. Karena itu dua aplikasi yang memanggil endpoint yang sama bisa mendapat jawaban berbeda, dan perbedaan itulah bukti authorization bekerja.

Prinsip pegangannya adalah least privilege: minta scope sekecil mungkin. Aplikasi yang hanya menampilkan grafik gula darah cukup meminta patient/Observation.read, bukan patient/*.read. Selain lebih aman, layar consent yang singkat membuat pasien lebih percaya menekan "Setuju".

Memilih Alur yang Tepat dan Kesalahan Umum OAuth 2.0 Authentication Authorization

OAuth 2.0 menyediakan beberapa grant type. Tidak semuanya layak dipakai hari ini:

Grant type Dipakai saat Status
Authorization Code + PKCEAda pengguna manusia (aplikasi web/seluler)✅ Dianjurkan
Client CredentialsSistem ke sistem tanpa pengguna (misalnya sinkronisasi antar-server)✅ Sesuai kasusnya
ImplicitToken dikirim lewat URL browser⛔ Tidak disarankan
Password (ROPC)Aplikasi meminta password langsung⛔ Jangan dipakai

Panduan keamanan terbaru menyarankan klien tidak memakai implicit grant dan melarang resource owner password credentials (Lodderstedt et al., 2025). Alasannya masuk akal: kedua alur itu mengorbankan prinsip utama OAuth, yaitu aplikasi tidak boleh memegang password pengguna.

๐Ÿงช Analisis: Empat Kesalahan yang Sering Terjadi
1. Menganggap "login berhasil" sama dengan "boleh akses semua". Autentikasi tidak otomatis memberi otorisasi. Periksa scope di setiap permintaan.
2. Meminta scope terlalu lebar. Pakai patient/*.read "biar aman nanti" melanggar least privilege.
3. Tidak memvalidasi redirect_uri. Authorization Server harus mencocokkan alamat callback secara persis dengan yang terdaftar.
4. Memakai OAuth murni sebagai "login". Gunakan OpenID Connect bila butuh identitas pengguna.
๐Ÿ’ก Latihan Mandiri (15 menit)
Buka sandbox SMART App Launcher, pilih pasien contoh, lalu amati parameter scope, state, dan code pada alamat browser saat proses berjalan. Catat mana yang termasuk authentication dan mana yang authorization.

Kesimpulan: Identitas Dulu, Izin Kemudian

Intinya, authentication menjawab "kamu siapa?", sedangkan authorization menjawab "boleh akses apa?". OAuth 2.0 authentication authorization bekerja bersama: OpenID Connect membuktikan identitas, OAuth 2.0 mengatur izin lewat token dan scope.

Untuk aplikasi kesehatan, pakai Authorization Code + PKCE, minta scope sekecil mungkin, perlakukan token seperti uang tunai, dan jangan biarkan aplikasi memegang password pasien.

Artikel berikutnya mengajakmu membedah satu transaksi FHIR utuh. Token yang baru kamu pelajari adalah "tiket masuknya".

Pertanyaan untuk kolom komentar: aplikasi kesehatan apa di ponselmu yang meminta izin paling banyak? Menurutmu, scope-nya wajar atau berlebihan?

๐Ÿ“š Referensi
  1. Hardt, D. (Ed.). (2012). The OAuth 2.0 Authorization Framework (RFC 6749). IETF. datatracker.ietf.org/doc/html/rfc6749
  2. Jones, M., & Hardt, D. (2012). The OAuth 2.0 Authorization Framework: Bearer Token Usage (RFC 6750). IETF. datatracker.ietf.org/doc/html/rfc6750
  3. Sakimura, N., Bradley, J., & Agarwal, N. (2015). Proof Key for Code Exchange by OAuth Public Clients (RFC 7636). IETF. datatracker.ietf.org/doc/html/rfc7636
  4. Lodderstedt, T., Bradley, J., Labunets, A., & Fett, D. (2025). Best Current Practice for OAuth 2.0 Security (RFC 9700). IETF. datatracker.ietf.org/doc/html/rfc9700
  5. Sakimura, N., Bradley, J., Jones, M., de Medeiros, B., & Mortimore, C. (2014). OpenID Connect Core 1.0. OpenID Foundation. openid.net/specs/openid-connect-core-1_0.html
  6. HL7 International. (n.d.). SMART App Launch Implementation Guide. hl7.org/fhir/smart-app-launch
  7. Mandel, J. C., Kreda, D. A., Mandl, K. D., Kohane, I. S., & Ramoni, R. B. (2016). SMART on FHIR: a standards-based, interoperable apps platform for electronic health records. Journal of the American Medical Informatics Association, 23(5), 899–908. doi.org/10.1093/jamia/ocv189
  8. Republik Indonesia. (2022). Undang-Undang Nomor 27 Tahun 2022 tentang Pelindungan Data Pribadi.
  9. Kementerian Kesehatan Republik Indonesia. (2022). Peraturan Menteri Kesehatan Nomor 24 Tahun 2022 tentang Rekam Medis.
๐Ÿท️ Tags
#PertukaranData #PertukaranInformasi #Kesehatan #OAuth2.0AuthenticationAuthorization
๐Ÿ“‚ Label
Authentication & Authorization OAuth 2.0 Keamanan Informasi Kesehatan
๐Ÿ“– Artikel Utama Seri

Pertukaran Informasi Kesehatan

Artikel ini adalah bagian ke-11 dari 16 seri kuliah D4 MIK. Lihat daftar isi lengkap untuk membaca seluruh materinya secara berurutan.

Buka Daftar Isi Kuliah →

saifiahmada.com adalah blog belajar programming Indonesia, membahas lengkap materi bahasa pemrograman: code HTML, CSS, Bootstrap, Desain, PHP, MySQL, coding Java, Query, SQL, dan dunia linux