كيف يعمل "بروتوكول OAuth الثلاثي"؟

ORCID تستخدم عمليات الدمج "بروتوكول OAuth الثلاثي" لمصادقة المستخدمين وطلب إذن للتفاعل مع سجلاتهم. يمكن لأي تكامل أن يطلب أذونات القراءة باستخدام واجهة برمجة التطبيقات العامة. ORCID يمكن للأعضاء استخدام Member API لطلب أذونات التحديث. يعمل مثل هذا:

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

يتضمن عنوان URL المخصص للتفويض معلومات العميل الخاصة بك، بالإضافة إلى "النطاقات" التي تحدد المناطق المحددة في السجل الخاص به والتي ترغب في الوصول إليها. بعد تسجيل الدخول، يقوم المستخدم بتفويض الاتصال بنظامك ويتم إعادته إلى صفحتك المقصودة مع رمز التفويض. ثم يتم استخدام هذا الرمز للحصول على ORCID iD جنبًا إلى جنب مع رمز وصول صالح للنطاقات المطلوبة.

بناء رابط التفويض والحصول على رمز التفويض

يمكنك إنشاء رابط التفويض الخاص بك عن طريق تحديد معرف العميل الخاص ببيانات اعتماد واجهة برمجة التطبيقات الخاصة بك وصفحة الوصول المرتبطة (URI لإعادة التوجيه). يمكنك اختيار الأذونات التي تريد طلبها عن طريق ضبط معلمة النطاق.

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

https://sandbox.orcid.org/oauth/authorize?client_id=[Your client ID]&response_type=code&scope=/read-limited&redirect_uri=[Your landing page]

قام المستخدم بالنقر فوق الارتباط ، وقم بتسجيل الدخول في ORCID ومنحهم أذونات ، تمت إعادة توجيههم مرة أخرى إلى موقعك ، على النحو التالي:

https://[Your landing page]?code=Q70Y3A

استبدل رمز التفويض بملف ORCID iD ورمز الوصول

يجب أن تقوم على الفور بتبادل رمز التفويض الخاص بـ ORCID iD ورمز الوصول. تنتهي صلاحية رمز التفويض عند الاستخدام. الطلب يبدو مثل هذا و لا يمكن إجراؤها في متصفح الويب، يجب أن يتم بواسطة الخادم الخاص بك.

 URL=https://sandbox.orcid.org/oauth/token
  HEADER: Accept: application/json
  HEADER: Content-Type: application/x-www-form-urlencoded
  METHOD: POST
  DATA: 
    client_id=[Your client ID]
    client_secret=[Your client secret]
    grant_type=authorization_code
    code=Six-digit code
    redirect_uri=[Your landing page]

ORCID سيعيد الباحث بعد ذلك مصدقًا عليه ORCID iD ورمز وصول بتنسيق JSON:

{"access_token":"f5af9f51-07e6-4332-8f1a-c0c11c1e3728","token_type":"bearer",
"refresh_token":"f725f747-3a65-49f6-a231-3e8944ce464d","expires_in":631138518,
"scope":"/read-limited","name":"Sofia Garcia","orcid":"0000-0001-2345-6789"}

تدوم رموز الوصول لفترة طويلة افتراضيًا وتنتهي بعد 20 عامًا من الإصدار. يمكن استخدام الرمز المميز عدة مرات قبل انتهاء صلاحيته.

استخدم رمز الوصول

ترتبط رموز الوصول ثلاثية الأرجل بمواقع محددة ORCID سِجِلّ. لاستخدامها، عليك تضمينها في طلبات API التي تجريها لقراءة هذا السجل أو تحديثه.