apigee-machineuser.sh ile makine kullanıcılarını yönetme

Apigee TOA, daha önce eski apigee-ssoadminapi.sh komut dosyası tarafından yönetilen iki tür kimlik doğrulama profilini destekler:

apigee-machineuser.sh yardımcı programı, gözetimsiz makine kullanıcı hesaplarını doğrudan OpenLDAP'te yönetmenize olanak tanır.

OAuth istemcileri (eski adıyla Yöneticiler) hakkında

Edge'in önceki sürümlerinde, UAA veritabanında dinamik olarak OAuth istemcileri oluşturmak için apigee-ssoadminapi.sh yardımcı programındaki admin komutlarını kullanıyordunuz. 4.54.00 sürümünde Apigee TOA, bildirim temelli bir yapılandırma (GitOps) modeline dayanır.

Artık statik oldukları için OAuth istemcileri oluşturmak üzere CLI komut dosyası kullanmıyorsunuz. Edge kullanıcı arayüzü için istemci yapılandırması /opt/silent.conf içinde tanımlanır. Makine kullanıcıları (edgecli) için kullanılan istemci ise Apigee TOA'da dolaylı olarak yapılandırılır.

Makine kullanıcıları hakkında

Bir makine kullanıcısı, tarayıcı veya etkileşimli MFA gerektirmeden standart bir şifre verme işlemi aracılığıyla OIDC/OAuth2 jetonları alabilir. Bu sayede, CI/CD ardışık düzenleriniz ve komut dosyalarınız için jeton alma ve yenileme jetonları sürecini tamamen otomatikleştirebilirsiniz.

apigee-machineuser.sh yardımcı programıyla bir makine kullanıcısı oluşturduğunuzda hesap doğrudan yerel OpenLDAP dizininde oluşturulur ve açıkça employeeType: machineuser ile etiketlenir. Bu etiket, birleşik SAML/OIDC gerçek kullanıcılar için kesin olarak zorunlu kılınsa bile Apigee TOA'nın, şifre izni aracılığıyla makine kullanıcısının kimliğini güvenli bir şekilde doğrulamasını sağlar.

apigee-machineuser.sh yardımcı programını çağırın.

apigee-machineuser.sh yardımcı programı, apigee-openldap bileşenini barındıran düğüme aşağıdaki yolda otomatik olarak yüklenir:

/opt/apigee/apigee-openldap/bin/apigee-machineuser.sh

Yardımcı program için kullanılabilen komutlar şunlardır:

  • add: OpenLDAP'de yeni bir makine kullanıcısı oluşturur.
  • list: OpenLDAP'ta kayıtlı tüm makine kullanıcılarını listeler.
  • setpassword: Mevcut bir makine kullanıcısının şifresini günceller.
  • delete: Makine kullanıcısını OpenLDAP'den kalıcı olarak kaldırır.

Makine kullanıcısı ekleme

Yeni bir makine kullanıcısı oluşturmak için -u ve -p işaretleriyle birlikte add komutunu kullanın.

/opt/apigee/apigee-openldap/bin/apigee-machineuser.sh add -u jenkins-bot@apigee.com -p BotSecret123!

Çıkış:

Machine user 'jenkins-bot@apigee.com' created successfully in OpenLDAP.

Tüm makine kullanıcılarını listeleme

OpenLDAP'ye kayıtlı tüm makine kullanıcılarını görüntülemek için list komutunu kullanın. Gerçek kullanıcılar bu listeden filtrelenir.

/opt/apigee/apigee-openldap/bin/apigee-machineuser.sh list

Çıkış:

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

Makine kullanıcısının şifresini sıfırlama

Mevcut bir makine kullanıcısının şifresini güncellemek için setpassword komutunu kullanın.

/opt/apigee/apigee-openldap/bin/apigee-machineuser.sh setpassword -u jenkins-bot@apigee.com -p NewSecret456!

Çıkış:

Password for machine user 'jenkins-bot@apigee.com' updated successfully.

Makine kullanıcısını silme

Bir makine kullanıcısını OpenLDAP'den kalıcı olarak kaldırmak için delete komutunu kullanın.

/opt/apigee/apigee-openldap/bin/apigee-machineuser.sh delete -u jenkins-bot@apigee.com

Çıkış:

Machine user 'jenkins-bot@apigee.com' deleted successfully from OpenLDAP.