Project: KICS (Provisioning / Security & Compliance)
File: fbf699b5-ef74-4542-9cf1-f6eeac379373.md

title: Numeric Schema Without Format (v3) hide: toc: true navigation: true <style> .highlight .hll { background-color: #ff171742; } .md-content { max-width: 1100px; margin: 0 auto; } </style> Query id: fbf699b5-ef74-4542-9cf1-f6eeac379373 Query name: Numeric Schema Without Format (v3) Platform: OpenAPI Severity: <span style="color:#edd57e">Low</span> Category: Insecure Configurations URL: Numeric schema (type set to 'integer' or 'number') should have 'format' defined.<br> ```json title="Positive test num. 1 - json file" hl_lines="58 75" { "openapi": "3.0.0", "info": { "title": "Simple API Overview", "version": "1.0.0", "contact": { "name": "contact", "url": "https://www.google.com/", "email": "user@gmail.com" } }, "paths": { "/": { "get": { "operationId": "listVersionsv2", "summary": "List API versions", "responses": { "200": { "description": "200 response", "content": { "application/json": { "examples": { "foo": { "value": { "versions": [ { "status": "CURRENT", "updated": "2011-01-21T11:33:21Z", "id": "v2.0", "links": [ { "href": "http://127.0.0.1:8774/v2/", "rel": "self" } ] } ] } } } } } } } } } }, "components": { "schemas": { "GeneralError": { "type": "object", "discriminator": { "propertyName": "petType" }, "additionalProperties": false, "properties": { "code": { "type": "integer", "minimum": 0, "maximum": 50 } }, "required": [ "petType" ] } }, "requestBodies": { "NewItem": { "description": "A JSON object containing item data", "required": true, "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/GeneralError" } } } } } } } ``` ```json title="Positive test num. 2 - json file" hl_lines="27" { "openapi": "3.0.0", "info": { "title": "Simple API Overview", "version": "1.0.0", "contact": { "name": "contact", "url": "https://www.google.com/", "email": "user@gmail.com" } }, "paths": { "/": { "get": { "responses": { "200": { "description": "200 response", "content": { "application/json": { "schema": { "discriminator": { "propertyName": "petType" }, "additionalProperties": false, "properties": { "code": { "type": "integer", "minimum": 0, "maximum": 50 } }, "required": [ "petType" ], "type": "object" }, "examples": { "foo": { "value": { "versions": [ { "status": "CURRENT", "updated": "2011-01-21T11:33:21Z", "id": "v2.0", "links": [ { "href": "http://127.0.0.1:8774/v2/", "rel": "self" } ] } ] } } } } } } }, "operationId": "listVersionsv2", "summary": "List API versions" } } } } ``` ```yaml title="Positive test num. 3 - yaml file" hl_lines="34 46" openapi: 3.0.0 info: title: Simple API Overview version: 1.0.0 paths: "/": get: operationId: listVersionsv2 summary: List API versions responses: "200": description: 200 response content: application/json: examples: foo: value: versions: status: CURRENT updated: "2011-01-21T11:33:21Z" id: v2.0 links: href: http://127.0.0.1:8774/v2/ rel: self components: schemas: GeneralError: type: object discriminator: propertyName: petType additionalProperties: false properties: code: type: integer minimum: 0 maximum: 50 required: petType requestBodies: NewItem: description: A JSON object containing item data required: true content: multipart/form-data: schema: $ref: "#/components/schemas/GeneralError" ``` <details><summary>Positive test num. 4 - yaml file</summary> ```yaml hl_lines="22" openapi: 3.0.0 info: title: Simple API Overview version: 1.0.0 paths: "/": get: operationId: listVersionsv2 summary: List API versions responses: "200": description: 200 response content: application/json: schema: type: object discriminator: propertyName: petType additionalProperties: false properties: code: type: integer minimum: 0 maximum: 50 required: petType examples: foo: value: versions: status: CURRENT updated: "2011-01-21T11:33:21Z" id: v2.0 links: href: http://127.0.0.1:8774/v2/ rel: self ``` </details> <details><summary>Positive test num. 5 - json file</summary> ```json hl_lines="23" { "swagger": "2.0", "info": { "title": "Simple API Overview", "version": "1.0.0", "contact": { "name": "contact", "url": "https://www.google.com/", "email": "user@gmail.com" } }, "paths": { "/": { "get": { "responses": { "200": { "description": "200 response", "schema": { "discriminator": "petType", "additionalProperties": false, "properties": { "code": { "type": "integer", "minimum": 0, "maximum": 50 } }, "required": [ "petType" ], "type": "object" } } }, "operationId": "listVersionsv2", "summary": "List API versions" } } } } ``` </details> <details><summary>Positive test num. 6 - yaml file</summary> ```yaml hl_lines="20" swagger: "2.0" info: title: Simple API Overview version: 1.0.0 contact: name: contact url: https://www.google.com/ email:

paths: "/": get: responses: "200": description: 200 response schema: discriminator: petType additionalProperties: false properties: code: type: integer minimum: 0 maximum: 50 required: petType type: object operationId: listVersionsv2 summary: List API versions ``` </details> ```json title="Negative test num. 1 - json file" { "openapi": "3.0.0", "info": { "title": "Simple API Overview", "version": "1.0.0", "contact": { "name": "contact", "url": "https://www.google.com/", "email": "user@gmail.com" } }, "paths": { "/": { "get": { "operationId": "listVersionsv2", "summary": "List API versions", "responses": { "200": { "description": "200 response", "content": { "application/json": { "examples": { "foo": { "value": { "versions": [ { "status": "CURRENT", "updated": "2011-01-21T11:33:21Z", "id": "v2.0", "links": [ { "href": "http://127.0.0.1:8774/v2/", "rel": "self" } ] } ] } } } } } } } } } }, "components": { "schemas": { "GeneralError": { "type": "object", "discriminator": { "propertyName": "petType" }, "additionalProperties": false, "properties": { "code": { "type": "integer", "format": "int32", "minimum": 0, "maximum": 50 } }, "required": [ "petType" ] } }, "requestBodies": { "NewItem": { "description": "A JSON object containing item data", "required": true, "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/GeneralError" } } } } } } } ``` ```json title="Negative test num. 2 - json file" { "openapi": "3.0.0", "info": { "title": "Simple API Overview", "version": "1.0.0", "contact": { "name": "contact", "url": "https://www.google.com/", "email": "user@gmail.com" } }, "paths": { "/": { "get": { "responses": { "200": { "description": "200 response", "content": { "application/json": { "schema": { "discriminator": { "propertyName": "petType" }, "additionalProperties": false, "properties": { "code": { "type": "integer", "minimum": 0, "maximum": 50, "format": "int32" } }, "required": [ "petType" ], "type": "object" }, "examples": { "foo": { "value": { "versions": [ { "status": "CURRENT", "updated": "2011-01-21T11:33:21Z", "id": "v2.0", "links": [ { "href": "http://127.0.0.1:8774/v2/", "rel": "self" } ] } ] } } } } } } }, "operationId": "listVersionsv2", "summary": "List API versions" } } } } ``` ```yaml title="Negative test num. 3 - yaml file" openapi: 3.0.0 info: title: Simple API Overview version: 1.0.0 paths: "/": get: operationId: listVersionsv2 summary: List API versions responses: "200": description: 200 response content: application/json: examples: foo: value: versions: status: CURRENT updated: "2011-01-21T11:33:21Z" id: v2.0 links: href: http://127.0.0.1:8774/v2/ rel: self components: schemas: GeneralError: type: object discriminator: propertyName: petType additionalProperties: false properties: code: type: integer format: int32 minimum: 0 maximum: 50 required: petType requestBodies: NewItem: description: A JSON object containing item data required: true content: multipart/form-data: schema: $ref: "#/components/schemas/GeneralError" ``` <details><summary>Negative test num. 4 - yaml file</summary> ```yaml openapi: 3.0.0 info: title: Simple API Overview version: 1.0.0 paths: "/": get: operationId: listVersionsv2 summary: List API versions responses: "200": description: 200 response content: application/json: schema: type: object discriminator: propertyName: petType additionalProperties: false properties: code: type: integer minimum: 0 maximum: 50 format: int32 required: petType examples: foo: value: versions: status: CURRENT updated: "2011-01-21T11:33:21Z" id: v2.0 links: href: http://127.0.0.1:8774/v2/ rel: self ``` </details> <details><summary>Negative test num. 5 - json file</summary> ```json { "swagger": "2.0", "info": { "title": "Simple API Overview", "version": "1.0.0", "contact": { "name": "contact", "url": "https://www.google.com/", "email": "user@gmail.com" } }, "paths": { "/": { "get": { "responses": { "200": { "description": "200 response", "schema": { "discriminator": "petType", "additionalProperties": false, "properties": { "code": { "type": "integer", "minimum": 0, "maximum": 50, "format": "int32" } }, "required": [ "petType" ], "type": "object" } } }, "operationId": "listVersionsv2", "summary": "List API versions" } } } } ``` </details> <details><summary>Negative test num. 6 - yaml file</summary> ```yaml swagger: "2.0" info: title: Simple API Overview version: 1.0.0 contact: name: contact url: https://www.google.com/ email: user@gmail.com paths: "/": get: responses: "200": description: 200 response schema: discriminator: petType additionalProperties: false properties: code: type: integer minimum: 0 maximum: 50 format: int32 required: petType type: object operationId: listVersionsv2 summary: List