​

HIPAA Uyumluluğu

​

Genel Bakış

1. Dinlenme Durumunda Şifreleme — PHI, Google yönetimli AES-256 (Cloud SQL varsayılanı) ile dinlenme durumunda şifrelenir
2. Erişim Kontrolleri — PHI erişimi belirlenmiş rollerle sınırlıdır
3. Denetim Kaydı — Tüm PHI erişimi neden kodlarıyla kaydedilir
4. Veri Saklama — Yapılandırılan saklama süresi sonrasında otomatik silme
5. BAA Takibi — Business Associate Agreement durum yönetimi

​

Kim ne yapabilir

​

Ön Koşullar

1. Devotel ile bir Business Associate Agreement (BAA) imzalamak
2. Ekipleri içinde bir HIPAA uyumluluk sorumlusu belirlemek

​

Teknik Kontroller

​

1. Dinlenme Durumunda Şifreleme

• Algoritma: AES-256 (Google Cloud varsayılan dinlenme durumunda şifreleme)
• Anahtar Yönetimi: Şifreleme anahtarları Google Cloud tarafından yönetilir ve döndürülür
• Kapsam: Mesaj body, media_url ve meta veriler dahil veritabanında saklanan tüm içerik
• Aktarım halinde: TLS 1.3, aktarım halindeki tüm verileri korur (bkz. Altyapı Korumaları)

Not: Devotel şu anda mesaj gövdelerinin kuruluş başına uygulama katmanı şifrelemesini gerçekleştirmemektedir. Dinlenme durumundaki PHI gizliliği, uygulama katmanı şifresi yerine Google Cloud’un şeffaf AES-256 şifrelemesine dayanır. GET /settings/hipaa yanıtı, yalnızca raporlama amaçlı bir encryption_algorithm alanı içerir — bu, mesaj gövdelerinin uygulama katmanında tek tek şifrelendiğini göstermez.

​

2. Erişim Kontrolleri

• treatment — Hasta tedavisi koordinasyonu için gerekli erişim
• payment — Ödeme işlemleri için gerekli erişim
• operations — Sağlık hizmeti operasyonları için gerekli erişim
• legal — Hukuki uyumluluk için gerekli erişim
• support — Müşteri desteği çözümü için gerekli erişim

Bilinen sınırlama: Orbit şu anda yukarıdaki billing sınırlamasının ötesinde mesaj içeriği okumalarını daha dar bir rol kümesiyle kısıtlamamakta ve mesaj okuma uç noktalarında (GET /messages, GET /messages/{id}) operatör tarafından sağlanan bir neden kodu da talep etmemektedir. HIPAA minimum gerekli standardını karşılamak için çalışma alanı üyeliğini ve API anahtarı kapsamlarını, yalnızca PHI’ye ihtiyacı olan personelin bu uç noktalara erişebileceği şekilde yapılandırın. Programınız mesaj içeriğinde rol bazlı okuma kısıtlaması gerektiriyorsa, buna güvenmeden önce compliance@devotel.io ile iletişime geçin.

​

3. PHI denetim kaydı

{
  "id": "phi_abc123",
  "userId": "usr_xyz789",
  "resource": "message:msg_def456",
  "reason": "treatment",
  "accessedAt": "2026-04-02T10:30:00Z"
}

• Yalnızca ekleme yapılabilir ve değiştirilemez veya silinemez
• Kuruluş başına en fazla 10.000 kayıt tutar (en eski kayıtlar otomatik olarak döndürülür)
• Pano veya API üzerinden owner ve admin rollerine açıktır
• Harici uyumluluk denetimleri için dışa aktarılabilir

​

4. Veri Saklama

• Varsayılan saklama süresi: 365 gün (yapılandırılabilir: 30–3.650 gün)
• Kapsam: Mesaj içeriği, çağrı kayıtları, medya ekleri
• Mekanizma: Otomatik bir arka plan görevi süresi dolmuş kayıtları tarar ve güvenli şekilde siler
• İstisnalar: Denetim kayıtları ve PHI erişim kayıtları, veri saklama politikasından bağımsız olarak tutulur

PUT /api/v1/settings/hipaa
{
  "enabled": true,
  "data_retention_days": 365
}

​

5. BAA durum yaşam döngüsü

• not_required — kuruluş, kapsamda PHI olmadığını atteste etmiştir (varsayılan)
• pending — Kapsamda PHI vardır ve BAA imzalanmayı beklemektedir
• executed — BAA imzalanmıştır ve süresi içindedir
• expired — İmzalanmış bir BAA bir yıllık süresini aşmıştır ve yeniden imzalanmalıdır

​

BAA’yı İmzalama

1. Mevcut durumu kontrol edin — GET /api/v1/compliance/baa/, baa_status, imzalayan ayrıntıları ve days_until_expiry döndürür (owner/admin).
2. PHI’nin kapsamda olduğunu atteste edin — POST /api/v1/compliance/baa/require, hipaa_required ayarlar ve bir not_required kuruluşu pending durumuna taşıyarak imzalama adımını açar (yalnızca owner). Akışı başlatır; HIPAA modunu etkinleştirmez.

POST /api/v1/compliance/baa/require
{
  "reason": "We began storing patient appointment reminders that contain PHI."
}

3. BAA’yı imzalayın — POST /api/v1/compliance/baa/execute, adı-yaz click-wrap e-imzası ile sözleşmeyi kaydeder (yalnızca owner). typed_attestation, signer_name ile tam olarak eşleşmelidir. Başarı durumunda kuruluş; imzalayan, sürüm ve tarih ile executed olarak damgalanır, bu da PHI gönderimlerini açar ve HIPAA modunu etkinleştirmenize izin verir.

POST /api/v1/compliance/baa/execute
{
  "signer_name": "Jane Roe",
  "signer_email": "jane@example.com",
  "typed_attestation": "Jane Roe"
}

Eski uç nokta: PUT /api/v1/settings/hipaa/baa (gövde { signed, signed_at, document_url }) daha eski bir JSONB durum yansıması yazar ve yalnızca geçiş öncesi kiracılar için bir yedektir. Bir kuruluş bir baa_status değerine sahip olduğunda, HIPAA-etkinleştirme ve PHI-gönderi kapıları o kanonik sütunu okur ve bu yansımayı yok sayar — dolayısıyla buradaki bir signed: true yazması gönderimlerin veya HIPAA modunun önünü açmaz. Bunun yerine POST /api/v1/compliance/baa/execute kullanın.

PUT /api/v1/settings/hipaa/baa
{
  "signed": true,
  "signed_at": "2026-04-01T00:00:00Z",
  "document_url": "https://storage.devotel.io/baa/org_abc123.pdf"
}

​

PHI ile İlişkili İzleyici Kayıt Defteri

GET /api/v1/compliance/hipaa/phi-audiences

{
  "audience_ids": ["list_9f2c1a", "seg_4b7e20"],
  "max": 500
}

PUT /api/v1/compliance/hipaa/phi-audiences
{
  "audience_ids": ["list_9f2c1a", "seg_4b7e20"]
}

Not: Kayıt defteri, kuruluşunuzun hangi izleyicilerin PHI içerdiğine dair attestasyonudur. Kiracıya aittir: Devotel sizin adınıza asla izleyici belirlemez ve belirleme yalnızca HIPAA kuruluşunuz için kapsama girdiğinde yürürlüğe girer.

​

Kampanya Başlatma Ön Kontrolü

1. Başlatma ön kontrolü (kampanya düzeyi, sert kapı). Bir kampanya taslak/zamanlanmış durumdan ayrılmadan önce, başlatma ön kontrolü izleyicisini kayıt defterine karşı çözümler. İzleyici belirlenmiş bir liste veya segmentse ve kuruluşunuzun BAA’sı executed ve süresi içinde değilse, başlatma 422 HIPAA_BAA_REQUIRED ile reddedilir. Bu, binlerce alıcı başına reddi için cüzdan kredisini yakmak yerine PHI kohortunu kampanya katılımının dışında tutar. Uyumluluk durumu okunamıyorsa, ön kontrol bir PHI izleyicisini sessizce kabul etmek yerine kapalı şekilde başarısız olur (500 HIPAA_BAA_GATE_DB_FAIL).
2. Gönderi kapısı (alıcı başına, mevcut davranış). BAA — HIPAA gönderi kapısı altında belgelenen alıcı başına gönderi kapısı, mesaj anında hâlâ geçerlidir ve değişmemiştir.

{
  "error": {
    "code": "HIPAA_BAA_REQUIRED",
    "status": 422,
    "message": "The designated PHI-adjacent audience for this campaign requires an executed Business Associate Agreement (BAA) before outbound sends are permitted."
  }
}

1. Kayıt defterini oluşturun — PHI içeren liste/segment kimlikleriyle PUT /api/v1/compliance/hipaa/phi-audiences.
2. Engeli doğrulayın — belirlenmiş bir izleyiciye karşı başlatmayı deneyin; BAA executed/süresi içinde olmadığı sürece 422 HIPAA_BAA_REQUIRED bekleyin.
3. BAA’yı çözün — BAA’yı İmzalama bölümünde açıklandığı gibi POST /api/v1/compliance/baa/execute ile bir BAA imzalayın (veya expired olanı yeniden imzalayın).
4. Yeniden başlatın — BAA executed ve süresi içinde olduğunda, ön kontrol geçer ve kampanya normal şekilde başlatılır.

• Kayıt defteri yalnızca kampanya başlatmalarını yönetir. Tek seferlik alıcı başına gönderimler, kayıt defterine danışmayan alıcı başına gönderi kapısı tarafından yönetilmeye devam eder.
• Başlatmada yalnızca list- ve segment-türü izleyiciler kayıt defterine karşı çözümlenir. Kişi başına bir araya getirilen izleyiciler (tüm kişiler, CSV, manuel giriş), gönderi anında alıcı bazında değerlendirilir.
• Sihirbazın PHI ile ilişkili uyarısı izleyici seçicisinde bilgilendiricidir; zorlama başlatma anındadır.

​

6. HIPAA Modunu Kapatma

POST /api/v1/settings/hipaa/reauth-challenge

{
  "challenge_token": "h7Yc...base64url...",
  "expires_at": "2026-04-02T10:35:00Z"
}

PUT /api/v1/settings/hipaa
X-Reauth-Challenge: h7Yc...base64url...
{
  "enabled": false
}

{
  "error": {
    "code": "REAUTH_REQUIRED",
    "message": "Fresh re-authentication is required to disable HIPAA mode. POST /settings/hipaa/reauth-challenge first, then retry within 5 minutes with X-Reauth-Challenge header."
  }
}

Not: Yeniden kimlik doğrulama talebi yalnızca etkinleştirme → kapatma geçişini kapılar. HIPAA modunu etkinleştirme ve HIPAA modu zaten kapalıyken gönderilen yalnızca saklama güncellemeleri bu başlığı gerektirmez.

​

API Referansı

​

Pano Yapılandırması

1. HIPAA Modu Düğmesi — HIPAA modunu aç/kapat (BAA gerektirir)
2. BAA Bölümü — BAA’yı imzala (adı-yaz e-imzası) ve durumunu, imzalayanı ve süre bitişini izle
3. Veri Saklama — Otomatik veri silme süresini yapılandırın
4. PHI Erişim Kaydı — PHI erişim denetim izini görüntüleyin ve dışa aktarın
5. PHI ile İlişkili İzleyiciler — Hangi kişi listelerinin ve segmentlerin PHI taşıdığını belirleyin; kampanya sihirbazı belirlenmiş izleyiciler konusunda uyarır ve başlatma ön kontrolü BAA kapısını zorlar

​

Altyapı Korumaları

• Cloud SQL Şifreleme: Tüm veritabanı depolaması Google Cloud tarafından AES-256 ile şifrelenir
• TLS 1.3: Aktarım halindeki tüm veriler TLS 1.3 ile şifrelenir
• VPC Yalıtımı: Veritabanına yalnızca VPC içindeki özel IP üzerinden erişilebilir
• Ayrıcalıklı Kapsayıcı Yok: GKE Autopilot, ayrıcalıklı kapsayıcı çalıştırmayı engeller
• Secret Manager: Tüm şifreleme anahtarları ve kimlik bilgileri GCP Secret Manager’da saklanır
• Denetim İzleri: Altyapı düzeyi erişim takibi için Google Cloud Audit Logs

​

Ses ve Video Transkript PII/PHI Sansürlemesi

​

Sansürleme varsayılan olarak açıktır

Uyarı: Bu kontrol tek bir kuruluştan ziyade tüm dağıtıma uygulandığı için tek bir çalışma alanına kapsamlandırılamaz. Dağıtımınız PHI işliyorsa, sansürleme etkin kalmalıdır — herhangi bir PHI saklamadan önce BAA’nızın bir parçası olarak durumunu Devotel ile yazılı olarak teyit edin.

​

Ortak Sorumluluk

​

Olay Yanıtı

1. Devotel’in güvenlik ekibi 1 saat içinde otomatik uyarılar aracılığıyla bilgilendirilir
2. Etkilenen kuruluşlar, HIPAA İhlal Bildirim Kuralı gereğince 24 saat içinde bilgilendirilir
3. PHI erişim kayıtları derhal korunur ve adli inceleme için dışa aktarılır
4. Düzeltme adımları belgelenir ve etkilenen taraflarla paylaşılır

​

İlgili sayfalar

• DLP tarayıcı — giden bir mesajı geçen düzenlenmiş verileri işaretleyen gönderi anındaki kontrol
• Gönderi öncesi politika tarayıcı — bu kontrolün beslediği karar ve zorlama modu