Swagger Editor and Supporting Services

Question

Hello,&nbsp;I have been successful in running Docker containers for Swagger UI and Swagger Editor, from swaggerapi/swagger-ui and swaggerapi/swagger-editor (pulled from DockerHub), respectively. This approach works well, but I quickly realized that Swagger Editor reaches out to a few other supporting services, at least:&nbsp;https://generator.swagger.iohttps://generator3.swagger.iohttps://converter.swagger.io/api/convert&nbsp;I know there are Docker containers for these as well, but I haven't been able to configure the Swagger Editor container to use them instead of reaching out to swagger.io.&nbsp;I rather avoid sending any API definitions to an external network.&nbsp;What are your recommendations?&nbsp;Much appreciated!

ponelat · Accepted Answer

The Docker image for SwaggerEditor is missing support for overriding configuration at the moment. There are two (old) issues that track that:
-&nbsp;https://github.com/swagger-api/swagger-editor/issues/1488
-&nbsp;https://github.com/swagger-api/swagger-editor/issues/1547
&nbsp;
It'd be great if you were interested in pushing any of those issues forward, as it's not a high priority for the core contributors at the moment.&nbsp;
&nbsp;
One way to achieve your goal is to override the default index.html, with the new URL configured in it.
Something like
&nbsp;
docker run -it --rm -p 8080:8080 -v "$(pwd)/index.html:/usr/share/nginx/html/index.html" swaggerapi/swagger-editor
&nbsp;
Where `$(pwd)` is the directory where your copy of index.html.&nbsp;
The official index.html is here: https://github.com/swagger-api/swagger-editor/blob/master/index.html.
And an example with the URLs overwritten can be found here:&nbsp;https://gist.github.com/ponelat/a63e894c87fdc626b520c69aa13ccba7#file-index-html-L56-L58&nbsp;

ponelat · Answer

Hi&nbsp;Syntax0111&nbsp;
&nbsp;
Glad the example works.
Not sure what can be done about the SSL error, there isn't any built-in SSL for those containers so it'll be a configuration on your HTTPS termination point (nginx/apache/etc). However there are some redirect configurations you can try, see https://github.com/swagger-api/validator-badge#swagger-validator-badge-&nbsp;for more details.
&nbsp;
Another point of caution is to ensure you're going to the right port.
&nbsp;
&nbsp;

syntax0111 · Answer

So far, this works great locally. Thank you so much for the reply ponelat!

However, when attempting to deploy this behind an HTTPS connection, I get the following 'Secure Connection Failed' Error code:

SSL_ERROR_RX_RECORD_TOO_LONG

Is there anything special I need to do to instantiate the following containers in order to avoid this error:

swaggerapi/swagger-validator-v2

swaggerapi/swagger-converter

Thanks again!

syntax0111 · Answer

Hello&nbsp;ponelat, after speaking to my peer, the SSL error turned out to be a NAT configuration issue which we were able to take care of, thank you. We now have instances of the supporting services listed below running in our test environment using the Docker containers from Docker Hub:&nbsp;swaggerapi/swagger-validator-v2swaggerapi/swagger-converter&nbsp;However, I am still facing some challenges with these services when requesting validation/conversion to an API definition that is hosted on the same server.&nbsp;While the sample&nbsp;https://petstore.swagger.io/v2/swagger.json&nbsp;validates with our instance of the validator badge and converts properly to OpenAPI 3.0 with the converter, I can't seem to validate any APIs definitions that are hosted on the same server, albeit different ports, for example, the following succeeds:&nbsp;https://example.test.host.com:8050/validator/?url=https://petstore.swagger.io/v2/swagger.json,&nbsp;andhttps://example.test.host.com:8051/api/convert/?url=https://petstore.swagger.io/v2/swagger.json&nbsp;But, the following request against an internal API's definition hosted on the same server, fails to validate and convert:&nbsp;https://example.test.host.com:8050/validator/?url=https://example.test.host.com:8052/api/swagger.json (fails validation)https://example.test.host.com:8051/api/convert/?url=https://example.test.host.com:8052/api/swagger.json&nbsp;(fails conversion)&nbsp;The validator badge fails with the error "Can't read from file https://example.test.host.com:8052/api/swagger.json"&nbsp;with an HTTP status code of 400 Bad Request.&nbsp;The converter fails with something similar: "Unable to read location 'https://example.test.host.com:8052/api/swagger.json'" with the same status.&nbsp;Here is a bit more detail on our current setup and where we are trying to go with this:&nbsp;We are trying to implement Swagger Opensource tools using the Dockerized services available in Docker Hub to view and author OpenAPI compliant definition files.&nbsp;So far, we have an instance of Swagger UI running to serve as our API catalog accomplished by using the URLS environment variable as described in the documentation (https://github.com/swagger-api/swagger-ui/blob/master/docs/usage/configuration.md) with URLs to some of our internal APIs that sit on the same server but on different ports. This works great and the UI has a drop down list to choose the APIs definition to render. Our next goal is to point our instance of Swagger UI to validate with our local validator instance since it's currently disabled.&nbsp;The Swagger Editor's File &gt; Import URL works great with the addresses to the internal API's definition as well, but although we were able to configure the Editor to point to our internal converter, the converter is unable to read definition as described above.&nbsp;One difference I noticed between the two containers that worked for us, Swagger UI and Editor and the two that are not working for us, is the port configuration the containers are configured with. While Swagger UI and Editor have the following configuration:&nbsp;PORTS&nbsp; &nbsp; NAMES80/tcp, 0.0.0.0:aaaa-&gt;8080/tcp&nbsp; &nbsp; swagger-ui80/tcp, 0.0.0.0:bbbb-&gt;8080/tcp&nbsp; &nbsp; swagger-editor&nbsp;The validator and converter look as follows:&nbsp;PORTS&nbsp; &nbsp; NAMES0.0.0.0:cccc-&gt;8080/tcp&nbsp; &nbsp; swagger-validator0.0.0.0:dddd-&gt;8080/tcp&nbsp; &nbsp; swagger-converter&nbsp;Any ideas on the reason the validator/converter can't read internally exposed definitions would be greatly appreciated.&nbsp;Thanks again!

ponelat · Answer

Hey&nbsp;Syntax0111&nbsp;
&nbsp;
I'm not entirely sure as these issues are more related to your networking than to Swagger itself.
It does sound like your internal services are not public, and because SwaggerUI makes calls from the browser (there is no sever component), it may not be able to reach your internal services.
&nbsp;
SwaggerUI (and the user's browser running SwaggerUI) will need to be able to reach your internal services. You could expose them publicly, or else you may need to consider using a VPN or other authentication methods (HTTP Basic as a crude alternative).

Forum Discussion

Swagger Editor and Supporting Services

5 Replies

Related Content

swagger- specific_Api

Creating virtual service using swagger definition (swagger.Json) URL failing

Swagger: How to stub REST service with Java code/annotations

Swagger Response In Array

Does free version of SOAPUI 5.3.0 support swagger and postman plugins?

Recent Discussions

Authorization Tag For Basic BASE64 Encoding

Support for Google Signin

parsing csv columns in enum on json file from flask-python

Swagger Editor (Local) CORS Error

SwaggerHub CORS Error