تتيح ميزة الدخول المُوحَّد (SSO) في Apigee نوعَين من ملفات المصادقة الشخصية التي كان يديرها سابقًا النص البرمجي القديم apigee-ssoadminapi.sh:
تتيح لك الأداة المساعدة apigee-machineuser.sh إدارة حسابات المستخدمين على الأجهزة بدون واجهة مستخدم رسومية مباشرةً في OpenLDAP.
لمحة عن عملاء OAuth (المشرفون سابقًا)
في الإصدارات السابقة من Edge، كنت تستخدم أوامر admin في الأداة المساعدة apigee-ssoadminapi.sh لإنشاء عملاء OAuth ديناميكيًا في قاعدة بيانات UAA. في الإصدار 4.54.00، تعتمد خدمة Apigee SSO على نموذج إعدادات تعريفية (GitOps).
لم تعُد تستخدم نصًا برمجيًا لواجهة سطر الأوامر (CLI) لإنشاء عملاء OAuth لأنّهم أصبحوا ثابتين الآن. يتم تحديد إعدادات العميل لواجهة مستخدم Edge في /opt/silent.conf. في المقابل، يتم ضبط العميل المستخدَم لمستخدمي الآلات (edgecli) بشكلٍ ضِمني في خدمة "الدخول المُوحَّد في Apigee".
لمحة عن مستخدمي الأجهزة
يمكن لمستخدم الآلة الحصول على رموز مميّزة OIDC/OAuth2 من خلال منح كلمة مرور عادية بدون الحاجة إلى متصفّح أو مصادقة تفاعلية متعدّدة العوامل. وهذا يعني أنّه يمكنك إتمام عملية الحصول على الرموز المميزة وتحديثها بشكل آلي بالكامل لمسارات التعلّم "الدمج المستمر" (CI) أو "النشر المستمر" (CD) والبرامج النصية.
عند إنشاء مستخدم جهاز باستخدام الأداة المساعدة apigee-machineuser.sh، يتم إنشاء الحساب مباشرةً في دليل OpenLDAP المحلي ويتم وضع علامة employeeType: machineuser عليه بشكل صريح. تتيح هذه العلامة لميزة الدخول المُوحَّد (SSO) في Apigee مصادقة مستخدم الجهاز بشكل آمن من خلال منح كلمة مرور، حتى في حال فرض استخدام SAML/OIDC الموحَّد بشكل صارم على المستخدمين البشريين.
استدعاء الأداة المساعدة apigee-machineuser.sh
يتم تثبيت الأداة المساعدة apigee-machineuser.sh تلقائيًا على العقدة التي تستضيف المكوّن apigee-openldap في المسار التالي:
/opt/apigee/apigee-openldap/bin/apigee-machineuser.sh
الأوامر المتاحة للأداة المساعدة هي:
-
add: لإنشاء مستخدم جهاز جديد في OpenLDAP -
list: تعرض هذه السمة قائمة بجميع مستخدمي الأجهزة المسجَّلين في OpenLDAP. -
setpassword: لتعديل كلمة المرور لمستخدم جهاز حالي delete: يزيل مستخدم الجهاز نهائيًا من OpenLDAP.
إضافة مستخدم آلي
استخدِم الأمر add مع علامتَي -u و-p لإنشاء مستخدم جهاز جديد.
/opt/apigee/apigee-openldap/bin/apigee-machineuser.sh add -u jenkins-bot@apigee.com -p BotSecret123!
الناتج:
Machine user 'jenkins-bot@apigee.com' created successfully in OpenLDAP.
عرض قائمة بجميع مستخدمي الآلة
استخدِم الأمر list لعرض جميع مستخدمي الأجهزة المسجَّلين حاليًا في OpenLDAP. تتم فلترة المستخدمين من هذه القائمة.
/opt/apigee/apigee-openldap/bin/apigee-machineuser.sh list
الناتج:
Listing all machine users in OpenLDAP: dn: uid=jenkins-bot@apigee.com,ou=users,ou=global,dc=apigee,dc=com uid: jenkins-bot@apigee.com mail: jenkins-bot@apigee.com
إعادة ضبط كلمة مرور مستخدم جهاز
استخدِم الأمر setpassword لتعديل كلمة المرور لمستخدم جهاز حالي.
/opt/apigee/apigee-openldap/bin/apigee-machineuser.sh setpassword -u jenkins-bot@apigee.com -p NewSecret456!
الناتج:
Password for machine user 'jenkins-bot@apigee.com' updated successfully.
حذف مستخدم آلي
استخدِم الأمر delete لإزالة مستخدم جهاز نهائيًا من OpenLDAP.
/opt/apigee/apigee-openldap/bin/apigee-machineuser.sh delete -u jenkins-bot@apigee.com
الناتج:
Machine user 'jenkins-bot@apigee.com' deleted successfully from OpenLDAP.