Success Response Code Undefined for Head Operation (v3)
- Query id: 3b066059-f411-4554-ac8d-96f32bff90da
- Query name: Success Response Code Undefined for Head Operation (v3)
- Platform: OpenAPI
- Severity: Low
- Category: Networking and Firewall
- CWE: 665
- URL: Github
Description¶
Head should define at least one success response (200 or 202)
Documentation
Code samples¶
Code samples with security vulnerabilities¶
Positive test num. 1 - json file
{
"openapi": "3.0.0",
"info": {
"title": "Simple API",
"version": "1.0.0"
},
"paths": {
"/item": {
"head": {
"operationId": "headItem",
"summary": "Head item",
"responses": {
"default": {
"description": "Error"
}
}
}
}
}
}
Positive test num. 2 - yaml file
openapi: 3.0.0
info:
title: Simple API
version: 1.0.0
paths:
"/item":
head:
operationId: headItem
summary: Head item
responses:
default:
description: Error
Positive test num. 3 - json file
{
"swagger": "2.0",
"info": {
"title": "Simple API",
"version": "1.0.0"
},
"paths": {
"/item": {
"head": {
"operationId": "headItem",
"summary": "Head item",
"responses": {
"default": {
"description": "Error"
}
}
}
}
}
}
Positive test num. 4 - yaml file
Code samples without security vulnerabilities¶
Negative test num. 1 - json file
{
"openapi": "3.0.0",
"info": {
"title": "Simple API",
"version": "1.0.0"
},
"paths": {
"/item": {
"head": {
"operationId": "headItem",
"summary": "Head item",
"responses": {
"200": {
"description": "success"
},
"default": {
"description": "Success"
}
}
},
"patch": {
"operationId": "updateItem",
"summary": "Update item",
"responses": {
"default": {
"description": "Error"
}
}
}
}
}
}
Negative test num. 2 - yaml file
openapi: 3.0.0
info:
title: Simple API
version: 1.0.0
paths:
"/item":
head:
operationId: headItem
summary: Head item
responses:
"200":
description: success
default:
description: Success
patch:
operationId: updateItem
summary: Update item
responses:
default:
description: Error
Negative test num. 3 - json file
{
"swagger": "2.0",
"info": {
"title": "Simple API",
"version": "1.0.0"
},
"paths": {
"/item": {
"head": {
"operationId": "headItem",
"summary": "Head item",
"responses": {
"200": {
"description": "success"
},
"default": {
"description": "Success"
}
}
},
"patch": {
"operationId": "updateItem",
"summary": "Update item",
"responses": {
"default": {
"description": "Error"
}
}
}
}
}
}
Negative test num. 4 - yaml file
Negative test num. 5 - json file
{
"swagger": "2.0",
"info": {
"title": "Simple API",
"version": "1.0.0"
},
"paths": {
"/item": {
"head": {
"operationId": "headItem",
"summary": "head item",
"responses": {
"2XX": {
"description": "Item head successfully"
},
"default": {
"description": "Error"
}
}
},
"patch": {
"operationId": "updateItem",
"summary": "Update item",
"responses": {
"default": {
"description": "Error"
}
}
}
}
}
}