Apigee SSO از دو نوع نمایه‌های اصالت‌سنجی پشتیبانی می‌کند که قبلاً توسط نوشتار apigee-ssoadminapi.sh قدیمی مدیریت می‌شد:
ابزار apigee-machineuser.sh به شما امکان می‌دهد حساب‌های کاربری ماشین بدون نمایشگر را مستقیماً در OpenLDAP مدیریت کنید.
درباره کارخواه‌های OAuth (با نام سابق «سرپرستان»)
در نسخه‌های قبلی Edge، از فرمان‌های admin در ابزار apigee-ssoadminapi.sh برای ایجاد پویای کارخواه‌های OAuth در پایگاه داده UAA استفاده می‌کردید. در نسخه ۴.۵۴.۰۰، Apigee SSO به مدل پیکربندی اعلانی (GitOps) متکی است.
دیگر از دستورگان CLI برای ایجاد کارخواه‌های OAuth استفاده نمی‌کنید زیرا اکنون این کارخواه‌ها ایستا هستند. پیکربندی کارخواه برای Edge UI در /opt/silent.conf تعریف شده است. درحالی‌که کارخواه مورداستفاده برای کاربران ماشین (edgecli) به‌طور ضمنی در Apigee SSO پیکربندی شده است.
درباره کاربران ماشینی
کاربر ماشین می‌تواند ازطریق اعطای گذرواژه استاندارد، بدون نیاز به مرورگر یا MFA تعاملی، به نشان‌های OIDC/OAuth2 دسترسی پیدا کند. این یعنی می‌توانید فرایند دریافت و بازآوری کردن ژتون‌ها را برای خطوط لوله و اسکریپت‌های CI/CD کاملاً خودکار کنید.
وقتی کاربر ماشینی را با ابزار کمکی apigee-machineuser.sh ایجاد می‌کنید، حساب مستقیماً در فهرست راهنمای OpenLDAP محلی ایجاد می‌شود و به‌طور صریح با employeeType: machineuser برچسب‌گذاری می‌شود. این برچسب به Apigee SSO اجازه می‌دهد تا کاربر ماشین را به‌طور ایمن ازطریق اعطای گذرواژه اصالت‌سنجی کند، حتی زمانی‌که 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.
فهرست کردن همه کاربران ماشین
برای مشاهده همه کاربران ماشین که درحال‌حاضر در OpenLDAP ثبت شده‌اند، از فرمان list استفاده کنید. کاربران انسانی از این فهرست فیلتر می‌شوند.
/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.