我正在使用 openApi 3.0 规范、koa2-swagger-ui 和 swagger-jsdoc。我正在尝试获取 swagger ui 上的 Authorize 按钮以允许我输入 JWT 令牌，以便我的请求将被授权。
我按照 OpenApi 3.0 文档在 securitySchemes 中设置了 bearerAuth，并且还使用了安全性使其成为全局性的。所有这些都是在我的 swagger-config.yaml 中实现的。
我想要的是能够在 swagger ui 上单击授权并可以选择输入 JWT。目前，当我单击授权时，该框为空。 空授权 请求响应 401 swagger ui
Swagger.json
{
"openapi": "3.0.0",
"info": {
"title": "LMS API Specification",
"version": "1.0.0",
"description": "Open documentation for LMS API"
},
"host": "localhost:8091",
"basePath": "/",
"components": {
"securitySchemes": {
"bearerAuth": {
"type": "http",
"scheme": "bearer",
"bearerFormat": "JWT"
}
}
},
"security": [
{
"bearerAuth": []
}
],
"paths": {
"/instructor/me": {
"get": {
"tags": [
"Instructor"
],
"description": "Finds all classes and their status for the current user",
"responses": {
"200": {
"description": "You have successfully found all classes and their status for the current user"
}
}
}
}
},
"tags": []
}
招摇配置.yaml
openapi: 3.0.0
info:
title: LMS API Specification
version: 1.0.0
description: Open documentation for LMS API
host: localhost:8091
basePath: /
apis: ['api/v1/instructor/index.js']
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
security:
- bearerAuth: []
应用程序.js
import Koa from 'koa'
import cors from 'koa-cors'
import serveStatic from 'koa-static'
// import websockify from 'koa-websocket'
import Logger from './lib/Logger'
import authInit from './auth'
import index from './routes/index'
import auth from './routes/auth'
import launch from './routes/launch'
import lesson from './routes/lesson'
import v1 from './api/v1'
import Router from 'koa-router'
export default async port => {
const koaSwagger = require('koa2-swagger-ui');
// const app = websockify(new Koa
const app = new Koa()
const swaggerJSDoc = require('swagger-jsdoc');
var router = new Router()
await authInit(app)
// Definitions for the swagger docs
const swaggerDefinition = {
info: {
// API informations (required)
title: 'LMS API Specification', // Title (required)
version: '1.0.0', // Version (required)
description: 'OpenAPI documentation for LMS', // Description (optional)
},
host: `localhost:8091/api/v1`, // Host (optional)
basePath: '/', // Base path (optional)
};
const options = {
// Import swaggerDefinitions
swaggerDefinition,
// Path to the API docs
// Note that this path is relative to the current directory from which the Node.js is ran, not the application itself.
apis: ['api/v1/instructor/index.js'],
};
// Initialize swagger-jsdoc -> returns validated swagger spec in json format
const swaggerSpec = swaggerJSDoc(options);
router.get('/swagger.json', async (ctx, next) => {
ctx.set('Content-Type', 'application/json')
ctx.body = (swaggerSpec);
return
});
app.use(
koaSwagger({
swaggerOptions: {
url: 'http://localhost:8091/swagger.json', // example path to json
},
hideTopbar: true,
routePrefix: '/docs', // route where the view is returned
}),
);
Logger.info(`Running in ${process.env.NODE_ENV} environment`)
app
.use(cors())
.use(serveStatic(__dirname + '/assets'))
.use(index.routes())
.use(auth.routes())
.use(launch.routes())
.use(lesson.routes())
.use(v1.routes())
.use(router.routes())
return app.listen(port, () => {
Logger.info(`> Ready on port ${port}`)
})
}
