I want to add a documentation to my Node.js API, for this I have a YAML file where I put my definitions, the swagger doc is at localhost:5000/api-doc and working fine.
Now I have to add Bearer authorization but Swagger with the following definition:
swagger: "2.0"
info:
version: 1.0.0
title: My API documentation
description: >
My API documentation
host: localhost:5000
basePath: "/v1"
schemes:
- http
securityDefinitions:
Bearer:
type: apiKey
description: "Value: Bearer "
name: Authorization
in: header
paths:
/users:
get:
responses:
"200":
description: "Will send `Authenticated`"
"403":
description: "You do not have necessary permissions for the resource"
When testing the request (I clicked on "Authorize" button at the top right and entered my token) I get following error:
"error": "Authorization header not found.
Why is the Authorization
header not included in the request?
securityDefinitions
alone aren't enough, you also need to add the security
key on the root level or operation level to actually apply the security.
security:
- Bearer: []