Incorporate securitySchemes

[conrs]

e.g.

security:
  - LROrgId: []
  - BearerToken: []

components:
  parameters: {}
  securitySchemes:
    LROrgId:
      type: apiKey
      in: header
      name: LR-Org-Id
    BearerToken:
      type: http
      scheme: bearer

Useful to call out and the above are the standard auth and org ID specifications.

[sirishalal]

Does anyone know what is it we are asking to be done here?

[forestgagnon]

this is partially resolved by #159, but it might not be surfaced as well in the api doc renderer as using the a semantic openapi field like securitySchemes. Not sure. Seems low priority now that we have arbitrary HTTP header support.

[njaczko]

It's also mostly duplicative of #21 (which we closed because it was partially resolved by #159)