AnpherosAnpheros PlatformDevelopers

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, κάθε ανάγνωση και εγγραφή υπό αυτήν την άδεια καταγράφεται εκεί που το άτομο μπορεί να τη δει, και η ανάκληση τίθεται σε ισχύ στην επόμενη αίτηση. Αυτή η σελίδα δείχνει πώς λειτουργεί, τι πρέπει να κάνει η εφαρμογή σας και τι δεν χρειάζεται να δημιουργήσετε.

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

Γιατί η συγκατάθεση ανήκει στο επίπεδο δεδομένων

Οι περισσότερες εφαρμογές υγείας καταγράφουν τη συγκατάθεση ως ένα πλαίσιο ελέγχου στη δική τους βάση δεδομένων και στη συνέχεια την επιβάλλουν στον κώδικα της εφαρμογής. Αυτό λειτουργεί μέχρι μια δεύτερη εφαρμογή, μια κλινική ενσωμάτωση ή μια λειτουργία AI να χρειαστεί τα ίδια δεδομένα: κάθε μία πρέπει να επανεφαρμόσει τους κανόνες, και το άτομο δεν έχει ένα ενιαίο μέρος για να δει ποιος έχει πρόσβαση. Όταν η πλατφόρμα που αποθηκεύει την εγγραφή επιβάλλει επίσης τη συγκατάθεση, κάθε πελάτης λαμβάνει τους ίδιους κανόνες και το άτομο λαμβάνει μία λίστα εφαρμογών για αναθεώρηση.

Συγκατάθεση ως σημαία στην εφαρμογή σας Συγκατάθεση στο επίπεδο δεδομένων (Anpheros)
Πού επιβάλλεται Στον κώδικα κάθε εφαρμογής Σε κάθε αίτημα API, από την πλατφόρμα
Εύρος πρόσβασης Ό,τι αποφασίσει η εφαρμογή να διαβάσει Μόνο οι εκχωρημένοι τύποι και κατηγορίες πόρων
Λήξη Σπάνια υλοποιείται Επιλέγεται από το άτομο: 30, 90, 180 ή 365 ημέρες
Τι βλέπει το άτομο Εξαρτάται από την εφαρμογή Κάθε εφαρμογή, τα εύρη της και η λήξη της, και ένα αρχείο καταγραφής πρόσβασης
Ανάκληση Πρέπει να διαδοθεί χειροκίνητα Το επόμενο αίτημα αποτυγχάνει. Το token ανανέωσης σταματά να λειτουργεί.

Τι ελέγχει ο ασθενής

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

Πώς η εφαρμογή σας ζητά συναίνεση

Το 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

Συχνές Ερωτήσεις

Τι είναι μια πλατφόρμα συναίνεσης ασθενούς;

Λογισμικό που καταγράφει ποιες εφαρμογές επιτρέπει ένα άτομο να έχουν πρόσβαση στα δεδομένα υγείας του, επιβάλλει αυτές τις επιλογές σε κάθε αίτημα, δείχνει στο άτομο ποιος απέκτησε πρόσβαση σε τι και του επιτρέπει να ανακαλέσει την πρόσβαση. Στο 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 εάν έχει εγγραφεί.

Σχετικά

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

Product updates by email

New features, guides and the end of the beta. One email a month at most.

Send me occasional Anpheros Platform updates by email (new features, API changes, guides). I'll confirm by email and can unsubscribe in one click from any email. Privacy