I am looking for the proper way to specify an Authorization header with a custom type like ApiKey in openAPI 3.
The custom Authorization header should look like
I think I have found a way that seems acceptable - although not perfect. Would like to see something better in the future...
It seems that there is no other way than to add the custom type to the value (aided by a description like below).
components:
securitySchemes:
ApiKey:
type: apiKey
name: Authorization
in: header
description: 'Prefix the value with \"ApiKey\" to indicate the custom authorization type'
security:
- ApiKey: []
This does at least produce the correct header in curl (if applied correctly).