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

طلبات وصول العيادة بموافقة المريض (CIBA)

تدفق OpenID CIBA وراء طلبات وصول العيادة: يقوم الاستقبال بإدخال البريد الإلكتروني للمريض، ويوافق المريض في التطبيق أو عبر البريد الإلكتروني لمدة 30 أو 90 أو 365 يومًا، ويتلقى تطبيق العيادة الرموز (tokens).

لا تصل العيادة إلى سجل المريض على Anpheros إلا عندما يوافق المريض عليه. يرسل تطبيق العيادة طلبًا يحدد عنوان البريد الإلكتروني للمريض والوصول الذي يحتاجه. يتلقى المريض هذا الطلب في تطبيق Anpheros وعبر البريد الإلكتروني، ويرى من يطلب وماذا يطلب، ويختار المدة التي يسمح بها، ويوافق أو يرفض. إذا وافق، يتلقى تطبيق العيادة الرموز ويمكنه قراءة السجل حتى تنتهي صلاحية الوصول أو يسحبه المريض.

التدفق هو تدفق OpenID Connect Client-Initiated Backchannel Authentication (CIBA) القياسي، في وضع الاستطلاع (poll mode). وهو موجود حتى لا يحتاج موظف الاستقبال إلى تسليم الهاتف أو رابط للمريض: يذهب الطلب إلى المريض، وليس عبر شاشة العيادة.

خطوة بخطوة

تدخل الاستقبال بريد المريض الإلكتروني. يتصل تطبيق العيادة بـ POST /oauth/bc-authorize باستخدام بيانات اعتماد العميل الخاصة به، وبريد المريض الإلكتروني كـ login_hint، و scope الذي يحتاجه، و binding_message قصير سيراه المريض.
ترد المنصة بنفس الطريقة لكل عنوان. يحتوي الرد على auth_req_id، وتاريخ انتهاء صلاحية، وفترة استطلاع، سواء كان لهذا البريد الإلكتروني حساب Anpheros أم لا. لا يكشف عن من لديه سجل. الطلب لشخص ليس لديه حساب ينتهي ببساطة.
يقرر المريض. يتلقى إشعارًا في تطبيق Anpheros وبريدًا إلكترونيًا. يعرض الطلب المنظمة والنطاق والرسالة. يختار فترة 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 الحالية. انظر دليل واجهة برمجة تطبيقات الرعاية الصحية بموافقة المريض للنموذج الأوسع.

هل هذا مباشر؟

نعم، على المنصة في مرحلة تجريبية خاصة. يتطلب الوصول إلى الإنتاج منظمة معتمدة واتفاقية معالجة بيانات موقعة.

ذات الصلة

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