Apigee-ssoadminapi.sh kullanma

Apigee TOA modülü iki tür hesabı destekler:

apigee-ssoadminapi.sh yardımcı programı, Apigee TOA modülüyle ilişkili yönetici ve makine kullanıcı hesaplarını yönetmenize olanak tanır.

apigee-ssoadminapi.sh yardımcı programını kullanarak:

  • Yönetici/makine kullanıcılarının listesini görüntüleme
  • Yönetici/makine kullanıcıları ekleme veya silme
  • Yönetici/makine kullanıcılarının şifresini değiştirme

Yönetici kullanıcılar hakkında

Modülün özelliklerini yönetmek için Apigee TOA modülünde bir yönetici hesabı gerekir.

Varsayılan olarak, Apigee TOA modülünü yüklediğinizde aşağıdaki kimlik bilgilerine sahip bir yönetici hesabı oluşturulur:

  • username: Apigee TOA modülünü yapılandırmak için kullanılan yapılandırma dosyasındaki SSO_ADMIN_NAME özelliği tarafından tanımlanır. Varsayılan değer: ssoadmin.
  • password: Apigee TOA modülünü yapılandırmak için kullanılan yapılandırma dosyasındaki SSO_ADMIN_SECRET özelliği tarafından tanımlanır.

Makine kullanıcıları hakkında

Makine kullanıcıları, şifre kodu belirtmek zorunda kalmadan OAuth2 jetonları alabilir. Bu, Edge Management API'sini kullanarak OAuth2 jetonlarını alma ve yenileme sürecini tamamen otomatikleştirebileceğiniz anlamına gelir.

Makine kullanıcılarını genellikle şu amaçlarla kullanırsınız:

  • Apigee Developer Services portalını (veya kısaca portalı) Edge ile iletişim kuracak şekilde yapılandırma
  • Geliştirme ortamı, test otomasyonu veya CI/CD gibi yaygın geliştirme görevleri için otomasyonu desteklediğinde.

Daha fazla bilgi için Harici IdP'ler için görevleri otomatikleştirme başlıklı makaleyi inceleyin.

apigee-ssoadminapi.sh yükleniyor

Apigee TOA modülünü yüklediğiniz Edge Yönetim Sunucusu düğümüne apigee-ssoadminapi.sh yardımcı programını yükleyin. Genellikle Apigee TOA modülünü yüklediğinizde apigee-ssoadminapi.sh yardımcı programını da yüklersiniz.

apigee-ssoadminapi.sh yardımcı programını henüz yüklemediyseniz:

  1. Yönetim Sunucusu düğümüne giriş yapın. Bu düğümde, Edge apigee-setup yardımcı programını yükleme bölümünde açıklandığı gibi apigee-service zaten yüklü olmalıdır.
  2. Aşağıdaki komutu çalıştırarak Apigee TOA modülü için yönetici ve makine kullanıcılarını yönetmek üzere kullanılan apigee-ssoadminapi.sh yardımcı programını yükleyin: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-ssoadminapi install
  3. Kabuktan çıkış yapın ve ardından apigee-ssoadminapi.sh yardımcı programını yolunuza eklemek için tekrar giriş yapın.

apigee-ssoadminapi.sh için yardım bilgilerini görüntüleme

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

  • admin add
  • admin delete
  • admin list
  • admin setpassword
  • saml machineuser add (LDAP ve SAML dahil tüm IdP'ler için saml komutunu kullanın)
  • saml machineuser delete
  • aaml machineuser list
  • saml machineuser setpassword

Bu komutlarla ilgili bilgileri /opt/apigee/apigee-ssoadminapi/README.md dosyasında görüntüleyebilirsiniz. Ayrıca, kullanım bilgilerini görüntülemek için her komutta "-h" seçeneğini belirtebilirsiniz.

Örneğin, aşağıdaki komut:

apigee-ssoadminapi.sh admin list -h

Şunu döndürür:

admin list
  --admin SSOADMIN_CLIENT_NAME      Name of the client having administrative privilege on sso
  --secret SSOADMIN_CLIENT_SECRET   Secret/Password for the client
  --host SSO_HOST                   Hostname of SSO server to connect
  --port SSO_PORT                   Port to use during request
  --ssl SSO_URI_SCHEME              Set to https, defaults to http
  --debug                           Set in debug mode, turns on verbose in curl
  -h                                Displays Help

apigee-ssoadminapi.sh yardımcı programını çağırma

apigee-ssoadminapi.sh yardımcı programını, tüm özellikleri komut satırı bağımsız değişkenleri olarak ileterek veya etkileşimli modda istemlere yanıt vererek çağırabilirsiniz.

Örneğin, yönetici kullanıcıların listesini görmek için komut satırında gerekli tüm bilgileri belirtmek üzere:

apigee-ssoadminapi.sh admin list --admin ssoadmin --secret Secret123 --host 35.197.94.184

Şunu döndürür:

[
  {
    "client_id": "ssoadmin",
    "access_token_validity": 300
  }
]

Yönetici şifresi gibi gerekli bilgileri atlarsanız sizden bu bilgileri girmeniz istenir.

Bu örnekte, Apigee TOA modülü --port için varsayılan 9099 değerini ve --ssl için http değerini kullandığından --port ve --ssl değerlerini atlarsınız. Yüklemenizde bu varsayılanlar kullanılmıyorsa bunları belirtin:

apigee-ssoadminapi.sh admin list --admin ssoadmin --secret Secret123
  --host 35.197.94.184 --port 9443 --ssl https

Alternatif olarak, tüm bilgileri girmeniz istenen etkileşimli formu kullanabilirsiniz:

apigee-ssoadminapi.sh admin list

Ardından, gerekli tüm bilgileri girmeniz istenir:

SSO admin name (current): ssoadmin
SSO Admin secret (current):
SSO host: 35.197.94.184