securityHandlers let http routes specify scopes, these should be displayed in swagger UI

[asarver]

using 4.5.0

openapi express allows you to specify scopes for individual routes using securityHandlers for http routes (similar to oauth). These should be displayed on the UI so users know which scopes are needed for which routes

{
  openapi: '3.0.0',
  info: {
    title: 'Example'
    version: '1.0.0'
  },
  components: {
    schemas: {
      Version: {
        type: 'object',
        properties: {
          version: {
            type: 'string',
            description: 'Semantic version number for the application',
            example: '0.1.0'
          }
        }
      }
    },
    securitySchemes: {
      BearerSchema: {
        type: 'http',
        scheme: 'bearer'
      },
      HeaderSchema: {
        type: 'apikey',
        name: 'apikey',
        in: 'header'
      }
    }
  },
  paths: {
    '/': {
      get: {
        operationId: 'getVersion',
        tags: ['version'],
        summary: 'Check the running version of the API',
        security: [{
          BearerSchema: ['read'],
          HeaderSchema: []
        }],
        responses: {
          200: {
            description: 'success',
            content: {
              'application/json': {
                schema: {
                  $ref: '#/components/schemas/Version'
                }
              }
            }
          }
        }
      }
    }
  }
}

and how it's used in the app

// register open api routes
initialize({
  app,
  apiDoc,
  promiseMode: true,
  exposeApiDocs: false,
  operations: {
    getVersion
  },
  securityHandlers: {
    BearerSchema: (req, scopes, def) => {
      log.info({ scopes, def }, 'in handler')
      return true
    }
  }
})

[scottie1984]

I am guessing this should be raised with swagger ui directly? This module is just about simplifying the hosting and configuration of the UI