acurl ve get_token hakkında

Apigee Edge belgelerini görüntülüyorsunuz.
. Git: Apigee X belgeleri. bilgi

Apigee, OAuth2 erişimi oluşturmak ve iletmek için aşağıdaki kolay hizmetleri sunar. tıklayın ve jetonları yenileyin. Bu jetonları, Edge API'nizde kimliğinizi doğrulamak için kullanırsınız OAuth kullanılarak yapılan çağrılarla (ör. SAML ve LDAP iş akışları):

  • acurl(1): Standart bir pakete yönelik bir kolaylık sarmalayıcı sunar. curl komutu. Uçta HTTP istekleri oluşturur API, get_token adlı iş ortağından erişim ve yenileme jetonları alır ve erişim jetonunu Kenar API'ye gidin.
  • get_token(1): Apigee kimlik bilgilerinizi erişim için değiştirir ve Edge API'yi çağırmak için kullanabileceğiniz jetonları yenileyin.

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

Apigee yardımcı programları tarafından oluşturulan jetonlar OAuth 2.0 Yetkilendirme Çerçevesi spesifikasyonlarına göz atın.

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

Acurl ve get_token'ı yükle

Apigee, şunları içeren bir ZIP dosyası sağlar: acurl(1), get_token(1) ve yükleme komut dosyasıdır.

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. Apigee'den yükleme ZIP dosyasını 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ı yürütün: 
    sudo ./install -b /usr/local/bin
    .

    -b seçeneği, yürütülebilir dosyaların konumunu belirtir. Google Takvim'i bu seçeneği belirtirseniz 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 metnini döndürür.

Jetonun son kullanma tarihi

acurl ve get_token, aşağıdaki sürelere sahip 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 API çağrısı yaptığınızda jeton çiftini 30 gün boyunca kullanmaya devam edebilirsiniz. Süre sona erdikten sonra, yeni jetonlar alabilirsiniz.

TOA uç noktasını ayarlama

İlk çağrınızı yapmadan önce, oluşturduğunuz Edge API için yetkilendirme sunucusu uç noktasını ayarlamanız gerekir. acurl ve get_token ile kullanmak istiyor musunuz?

Terminalden SSO_LOGIN_URL ortam değişkenini yetkilendirmenize ayarlayın sunucu uç noktası. Örneğin:

  • Alt bölgesi olmayan Cloud müşterileri için: 
    export SSO_LOGIN_URL=https://login.apigee.com
    .
  • 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 bir şifre kodu kullanın (SAML için gereklidir)

acurl veya get_token ile API çağrısı yaparken kimliğinizi doğrulamanız gerekir kendinizi yardımcı programını uygular. Bunun için Apigee'nizi ekleyebilirsiniz. hesabın kullanıcı adı, şifresi ve MFA kodu. Ancak SAML IdP kullanıyorsanız veya şifrenizi kullanmak istiyorsanız bunun yerine kullanmak üzere tek seferlik bir şifre kodu alabilirsiniz.

Tek seferlik şifre kodu almak için:

  1. Aşağıdaki URL'yi bir tarayıcıya girin:
    • Alt bölgesi olmayan Cloud müşterileri için: 
      https://login.apigee.com/passcode
      .
    • 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ği ile acurl veya get_token kullanın ve şifre kodunu ekleyin: 
    get_token -p 1a2b3c

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

acurl veya get_token uygulamasını başarıyla yürüttüğünüzde yardımcı programlar ~/.sso-cli içinde jetonları ve diğer meta verileri içeren bir veri dosyası oluşturun.

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

get_token -v

Bu komut, kodu çözülmüş jeton taleplerini gösterir. Ö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ı "Yazılım" olarak sunulur altında Hizmet de dahil olmak üzere Google Cloud Platform kullanımınızı düzenleyen sözleşme Özel Şartlar'a https://cloud.google.com/terms/service-terms adresinden ulaşabilirsiniz.