استخدام أدوات المشرف وواجهات برمجة التطبيقات في Edge بعد تفعيل الدخول المُوحَّد (SSO) في Apigee

يوضِّح هذا القسم كيفية تشغيل أدوات وطلبات مشرف نظام Edge بعد تفعيل خدمة Apigee SSO. تتطلّب العديد من المهام على Edge بيانات اعتماد مشرف النظام، مثل:

  • إنشاء المؤسسات والبيئات
  • إضافة وإزالة مكوّنات Edge
  • تشغيل أوامر apigee-adminapi.sh

بعد تفعيل خدمة "الدخول المُوحَّد" (SSO) على Edge، يتم عادةً إيقاف المصادقة الأساسية بحيث تكون الطريقة الوحيدة للمصادقة هي من خلال موفِّر الهوية OIDC/SAML. لذلك، يجب التأكّد من إضافة حساب مشرف النظام إلى موفِّر الهوية أو إنشاء مستخدم آلة محلي لأغراض التشغيل الآلي.

استدعاء واجهات برمجة تطبيقات إدارة Edge بصفتك مشرف النظام

تتطلّب العديد من طلبات بيانات من واجهة برمجة تطبيقات Edge منك تمرير بيانات اعتماد مشرف النظام. يحتوي المستند استخدام SAML مع واجهة برمجة تطبيقات إدارة Edge على تعليمات حول كيفية الحصول على الرموز المميّزة وتجديدها باستخدام الأداة get_token عند إجراء طلبات إلى واجهة برمجة تطبيقات إدارة Edge.

استخدام الأداة `apigee-adminapi.sh` مع خدمة Apigee SSO

استخدِم الأداة apigee-adminapi.sh لتنفيذ مهام إعداد Edge نفسها التي تنفّذها من خلال إجراء طلبات إلى واجهة برمجة تطبيقات إدارة Edge. تتميّز الأداة apigee-adminapi.sh بما يلي:

  • استخدام واجهة سطر أوامر بسيطة
  • تنفيذ إكمال الأوامر المستند إلى علامات التبويب
  • توفير معلومات المساعدة والاستخدام
  • إمكانية عرض طلب بيانات من واجهة برمجة التطبيقات المقابل إذا قرّرت تجربة واجهة برمجة التطبيقات

بعد تفعيل خدمة Apigee SSO، لديك طريقتان أساسيتان لتمرير بيانات الاعتماد إلى الأداة apigee-adminapi.sh، وذلك حسب ما إذا كنت مشرفًا بشريًا أو نصًا برمجيًا آليًا.

يمكنك الاطّلاع على جميع خيارات أي أمر apigee-adminapi.sh، بما في ذلك خيارات تحديد بيانات اعتماد "الدخول المُوحَّد" (SSO)، باستخدام الخيار -h للأمر. مثال:

apigee-adminapi.sh orgs list -h

تمرير رمز مميّز للحامل (للمشرفين البشريين)

بما أنّ خدمة Apigee SSO الحديثة لا تتيح عملية النسخ واللصق القديمة لرمز المرور /passcode، يجب أن يستخدم المشرفون البشريون الأداة get_token لإكمال عملية رمز الجهاز في OAuth 2.0، ثم تمرير الرمز المميّز الناتج إلى النص البرمجي.

أولاً، احصل على رمز مميّز:

/opt/apigee/apigee-openldap/bin/get_token -u adminEmail

بعد ذلك، استخدِم الرمز المميّز عند استدعاء الأمر:

apigee-adminapi.sh orgs list --sso-url http://edge_sso_IP_DNS:9099 --oauth-flow passcode \
  --admin adminEmail --oauth-token token_string

المكان:

  • oauth-flow تحدِّد passcode (يشير ذلك إلى النص البرمجي القديم إلى أنّه يتم تقديم رمز مميّز).
  • oauth-token يحتوي على سلسلة JWT الأولية التي تم الحصول عليها من get_token.

تمرير كلمة مرور (لمستخدمي الآلة فقط)

إذا كنت تعمل على أتمتة عمليات نشر البنية الأساسية، يمكنك تمرير بيانات الاعتماد مباشرةً باستخدام عملية password_grant. ومع ذلك، إذا تم تفعيل الربط بين SAML/OIDC، يتم منع المستخدمين الوهميين البشريين من تسجيل الدخول باستخدام كلمة المرور لمنع تجاوز المصادقة الثنائية. يجب أولاً توفير مستخدم آلة صريح في OpenLDAP.

apigee-adminapi.sh orgs list --sso-url http://edge_sso_IP_DNS:9099 --oauth-flow password_grant \
  --admin machineUserEmail --oauth-password machineUserPassword

المكان:

  • يحدِّد الخيار sso-url عنوان URL لخدمة Apigee SSO. عدِّل المنفذ أو البروتوكول إذا غيّرتهما من 9099 وHTTP.
  • oauth-flow تحدِّد password_grant.
  • machineUserEmail هو عنوان البريد الإلكتروني لمستخدم الآلة الآلي.
  • oauth-password تحدِّد كلمة مرور مستخدم الآلة.

استخدام أدوات Edge مع خدمة Apigee SSO

تتطلّب العديد من أدوات Edge بيانات اعتماد مشرف النظام، مثل:

  • apigee-provision تُستخدَم لإنشاء المؤسسات والبيئات والمضيفين الظاهريين
  • setup.sh تُستخدَم لإضافة عُقد إلى نظام حالي
  • أي أداة أخرى يجب فيها تحديد بيانات اعتماد مشرف النظام في ملف إعداد

تأخذ هذه الأدوات كإدخال ملف إعداد يحدِّد بيانات اعتماد مشرف النظام. قبل تفعيل خدمة "الدخول المُوحَّد" (SSO)، يتم ذلك باستخدام الخصائص التالية:

ADMIN_EMAIL="adminEmail"
APIGEE_ADMINPW="adminPWord"

بعد تفعيل خدمة Apigee SSO، يجب استخدام خصائص مختلفة لتحديد بيانات اعتماد مشرف النظام.

استخدام رمز مميّز للحامل (للمشرفين البشريين)

بالنسبة إلى عمليات النشر التفاعلية التي يجريها المشرفون البشريون، احصل على رمز مميّز باستخدام الأداة get_token وقدِّمه من خلال السمة OAUTH_BEARER_TOKEN:

ADMIN_EMAIL="adminEmail"
SSO_LOGIN_URL="http://edge_sso_IP_DNS:9099"
OAUTH_FLOW="passcode"
OAUTH_BEARER_TOKEN="token_string"

المكان:

  • OAUTH_FLOW تحدِّد passcode (يشير ذلك إلى أنّه يتم تقديم رمز مميّز).
  • OAUTH_BEARER_TOKEN يحتوي على سلسلة JWT الأولية التي تم الحصول عليها من get_token.

استخدام كلمة مرور (لمستخدمي الآلة فقط)

بالنسبة إلى عمليات النشر الآلية بالكامل، قدِّم بيانات اعتماد مستخدم آلة تم توفيره بشكل صريح باستخدام عملية password_grant:

ADMIN_EMAIL="machineUserEmail"
SSO_LOGIN_URL="http://edge_sso_IP_DNS:9099"
OAUTH_FLOW="password_grant"
OAUTH_ADMIN_PASSWORD="machineUserPassword"

المكان:

  • SSO_LOGIN_URL تحدِّد عنوان URL لخدمة Apigee SSO.
  • OAUTH_FLOW تحدِّد password_grant.
  • OAUTH_ADMIN_PASSWORD تحدِّد كلمة مرور مستخدم الآلة.