Project: KICS (Provisioning / Security & Compliance)
File: 8aee4754-970d-4c5f-8142-a49dfe388b1a.md

title: Server Object Variable Not Used hide: toc: true navigation: true <style> .highlight .hll { background-color: #ff171742; } .md-content { max-width: 1100px; margin: 0 auto; } </style> Query id: 8aee4754-970d-4c5f-8142-a49dfe388b1a Query name: Server Object Variable Not Used Platform: OpenAPI Severity: <span style="color:#5bc0de">Info</span> Category: Structure and Semantics URL: Every defined Server Variable Object should be used in a Service URL.<br> ```json title="Positive test num. 1 - json file" hl_lines="38" { "openapi": "3.0.0", "info": { "title": "Simple API Overview", "version": "1.0.0" }, "paths": { "/": { "get": { "summary": "List API versions", "responses": { "200": { "description": "the user being returned", "content": { "application/json": { "schema": { "type": "object", "properties": { "uuid": { "type": "string", "format": "uuid" } } } } }, "links": { "address": { "server": { "url": "https://development.{server}.com/{base}", "variables": { "base": { "default": "v2" }, "server": { "default": "gigant-server" }, "another": { "default": "another" } } } } } } }, "operationId": "listVersionsv2" } } } } ``` ```json title="Positive test num. 2 - json file" hl_lines="35" { "openapi": "3.0.0", "info": { "title": "Simple API Overview", "version": "1.0.0" }, "paths": { "/": { "get": { "operationId": "listVersionsv2", "summary": "List API versions", "responses": { "200": { "description": "the user being returned", "content": { "application/json": { "schema": { "properties": { "uuid": { "type": "string", "format": "uuid" } }, "type": "object" } } } } }, "servers": [ { "url": "https://development.gigant-server.com/v2", "description": "Development server", "variables": { "base": { "default": "v2" } } } ] } } } } ``` ```yaml title="Positive test num. 3 - yaml file" hl_lines="30" openapi: 3.0.0 info: title: Simple API Overview version: 1.0.0 paths: "/": get: operationId: listVersionsv2 summary: List API versions responses: "200": description: the user being returned content: application/json: schema: type: object properties: uuid: # the unique user id type: string format: uuid links: address: server: url: https://development.{server}.com/{base} variables: base: default: v2 server: default: gigant-server another: default: another ``` <details><summary>Positive test num. 4 - yaml file</summary> ```yaml hl_lines="25" openapi: 3.0.0 info: title: Simple API Overview version:

paths: "/": get: operationId: listVersionsv2 summary: List API versions responses: "200": description: the user being returned content: application/json: schema: type: object properties: uuid: # the unique user id type: string format: uuid servers: url: https://development.gigant-server.com/v2 description: Development server variables: base: default: v2 ``` </details> ```json title="Negative test num. 1 - json file" { "openapi": "3.0.0", "info": { "title": "Simple API Overview", "version": "1.0.0" }, "paths": { "/": { "get": { "summary": "List API versions", "responses": { "200": { "description": "the user being returned", "content": { "application/json": { "schema": { "type": "object", "properties": { "uuid": { "type": "string", "format": "uuid" } } } } }, "links": { "address": { "server": { "url": "https://development.{server}.com/{base}", "variables": { "base": { "default": "v2" }, "server": { "default": "gigant-server" } } } } } } }, "operationId": "listVersionsv2" } } } } ``` ```json title="Negative test num. 2 - json 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": "the user being returned", "content": { "application/json": { "schema": { "properties": { "uuid": { "type": "string", "format": "uuid" } }, "type": "object" } } } } }, "servers": [ { "url": "https://development.{server}.com/{base}", "description": "Development server", "variables": { "base": { "default": "v2" }, "server": { "default": "gigant-server" } } } ] } } } } ``` ```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: the user being returned content: application/json: schema: type: object properties: uuid: # the unique user id type: string format: uuid links: address: server: url: https://development.{server}.com/{base} variables: base: default: v2 server: default: gigant-server ``` <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: the user being returned content: application/json: schema: type: object properties: uuid: # the unique user id type: string format: uuid servers: url: https://development.{server}.com/{base} description: Development server variables: base: default: v2 server: default: gigant-server ``` </details>