MAP-94: improve swagger docs for security service