SAML'yi etkinleştirdikten sonra Edge yönetici yardımcı programlarını ve API'leri kullanma

Edge for Private Cloud 4.18.05 sürümü

Bu bölümde, SAML'yi 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 komutlarını çalıştırma

Ancak Edge'de SAML'yi etkinleştirdikten sonra genellikle Temel Kimlik Doğrulama'yı devre dışı bırakırsınız. Böylece kimlik doğrulamanın tek yolu SAML IdP üzerinden olur. Bu nedenle, sistem yöneticisi hesabını SAML IdP'nize eklediğinizden emin olmanız gerekir.

Edge yönetim API'lerini sistem yöneticisi olarak çağırma

Birçok Edge API çağrısı, sistem yöneticisi kimlik bilgilerini iletmenizi gerektirir. Edge Management API ile SAML kullanma bölümünde, Edge Management API çağrıları yaparken jetonların nasıl alınacağı ve yenileme jetonlarının nasıl alınacağıyla ilgili talimatlar yer alır.

apigee-adminapi.sh yardımcı programını SAML kimlik doğrulamasıyla kullanma

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

  • Basit bir komut satırı arayüzü kullanma
  • 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.

Daha fazla bilgi için apigee-ssoadminapi.sh'yi kullanma başlıklı makaleyi inceleyin.

SAML kimlik doğrulamasını etkinleştirdikten sonra, sistem yöneticisi kimlik bilgilerini apigee-adminapi.sh yardımcı programına iletmek için kullanabileceğiniz birkaç yöntem vardır.

SAML kimlik bilgilerini belirtme seçenekleri de dahil olmak üzere tüm apigee-adminapi.sh komutlarının seçeneklerini görmek için komutta "-h" seçeneğini kullanabilirsiniz. Örneğin:

apigee-adminapi.sh orgs list -h

Örneğin, sistem yöneticisi kimlik bilgilerini iletebilirsiniz:

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

Burada:

  • sso-url seçeneği, Edge TOA modülünün URL'sini belirtir. 9099 ve HTTP'den değiştirdiyseniz bağlantı noktasını veya protokolü değiştirin.
  • oauth-flow, passcode veya password_grant değerini belirtir. Bu örnekte password_grant değerini belirtirsiniz.
  • adminEmail, sistem yöneticisinin e-posta adresidir.
  • oauth-password, sistem yöneticisinin şifresini belirtir.

Alternatif olarak, komutu çağırırken şifre kodu kullanabilirsiniz:

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

Burada:

  • oauth-flow, passcode değerini belirtir.
  • oauth-passcode, http://edge_sso_IP_DNS:9099/passcode. adresinden alınan şifre kodunu belirtir.

Son olarak, komutu çağırırken bir jeton kullanabilirsiniz:

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

Burada:

  • oauth-flow, jetonu ilk olarak nasıl aldığınıza bağlı olarak passcode veya password_grant değerini belirtir. Bu örnekte, jetonu başlangıçta get_token kullanarak aldığınız için passcode değerini belirtirsiniz. Edge Management API ile SAML'yi kullanma başlıklı makaleyi inceleyin.
  • oauh_token, jetonu içerir.

SAML kimlik doğrulamasıyla Edge yardımcı programlarını kullanma

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

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

Bu yardımcı programlar, aşağıdaki özellikleri kullanarak sistem yöneticisinin kimlik bilgilerini belirten bir yapılandırma dosyasını giriş olarak alır:

ADMIN_EMAIL="adminEmail"
APIGEE_ADMINPW=adminPWord

Şifreyi atlarsanız şifre girmeniz istenir.

SAML'yi etkinleştirdikten sonra sistem yöneticisinin kimlik bilgilerini belirtmek için farklı özellikler kullanırsınız. Örneğin, sistem yöneticisi kimlik bilgilerini iletebilirsiniz:

ADMIN_EMAIL="adminEmail"
SSO_LOGIN_URL=http://edge_sso_IP_DNS:9099
OAUTH_FLOW=password_grant
OAUTH_ADMIN_PASSWORD=adminPWord

Burada:

  • SSO_LOGIN_URL, Edge TOA modülünün URL'sini belirtir. 9099 ve HTTP'den değiştirdiyseniz bağlantı noktasını veya protokolü değiştirin.
  • OAUTH_FLOW, passcode veya password_grant değerini belirtir. Bu örnekte, sistem yöneticisinin şifresini ilettiğiniz için password_grant değerini belirtirsiniz.
  • OAUTH_ADMIN_PASSWORD, sistem yöneticisinin şifresini belirtir.

Alternatif olarak, şifre kodu akışının bir parçası olarak kimlik bilgilerini belirtmek için aşağıdaki özellikleri kullanabilirsiniz:

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

Burada:

  • OAUTH_FLOW, passcode değerini belirtir.
  • OAUTH_ADMIN_PASSCODE, http://edge_sso_IP_DNS:9099/passcode. adresinden alınan şifre kodunu belirtir.

Son olarak, jeton kullanarak

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

Burada:

  • OAUTH_FLOW, jetonu ilk olarak nasıl aldığınıza bağlı olarak passcode veya password_grant değerini belirtir. Bu örnekte, jetonu başlangıçta get_token kullanarak aldığınız için passcode değerini belirtirsiniz. Edge Management API ile SAML'yi kullanma başlıklı makaleyi inceleyin.
  • OAUTH_BEARER_TOKEN, jetonu içerir.