99.4. 在 API 文档中添加安全定义

Rest DSL 现在支持在生成的 API 文档中声明 OpenApi securityDefinitions。例如，如下所示：

rest("/user").tag("dude").description("User rest service")
    // setup security definitions
    .securityDefinitions()
        .oauth2("petstore_auth").authorizationUrl("http://petstore.swagger.io/oauth/dialog").end()
        .apiKey("api_key").withHeader("myHeader").end()
    .end()
    .consumes("application/json").produces("application/json")

在这里，我们设置了两个安全定义

然后，您需要通过引用其密钥(petstore_auth 或 api_key)来指定使用其他操作。

.get("/{id}/{date}").description("Find user by id and date").outType(User.class)
    .security("api_key")

...

.put().description("Updates or create a user").type(User.class)
    .security("petstore_auth", "write:pets,read:pets")

此处 get 操作使用 Api Key 安全性，put 操作使用带有允许的读取和写入片断范围的 OAuth 安全性。