158 lines
4.6 KiB
JSON
158 lines
4.6 KiB
JSON
{
|
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
"$id": "https://schema.stella-ops.org/plugin-manifest/v2.json",
|
|
"title": "StellaOps Plugin Manifest",
|
|
"description": "Schema for plugin.json manifest files (v2.0)",
|
|
"type": "object",
|
|
"required": ["id", "name", "assembly"],
|
|
"properties": {
|
|
"schemaVersion": {
|
|
"type": "string",
|
|
"description": "Schema version. Current version is 2.0",
|
|
"default": "2.0",
|
|
"enum": ["1.0", "2.0"]
|
|
},
|
|
"id": {
|
|
"type": "string",
|
|
"description": "Unique plugin identifier in format: stellaops.{module}.{plugin}",
|
|
"pattern": "^[a-z][a-z0-9-]*(?:\\.[a-z][a-z0-9-]*)*$",
|
|
"examples": ["stellaops.router.tcp", "stellaops.scanner.lang.dotnet"]
|
|
},
|
|
"name": {
|
|
"type": "string",
|
|
"description": "Human-readable display name",
|
|
"minLength": 1,
|
|
"maxLength": 100
|
|
},
|
|
"version": {
|
|
"type": "string",
|
|
"description": "Plugin version (SemVer)",
|
|
"default": "1.0.0",
|
|
"pattern": "^\\d+\\.\\d+\\.\\d+(?:-[a-zA-Z0-9.]+)?(?:\\+[a-zA-Z0-9.]+)?$"
|
|
},
|
|
"assembly": {
|
|
"$ref": "#/$defs/assemblyDescriptor"
|
|
},
|
|
"type": {
|
|
"type": "string",
|
|
"description": "Entry point type for plugin initialization (fully qualified type name)",
|
|
"examples": ["StellaOps.Router.Tcp.TcpTransportPlugin"]
|
|
},
|
|
"capabilities": {
|
|
"type": "array",
|
|
"description": "Plugin capabilities",
|
|
"items": {
|
|
"type": "string",
|
|
"pattern": "^[a-z][a-z0-9-]*(?::[a-zA-Z0-9*.-]+)?$"
|
|
},
|
|
"examples": [["signing:ES256", "transport:tcp", "analyzer:dotnet"]]
|
|
},
|
|
"platforms": {
|
|
"type": "array",
|
|
"description": "Supported platforms. Empty array means all platforms",
|
|
"items": {
|
|
"type": "string",
|
|
"enum": ["*", "linux", "linux-x64", "linux-arm64", "win", "win-x64", "win-arm64", "osx", "osx-x64", "osx-arm64"]
|
|
},
|
|
"default": []
|
|
},
|
|
"compliance": {
|
|
"type": "array",
|
|
"description": "Compliance standards",
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"examples": [["NIST", "FIPS-140-3", "GOST", "eIDAS", "KCMVP", "GM/T"]]
|
|
},
|
|
"jurisdiction": {
|
|
"type": "string",
|
|
"description": "Jurisdiction restriction",
|
|
"enum": ["world", "russia", "china", "eu", "korea", "usa"],
|
|
"default": "world"
|
|
},
|
|
"priority": {
|
|
"type": "integer",
|
|
"description": "Loading priority (0-100). Higher priority plugins are loaded first",
|
|
"minimum": 0,
|
|
"maximum": 100,
|
|
"default": 100
|
|
},
|
|
"enabled": {
|
|
"type": "boolean",
|
|
"description": "Whether the plugin is enabled by default",
|
|
"default": true
|
|
},
|
|
"enabledByDefault": {
|
|
"type": "boolean",
|
|
"description": "Whether the plugin is enabled by default in new installations",
|
|
"default": false
|
|
},
|
|
"options": {
|
|
"type": "object",
|
|
"description": "Plugin-specific configuration options",
|
|
"additionalProperties": true
|
|
},
|
|
"metadata": {
|
|
"type": "object",
|
|
"description": "Additional metadata",
|
|
"additionalProperties": {
|
|
"type": "string"
|
|
},
|
|
"properties": {
|
|
"author": {
|
|
"type": "string",
|
|
"description": "Plugin author"
|
|
},
|
|
"license": {
|
|
"type": "string",
|
|
"description": "License identifier (SPDX)"
|
|
},
|
|
"homepage": {
|
|
"type": "string",
|
|
"format": "uri",
|
|
"description": "Plugin homepage URL"
|
|
},
|
|
"repository": {
|
|
"type": "string",
|
|
"format": "uri",
|
|
"description": "Source repository URL"
|
|
}
|
|
}
|
|
},
|
|
"dependencies": {
|
|
"type": "array",
|
|
"description": "Plugin dependencies (other plugin IDs)",
|
|
"items": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"conditionalCompilation": {
|
|
"type": "string",
|
|
"description": "Conditional compilation symbol required to build this plugin"
|
|
}
|
|
},
|
|
"$defs": {
|
|
"assemblyDescriptor": {
|
|
"type": "object",
|
|
"description": "Descriptor for the plugin assembly location",
|
|
"required": ["path"],
|
|
"properties": {
|
|
"path": {
|
|
"type": "string",
|
|
"description": "Relative path to the assembly DLL from the plugin directory",
|
|
"examples": ["StellaOps.Router.Tcp.dll"]
|
|
},
|
|
"sha256": {
|
|
"type": "string",
|
|
"description": "SHA256 hash of the assembly for integrity verification",
|
|
"pattern": "^[a-fA-F0-9]{64}$"
|
|
},
|
|
"signaturePath": {
|
|
"type": "string",
|
|
"description": "Path to signature file (.sig) for cosign verification"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|