SmartDocs se instala automáticamente cuando instalas y ejecutas las secuencias de comandos de prueba de instalación
como se describe en Cómo probar la instalación. Como parte de la ejecución de la prueba
secuencias de comandos, debes ejecutar los siguientes comandos:
Este comando debería mostrar lo siguiente si SmartDocs está instalado:
[ "smartdocs", "passthrough" ]
En la IU de Edge, crea y actualiza una KVM llamada “smartdocs_whitelist”, como se muestra en la siguiente imagen.
El KVM debe crearse en la organización y en el entorno donde se ejecuta el proxy de SmartDocs.
implementados en ese momento.
Nota: Asegúrate de que la casilla de encriptado NO esté marcada.
Agrega una clave llamada "is_whitelist_configured", en la que el valor sea "YES".
Agrega una segunda clave llamada “allowed_hosts”, en la que los valores son nombres de host o direcciones IP separados por espacios a los que se llama desde SmartDocs. El valor de "allowed_hosts" debe incluir todos los hosts incluidos en las especificaciones de OpenAPI que se agregaron a SmartDocs. Por ejemplo, si tienes una especificación de OpenAPI que llama a mocktarget.apigee.net, deberás agregar mocktarget.apigee.net al valor "allowed_hosts". Si un host no es
incluido en el KVM, la respuesta de SmartDocs será 400 Bad Request con un
de Bad Request-Hostname not permitted.
Nota: Si no agregas ni configuras este KVM, el proxy no aplicará la lista de entidades permitidas. Esta
podría ocasionar un acceso no autorizado a sus hosts y direcciones IP. Solo se deben incluir los nombres de host y las direcciones IP de los extremos de la API documentados con SmartDocs en los valores de "allowed_hosts".