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 konfiguracji, którego użyto do zainstalowania Edge. Więcej informacji znajdziesz w artykule Instalowanie komponentów Edge na węźle.

To polecenie instaluje pliki SmartDocuments 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ć to wywołanie interfejsu API na 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 KVM o nazwie „smartdocs_whitelist”, jak pokazano na rysunku poniżej. KVM powinna być utworzona 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” (czy biała lista jest skonfigurowana), którego wartość to „YES” (tak).
    • 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” powinna obejmować wszystkie hosty uwzględnione w specyfikacji OpenAPI dodanej do SmartDocs. 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 miała treść 400 Bad Request i treść ładunek o wartości Bad Request-Hostname not permitted.
    Interfejs tworzenia maszyny wirtualnejUwaga: jeśli nie dodasz i nie skonfigurujesz tego KVM, serwer proxy nie będzie stosować białej listy. Może to spowodować nieautoryzowany dostęp do Twoich hostów i adresów IP. Wartości „allowed_hosts” powinny zawierać tylko nazwy hostów i adresy IP punktów końcowych interfejsu API udokumentowanych za pomocą SmartDocs.