На схему безопасности Swagger PHP ссылаются плохо

Question

Я использую эту SecuritySchema для определения проверки безопасности JWT:

/*
     * @SWG\SecurityScheme(
     *   securityDefinition="JWT",
     *   type="apiKey",
     *   in="header",
     *   name="Authenticate"
     * ) */

И ссылаясь на это как:

/*
 * @SWG\Post(path="/ap/some/method",
 *   security={"JWT"={}},
 * )

и спецификации говорят, что я должен ссылаться как

{
...
"security":["JWT":[]]
...
}

но правда в том, что Swagger-PHP генерирует:

{
...
"security":{"JWT":[]}
...
}

который показывает как ошибки проверки на Swagger UI.

Вопрос заключается в следующем: как мне эмулировать желаемый вывод, чтобы избежать предупреждений / ошибок Swagger UI И Swagger PHP?

Answer 1

security":["JWT":[]] не является допустимым JSON, но спецификация требует массив для свойства безопасности.

Желаемый результат:

"security":[{"JWT":[]}]

Который может быть сгенерирован:

security={{"JWT":{}}}

(обратите внимание на дополнительные скобки)