Apigee TOA'yı etkinleştirdikten sonra Edge yönetici yardımcı programlarını ve API'lerini kullanma

Bu bölümde, Apigee TOA'yı etkinleştirdikten sonra Edge sistem yöneticisi araçlarının ve komutlarının nasıl çalıştırılacağı açıklanmaktadır. Edge'deki birçok görev için sistem yönetimi kimlik bilgileri gerekir. Örneğin:

  • Kuruluş ve ortam oluşturma
  • Edge bileşenlerini ekleme ve kaldırma
  • apigee-adminapi.sh komut çalıştırılıyor

Ancak Edge'de TOA'yı etkinleştirdikten sonra genellikle Temel Kimlik Doğrulama'yı devre dışı bırakırsınız. Böylece kimlik doğrulamanın tek yolu OIDC/SAML IdP üzerinden olur. Bu nedenle, sistem yöneticisi hesabını IdP'nize eklediğinizden veya otomasyon için yerel bir makine kullanıcısı oluşturduğunuzdan emin olmanız gerekir.

Sistem yöneticisi olarak Edge Management API'lerini çağırma

Birçok Edge API çağrısı, sistem yöneticisi kimlik bilgilerini iletmenizi gerektirir. Edge Management API ile SAML kullanma başlıklı makalede, Edge Management API çağrıları yaparken get_token yardımcı programını kullanarak jetonları edinme ve yenileme jetonları talimatları yer almaktadır.

Apigee SSO ile apigee-adminapi.sh yardımcı programını kullanma

Edge Management API'sine çağrı yaparak gerçekleştirdiğiniz Edge yapılandırma görevlerini yapmak için apigee-adminapi.sh yardımcı programını kullanın. apigee-adminapi.sh yardımcı programının avantajı şudur:

  • Basit bir komut satırı arayüzü kullanır.
  • Sekmeye dayalı komut tamamlamayı uygular.
  • Yardım ve kullanım bilgileri sağlar
  • API'yi denemeye karar verirseniz ilgili API çağrısını gösterebilir.

Apigee TOA'yı etkinleştirdikten sonra, gerçek bir yönetici veya otomatik bir komut dosyası olmanıza bağlı olarak kimlik bilgilerini apigee-adminapi.sh yardımcı programına iletmenin iki temel yolu vardır.

Komuta -h seçeneğini ekleyerek TOA kimlik bilgilerini belirtme seçenekleri de dahil olmak üzere tüm apigee-adminapi.sh komut seçeneklerini görebilirsiniz. Örneğin:

apigee-adminapi.sh orgs list -h

Hamiline ait jeton iletme (insan yöneticiler için)

Modernize edilmiş Apigee SSO, eski /passcode kopyalama-yapıştırma akışını desteklemediğinden, insan yöneticilerin OAuth 2.0 Cihaz Kodu akışını tamamlamak için get_token yardımcı programını kullanması ve ardından ortaya çıkan jetonu komut dosyasına iletmesi gerekir.

Öncelikle bir jeton alın:

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

Ardından, komutu çağırırken jetonu kullanın:

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

Burada:

  • oauth-flow, passcode değerini belirtir (bu, eski komut dosyasına bir jeton sağlandığını bildirir).
  • oauth-token, get_token kaynağından alınan ham JWT dizesini içerir.

Şifre iletme (yalnızca makine kullanıcıları için)

Altyapı dağıtımlarını otomatikleştiriyorsanız kimlik bilgilerini doğrudan password_grant akışını kullanarak iletebilirsiniz. Ancak SAML/OIDC federasyonu etkinleştirilirse MFA'nın atlanmasını önlemek için gerçek gölge kullanıcıların şifreyle giriş yapması engellenir. Öncelikle OpenLDAP'te açık bir Makine Kullanıcısı temel hazırlığı yapmanız gerekir.

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

Burada:

  • sso-url seçeneği, Apigee TOA'nın URL'sini belirtir. 9099 ve HTTP'den değiştirdiyseniz bağlantı noktasını veya protokolü değiştirin.
  • oauth-flow belirtir password_grant.
  • machineUserEmail, otomatik makine kullanıcısının e-posta adresidir.
  • oauth-password, makine kullanıcısının şifresini belirtir.

Edge yardımcı programlarını Apigee TOA ile kullanma

Birçok Edge yardımcı programı, sistem yöneticisi kimlik bilgileri gerektirir. Örneğin:

  • apigee-provision kuruluşları, ortamları ve sanal ana makineleri oluşturmak için kullanılır.
  • setup.sh mevcut bir sisteme düğüm eklemek için kullanılır
  • Bir yapılandırma dosyasında sistem yöneticisi kimlik bilgilerini belirtmeniz gereken diğer yardımcı programlar

Bu yardımcı programlar, sistem yöneticisinin kimlik bilgilerini belirten bir yapılandırma dosyasını giriş olarak alır. TOA etkinleştirilmeden önce bu işlem, aşağıdaki özellikler kullanılarak yapılır:

ADMIN_EMAIL="adminEmail"
APIGEE_ADMINPW="adminPWord"

Apigee TOA'yı etkinleştirdikten sonra, sistem yöneticisinin kimlik bilgilerini belirtmek için farklı özellikler kullanmanız gerekir.

Hamiline ait jeton kullanma (insan yöneticiler için)

İnsan yöneticiler tarafından yapılan etkileşimli dağıtımlar için get_token yardımcı programını kullanarak bir jeton alın ve OAUTH_BEARER_TOKEN özelliği aracılığıyla sağlayın:

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

Burada:

  • OAUTH_FLOW, passcode değerini belirtir (bir jetonun sağlandığını gösterir).
  • OAUTH_BEARER_TOKEN, get_token adresinden alınan ham JWT dizesini içerir.

Şifre kullanma (yalnızca makine kullanıcıları için)

Tam otomatik dağıtımlar için password_grant akışını kullanarak açıkça temel hazırlığı yapılmış bir makine kullanıcısının kimlik bilgilerini sağlayın:

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

Burada:

  • SSO_LOGIN_URL, Apigee TOA'nın URL'sini belirtir.
  • OAUTH_FLOW, password_grant değerini belirtir.
  • OAUTH_ADMIN_PASSWORD, makine kullanıcısının şifresini belirtir.