SmartDocs устанавливается автоматически при установке и запуске сценариев тестирования установки, описанных в разделе Проверка установки . В рамках запуска тестовых сценариев вы запускаете следующие команды:
/opt/apigee/apigee-service/bin/apigee-service apigee-validate install
/opt/apigee/apigee-service/bin/apigee-service apigee-validate setup -f configFile
Где configFile — это тот же файл конфигурации, который вы использовали для установки Edge. Дополнительные сведения см. в разделе Установка компонентов Edge на узле .
Эта команда устанавливает SmartDocs как часть выполнения тестов.
Чтобы завершить установку:
Проверьте установку SmartDocs, убедившись, что файл
smartdocs.zip
находится в следующем каталоге:/opt/apigee/apigee-validate/bundles/
Или запустите следующий вызов API на узле Management Server:
curl -v -u adminEmail:adminPword 0:8080/v1/o/validate/apis
Эта команда должна вернуть следующее, если SmartDocs установлен:
[ "smartdocs", "passthrough" ]
- В пользовательском интерфейсе Edge создайте и обновите KVM с именем «smartdocs_whitelist», как показано на рисунке ниже. KVM должен быть создан в организации и среде, в которой в настоящее время развернут прокси-сервер SmartDocs.
Примечание . Убедитесь, что флажок «Зашифровано» НЕ установлен.
- Добавьте ключ с именем «is_whitelist_configured», где значение «ДА».
- Добавьте второй ключ с именем «allowed_hosts», где значения — это имена хостов, разделенные пробелами, или IP-адреса, вызванные из SmartDocs. Значение «allowed_hosts» должно включать все хосты, включенные в спецификации OpenAPI, добавленные в SmartDocs. Например, если у вас есть спецификация OpenAPI, которая вызывает
mocktarget.apigee.net
, вам нужно будетmocktarget.apigee.net
к значению «allowed_hosts». Если хост не включен в KVM, ответом SmartDocs будет400 Bad Request
с полезной нагрузкой содержимогоBad Request-Hostname not permitted
.