Apigee SSO mendukung dua jenis profil autentikasi yang sebelumnya dikelola oleh skrip apigee-ssoadminapi.sh lama:
Utilitas apigee-machineuser.sh memungkinkan Anda mengelola akun pengguna mesin tanpa UI langsung di OpenLDAP.
Tentang klien OAuth (sebelumnya Administrator)
Di versi Edge sebelumnya, Anda menggunakan perintah admin di utilitas apigee-ssoadminapi.sh untuk membuat klien OAuth secara dinamis di database UAA. Di 4.54.00, Apigee SSO mengandalkan model konfigurasi deklaratif (GitOps).
Anda tidak lagi menggunakan skrip CLI untuk membuat klien OAuth karena sekarang bersifat statis. Konfigurasi klien untuk UI Edge ditentukan di /opt/silent.conf. Sedangkan klien yang digunakan untuk pengguna mesin (edgecli) dikonfigurasi secara implisit di Apigee SSO.
Tentang pengguna mesin
Pengguna mesin dapat memperoleh token OIDC/OAuth2 melalui pemberian sandi standar tanpa memerlukan browser atau MFA interaktif. Artinya, Anda dapat sepenuhnya mengotomatiskan proses perolehan dan pembaruan token untuk pipeline dan skrip CI/CD.
Saat Anda membuat pengguna mesin dengan utilitas apigee-machineuser.sh, akun akan dibuat langsung di direktori OpenLDAP lokal dan ditandai secara eksplisit dengan employeeType: machineuser. Tag ini memungkinkan Apigee SSO mengautentikasi pengguna mesin dengan aman melalui pemberian sandi, bahkan saat SAML/OIDC gabungan diterapkan secara ketat untuk pengguna manusia.
Memanggil utilitas apigee-machineuser.sh
Utilitas apigee-machineuser.sh diinstal secara otomatis di node yang menghosting komponen apigee-openldap di jalur berikut:
/opt/apigee/apigee-openldap/bin/apigee-machineuser.sh
Perintah yang tersedia untuk utilitas ini adalah:
add: Membuat pengguna mesin baru di OpenLDAP.list: Mencantumkan semua pengguna mesin yang terdaftar di OpenLDAP.setpassword: Memperbarui sandi untuk pengguna mesin yang ada.delete: Menghapus pengguna mesin secara permanen dari OpenLDAP.
Menambahkan pengguna mesin
Gunakan perintah add dengan flag -u dan -p untuk membuat pengguna mesin baru.
/opt/apigee/apigee-openldap/bin/apigee-machineuser.sh add -u jenkins-bot@apigee.com -p BotSecret123!
Output:
Machine user 'jenkins-bot@apigee.com' created successfully in OpenLDAP.
Mencantumkan semua pengguna mesin
Gunakan perintah list untuk melihat semua pengguna mesin yang saat ini terdaftar di OpenLDAP. Pengguna manusia difilter dari daftar ini.
/opt/apigee/apigee-openldap/bin/apigee-machineuser.sh list
Output:
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
Mereset sandi pengguna mesin
Gunakan perintah setpassword untuk memperbarui sandi pengguna mesin yang ada.
/opt/apigee/apigee-openldap/bin/apigee-machineuser.sh setpassword -u jenkins-bot@apigee.com -p NewSecret456!
Output:
Password for machine user 'jenkins-bot@apigee.com' updated successfully.
Menghapus pengguna mesin
Gunakan perintah delete untuk menghapus pengguna mesin secara permanen dari OpenLDAP.
/opt/apigee/apigee-openldap/bin/apigee-machineuser.sh delete -u jenkins-bot@apigee.com
Output:
Machine user 'jenkins-bot@apigee.com' deleted successfully from OpenLDAP.