عند مطالبة المستخدمين بإنشاء ملفات ORCID iD إلى نظامك ، يمكنك توفير الوقت والجهد على الباحثين لديك عن طريق ملء المعلومات التي قام نظامك بتخزينها بالفعل عنهم ، وتعيين لغة العرض الخاصة بهم ، وتسجيل خروجهم من أي جلسات نشطة للتأكد من تسجيلهم للدخول الصحيح ORCID حساب.
• ORCID تقدم واجهات برمجة التطبيقات عدة خيارات لتخصيص تجربة المستخدم
املأ نموذج التسجيل / تسجيل الدخول مسبقًا
ORCID يقدم خيارًا للأعضاء لملء نموذج تسجيل/تسجيل الدخول OAuth مسبقًا كجزء من تفاعل واجهة برمجة التطبيقات باستخدام المعلمات الموجودة على عنوان URL https://orcid.org/oauth/authorize
يمكن استخدام أي من المعلمات أو جميعها:
| معامل | الحقل | ملاحظة |
| أسماء مسماه | الاسم المعطى | • الاسم الاول سيتم ملء الحقل في استمارة التسجيل إذا كان عنوان البريد الإلكتروني المحدد أو ORCID iD لا يتطابق مع ملف ORCID سجل. |
| اسماء العائلة | اسم العائلة | • الكنية سيتم ملء الحقل في استمارة التسجيل إذا كان عنوان البريد الإلكتروني المحدد أو ORCID iD لا يتطابق مع ملف ORCID سجل. |
| البريد الإلكتروني | البريد الإلكتروني | • البريد الإلكتروني/ORCID iD سيتم ملء الحقل في نموذج تسجيل الدخول إذا تم العثور على عنوان البريد الإلكتروني المحدد في نظامنا ولم يكن صالحًا ORCID iD محدد البريد الإلكتروني سيتم ملء الحقل في استمارة التسجيل إذا تم العثور على عنوان البريد الإلكتروني المحدد في نظامنا ولم يكن صالحًا ORCID iD يجب أن يكون عنوان البريد الإلكتروني URL المشفر، بما في ذلك تغيير "@" إلى "٪ 40". إذا كنت تعرف المستخدم ORCID iD وعنوان البريد الإلكتروني ، نقترح فقط توفير ORCID iD في معلمة orcid. |
| أوركيد | ORCID iD | • البريد الإلكتروني/ORCID iD سيتم ملء الحقل في نموذج تسجيل الدخول إذا كان المحدد ORCID iD موجود في نظامنا استمارة التسجيل سيتم عرض خلاف ذلك إذا كان المحدد ORCID iD غير موجود في نظامنا ORCID iD يجب أن يكون في 16 رقمًا بتنسيق iD URI. |
مثال URL مع هذه المعلمات هو
https://sandbox.orcid.org/oauth/authorize?client_id=APP-NPXKK6HFN6TJ4YYIn&response_type=coden&scope=/authenticaten&redirect_uri=https%3A%2F%2Fdevelopers.google.com%2Foauthplaygroundn&family_names=Finn&given_names=Huckleberry&email=huckle%40mailinator.com
0
0
اضبط لغة العرض
ORCID يقدم خيار تحديد لغة العرض لنموذج تسجيل/تسجيل الدخول في OAuth كجزء من تفاعل واجهة برمجة التطبيقات باستخدام معلمة "lang" على عنوان URL https://orcid.org/oauth/authorize. سيؤدي هذا أيضًا إلى تعيين تفضيلات لغة العرض للمستخدم.
المستخدمين يمكنهم تغيير لغة العرض الخاصة بهم من تلقاء أنفسهم في أي وقت. تتوفر إعدادات اللغة التالية:
| اللغة | رمز |
| عربى (عربي) | ar |
| شيشتينا (تشيك) | cs |
| انجليزي | en |
| الاسبانية (الإسبانية) | es |
| الفرنسية (الفرنسية) | fr |
| الألمانية (الألمانية) | de |
| إيطاليانو (إيطالي) | it |
| Japanese (اليابانية) | ja |
| 한국어 (كوري) | ko |
| بولسكي (بولندي) | pl |
| البرتغالية (البرتغالية) | pt |
| Русский (الروسية) | ru |
| Türkçe (التركية) | tr |
| 简体 中文 (الصينية المبسطة) | zh_CN |
| 繁體 中文 (الصينية التقليدية) | ZH_TW |
0
0
مثال
هذا المثال يملأ النموذج مسبقًا ويضبط اللغة على الإسبانية
https://sandbox.orcid.org/oauth/authorize?client_id=APP-NPXKK6HFN6TJ4YYI
&response_type=code
&scope=/authenticate
&redirect_uri=https%3A%2F%2Fdevelopers.google.com%2Foauthplayground
&family_names=Finn&given_names=Huckleberry&email=huck%40mailinator.com
&lang=es افتراضيًا في نموذج تسجيل الدخول أو نموذج التسجيل
في الوقت الراهن ORCID تقدم شاشة OAuth نموذج تسجيل الدخول بشكل افتراضي وتوفر رابطًا للتبديل إلى نموذج التسجيل. بغض النظر عن السلوك الافتراضي ، يمكن تعيين النموذج المعروض عن طريق إضافة المعلمة "& show_login = true" لعرض نموذج تسجيل الدخول أو "& show_login = false" لعرض نموذج التسجيل. لاحظ أنه إذا كان عنوان البريد الإلكتروني أو ORCID iD في عنوان URL ، سيتم تحديد النموذج الموضح بواسطة هذه المعلمات وسيتم تجاهل المعلمة & show_login.
ORCID نوصي بشدة بأفضل ممارسة للسماح للمستخدمين النهائيين بتغيير حجم نافذة تسجيل الدخول إلى OAuth من أجل تحسين إمكانية الوصول ، بما يتماشى مع قيمنا المتعلقة بالتضمين.
حدد الباحث بمعامل "حالة" مخصص
يتم استخدام هذا من قبل بعض عمليات التكامل لأسباب فنية. ولا يظهر على شاشة تسجيل الدخول.
يمكن تضمين معلمة الحالة مع عنوان URL للترخيص من أجل تحديد هوية المستخدم ، مثل تسلسل فريد من الأرقام يترجم إلى المعرف الداخلي للمستخدم داخل نظامك. لا تؤثر المعلمة على تجربة المستخدم ، ولكن سيتم إرجاعها مع رمز التفويض ويمكن استخدامها لتحديد المستخدم أو الجلسة. يتم أيضًا إرجاع معلمة الحالة إذا رفض المستخدم الوصول.
يرجى ملاحظة أن معلمة الحالة لها حد 2000 حرف.
اختياريًا ، قم بفرض تسجيل الخروج
يمكنك تسجيل خروج المستخدم إذا كنت قلقًا من وجود عدة مستخدمين على جهاز واحد.
إذا كنت قلقًا بشأن وجود عدة مستخدمين على نفس الجهاز وعدم تسجيل الخروج بين الجلسات ، فيمكنك إجبارهم على إعادة المصادقة أثناء عملية OAuth. ببساطة قم بتضمين prompt=login في طلب OAuth. يمكنك أيضًا تعيين max_age بالثواني لإجبار المستخدمين على إعادة المصادقة إذا كانت جلستهم تتجاوز مدة معينة. انظر لدينا وثائق OpenID Connect لمزيد من التفاصيل.
0
1
تخطي التفويض
ORCID يتخطى التفويض في ظروف معينة.
إذا كان رمز الدخول النشط موجودًا بالفعل بنفس النطاقات التي يطلبها عنوان URL لتفويض OAuth ، وكان المستخدم قد سجل الدخول ORCID سجل ، فلن تتم مطالبتهم بمنح الإذن مرة أخرى. وبدلاً من ذلك ، سيتم نقلهم مباشرةً إلى عنوان URI لإعادة التوجيه. إذا كنت تريد أن تطلب من المستخدم منح الإذن في كل مرة يتصل فيها ، فاستخدم طريقة فرض الخروج
1
0