Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card

Sağlık Uygulamaları İçin Hasta Onay Platformu

Veri katmanına entegre edilmiş onay mekanizması: OAuth 2.1 ve SMART kapsamları, kişinin seçtiği amaç ve geçerlilik süresi, görebileceği bir erişim günlüğü, bir sonraki istekte geri alma seçeneği ve uygulamanızın hala sahip olduğu haklar.

Hasta onay platformu, bir kişinin hangi uygulamaların sağlık kayıtlarını hangi amaçla ve ne kadar süreyle okuyabileceğine veya değiştirebileceğine karar vermesini sağlar ve bu erişimi istedikleri zaman görmelerine ve geri almalarına olanak tanır. Anpheros, onayı veri katmanına yerleştirir: bir uygulama, yalnızca kişinin Anpheros onay sayfasında onayladığı bir izin aracılığıyla hastanın FHIR R4 kaydına ulaşır, bu izin altındaki her okuma ve yazma işlemi kişinin görebileceği bir yerde günlüğe kaydedilir ve geri alma bir sonraki istekte yürürlüğe girer. Bu sayfa, bunun nasıl çalıştığını, uygulamanızın ne yapması gerektiğini ve neyi oluşturması gerekmediğini gösterir.

How one consent works, end to end

1 · Your app asksOAuth 2.1 with PKCE: SMART scopes, a purpose and the patient's language
2 · The person decidesOn the Anpheros consent page: what, for whom and for how long — 30, 90, 180 or 365 days
3 · Your app readsOne patient's record, only the granted resource types and categories
4 · Every access is loggedThe person sees each read and write by your application
5 · The person revokesThe next request fails; a refresh token cannot bring access back

Neden rıza veri katmanında yer almalı?

Çoğu sağlık uygulaması, rızayı kendi veritabanlarında bir onay kutusu olarak kaydeder ve ardından uygulama kodunda uygular. Bu, ikinci bir uygulama, bir klinik entegrasyonu veya bir yapay zeka özelliği aynı veriye ihtiyaç duyana kadar işe yarar: her biri kuralları yeniden uygulamak zorunda kalır ve kişi kimin erişimi olduğunu görebileceği tek bir yere sahip olmaz. Kaydı depolayan platform aynı zamanda rızayı uyguladığında, her istemci aynı kuralları alır ve kişi gözden geçirebileceği tek bir uygulama listesine sahip olur.

	Uygulamanızda bir bayrak olarak rıza	Veri katmanında rıza (Anpheros)
Nerede uygulanır	Her uygulamanın kodunda	Her API isteğinde, platform tarafından
Erişim kapsamı	Uygulamanın okumaya karar verdiği her şey	Yalnızca verilen kaynak türleri ve kategorileri
Süre sonu	Nadiren uygulanır	Kişi tarafından seçilir: 30, 90, 180 veya 365 gün
Kişinin gördükleri	Uygulamaya bağlı	Her uygulama, kapsamları ve süresi dolanlar ve bir erişim günlüğü
Geri alma	Elle yayılmalı	Bir sonraki istek başarısız olur; yenileme belirteci çalışmayı durdurur

Hastanın Kontrol Ettiği Şeyler

What the patient controls

WhoEach application is listed by name with its own grant

WhatResource types and categories, e.g. only laboratory Observations

WhyThe purpose your app declares is shown on the consent page

How long30, 90, 180 or 365 days; access ends by itself

What happenedAn access log of every read and write under the grant

StopRevocation takes effect on the next request

Uygulamanızın onay isteme şekli

Anpheros, PKCE ile OAuth 2.1 ve SMART on FHIR v2 kapsamlarını kullanır. Uygulamanız, ihtiyaç duyduğu kapsamları ve isteğe bağlı bir amacı belirterek kişiyi onay sayfasına gönderir; onaydan sonra tam olarak bir hasta için bir erişim belirteci (30 dakika) ve dönen bir yenileme belirteci (30 gün) alır.

import { OAuthFlow, generatePkce } from '@anpheros/sdk';

const flow = new OAuthFlow({
  baseUrl: 'https://platform.anpheros.com',
  clientId: process.env.ANPHEROS_CLIENT_ID!,
  redirectUri: 'https://your.app/callback',
});
const pkce = await generatePkce();
const url = flow.authorizeUrl({
  scopes: ['patient/Observation.rs?category=laboratory', 'patient/Condition.rs', 'offline_access'],
  purpose: 'treatment',
  state: crypto.randomUUID(),
  pkce,
  lang: 'en',
});
// redirect the person to `url`; on the callback exchange the code (see the authentication guide)

patient/Observation.rs?category=laboratory gibi bir kapsam, okumayı laboratuvar sonuçlarıyla sınırlar; kategori filtresi sunucu tarafından zorlanır. İzin dışı bir kaynak türü 403 döndürür; izin dışı bir hasta 404 döndürür, bu nedenle kimlikler sorgulanamaz.

Geri Almaya Tepki Verme

Kişi bir yetkiyi sonlandırdığında, o belirteçle yapılan sonraki istek başarısız olur ve yenileme belirteci erişimi geri getiremez. Hemen temizlemek için, consent.revoked webhook'una abone olun; bu webhook, grant_id, gördüğünüz hasta kimliği, kapsamlar ve revoked_at bilgilerini taşır.

await anpheros.webhooks.create('https://your.app/anpheros/hook', { events: ['consent.granted', 'consent.revoked'] });

Anpheros Neler Yapmaz

Pazarlama veya araştırma katılımı gibi veri erişimi dışındaki amaçlar için onay toplamaz.
Yasal dayanağınıza siz karar verirsiniz. Veri erişimi için onay bir kontrol mekanizmasıdır; gizlilik bildiriminiz, sözleşmeleriniz ve işleme kayıtlarınız size aittir.
Bir projenin kendi API anahtarı, izin olmadan projenin oluşturduğu hastaları görür. Onay, diğer uygulamalar tarafından erişimi yönetir.

Sıkça Sorulan Sorular

Hasta onay platformu nedir?

Bir kişinin sağlık verilerine erişmesine hangi uygulamaların izin verdiğini kaydeden, bu seçimleri her istekte uygulayan, kişiye kimin neye eriştiğini gösteren ve erişimi geri çekmesine olanak tanıyan yazılımdır. Anpheros'ta onay, ayrı bir hizmet yerine FHIR R4 kaydının kendisinin bir parçasıdır.

Anpheros hasta onayı için hangi standartları kullanır?

Yetkilendirme akışı için PKCE ile OAuth 2.1 ve bir uygulamanın okuyabileceği veya yazabileceği şeyler için SMART on FHIR v2 hasta kapsamları (isteğe bağlı bir ?category= filtreli patient/<Type>.<cruds>). OpenID Connect, openid fhirUser istediğinizde bir kimlik belirteci ekler.

Bir hasta yalnızca verilerinin bir kısmına erişimi sınırlayabilir mi?

Evet. Erişim, verilen kapsamlardaki kaynak türleri ve kategorileriyle sınırlıdır, örneğin yalnızca laboratuvar Gözlemleri. Diğer her şey bir hata döndürür.

Onay ne kadar sürer?

Kişi onay sayfasında 30, 90, 180 veya 365 gün seçer. Sonrasında izin süresi dolar ve uygulama tekrar sormalıdır.

Hasta bir uygulamanın erişimle ne yaptığını görebilir mi?

Evet. Kişi, erişimi olan her uygulamayı, kapsamlarını ve süresinin dolmasını ve her uygulamanın ne okuduğunu veya yazdığını listeleyen bir erişim günlüğünü görür.

Onay geri alındığında ne olur?

Bu erişim belirteciyle yapılan bir sonraki istek başarısız olur, yenileme belirteci yenisini almak için kullanılamaz ve sunucunuz abone olduysa bir consent.revoked webhook'u alır.

İlgili Konular

Onay ve erişim modeli: kuralların tamamı
Kimlik Doğrulama ve OAuth: jetonlar, kapsamlar ve kod değişimi
SMART on FHIR ile hasta onayının nasıl uygulanacağı
Webhook'lar: consent.granted ve consent.revoked
Tıbbi veri kökenbilimi (provenance) açıklandı
Boylamsal hasta verileri API'si

Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card