[jira] [Created] (NIFIREG-172) Add self-hosted Swagger UI to nifi-registry-web-api WAR

["Kevin Doran (JIRA)" <ji...@apache.org>]

Kevin Doran created NIFIREG-172:
-----------------------------------

             Summary: Add self-hosted Swagger UI to nifi-registry-web-api WAR
                 Key: NIFIREG-172
                 URL: https://issues.apache.org/jira/browse/NIFIREG-172
             Project: NiFi Registry
          Issue Type: Improvement
            Reporter: Kevin Doran
            Assignee: Kevin Doran
             Fix For: 0.2.0


Currently in NiFi Registry, a detailed Swagger specification for the NiFi Registry REST API is being generated as part of the build. This is used for a number of things, including input into the REST API documentation handlebars.js templates and an input into downstream, community projects such as NiPyAPi [1].

The Swagger project also offers an Apache Licensed (ALv2) UI that consists of static html/js/css files that are capable of rendering any swagger.json specification in the form of a high-quality, interactive REST API documentation. The Swagger UI project is hosted on GitHub [2]. There is also an online demo of the Swagger UI [3].

This ticket is to augment the maven build for the nifi-registry-web-api war to bundle those static Swagger UI assets, enabling our swagger.json that is already being generated to be exposed through the Swagger UI as an additional resource.

The swagger ui static assets should be hosted at /nifi-registry-api/swagger/* and a pseudo-resource type for "swagger" will have to be added to the authorization resource types in order to allow administrators to control user access, in a similar manner to the actuator endpoints.

[1] https://github.com/Chaffelson/nipyapi
[2] https://github.com/swagger-api/swagger-ui
[3] http://petstore.swagger.io/



--
This message was sent by Atlassian JIRA
(v7.6.3#76005)