acurl ve get_token hakkında

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi

Apigee, OAuth2 erişim ve yenileme jetonları oluşturmak ve iletmek için aşağıdaki yardımcı yardımcı programları sunar. Bu jetonları, OAuth ile Edge API çağrılarınızda (SAML ve LDAP iş akışları dahil) kimliğinizi doğrulamak için kullanırsınız:

  • acurl(1): Standart bir curl komutunun etrafında bir kolaylık sarmalayıcı sağlar. Edge API'ye HTTP istekleri oluşturur, get_token uygulamasından erişim ve yenileme jetonları alır ve erişim jetonunu Edge API'ye iletir.
  • get_token(1): Apigee kimlik bilgilerinizi erişim için değiştirir ve Edge API'yi çağırmak için kullanabileceğiniz yenileme jetonlarını kullanır.

Bu yardımcı programların her ikisi de Apigee hesap kimlik bilgilerinizi (kullanıcı adı ve şifre veya şifre kodu) OAuth2 jetonları ile değiştirir.

Apigee yardımcı programları tarafından oluşturulan jetonlar, OAuth 2.0 Yetkilendirme Çerçevesi spesifikasyonuna uygundur.

Jeton almak için Apigee yardımcı programlarını kullanmak veya Edge API'leri için kimlik doğrulama sunucusuna erişmek isteğe bağlıdır. OAuth2 erişim jetonları oluşturmak ve isteklerinizde Edge API'ye göndermek için kendi şemalarınızı uygulayabilirsiniz.

acurl ve get_token öğelerini yükleyin

Apigee, acurl(1), get_token(1) ve yükleme komut dosyasını içeren bir ZIP dosyası sağlar.

acurl ve get_token uygulamalarını yüklemek için:

  1. Makinenizde bir yükleme dizini oluşturun veya varsayılan usr/local/bin dizinini kullanın.
  2. Kurulum ZIP dosyasını Apigee'den indirin: 
    curl https://login.apigee.com/resources/scripts/sso-cli/ssocli-bundle.zip -O
  3. İndirilen dosyanın sıkıştırmasını açın.
  4. Yükleme komut dosyasını çalıştırın: 
    sudo ./install -b /usr/local/bin

    -b seçeneği, yürütülebilir dosyaların konumunu belirtir. Bu seçeneği belirtmezseniz yükleme komut dosyası /usr/local/bin içindeki yardımcı programları yükler.

  5. Yüklemeleri test edin: 
        acurl -h
    get_token -h

    Yükleme başarılı olursa bu komutlar yardımcı programlar için Yardım metni döndürür.

Jetonun son kullanma tarihi

acurl ve get_token, aşağıdaki sürelerde jetonlar oluşturur:

  • Erişim jetonlarının süresi 12 saat içinde dolar.
  • Yenileme jetonlarının süresi 30 gün içinde dolar.

Sonuç olarak, acurl veya get_token ile başarılı bir şekilde API çağrısı yaptıktan sonra, jeton çiftini 30 gün boyunca kullanmaya devam edebilirsiniz. Süre sona erdikten sonra kimlik bilgilerinizi yeniden girmeniz ve yeni jetonlar almanız gerekir.

TOA uç noktasını ayarlama

İlk çağrınızı yapmadan önce, acurl ve get_token ile kullanmak istediğiniz Edge API için yetkilendirme sunucusu uç noktasını ayarlamanız gerekir.

Terminalden SSO_LOGIN_URL ortam değişkenini yetkilendirme sunucusu uç noktanıza ayarlayın. Örneğin:

  • Alt bölge bulunmayan Cloud müşterileri için: 
    export SSO_LOGIN_URL=https://login.apigee.com
  • Şu alt bölgeye sahip Cloud müşterileri için: 
    export SSO_LOGIN_URL=https://zone_name.login.apigee.com
  • Private Cloud müşterileri, uygun TOA uç noktası için yöneticinizle iletişime geçin.

Tek kullanımlık şifre kodu kullanın (SAML için gereklidir)

acurl veya get_token ile bir API çağrısı yaptığınızda, bir jeton çifti almak için yardımcı programda kimliğinizi doğrulamanız gerekir. Bunu Apigee hesabınızın kullanıcı adını, şifresini ve bir MFA kodunu ileterek yapabilirsiniz. Ancak SAML IDP kullanıyorsanız veya şifrenizi kullanmak istemiyorsanız bunun yerine tek seferlik bir kod şifre kodu alabilirsiniz.

Tek seferlik şifre kodu almak için:

  1. Aşağıdaki URL'yi bir tarayıcıya girin:
    • Alt bölge bulunmayan Cloud müşterileri için: 
      https://login.apigee.com/passcode
    • Şu alt bölgeye sahip Cloud müşterileri için: 
      https://zone_name.login.apigee.com/passcode
    • Private Cloud müşterileri, uygun TOA uç noktası için yöneticinizle iletişime geçin.
  2. Apigee hesabınıza giriş yapın.
  3. 6 karakterli şifre kodunu kopyalayın.
  4. -p seçeneğiyle birlikte acurl veya get_token kodunu kullanın ve şifre kodunu aşağıdaki örnekte gösterildiği gibi iletin: 
    get_token -p 1a2b3c

Jetonlarınızı görüntüleyin

acurl veya get_token işlemini başarıyla gerçekleştirdiğinizde, yardımcı programlar ~/.sso-cli içinde jetonları ve diğer meta verileri içeren bir veri dosyası oluşturur.

Jetonları görüntülemek için aşağıdaki gibi bir komut kullanabilirsiniz:

get_token -v

Bu komut, kodu çözülmüş jeton iddialarını görüntüler. Örneğin:

Decoded token claims:
 {
  "jti": "8018507e-9f34-4a90-bf97-ff226a06b19b",
  "sub": "858217a9-01a1-4111-8525-75ca555f5d5c",
  "scope": [
    "scim.emails.read",
    "scim.me",
    "openid",
    "password.write",
    "approvals.me",
    "scim.ids.read",
    "oauth.approvals"
          ],
  "client_id": "edgecli",
  "cid": "edgecli",
  "azp": "edgecli",
  "grant_type": "password",
  "user_id": "858217a9-01a1-4111-8525-75ca555f5d5c",
  "origin": "usergrid",
  "user_name": "myusername@google.com",
  "email": "myusername@google.com",
  "auth_time": 1597444772,
  "al": 0,
  "rev_sig": "6271c527",
  "iat": 1597444772,
  "exp": 1597487972,
  "iss": "https://login.apigee.com",
  "zid": "uaa",
  "aud": [
    "edgecli",
    "scim.emails",
    "scim",
    "openid",
    "password",
    "approvals",
    "scim.ids",
    "oauth"
        ]
    }
Current timestamp: 1597444983
Existing access token is still valid

(1) Telif Hakkı 2023 Google LLC
acurl ve get_token araçları, https://cloud.google.com/terms/service-terms adresinde yer alan Hizmete Özel Şartlar da dahil olmak üzere Google Cloud Platform kullanımınızı düzenleyen sözleşme kapsamında "Yazılım" olarak sunulmaktadır.