authentication - 如何让 Swagger UI 让我提供身份验证 header ？

Question

我使用 Luminus 以及 reitit 和 swagger-ui 来生成一个页面，让我可以试用我的 Luminus API。我只需输入我的 API 请求正文并提交即可测试我的 API。

现在我已经使用 buddy 添加了身份验证，并且我的 API 需要在请求的 header 中传递一个 token ，否则它会拒绝该请求作为被禁止的请求。
我正在尝试让“授权” header 字段神奇地出现在我的 UI 中，以便我可以输入 JWT token 字符串并测试我的 API。对于使用 reitit 创建 API 的任何人来说，这一定是一个非常普遍的要求，但我不知道如何去做。
我四处寻找，发现this reitit issues page ，其中包括文本...

Header params are declared as lower-case strings {:headers {"authorization" string?}} which would match exactly what Ring provides us. (Could still HTTP-Header-Case them for documentation.)

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

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

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

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

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


...看起来我在正确的轨道上，但我仍然无法在身份验证 header 中输入我的 token 。

正如我所说，一切都与 curl 一起工作......只是那个招摇没有显示任何添加身份验证 header 的方法。有人知道如何让 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 []}]}