This plugin will expose the OpenAPI Spec (OAS), Swagger, or other specification of auth protected API services fronted by the Kong gateway.
API providers need a means of exposing the specifications of their services while maintaining authentication on the service itself - this plugin solves this problem by:
Plugin enables Kong Admin to specify the endpoint of their API specification.
Plugin will validate the Proxy request is GET method, and will validate the proxy request ends with “/specz”. If these two requirements are met, the endpoint will return the specification of the API Service with Content-Type header identical to what the API Service exposes.
$ luarocks install kong-spec-expose
$ git clone https://github.com/Optum/kong-spec-expose.git /path/to/kong/plugins/kong-spec-expose $ cd /path/to/kong/plugins/kong-spec-expose $ luarocks make *.rockspec
Feel free to open issues, or refer to our Contribution Guidelines if you have any questions.