Zainstaluj SmartDokumenty

Usługa SmartDocuments jest instalowana automatycznie podczas instalowania i uruchamiania skryptów testów instalacji opisane w artykule Testowanie instalacji. W ramach testu skryptów, uruchamia się następujące polecenia:

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

Gdzie configFile to ten sam plik konfiguracyjny użyty do zainstalowania Edge. Więcej informacji znajdziesz w artykule o instalowaniu komponentów Edge w węźle.

To polecenie instaluje Dokumenty SmartDocument w ramach testów.

Aby dokończyć instalację:

1. Sprawdź, czy zainstalowano Dokumenty Google, sprawdzając, czy plik smartdocs.zip jest znajduje się w następującym katalogu:

   /opt/apigee/apigee-validate/bundles/

   Możesz też uruchomić poniższe wywołanie interfejsu API w węźle serwera zarządzania:

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

   Jeśli zainstalowano aplikację SmartDocuments, to polecenie powinno zwrócić następujący komunikat:

   [ "smartdocs", "passthrough" ]

2. W interfejsie Edge utwórz i zaktualizuj maszynę wirtualną o nazwie „smartdocs_whitelist”, jak pokazano na ilustracji poniżej. KVM należy utworzyć w organizacji i środowisku, w którym działa serwer proxy SmartDocuments obecnie wdrożona.

   Uwaga: upewnij się, że pole zaszyfrowane NIE jest zaznaczone.

   • Dodaj klucz o nazwie „is_whitelist_configured”, gdzie wartość to „YES”.
   • Dodaj drugi klucz o nazwie „allowed_hosts”, gdzie wartości są rozdzielanymi spacjami nazwami hostów lub adresami IP ze SmartDokumentów. Wartość „allowed_hosts” powinien zawierać wszystkie hosty uwzględnione w specyfikacji OpenAPI dodano do Dokumentów. Jeśli na przykład masz specyfikację OpenAPI, która wywołuje mocktarget.apigee.net, musisz dodać mocktarget.apigee.net do „allowed_hosts” . Jeśli host nie jest zawarte w KVM, odpowiedź SmartDocuments będzie mieć treść 400 Bad Request i treść ładunek o wartości Bad Request-Hostname not permitted.
   . Uwaga: jeśli nie dodasz ani nie skonfigurujesz tej maszyny wirtualnej, serwer proxy nie wymusza umieszczenia na białej liście. Ten może doprowadzić do nieautoryzowanego dostępu do Twoich hostów i adresów IP. Tylko nazwy hostów i adresy IP Punkty końcowe interfejsu API udokumentowane za pomocą SmartDocuments powinny być uwzględnione w „allowed_hosts” .