المصادقة الأساسية هي إحدى طرق المصادقة عند إجراء طلبات إلى Edge management API.
على سبيل المثال، يمكنك إجراء طلب curl التالي إلى Edge management API للوصول إلى
معلومات عن مؤسستك:
curl -u USER_NAME:PASSWORD http://MS_IP_DNS:8080/v1/organizations/ORG_NAME
في هذا المثال، يمكنك استخدام الخيار curl -u لتمرير بيانات اعتماد المصادقة الأساسية. بدلاً من ذلك، يمكنك تمرير رمز OIDC/OAuth2 المميّز في العنوان Authorization: Bearer لإجراء طلبات بيانات من واجهة برمجة التطبيقات Edge management API، كما هو موضّح في المثال التالي:
curl -H "Authorization: Bearer ACCESS_TOKEN" http://MS_IP_DNS:8080/v1/organizations/ORG_NAME
بعد تفعيل موفّر الهوية الخارجي للمصادقة، يمكنك اختياريًا إيقاف المصادقة الأساسية. إذا أوقفت المصادقة الأساسية، لن تعمل بعد ذلك جميع النصوص البرمجية (مثل Maven وShell وapigeetool) التي
تعتمد على طلبات Edge management API التي تتيح المصادقة الأساسية. عليك تعديل
أي طلبات بيانات من واجهة برمجة التطبيقات ونصوص برمجية تستخدم المصادقة الأساسية لتمرير رموز OAuth2 المميزة للدخول في الـ
Bearer رأس.
الحصول على الرموز المميّزة وتحديثها باستخدام `get_token`
تستخدم الأداة get_token مسار رمز الجهاز القياسي في OAuth 2.0 للحصول على رموز OIDC/OAuth2 المميزة للدخول والرمز المميز لإعادة التحميل. تطلب منك الأداة الانتقال إلى عنوان URL في متصفحك للمصادقة من خلال موفّر الهوية الخارجي (أو LDAP المحلي)، ثم تزيل تلقائيًا حظر المحطة الطرفية لعرض رمز الدخول المميّز الصالح.
تخزّن الأداة get_token الرموز المميّزة بشكل آمن على القرص في ~/.sso-cli/، لتكون جاهزة للاستخدام عند الحاجة. تعرض الأداة أيضًا رمز دخول مميّزًا صالحًا على stdout. إذا كان من الممكن إعادة تحميل رمز مميّز حالي، ستعيد الأداة تحميله تلقائيًا. إذا انتهت صلاحية الرمز المميز لإعادة التحميل، ستبدأ الأداة مسار ترخيص جديدًا مستندًا إلى المتصفح.
للحصول على رمز OAuth2 مميّز للدخول لإجراء طلبات Edge management API، اتّبِع الخطوات التالية:
- يتم تثبيت الأداتَين
get_tokenوacurlمسبقًا على العُقدة التي تستضيف Apigee SSO (عُقدة OpenLDAP) في المسار:/opt/apigee/apigee-openldap/bin/ - (اختياري) اضبط متغيّر البيئة
SSO_LOGIN_URLعلى عنوان URL لمصدر الدخول المُوحَّد (SSO)، بالصيغة التالية:export SSO_LOGIN_URL="http://EDGE_SSO_IP_DNS:9099"
حيث EDGE_SSO_IP_DNS هو عنوان IP أو اسم نظام أسماء النطاقات (DNS) للجهاز الذي يستضيف Apigee SSO. إذا ضبطت بروتوكول أمان طبقة النقل (TLS) على Apigee SSO، استخدِم
httpsورقم منفذ بروتوكول أمان طبقة النقل الصحيح. - استخدِم الأمر
get_tokenمع عنوان بريدك الإلكتروني لبدء مسار رمز الجهاز في OAuth 2.0:/opt/apigee/apigee-openldap/bin/get_token -u EMAIL_ADDRESS
حيث EMAIL_ADDRESS هو عنوان البريد الإلكتروني لمستخدم Edge.
- ستتوقف الأداة وتعرض عنوان URL ورمز جهاز مكوّنًا من 8 أحرف على المحطة الطرفية:
Please visit: http://EDGE_SSO_IP_DNS:9099/device And enter code: ABCD-EFGH
- افتح عنوان URL المحدّد في متصفحك، وأدخِل رمز الجهاز، وانقر على إرسال. ستتم إعادة توجيهك إلى موفّر الهوية الخارجي (أو نموذج LDAP المحلي) للمصادقة والموافقة على الطلب.
- بعد المصادقة بنجاح في المتصفح، ارجع إلى المحطة الطرفية. ستكتشف الأداة
get_tokenالموافقة تلقائيًا، وتحصل على رمز OAuth2 المميّز للدخول، وتعرضه على الشاشة، وتخزّنه مؤقتًا بشكل آمن. - مرِّر رمز الدخول المميّز إلى طلب Edge management API باستخدام الأداة
acurl، التي تقرأ تلقائيًا الرمز المميّز المخزّن مؤقتًا وتُدرِج العنوان Bearer:/opt/apigee/apigee-openldap/bin/acurl http://MS_IP_DNS:8080/v1/organizations/ORG_NAME
بدلاً من ذلك، يمكنك تمرير الرمز المميّز يدويًا باستخدام الأمر
curlالعادي:curl -H "Authorization: Bearer ACCESS_TOKEN" \ http://MS_IP_DNS:8080/v1/organizations/ORG_NAME
استخدام Management API للحصول على الرموز المميّزة وإعادة تحميلها
تمت إزالة نقطة النهاية القديمة /passcode. لذلك، على المستخدمين من البشر استخدام الأداة get_token كما هو موضّح سابقًا لبدء مسار رمز الجهاز في OAuth 2.0 المستند إلى المتصفح للمصادقة الأولية.
إذا كنت تكتب نصوصًا برمجية أو مسارات CI/CD لا يمكنها التفاعل مع متصفح، اطّلِع على مقالة التشغيل الآلي للمهام باستخدام حسابات المستخدمين من الآلات. يمكن للمستخدمين من الآلات أو التطبيقات الآلية التي لديها بيانات اعتماد صالحة استخدام طلبات بيانات من واجهة برمجة التطبيقات العادية للحصول على الرمز المميز لإعادة التحميل وتحديثه.