From a5ad1f94876502c9b002feb6dc680ca5809bb784 Mon Sep 17 00:00:00 2001 From: Pasha Zayko Date: Fri, 8 May 2026 17:21:40 -0400 Subject: [PATCH 1/2] Adding new endpoint Adding endpoint definition to respond to healthcheck probes --- specs/SHIELD.json | 69 ++++++++++++++++++++++++- src/shield/TypeScript/package-lock.json | 4 +- src/shield/TypeScript/package.json | 2 +- 3 files changed, 71 insertions(+), 4 deletions(-) diff --git a/specs/SHIELD.json b/specs/SHIELD.json index 8c02b1c..b778ffc 100644 --- a/specs/SHIELD.json +++ b/specs/SHIELD.json @@ -363,6 +363,37 @@ } ] }, + "Core.HealthReport": { + "description": "Health report that indicates if a service is down or not that SHIELD web app relies on.", + "properties": { + "authClient": { + "description": "Flag that indicates if the client side authentication validation is working or not.", + "examples": [ + false + ], + "type": "boolean" + }, + "authServer": { + "description": "Flag that indicates if the server side authentication is working or not.", + "examples": [ + true + ], + "type": "boolean" + } + }, + "required": [ + "authClient", + "authServer" + ], + "title": "Core System - Health Report", + "type": "object", + "examples": [ + { + "authClient": false, + "authServer": true + } + ] + }, "Core.ProgressBar": { "title": "Core - Progress Bar", "description": "Used to indicate the progress of a long running operation.", @@ -3990,7 +4021,7 @@ }, "description": "Deprive your threats of practical significance. Deploy the Securing Privilege Access architecture. All in a few seconds.", "title": "SHI Environment Lockdown and Defense", - "version": "3.4.1" + "version": "3.5.0" }, "openapi": "3.1.1", "paths": { @@ -4033,6 +4064,42 @@ "summary": "Indicates If the System Requirements Are Met or Not." } }, + "/Api/Core/Health": { + "get": { + "description": "Check the health of the various components of the SHIELD app and report back. Useful for automated health probing.", + "operationId": "/Api/Core/Health/Get", + "responses": { + "201": { + "description": "Service is operational!" + }, + "500": { + "description": "Service has a failure described with following report.", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Core.HealthReport" + }, + "examples": { + "Auth system failure": { + "summary": "Example Health Report - Auth Failure", + "description": "An example health report returned indicates the authentication components are not working.", + "value": { + "authClient": false, + "authServer": true + } + } + } + } + } + } + }, + "tags": [ + "Core" + ], + "security": [], + "summary": "Health of the Service for Probing" + } + }, "/Api/Auth/Id": { "get": { "description": "Provides the Tenant ID and the Application ID of the service principal that access tokens need to be issued against. This is also useful for configuring public clients to be able to authenticate to for auth code flows.", diff --git a/src/shield/TypeScript/package-lock.json b/src/shield/TypeScript/package-lock.json index 77e3adc..c93f929 100644 --- a/src/shield/TypeScript/package-lock.json +++ b/src/shield/TypeScript/package-lock.json @@ -1,12 +1,12 @@ { "name": "@shi-corp/sdk-shield", - "version": "3.4.1", + "version": "3.5.0", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "@shi-corp/sdk-shield", - "version": "3.4.1", + "version": "3.5.0", "license": "MIT", "dependencies": { "@microsoft/kiota-authentication-azure": "~1.0.0-preview.100", diff --git a/src/shield/TypeScript/package.json b/src/shield/TypeScript/package.json index 5a2e85e..ccc4df2 100644 --- a/src/shield/TypeScript/package.json +++ b/src/shield/TypeScript/package.json @@ -1,6 +1,6 @@ { "name": "@shi-corp/sdk-shield", - "version": "3.4.1", + "version": "3.5.0`", "type": "module", "main": "bin/index.js", "description": "SDK client used to interface with the SHIELD application.", From 18225eb669142adb8cb529a7207e648c6a7bbe30 Mon Sep 17 00:00:00 2001 From: Pasha Zayko Date: Wed, 13 May 2026 17:02:00 -0400 Subject: [PATCH 2/2] Typo fix Fixing typo --- src/shield/TypeScript/package.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/shield/TypeScript/package.json b/src/shield/TypeScript/package.json index ccc4df2..ddbf79c 100644 --- a/src/shield/TypeScript/package.json +++ b/src/shield/TypeScript/package.json @@ -1,6 +1,6 @@ { "name": "@shi-corp/sdk-shield", - "version": "3.5.0`", + "version": "3.5.0", "type": "module", "main": "bin/index.js", "description": "SDK client used to interface with the SHIELD application.",