evidència_consulta
Consulta un proveïdor d’evidències amb el context complet d’execució i la política de divulgació.
Notes clau
- La política de divulgació pot redactar valors en brut; els hashes/ancres encara es retornen.
- Utilitzeu per a diagnòstics o comprovacions abans del vol; el temps d’execució utilitza la mateixa lògica del proveïdor.
- Requereix provider_id, check_id i EvidenceContext complet.
Inputs
- context (required): Context de l’evidència utilitzat per a l’avaluació.
- query (required): Càrrega de consulta d’evidències.
Input Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"context": {
"additionalProperties": false,
"description": "Evidence context used for evaluation.",
"properties": {
"correlation_id": {
"oneOf": [
{
"type": "null"
},
{
"description": "Correlation identifier.",
"type": "string"
}
]
},
"namespace_id": {
"description": "Namespace identifier.",
"minimum": 1,
"type": "integer"
},
"run_id": {
"description": "Run identifier.",
"type": "string"
},
"scenario_id": {
"description": "Scenario identifier.",
"type": "string"
},
"stage_id": {
"description": "Stage identifier.",
"type": "string"
},
"tenant_id": {
"description": "Tenant identifier.",
"minimum": 1,
"type": "integer"
},
"trigger_id": {
"description": "Trigger identifier.",
"type": "string"
},
"trigger_time": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"kind": {
"const": "unix_millis"
},
"value": {
"type": "integer"
}
},
"required": [
"kind",
"value"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"kind": {
"const": "logical"
},
"value": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"kind",
"value"
],
"type": "object"
}
]
}
},
"required": [
"tenant_id",
"namespace_id",
"run_id",
"scenario_id",
"stage_id",
"trigger_id",
"trigger_time"
],
"type": "object"
},
"query": {
"additionalProperties": false,
"description": "Evidence query payload.",
"properties": {
"check_id": {
"description": "Provider check identifier.",
"type": "string"
},
"params": {
"description": "Provider-specific parameter payload.",
"type": [
"null",
"boolean",
"number",
"string",
"array",
"object"
]
},
"provider_id": {
"description": "Evidence provider identifier.",
"type": "string"
}
},
"required": [
"provider_id",
"check_id"
],
"type": "object"
}
},
"required": [
"query",
"context"
],
"type": "object"
}
Sortides
- result (required): Tipus: object.
Esquema de sortida
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"result": {
"additionalProperties": false,
"properties": {
"content_type": {
"oneOf": [
{
"type": "null"
},
{
"description": "Evidence content type.",
"type": "string"
}
]
},
"error": {
"oneOf": [
{
"type": "null"
},
{
"additionalProperties": false,
"properties": {
"code": {
"description": "Stable error code.",
"type": "string"
},
"details": {
"oneOf": [
{
"type": "null"
},
{
"description": "Optional structured error details.",
"type": [
"null",
"boolean",
"number",
"string",
"array",
"object"
]
}
]
},
"message": {
"description": "Error message.",
"type": "string"
}
},
"required": [
"code",
"message",
"details"
],
"type": "object"
}
]
},
"evidence_anchor": {
"oneOf": [
{
"type": "null"
},
{
"additionalProperties": false,
"properties": {
"anchor_type": {
"description": "Anchor type identifier.",
"type": "string"
},
"anchor_value": {
"description": "Anchor value.",
"type": "string"
}
},
"required": [
"anchor_type",
"anchor_value"
],
"type": "object"
}
]
},
"evidence_hash": {
"oneOf": [
{
"type": "null"
},
{
"additionalProperties": false,
"properties": {
"algorithm": {
"enum": [
"sha256"
],
"type": "string"
},
"value": {
"description": "Lowercase hex digest.",
"type": "string"
}
},
"required": [
"algorithm",
"value"
],
"type": "object"
}
]
},
"evidence_ref": {
"oneOf": [
{
"type": "null"
},
{
"additionalProperties": false,
"properties": {
"uri": {
"description": "Evidence reference URI.",
"type": "string"
}
},
"required": [
"uri"
],
"type": "object"
}
]
},
"lane": {
"description": "Trust lane classification for evidence.",
"enum": [
"verified",
"asserted"
],
"type": "string"
},
"signature": {
"oneOf": [
{
"type": "null"
},
{
"additionalProperties": false,
"properties": {
"key_id": {
"description": "Signing key identifier.",
"type": "string"
},
"scheme": {
"description": "Signature scheme identifier.",
"type": "string"
},
"signature": {
"items": {
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"type": "array"
}
},
"required": [
"scheme",
"key_id",
"signature"
],
"type": "object"
}
]
},
"value": {
"oneOf": [
{
"type": "null"
},
{
"oneOf": [
{
"additionalProperties": false,
"properties": {
"kind": {
"const": "json"
},
"value": {
"description": "Evidence JSON value.",
"type": [
"null",
"boolean",
"number",
"string",
"array",
"object"
]
}
},
"required": [
"kind",
"value"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"kind": {
"const": "bytes"
},
"value": {
"items": {
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"type": "array"
}
},
"required": [
"kind",
"value"
],
"type": "object"
}
]
}
]
}
},
"required": [
"value",
"lane",
"error",
"evidence_hash",
"evidence_ref",
"evidence_anchor",
"signature",
"content_type"
],
"type": "object"
}
},
"required": [
"result"
],
"type": "object"
}
Exemples
Consulta un proveïdor d’evidències utilitzant el context d’execució.
Input:
{
"context": {
"correlation_id": null,
"namespace_id": 1,
"run_id": "run-0001",
"scenario_id": "example-scenario",
"stage_id": "main",
"tenant_id": 1,
"trigger_id": "trigger-0001",
"trigger_time": {
"kind": "unix_millis",
"value": 1710000000000
}
},
"query": {
"check_id": "get",
"params": {
"key": "DEPLOY_ENV"
},
"provider_id": "env"
}
}
Output:
{
"result": {
"content_type": "text/plain",
"error": null,
"evidence_anchor": {
"anchor_type": "env",
"anchor_value": "DEPLOY_ENV"
},
"evidence_hash": {
"algorithm": "sha256",
"value": "5c3a5b6bce0f4a2c9e22c4fa6a1e6d8d90b0f2dfed1b7f1e9b3d3b3d1f0c9b21"
},
"evidence_ref": null,
"lane": "verified",
"signature": null,
"value": {
"kind": "json",
"value": "production"
}
}
}