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

रोगी की मंजूरी के साथ क्लिनिक एक्सेस अनुरोध (CIBA)

क्लिनिक एक्सेस अनुरोधों के पीछे OpenID CIBA फ़्लो: रिसेप्शन रोगी का ईमेल दर्ज करता है, रोगी 30, 90 या 365 दिनों के लिए ऐप में या ईमेल द्वारा अनुमोदन करता है, और क्लिनिक के एप्लिकेशन को टोकन प्राप्त होते हैं।

एक क्लिनिक Anpheros पर रोगी के रिकॉर्ड तक तभी पहुँचता है जब रोगी इसकी मंजूरी देता है। क्लिनिक का एप्लिकेशन रोगी के ईमेल पते और आवश्यक एक्सेस का नाम बताते हुए एक अनुरोध भेजता है। रोगी इसे Anpheros ऐप में और ईमेल द्वारा प्राप्त करता है, देखता है कि कौन और किस लिए पूछ रहा है, यह चुनता है कि इसे कितनी देर तक अनुमति देनी है, और मंजूरी देता है या मना करता है। यदि वे मंजूरी देते हैं, तो क्लिनिक के एप्लिकेशन को टोकन प्राप्त होते हैं और एक्सेस समाप्त होने या रोगी द्वारा वापस लेने तक रिकॉर्ड पढ़ सकते हैं।

यह प्रवाह मानक OpenID Connect Client-Initiated Backchannel Authentication (CIBA) प्रवाह है, पोल मोड में। यह इसलिए मौजूद है ताकि रिसेप्शनिस्ट को रोगी को फोन या लिंक देने की आवश्यकता न पड़े: अनुरोध रोगी के पास जाता है, क्लिनिक की स्क्रीन के माध्यम से नहीं।

चरण दर चरण

रिसेप्शन रोगी का ईमेल दर्ज करता है। क्लिनिक का एप्लिकेशन POST /oauth/bc-authorize को अपने क्लाइंट क्रेडेंशियल्स, रोगी के ईमेल को login_hint के रूप में, scope की आवश्यकता और एक छोटा binding_message जो रोगी देखेगा, के साथ कॉल करता है।
प्लेटफ़ॉर्म हर पते के लिए एक ही तरह से जवाब देता है। प्रतिक्रिया में एक auth_req_id, एक समाप्ति तिथि और एक पोलिंग अंतराल शामिल होता है, चाहे उस ईमेल का एंफ़ेरोस खाता हो या नहीं। यह खुलासा नहीं करता कि किसका रिकॉर्ड है। बिना खाते वाले व्यक्ति के लिए अनुरोध बस समाप्त हो जाता है।
रोगी निर्णय लेता है। उन्हें एंफ़ेरोस ऐप में एक सूचना और एक ईमेल प्राप्त होता है। अनुरोध संगठन, स्कोप और संदेश दिखाता है। वे 30, 90 या 365 दिनों की अवधि चुनते हैं और अनुमति दें या अस्वीकार करें पर क्लिक करते हैं। ईमेल में लिंक कुछ भी स्वीकृत नहीं करता है जब उसे खोला जाता है, क्योंकि मेल स्कैनर लिंक खोलते हैं; रोगी को बटन दबाना होगा।
क्लिनिक पोल करता है। एप्लिकेशन POST /oauth/token को ग्रांट टाइप urn:openid:params:grant-type:ciba और auth_req_id के साथ कॉल करता है। जब तक रोगी ने निर्णय नहीं लिया है, तब तक उत्तर authorization_pending है। अनुमोदन के बाद टोकन एक बार लौटा दिए जाते हैं। इनकार access_denied लौटाता है और अनुत्तरित अनुरोध expired_token लौटाता है।
क्लिनिक अनुमत स्कोप के भीतर पढ़ता है और लिखता है। हर रीड लॉग किया जाता है और रोगी के लिए दिखाई देता है। क्लिनिक केवल वही बदल या हटा सकता है जो उसने स्वयं लिखा हो।

रोगी की सुरक्षा कौन करता है

केवल सत्यापित ईमेल। एक अनुरोध केवल उस खाते से मेल खाता है जिसका ईमेल सत्यापित है, इसलिए कोई भी अपने पते के साथ खाता बनाकर किसी और के अनुरोध प्राप्त नहीं कर सकता है।
दायरे में और समय-सीमित। एक्सेस प्रति संसाधन प्रकार और क्रिया के लिए, एक निश्चित अवधि के लिए होता है। एक अनुरोध जिसका कोई जवाब नहीं देता है, वह डिफ़ॉल्ट रूप से एक दिन के भीतर और अधिकतम सात दिनों में समाप्त हो जाता है।
किसी भी समय रद्द किया जा सकता है। रद्दीकरण अगले अनुरोध पर प्रभावी होता है। क्लिनिक अपने तरीके से वापस ताज़ा नहीं कर सकता है।
दृश्यमान। रोगी ऐप में हर कनेक्शन और हर एक्सेस को देखता है। सहमति और एक्सेस मॉडल देखें।

क्लिनिक को क्या बनाने की आवश्यकता है

प्लेटफ़ॉर्म के साथ पंजीकृत एक गोपनीय OAuth क्लाइंट, जिसका सीक्रेट सर्वर पर रखा गया हो।
एक पोलिंग लूप जो अंतराल का सम्मान करता है और चार परिणामों को संभालता है।
मरीज़ के निर्णय को रिसेप्शन पर दिखाने का एक तरीका ("मरीज़ का इंतज़ार", "… तक स्वीकृत", "अस्वीकृत")।
अल्पकालिक क्रेडेंशियल्स के रूप में लौटाए गए टोकन को संभालना: एक्सेस टोकन 30 मिनट तक चलते हैं और रिफ्रेश टोकन हर उपयोग पर रोटेट होते हैं। प्रमाणीकरण और OAuth देखें।

उस क्लिनिक के लिए जो मरीज़ के सामने सहमति पृष्ठ खोलने को प्राथमिकता देता है, उदाहरण के लिए डेस्क पर, PKCE और SMART on FHIR स्टैंडअलोन लॉन्च के साथ मानक प्राधिकरण-कोड प्रवाह भी समर्थित है।

अक्सर पूछे जाने वाले प्रश्न

क्या मरीज़ को क्लिनिक में होना ज़रूरी है?

नहीं। वे अपने फ़ोन से या ईमेल लिंक से, जहाँ भी हों, मंज़ूरी दे सकते हैं। इसलिए अपॉइंटमेंट से पहले एक अनुरोध भेजा जा सकता है, और विदेश में रहने वाला मरीज़ भी उसे मंज़ूर कर सकता है।

क्या होगा अगर मरीज़ के पास Anpheros खाता न हो?

अनुरोध स्वीकार कर लिया जाता है और फिर बिना किसी निर्णय के समाप्त हो जाता है, और क्लिनिक यह नहीं बता सकता कि खाता मौजूद है या नहीं। मरीज़ एक खाता बना सकता है और क्लिनिक एक नया अनुरोध भेज सकता है।

एक्सेस कितने समय तक रहता है?

मरीज़ मंज़ूरी देते समय 30, 90 या 365 दिन चुनता है। वे इसे पहले वापस ले सकते हैं।

क्या क्लिनिक रिकॉर्ड में सब कुछ देख सकता है?

केवल वही स्कोप जिसे मरीज़ ने मंज़ूर किया है। स्कोप प्रति संसाधन प्रकार और क्रिया के लिए सेट किए जाते हैं, और श्रेणी के अनुसार फ़िल्टर किए जा सकते हैं।

क्या अनुरोध प्रवाह एक मानक है?

हाँ। यह OpenID Connect CIBA है, इसलिए मौजूदा OAuth लाइब्रेरी का उपयोग किया जा सकता है। व्यापक मॉडल के लिए मरीज़ की सहमति के साथ स्वास्थ्य सेवा API गाइड देखें।

क्या यह लाइव है?

हाँ, प्लेटफ़ॉर्म पर निजी बीटा में। प्रोडक्शन एक्सेस के लिए एक सत्यापित संगठन और एक हस्ताक्षरित डेटा प्रोसेसिंग समझौते की आवश्यकता होती है।