带有 Spring 安全性的 Swagger-ui
我有一个带有身份验证服务的简单 REST 应用程序.我尝试向其中添加 swagger 和 swagger-ui，但我只能在 /v2/api-docs 中看到我的端点.在 swagger-ui.html 我只看到一组端点，但我无法扩展任何列表. 在 chrome 调试中我看到: 加载资源失败:服务器响应状态为401() 未捕获的类型错误:无法读取未定义的属性“indexOf"
..
swagger-ui相关内容
如何在没有用户在授权按钮处输入的情况下自动在 swagger 3.0 中添加基本身份验证?
我正在使用 swagger 3.0，并且在 swagger 文档中有多个端点. 我希望用户不要每次都在授权按钮处输入凭据. 有什么方法可以在 index.html 或我的 yaml 文件中包含身份验证以自动授权用户. 谢谢. 解决方案 Swagger UI 3.13.0+ 为此提供了 preauthorizeBasic 方法.假设您的 API 定义包含基本身份验证的安全方
..
Swashbuckle MapType<类型>不适用于参数
我有一个将 ShortGuid 类作为参数的 API 端点，如下所示: [HttpGet("api/endpoint")]公共异步任务GetTablesAsync(ShortGuid id){} 生成一个大摇大摆的定义: “参数":[{“名称":“指导"，“在":“查询"，“必需":假，“类型":“字符串"，“格式":“uuid"},{“名称":“值"，“在":
..
从 Swagger Editor 发出请求时，如何避免 CORS 错误(“无法获取"或“未找到服务器或发生错误")?
我有以下 OpenAPI 定义: swagger: "2.0"信息:版本:1.0.0标题:简单的 API描述:学习如何编写 OpenAPI 规范的简单 API方案:- https主办方:now.httpbin.org路径:/:得到:摘要:以 rfc2822 格式获取日期回复:200:架构:类型:对象项目:特性:现在:类型:对象RFC2822:类型:字符串 我想从 响应中检索 rfc2822:
..
swagger 在线编辑器可以通过地址栏输入一个 YAML url 作为输入吗?
我想访问 https://editor.swagger.io/ 但需要 YAML 文件基于 URL 参数预加载. 所以如果我想查看 https://github.com/OAI/OpenAPI-Specification/blob/master/examples/v3.0/petstore.yaml，我应该可以将其作为输入提供给可通过 Internet 访问的 swagger 编辑器.p>
..
使用 Spring Boot 配置 Swagger 时出现意外结果
我对 Swagger 非常陌生，我开始记录使用 Spring Boot 构建的非常简单的 Web 服务. 问题是，在我配置 swagger 之后，当我在浏览器中键入 localhost:8080/swagger-ui.html 时，我会看到以下屏幕，并带有一些奇怪的弹出消息，上面写着“无法推断"基本 url.这在使用动态 servlet 注册或 API 位于 API 网关后面时很常见. 我
..
检测到无效的映射模式:/**/swagger-ui/**
我正在将 springdoc-openapi-ui 用于 Spring Boot API 文档并面临以下问题 - 我已经添加了所有必要的配置如下 - maven 依赖 - org.springdocspringdoc-openapi-ui1.5.2
..
无法解析指针:/definitions/Error-ModelName
..
Python 连接不显示 Swagger UI
我使用 connexion 模块构建了一个基于 Python/Flask 的 REST API.这与使用 swagger.yml 文件定义 REST API 效果很好.应用程序正在运行，但是当我导航到/ui 时，我在浏览器中得到的只是: 我没有禁用 UI，所以我不确定发生了什么以及为什么 UI 没有显示.我的应用程序没有/static 文件夹(它只是一个 API)，因此该应用程序不提供任何静
..
如何在 Swagger 中定义角色/权限安全性
在我的 API 文档中，我想为每个 API 端点定义必要的安全性.该项目已定义角色和权限，以确定哪些用户可以访问 API.Swagger 中记录此信息的最佳方式是什么?是否有关于如何显示此详细信息的最佳做法或建议? 这是我尝试使用 securityDefinitions 和角色的自定义变量，但是当我通过 swagger2markup 或使用 swagger-ui 运行它时，该信息(x-rol
..
带有花饰的标头中的 API 密钥
我想使用 Swashbuckle (swagger for .net) 对 WebAPI 项目进行基于 API 密钥的身份验证. 我已将 swashbuckle 配置如下: 配置.EnableSwagger(c =>{c.ApiKey("apiKey").Description("API 密钥认证").Name("X-ApiKey").In("标题");c.SingleApiVersion
..
如何删除 swagger production .net core 2.1
我在多个微服务上大摇大摆地工作.部署到 Azure 时，由于安全最佳实践，我们需要一起删除 swagger 选项.使用 .net 核心 2.1寻找定义的例子. 解决方案 首先，什么是“安全最佳实践"?将 API 文档用于生产并没有错.这实际上是重点:客户应该能够查看文档，以便他们可以正确使用您的 API.如果这些微服务不被外部客户端使用，那么问题就更小了，因为无论如何，外部没有人可以访问服
..
node.js 上招摇的可空字段
我花了很多时间试图找到在 Node.JS 中创建 swagger 文档的解决方案.主库是 swagger-node，您可以在其中创建一个 swagger yaml 文件，然后将控制器添加到其中.它会自动在您的应用程序中提供 swagger ui 文档，并对请求进行验证响应您在 yaml 中指定的模型. 这很简洁，但是我有一个要求，我希望某些字段能够显式返回或接受 null 作为值，例如:
..
具有 .NetCore 3.0 不记名令牌授权的 SwaggerUI
我正在尝试将授权标头添加到 SwaggerUI api 测试中.下面是我的 Startup.cs public void ConfigureServices(IServiceCollection services){服务.AddControllers();services.Configure(options =>{options.SuppressModel
..
如何在请求之前在 Swagger 中计算 AWS 签名 V4
对于我们的 AWS API 终端节点，我们使用 AWS_IAM 授权并希望从 Swagger UI 进行调用.要成功调用，必须有 2 个标头“授权"和“x-amz-date".为了形成“授权"，我们使用 遵循 aws doc 中的步骤.我们必须在每次调用时更改“x-amz-date"以通过授权.问题是:如何在 Swagger 中编写脚本来签署请求，每次 在 请求发送到 aws 时运行该脚本?(我们
..
如何在 spring-boot 中完全禁用 swagger-ui?(/swagger-ui.html 应该返回 404)
..
如何在生产中关闭 swagger-ui
我已经大摇大摆地插入了我的 Spring Boot 应用程序.Spring boot 允许您拥有每个环境的属性文件.有没有办法在生产环境中禁用 swagger? 解决方案 将你的 swagger 配置放到单独的配置类中，并用 @Profile 注释进行注释 -> 以便将其扫描到 Spring 上下文中仅在某些配置文件中. 例子: @Configuration@EnableSwagg
..
如何在 Swagger-UI 中打开本地文件
我正在尝试使用 swagger- 打开我自己生成的 swagger 规范文件 my.jsonui 在我的本地计算机上. 于是我下载了最新标签v2.1.8-M1并提取拉链.然后我进入子文件夹 dist 并将文件 my.json 复制到其中.现在我打开 index.html 并想探索 my.json.问题从这里开始: 如果我输入一个本地路径，它总是会以包含 index.html 的当前 u
..
虚拟目录中的 IIS 站点 Swagger UI 端点
Swagger UI 端点与 staging 中的 dev 不同(不包括域名) IIS 配置 public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)app.UseSwagger(c=>{//改变终点的路径，也应该为这个改变更新UI中间件c.
..
如何在 OpenAPI/Swagger 中递归引用封闭类型定义?
我正在 Swagger Editor 中编写 OpenAPI 定义. 我的一个类型定义包含一个数组，其中包含与父元素相同类型的子元素.IE.像这样: 定义:树节点:类型:对象特性:名称:类型:字符串描述:树节点的名称.孩子们:类型:数组项目:$ref: '#/definitions/TreeNode' 但是，Swagger 编辑器不会在 children 数组中提取递归引用，它只是显示为
..