Publishing a Secured Swagger Spec
Recently I had a requirement to publish a Swagger spec. My preferred method as a consumer would always be to have the JSON or YAML available to post to the Swagger Editor, because that tool offers the ability to generate code. But here the recipient just wanted to view it. So I looked at running the Swagger UI tool somewhere. Hosting via Docker was not, at this point, an option. So the download took me to the GitHub repo.
I have to admit to being a little confused by the documentation on deployment. The options just seemed to talk about embedding it in another web application, either npm or not. I was hoping for an option to just install Node.JS, build with some configuration of port etc and go. It looks like you have to build the web server component (which isn’t hard, admittedly) yourself. I think.
But the swagger-ui-dist module doesn’t need Node.JS and runs standalone. A quick test of putting it in the domino/html folder, amending the index.html to point to my spec and it was working. Very nice.