SmartDokümanlar'ı yükleme

Yüklemeyi test etme bölümünde açıklanan yükleme testi komut dosyalarını yükleyip çalıştırdığınızda SmartDokümanlar otomatik olarak yüklenir. Test komut dosyalarını çalıştırmanın bir parçası olarak, aşağıdaki komutları çalıştırırsınız:

/opt/apigee/apigee-service/bin/apigee-service apigee-validate install
/opt/apigee/apigee-service/bin/apigee-service apigee-validate setup -f configFile

Burada configFile, Edge'i yüklemek için kullandığınız yapılandırma dosyasıyla aynıdır. Daha fazla bilgi için Düğüm bileşenlerini düğüme yükleme başlıklı makaleye göz atın.

Bu komut, testleri çalıştırmanın bir parçası olarak SmartDokümanlar'ı yükler.

Yüklemeyi tamamlamak için:

  1. smartdocs.zip dosyasının aşağıdaki dizinde bulunduğunu onaylayarak SmartDokümanlar'ın yüklü olduğunu test edin:

    /opt/apigee/apigee-validate/bundles/

    Veya Yönetim Sunucusu düğümünde aşağıdaki API çağrısını çalıştırın:

    curl -v -u adminEmail:adminPword 0:8080/v1/o/validate/apis

    SmartDokümanlar yüklenirse bu komut aşağıdakini döndürmelidir:

    [ "smartdocs", "passthrough" ]
  2. Aşağıdaki şekilde gösterildiği gibi, Edge kullanıcı arayüzünde "smartdocs_whitelist" adlı bir KVM oluşturun ve güncelleyin. KVM, SmartDokümanlar proxy'sinin dağıtıldığı kuruluş ve ortamda oluşturulmalıdır.

    Not: Şifrelenmiş kutusunun işaretli OLMADIĞINDAN emin olun.

    • "is_whitelist_configure" adlı bir anahtar ekleyin. Buradaki değer "YES"tir.
    • "allowed_hosts" adlı ikinci bir anahtar ekleyin. Bu anahtarlarda değerler, SmartDokümanlar'dan çağrılan boşlukla ayrılmış ana makine adları veya IP adresleridir. "allowed_hosts" değeri, SmartDokümanlar'a eklenen OpenAPI özelliklerine dahil olan tüm ana makineleri içermelidir. Örneğin, mocktarget.apigee.net çağrısı yapan bir OpenAPI spesifikasyonunuz varsa mocktarget.apigee.net öğesini "allowed_hosts" değerine eklemeniz gerekir. Bir ana makine KVM'ye dahil edilmezse SmartDokümanlar yanıtı, Bad Request-Hostname not permitted içerik yüküne sahip 400 Bad Request olur.
    KVM oluşturma arayüzü Not: Bu KVM'yi ekleyip yapılandırmazsanız proxy, beyaz listeye eklemeyi zorunlu kılmaz. Bu da ana makinelerinize ve IP adreslerinize yetkisiz erişimle sonuçlanabilir. "allowed_hosts" değerlerine yalnızca SmartDokümanlar tarafından belgelenen API uç noktalarının ana makine adları ve IP adresleri eklenmelidir.