Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card
Πλατφόρμα συναίνεσης ασθενούς για εφαρμογές υγείας
Συναίνεση ενσωματωμένη στο επίπεδο δεδομένων: πεδία OAuth 2.1 και SMART, σκοπός και λήξη που επιλέγονται από το άτομο, αρχείο πρόσβασης που μπορεί να δει, ανάκληση στην επόμενη αίτηση και τι εξακολουθεί να κατέχει η εφαρμογή σας.
Μια πλατφόρμα συναίνεσης ασθενούς επιτρέπει σε ένα άτομο να αποφασίσει ποιες εφαρμογές μπορούν να διαβάσουν ή να τροποποιήσουν το ιατρικό του αρχείο, για ποιον σκοπό και για πόσο χρονικό διάστημα, και του επιτρέπει να βλέπει και να ανακαλεί αυτήν την πρόσβαση ανά πάσα στιγμή. Η Anpheros ενσωματώνει τη συναίνεση στο επίπεδο δεδομένων: μια εφαρμογή φτάνει στο FHIR R4 αρχείο ενός ασθενούς μόνο μέσω μιας άδειας που το άτομο ενέκρινε στη σελίδα συναίνεσης της Anpheros, κάθε ανάγνωση και εγγραφή υπό αυτήν την άδεια καταγράφεται εκεί που το άτομο μπορεί να τη δει, και η ανάκληση τίθεται σε ισχύ στην επόμενη αίτηση. Αυτή η σελίδα δείχνει πώς λειτουργεί, τι πρέπει να κάνει η εφαρμογή σας και τι δεν χρειάζεται να δημιουργήσετε.
- 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
Γιατί η συγκατάθεση ανήκει στο επίπεδο δεδομένων
Οι περισσότερες εφαρμογές υγείας καταγράφουν τη συγκατάθεση ως ένα πλαίσιο ελέγχου στη δική τους βάση δεδομένων και στη συνέχεια την επιβάλλουν στον κώδικα της εφαρμογής. Αυτό λειτουργεί μέχρι μια δεύτερη εφαρμογή, μια κλινική ενσωμάτωση ή μια λειτουργία AI να χρειαστεί τα ίδια δεδομένα: κάθε μία πρέπει να επανεφαρμόσει τους κανόνες, και το άτομο δεν έχει ένα ενιαίο μέρος για να δει ποιος έχει πρόσβαση. Όταν η πλατφόρμα που αποθηκεύει την εγγραφή επιβάλλει επίσης τη συγκατάθεση, κάθε πελάτης λαμβάνει τους ίδιους κανόνες και το άτομο λαμβάνει μία λίστα εφαρμογών για αναθεώρηση.
| Συγκατάθεση ως σημαία στην εφαρμογή σας | Συγκατάθεση στο επίπεδο δεδομένων (Anpheros) | |
|---|---|---|
| Πού επιβάλλεται | Στον κώδικα κάθε εφαρμογής | Σε κάθε αίτημα API, από την πλατφόρμα |
| Εύρος πρόσβασης | Ό,τι αποφασίσει η εφαρμογή να διαβάσει | Μόνο οι εκχωρημένοι τύποι και κατηγορίες πόρων |
| Λήξη | Σπάνια υλοποιείται | Επιλέγεται από το άτομο: 30, 90, 180 ή 365 ημέρες |
| Τι βλέπει το άτομο | Εξαρτάται από την εφαρμογή | Κάθε εφαρμογή, τα εύρη της και η λήξη της, και ένα αρχείο καταγραφής πρόσβασης |
| Ανάκληση | Πρέπει να διαδοθεί χειροκίνητα | Το επόμενο αίτημα αποτυγχάνει. Το token ανανέωσης σταματά να λειτουργεί. |
Τι ελέγχει ο ασθενής
Πώς η εφαρμογή σας ζητά συναίνεση
Το Anpheros χρησιμοποιεί OAuth 2.1 με PKCE και SMART on FHIR v2 scopes. Η εφαρμογή σας στέλνει το άτομο στη σελίδα συναίνεσης με τα scopes που χρειάζεται και έναν προαιρετικό σκοπό. Μετά την έγκριση, λαμβάνει ένα access token (30 λεπτά) και ένα περιστρεφόμενο refresh token (30 ημέρες) για έναν ακριβώς ασθενή.
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)
Ένα scope όπως το patient/Observation.rs?category=laboratory περιορίζει την ανάγνωση σε εργαστηριακά αποτελέσματα. Το φίλτρο κατηγορίας επιβάλλεται από τον διακομιστή. Ένας τύπος πόρου εκτός της παραχώρησης επιστρέφει 403. Ένας ασθενής εκτός της παραχώρησης επιστρέφει 404, επομένως τα αναγνωριστικά δεν μπορούν να διερευνηθούν.
Αντίδραση στην ανάκληση
Όταν το άτομο τερματίζει μια παραχώρηση, το επόμενο αίτημα με αυτό το token αποτυγχάνει και το refresh token δεν μπορεί να επαναφέρει την πρόσβαση. Για να γίνει άμεση εκκαθάριση, εγγραφείτε στο webhook consent.revoked, το οποίο μεταφέρει το grant_id, το αναγνωριστικό ασθενούς που βλέπετε, τα scopes και το revoked_at.
await anpheros.webhooks.create('https://your.app/anpheros/hook', { events: ['consent.granted', 'consent.revoked'] });
Τι δεν κάνει το Anpheros
- Δεν συλλέγει συναίνεση για σκοπούς εκτός της πρόσβασης στα δεδομένα, όπως μάρκετινγκ ή συμμετοχή σε έρευνα.
- Δεν αποφασίζει τη νομική σας βάση. Η συναίνεση για πρόσβαση είναι ένας έλεγχος· η ειδοποίηση απορρήτου, οι συμβάσεις και τα αρχεία επεξεργασίας παραμένουν δικά σας.
- Το δικό του API key ενός project βλέπει τους ασθενείς που δημιούργησε το project, χωρίς παραχώρηση. Η συναίνεση διέπει την πρόσβαση από άλλες εφαρμογές.
Συχνές Ερωτήσεις
Τι είναι μια πλατφόρμα συναίνεσης ασθενούς;
Λογισμικό που καταγράφει ποιες εφαρμογές επιτρέπει ένα άτομο να έχουν πρόσβαση στα δεδομένα υγείας του, επιβάλλει αυτές τις επιλογές σε κάθε αίτημα, δείχνει στο άτομο ποιος απέκτησε πρόσβαση σε τι και του επιτρέπει να ανακαλέσει την πρόσβαση. Στο Anpheros, η συναίνεση αποτελεί μέρος του ίδιου του αρχείου FHIR R4 αντί για μια ξεχωριστή υπηρεσία.
Ποια πρότυπα χρησιμοποιεί το Anpheros για τη συναίνεση ασθενούς;
OAuth 2.1 με PKCE για τη ροή εξουσιοδότησης και SMART on FHIR v2 patient scopes (patient/<Type>.<cruds> με ένα προαιρετικό φίλτρο ?category=) για το τι μπορεί να διαβάσει ή να γράψει μια εφαρμογή. Το OpenID Connect προσθέτει ένα ID token όταν ζητάτε openid fhirUser.
Μπορεί ένας ασθενής να περιορίσει την πρόσβαση μόνο σε ορισμένα από τα δεδομένα του;
Ναι. Η πρόσβαση περιορίζεται στους τύπους πόρων και τις κατηγορίες στα χορηγηθέντα scopes, για παράδειγμα μόνο σε εργαστηριακές Παρατηρήσεις (Observations). Οτιδήποτε άλλο επιστρέφει σφάλμα.
Πόσο διαρκεί η συναίνεση;
Το άτομο επιλέγει 30, 90, 180 ή 365 ημέρες στη σελίδα συναίνεσης. Μετά από αυτό, η άδεια λήγει και η εφαρμογή πρέπει να ζητήσει ξανά.
Μπορεί ο ασθενής να δει τι έκανε μια εφαρμογή με την πρόσβαση;
Ναι. Το άτομο βλέπει κάθε εφαρμογή με πρόσβαση, τα scopes και την ημερομηνία λήξης της, και ένα αρχείο καταγραφής πρόσβασης που αναφέρει τι διάβασε ή έγραψε κάθε εφαρμογή.
Τι συμβαίνει όταν ανακαλείται η συναίνεση;
Το επόμενο αίτημα με αυτό το access token αποτυγχάνει, το refresh token δεν μπορεί να χρησιμοποιηθεί για να αποκτηθεί ένα νέο, και ο διακομιστής σας λαμβάνει ένα webhook consent.revoked εάν έχει εγγραφεί.
Σχετικά
- Μοντέλο συναίνεσης και πρόσβασης: οι κανόνες αναλυτικά
- Έλεγχος ταυτότητας και OAuth: tokens, scopes και η ανταλλαγή κώδικα
- Πώς να υλοποιήσετε τη συναίνεση ασθενούς με SMART on FHIR
- Webhooks:
consent.grantedκαιconsent.revoked - Επεξήγηση προέλευσης ιατρικών δεδομένων
- API για διαχρονικά δεδομένα ασθενούς
Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card