如何让 Swagger UI 让我提供身份验证标头？

Question

我使用 Luminus 以及 reitit 和 swagger-ui 生成一个页面，让我可以尝试我的 Luminus API。我只需输入 API 请求正文并提交即可测试我的 API。 现在我已经使用伙伴添加了身份验证，并且我的 API 要求在请求标头中传递令牌，否则它会因为禁止而拒绝该请求。
我试图让“授权”标头字段神奇地出现在我的 UI 中，以便我可以输入 JWT 令牌字符串并测试我的 API。对于任何使用 reitit 创建 API 的人来说，这一定是一个非常常见的要求，但我不知道如何做到这一点。我到处搜索，发现了这个 reitit 问题页面，其中包括文本......

标头参数被声明为小写字符串 {:headers {"authorization" string?}} ，这将与 Ring 为我们提供的内容完全匹配。（仍然可以使用 HTTP-Header-Case 来获取文档。）

...并建议以下设置...

:get {:summary "list offers"
      :parameters 
        {:headers 
          {"authorization" string?}}
         ... etc

这样做并没有让我有任何方式进行身份验证。因此，我找到了此讨论并通过在上述路线中的 :summary 和 :parameters 之后添加以下内容来编辑我的路线...

             :middleware [authenticated?]
             :swagger {:security [:apiKey]}

添加后，我得到了这个......

...看起来我走在正确的轨道上，但我仍然无法在 auth 标头中输入我的令牌。

正如我所说，一切都与卷曲一起工作......只是那个大摇大摆没有显示任何添加身份验证标头的方法。有人知道如何让 Swagger UI 在这种情况下发挥作用吗？

如果 reitit 不支持这一点，那么人们如何使用 Swagger UI 来处理经过身份验证的请求？

任何帮助，将不胜感激！

Answer 1

好的。解决了。

在我的 API 路由的根部（封装我可能最终使用此身份验证的所有路由），我添加 :securityDefinitions。

  ["/api"
   {:swagger {:id ::api
              :securityDefinitions {:apiAuth
                                             {:type "apiKey"
                                              :name "Authorization"
                                              :in "header"
                                              }}}

里面具体路线：

             :middleware [authenticated?]
             :swagger {:security [{:apiAuth []}]}