Inteligentna dokument jest instalowany automatycznie podczas instalacji i uruchamiania skryptów testowych instalacji opisanych w sekcji Testowanie instalacji. W ramach uruchamiania skryptów testowych uruchamiasz te 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óry został użyty do zainstalowania Edge. Więcej informacji znajdziesz w sekcji Instalowanie komponentów Edge w węźle.
To polecenie instaluje SmartDokumenty w ramach przeprowadzanych testów.
Aby dokończyć instalację:
Sprawdź, czy plik SmartDocuments jest zainstalowany, sprawdzając, czy plik
smartdocs.zipznajduje się w tym katalogu:/opt/apigee/apigee-validate/bundles/
Możesz też uruchomić to wywołanie interfejsu API w węźle serwera zarządzania:
curl -v -u adminEmail:adminPword 0:8080/v1/o/validate/apis
Jeśli to polecenie jest zainstalowane, to polecenie powinno zwracać te wartości:
[ "smartdocs", "passthrough" ]
- W interfejsie użytkownika Edge utwórz i zaktualizuj KVM o nazwie „smartdocs_whitelist”, tak jak to pokazano na ilustracji poniżej.
KVM należy utworzyć w organizacji i środowisku, w którym jest wdrożony serwer proxy SmartDocuments.
Uwaga: 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 to nazwy hostów lub adresy IP rozdzielone przecinkami. Wartość w polu „allowed_hosts” powinna zawierać wszystkie hosty uwzględnione w specyfikacji OpenAPI dodane do SmartSmart. Jeśli na przykład masz specyfikację OpenAPI, która wywołuje
mocktarget.apigee.net, musisz dodaćmocktarget.apigee.netdo wartości „allowed_hosts”. Jeśli host nie jest uwzględniony w KVM, odpowiedź SmartDocuments to400 Bad Requestz ładunkiem treściBad Request-Hostname not permitted.
Uwaga: jeśli nie dodasz i nie skonfigurujesz tej usługi KVM, serwer proxy nie będzie wymuszać dodawania stron do białej listy. Może to spowodować nieupoważniony dostęp do hostów i adresów IP. W wartościach „allowed_hosts” powinny się znaleźć tylko nazwy hostów i adresy IP punktów końcowych interfejsu API udokumentowane za pomocą SmartDocuments.