Edge for Private Cloud 4.17.09 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
- birçok başka görev
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 yardımcı programının avantajı şunlardır:
- 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 iletmenin birkaç yolu vardır.
SAML kimlik bilgilerini belirtme seçenekleri de dahil olmak üzere tüm apigee-adminapi.sh komutlarının seçeneklerini, komutun "-h" seçeneğini kullanarak görebilirsiniz. Ö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
Bu örnekte:
- sso-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'i 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
Bu örnekte:
- 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
Bu örnekte:
- 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 kullanma başlıklı makaleyi inceleyin.
- oauh_token, jetonu içerir.
Edge yardımcı programlarını SAML kimlik doğrulamasıyla kullanma
Birçok Edge yardımcı programı, sistem yöneticisi kimlik bilgileri gerektirir. Örneğin:
- Kuruluş, ortam ve sanal ana makine oluşturmak için kullanılan apigee-provision
- 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
Bu örnekte:
- 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
Bu örnekte:
- OAUTH_FLOW, şifre kodu 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
Bu örnekte:
- 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 kullanma başlıklı makaleyi inceleyin.
- OAUTH_BEARER_TOKEN, jetonu içerir.