Как установить SmartDocs

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 как часть выполняемых тестов.

Чтобы завершить установку:

  1. Чтобы проверить, установлен ли SmartDocs, убедитесь, что файл smartdocs.zip находится в следующем каталоге:

    /opt/apigee/apigee-validate/bundles/

    Или выполните следующий вызов API на узле сервера управления:

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

    Если SmartDocs установлен, эта команда должна вернуть следующий результат:

    [ "smartdocs", "passthrough" ]
  2. В интерфейсе Edge создайте и обновите хранилище пар "ключ-значение" с названием smartdocs_whitelist, как показано на рисунке ниже. Хранилище пар "ключ-значение" должно быть создано в организации и среде, в которой в настоящее время развернут прокси SmartDocs.

    Примечание. Убедитесь, что флажок зашифровано НЕ установлен.

    • Добавьте ключ с названием is_whitelist_configured и значением YES.
    • Добавьте второй ключ с названием 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.
    Интерфейс создания KVM Примечание. Если вы не добавите и не настроите это хранилище пар "ключ-значение", прокси-сервер не будет применять белый список. Это может привести к несанкционированному доступу к вашим хостам и IP-адресам. В значениях параметра allowed_hosts должны быть указаны только имена хостов и IP-адреса конечных точек API, описанных в SmartDocs.