Display securityDefinitions/security

[RomanHotsiy]

• securityDefinitions
• add security definitions to the side menu
• security

[adamaltman]

👍

[cayter]

+1

[rbaumi]

+1

[RomanHotsiy]

securityDefinitions are now rendered in the docs
Also the placement of securityDefinitions can be configured.
Check out details in the docs or check example in the demo spec

[SebastianStehle]

There are also security information per operation, e.g. you can specify the roles or claims. Would be awesome to support this:

 "security": [
      {
        "roles": []
      }
    ]

[mooop12]

Any news on this? This is kind of a big deal, most APIs use some kind of authorization. I know this will be important during API console implementation, but maybe until then we could get a placeholder link pointing to the appropriate securityDefinition section?

[robdefeo]

Missing this feature is significant because it does not allow the user to understand what security scopes are required for each operation. With complex API's this is a significant ask. What is the status with this feature?

[RomanHotsiy]

It is being worked on in version 2 (track here: #357)

Here is the screenshot of the current implementation. If anyone has a better idea of how to visualize this, please share!

[RomanHotsiy]

Implemented in 2.0-alpha.x

[tPl0ch]

@RomanGotsiy is there an npm package for the 2.0-rc* version? We'd like to use this feature but would need to completely change our redoc deployment (which is based on npm install currently).

Regards and many thanks for your work on redoc,
Thomas