التخطي إلى المحتوى الرئيسي

استخدام Casdoor كخادم OAuth2 في ShowDoc

استخدام Casdoor للمصادقة في ShowDoc​

ShowDoc هو أداة توثيق API عبر الإنترنت وتوثيق فني مثالية لفرق تكنولوجيا المعلومات. يجعل ShowDoc من السهل استخدام بناء جمل Markdown لكتابة وثائق API جميلة، وثائق قاموس البيانات، وثائق فنية، وثائق Excel عبر الإنترنت، والمزيد.

يدعم ShowDoc المصادقة الخارجية، بما في ذلك OAuth2. إليك دليل لتحقيق ذلك.

الخطوة 1: إنشاء تطبيق Casdoor​

اذهب إلى Casdoor الخاص بك وأضف تطبيقًا جديدًا يسمى ShowDoc. إليك مثال على إنشاء تطبيق ShowDoc في Casdoor.

create_application.png

يرجى تذكر client ID و client Secret للخطوة التالية.

معلومات

يرجى عدم ملء callback URL في هذه الخطوة. يعتمد الرابط على التكوينات في ShowDoc في الخطوة التالية. سنعود لتعيين رابط callback صحيح لاحقًا.

الخطوة 2: تكوين ShowDoc​

أولاً، قم بتمكين زر تسجيل الدخول OAuth2. ثم، املأ callback URL كما هو موضح في المثال. املأ client ID و client secret الذي تم تذكره في الخطوة السابقة.

showdoc_oauth2.png

Authorize path، AccessToken path، و User info path مطلوبة. يمكنك ملؤها كما هو موضح أدناه.

Authorize path:   /login/oauth/authorize
AccessToken path:   /api/login/oauth/access_token
User info path:   /api/get-account

الخطوة 3: تكوين رابط Callback في Casdoor​

عد إلى صفحة تحرير التطبيق في الخطوة 1 وأضف callback URL الذي قمت بملئه في ShowDoc.

showdoc_callbackurl.png

الخطوة 4: جرب على ShowDoc​

يجب أن ترى ما يلي على صفحة تسجيل الدخول:

showdoc_login.png

مبروك! لقد أكملت جميع الخطوات. اضغط على زر 'Casdoor SSO'، وسيتم تحويلك إلى صفحة تسجيل الدخول Casdoor.