Provide description of the security definition

[zregvart]

This is a...

[x] Feature request
[ ] Regression (a behavior that used to work and stopped working in a new release)
[ ] Bug report  
[ ] Documentation issue or request

Description

The OpenAPI 2.0 (Swagger) specification allows for the description to be present in the security definitions. When we present the choice to the user to select one security definition based on which the authentication related properties will be configured for the new custom API connector we only display the kind (Basic Authentication, OAuth, API Key) we don't display that description, if present.

We should also display the description to make it easier for the user to pick the security definition/authentication method for the new custom API connector.

[stale[bot]]

This issue has been automatically marked as stale because it has not had any activity since 90 days. It will be closed if no further activity occurs within 7 days. Thank you for your contributions!