Skill: krishnakumarmahadevan-cmd/toolweb-itsm-security-maturity (version 1.0.0)

--- name: ITSM Security Maturity Assessment description: Comprehensive ITSM/ITIL security maturity evaluation platform for assessing organizational compliance and process maturity across eight critical ITSM domains. --- # Overview The ITSM Security Maturity Assessment platform provides a comprehensive evaluation framework for organizations seeking to benchmark and improve their IT Service Management security posture against ITIL best practices. This platform enables enterprises to systematically assess their maturity across eight critical ITSM processes: incident management, problem management, change management, release management, asset management, service desk operations, knowledge management, and SLA management. Organizations use this assessment tool to identify capability gaps, prioritize security improvements, and demonstrate compliance with industry frameworks. The platform evaluates each ITSM process across four dimensions (q1-q4), using a 0-5 maturity scale to provide granular insight into process effectiveness, security controls, and organizational readiness. Real-time scoring and comparative analysis help security leaders and ITSM practitioners make data-driven decisions about resource allocation and process optimization. Ideal users include CISSP-certified security architects, ITIL-certified service managers, compliance officers, and enterprise security teams responsible for IT governance and operational risk management. ## Usage ### Sample Request ```json { "sessionId": "sess-20250116-001", "userId": 42, "timestamp": "2025-01-16T14:30:00Z", "assessmentData": { "sessionId": "sess-20250116-001", "timestamp": "2025-01-16T14:30:00Z", "incident_management": { "q1": 4, "q2": 3, "q3": 4, "q4": 3 }, "problem_management": { "q1": 3, "q2": 3, "q3": 2, "q4": 2 }, "change_management": { "q1": 5, "q2": 4, "q3": 4, "q4": 5 }, "release_management": { "q1": 3, "q2": 3, "q3": 3, "q4": 2 }, "asset_management": { "q1": 4, "q2": 4, "q3": 3, "q4": 4 }, "service_desk": { "q1": 4, "q2": 4, "q3": 4, "q4": 3 }, "knowledge_management": { "q1": 2, "q2": 2, "q3": 2, "q4": 1 }, "sla_management": { "q1": 4, "q2": 3, "q3": 3, "q4": 4 } } } ``` ### Sample Response ```json { "sessionId": "sess-20250116-001", "userId": 42, "timestamp": "2025-01-16T14:30:00Z", "assessmentResults": { "incident_management": { "average_maturity": 3.5, "maturity_level": "Managed", "score": 3.5 }, "problem_management": { "average_maturity": 2.5, "maturity_level": "Defined", "score": 2.5 }, "change_management": { "average_maturity": 4.5, "maturity_level": "Optimized", "score": 4.5 }, "release_management": { "average_maturity": 2.75, "maturity_level": "Defined", "score": 2.75 }, "asset_management": { "average_maturity": 3.75, "maturity_level": "Managed", "score": 3.75 }, "service_desk": { "average_maturity": 3.75, "maturity_level": "Managed", "score": 3.75 }, "knowledge_management": { "average_maturity": 1.75, "maturity_level": "Initial", "score": 1.75 }, "sla_management": { "average_maturity": 3.5, "maturity_level": "Managed", "score": 3.5 }, "overall_maturity": 3.28, "overall_maturity_level": "Managed", "recommendations": [ "Enhance knowledge management documentation and processes", "Strengthen release management controls and automation", "Advance problem management root cause analysis practices" ] }, "status": "success" } ``` ## Endpoints ### GET / **Health Check Endpoint** Verifies the API service is operational. Used for liveness and readiness probes. - **Method**: GET - **Path**: `/` - **Parameters**: None - **Response**: JSON object confirming service status (HTTP 200) --- ### POST /api/itsm/assess **Assess ITSM Security Maturity** Evaluates organizational ITSM security maturity across eight critical processes. Accepts assessment responses for incident management, problem management, change management, release management, asset management, service desk operations, knowledge management, and SLA management. Returns calculated maturity scores, levels, and improvement recommendations. - **Method**: POST - **Path**: `/api/itsm/assess` - **Content-Type**: application/json - **Required Parameters**: - `assessmentData` (object, required): Core assessment data containing process evaluations and session metadata - `incident_management` (ProcessAssessment, required): Incident management process scores (q1-q4, 0-5 scale) - `problem_management` (ProcessAssessment, required): Problem management process scores (q1-q4, 0-5 scale) - `change_management` (ProcessAssessment, required): Change management process scores (q1-q4, 0-5 scale) - `release_management` (ProcessAssessment, required): Release management process scores (q1-q4, 0-5 scale) - `asset_management` (ProcessAssessment, required): Asset management process scores (q1-q4, 0-5 scale) - `service_desk` (ProcessAssessment, required): Service desk process scores (q1-q4, 0-5 scale) - `knowledge_management` (ProcessAssessment, required): Knowledge management process scores (q1-q4, 0-5 scale) - `sla_management` (ProcessAssessment, required): SLA management process scores (q1-q4, 0-5 scale) - `sessionId` (string, required): Unique session identifier for tracking assessment - `timestamp` (string, required): ISO 8601 timestamp of assessment data collection - `sessionId` (string, required): Unique session identifier for request tracking - `timestamp` (string, required): ISO 8601 timestamp of assessment submission - **Optional Parameters**: - `userId` (integer or null, optional): Numeric identifier of user conducting assessment - **Response** (HTTP 200): - `sessionId`: Session identifier - `userId`: User identifier (if provided) - `timestamp`: Processing timestamp - `assessmentResults`: Object containing: - Individual process results with average_maturity, maturity_level, and score - `overall_maturity`: Numeric average across all eight processes (0-5 scale) - `overall_maturity_level`: Text maturity level (Initial, Managed, Defined, Optimized) - `recommendations`: Array of prioritized improvement actions - `status`: "success" on completion - **Error Response** (HTTP 422): - `detail`: Array of validation errors with location, message, and error type --- ### GET /api/itsm/maturity-levels **Get Maturity Level Definitions** Retrieves the standard ITSM maturity level framework and definitions used for assessment scoring and interpretation. - **Method**: GET - **Path**: `/api/itsm/maturity-levels` - **Parameters**: None - **Response**: JSON object containing: - Level definitions (Initial, Managed, Defined, Optimized) - Characteristics and capabilities at each level - Assessment criteria and thresholds --- ### GET /api/itsm/process-definitions **Get ITSM Process Definitions** Retrieves detailed definitions of the eight ITSM processes evaluated by the assessment platform, including process objectives, key activities, and security requirements. - **Method**: GET - **Path**: `/api/itsm/process-definitions` - **Parameters**: None - **Response**: JSON object containing: - Eight process definitions (incident, problem, change, release, asset, service desk, knowledge, SLA management) - Process purpose and scope - Key activities and security controls - Assessment dimensions (q1-q4 focus areas) --- ## Pricing | Plan | Calls/Day | Calls/Month | Price | |------|-----------|-------------|-------| | Free | 5 | 50 | Free | | Developer | 20 | 500 | $39/mo | | Professional | 200 | 5,000 | $99/mo | | Enterprise | 100,000 | 1,000,000 | $299/mo | ## About ToolWeb.in - 200+ security APIs, CISSP & CISM, platforms: Pay-per-run, API Gateway, MCP Server, OpenClaw, RapidAPI, YouTube. - [toolweb.in](https://toolweb.in) - [portal.toolweb.in](https://portal.toolweb.in) - [hub.toolweb.in](https://hub.toolweb.in) - [toolweb.in/openclaw/](https://toolweb.in/openclaw/) - [rapidapi.com/user/mkrishna477](https://rapidapi.com/user/mkrishna477) - [youtube.com/@toolweb-009](https://youtube.com/@toolweb-009) ## References - **Kong Route**: https://api.mkkpro.com/compliance/itsm-maturity - **API Docs**: https://api.mkkpro.com:8104/docs

path: openapi.json
content: {
  "openapi": "3.1.0",
  "info": {
    "title": "ITSM Security Maturity Assessment",
    "description": "Comprehensive ITSM/ITIL Security Maturity Evaluation Platform",
    "version": "1.0.0"
  },
  "paths": {
    "/": {
      "get": {
        "summary": "Root",
        "description": "Health check endpoint",
        "operationId": "root__get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/api/itsm/assess": {
      "post": {
        "summary": "Assess Maturity",
        "description": "Assess ITSM security maturity",
        "operationId": "assess_maturity_api_itsm_assess_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AssessmentRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/api/itsm/maturity-levels": {
      "get": {
        "summary": "Get Maturity Levels",
        "description": "Get maturity level definitions",
        "operationId": "get_maturity_levels_api_itsm_maturity_levels_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    },
    "/api/itsm/process-definitions": {
      "get": {
        "summary": "Get Process Definitions",
        "description": "Get ITSM process definitions",
        "operationId": "get_process_definitions_api_itsm_process_definitions_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "AssessmentData": {
        "properties": {
          "incident_management": {
            "$ref": "#/components/schemas/ProcessAssessment"
          },
          "problem_management": {
            "$ref": "#/components/schemas/ProcessAssessment"
          },
          "change_management": {
            "$ref": "#/components/schemas/ProcessAssessment"
          },
          "release_management": {
            "$ref": "#/components/schemas/ProcessAssessment"
          },
          "asset_management": {
            "$ref": "#/components/schemas/ProcessAssessment"
          },
          "service_desk": {
            "$ref": "#/components/schemas/ProcessAssessment"
          },
          "knowledge_management": {
            "$ref": "#/components/schemas/ProcessAssessment"
          },
          "sla_management": {
            "$ref": "#/components/schemas/ProcessAssessment"
          },
          "sessionId": {
            "type": "string",
            "title": "Sessionid"
          },
          "timestamp": {
            "type": "string",
            "title": "Timestamp"
          }
        },
        "type": "object",
        "required": [
          "incident_management",
          "problem_management",
          "change_management",
          "release_management",
          "asset_management",
          "service_desk",
          "knowledge_management",
          "sla_management",
          "sessionId",
          "timestamp"
        ],
        "title": "AssessmentData"
      },
      "AssessmentRequest": {
        "properties": {
          "assessmentData": {
            "$ref": "#/components/schemas/AssessmentData"
          },
          "sessionId": {
            "type": "string",
            "title": "Sessionid"
          },
          "userId": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Userid"
          },
          "timestamp": {
            "type": "string",
            "title": "Timestamp"
          }
        },
        "type": "object",
        "required": [
          "assessmentData",
          "sessionId",
          "timestamp"
        ],
        "title": "AssessmentRequest"
      },
      "HTTPValidationError": {
        "properties": {
          "detail": {
            "items": {
              "$ref": "#/components/schemas/ValidationError"
            },
            "type": "array",
            "title": "Detail"
          }
        },
        "type": "object",
        "title": "HTTPValidationError"
      },
      "ProcessAssessment": {
        "properties": {
          "q1": {
            "type": "integer",
            "maximum": 5.0,
            "minimum": 0.0,
            "title": "Q1"
          },
          "q2": {
            "type": "integer",
            "maximum": 5.0,
            "minimum": 0.0,
            "title": "Q2"
          },
          "q3": {
            "type": "integer",
            "maximum": 5.0,
            "minimum": 0.0,
            "title": "Q3"
          },
          "q4": {
            "type": "integer",
            "maximum": 5.0,
            "minimum": 0.0,
            "title": "Q4"
          }
        },
        "type": "object",
        "required": [
          "q1",
          "q2",
          "q3",
          "q4"
        ],
        "title": "ProcessAssessment"
      },
      "ValidationError": {
        "properties": {
          "loc": {
            "items": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "integer"
                }
              ]
            },
            "type": "array",
            "title": "Location"
          },
          "msg": {
            "type": "string",
            "title": "Message"
          },
          "type": {
            "type": "string",
            "title": "Error Type"
          }
        },
        "type": "object",
        "required": [
          "loc",
          "msg",
          "type"
        ],
        "title": "ValidationError"
      }
    }
  }
}

Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)