이 MCP로 할 수 있는 일
Provides CVE, CISA KEV, EPSS, CWE, vendor advisory, SBOM, package exposure, and internet-exposure lookups for vulnerability management.
도구
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['version'], 'properties': {'package': {'type': 'string', 'description': 'Registry path: the package name in that ecosystem, such as lodash.'}, 'product': {'type': 'string', 'description': 'CPE path: the NVD CPE product token, such as openssl, nginx or linux_kernel. Leave out for the registry path.'}, 'version': {'type': 'string', 'description': 'The version to check, such as 3.0.0.'}, 'ecosystem': {'type': 'string', 'description': "Registry path: the package's ecosystem, such as npm, PyPI or Maven. Give with package, not with product."}}}
출력 스키마
{'type': 'object', 'oneOf': [{'type': 'object', 'required': ['state', 'measured_at', 'method', 'coverage', 'freshness', 'notes', 'data'], 'properties': {'data': {'type': 'object', 'properties': {'count': {'type': ['number', 'null']}, 'capped': {'type': ['boolean', 'null']}, 'vendor': {'type': ['string', 'null']}, 'cve_ids': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}]}, 'matches': {'anyOf': [{'type': 'array', 'items': {'type': 'object', 'properties': {'cve_id': {'type': ['string', 'null']}, 'severity': {'type': ['string', 'null'], 'description': "NVD's own CVSS v3 band, as provenance: it can be NONE for a CVE NVD rated only under CVSS v2. Rank and display on effective_severity."}, 'cpe_vendor': {'type': ['string', 'null'], 'description': "The vendor NVD's CPE asserts for this match."}, 'epss_score': {'type': ['number', 'null'], 'description': 'EPSS exploitation probability, 0 to 1.'}, 'kev_listed': {'type': ['boolean', 'null'], 'description': 'Listed in CISA-KEV: known to be exploited.'}, 'ransomware': {'type': ['boolean', 'null'], 'description': 'CISA-KEV records known use in ransomware campaigns.'}, 'description': {'type': ['string', 'null']}, 'match_method': {'type': ['string', 'null']}, 'match_reason': {'type': ['string', 'null']}, 'cvss_v2_score': {'type': ['number', 'null']}, 'cvss_v3_score': {'type': ['number', 'null']}, 'cvss_v4_score': {'type': ['number', 'null']}, 'score_assessed': {'type': ['boolean', 'null'], 'description': 'Whether EchelonGraph has scored the CVE. false: NOT YET SCORED, and echelongraph_score is withheld.'}, 'vendor_unknown': {'type': ['boolean', 'null'], 'description': 'true: the vendor was not verified, so the match is real but its attribution to your vendor is not.'}, 'effective_score': {'type': ['number', 'null'], 'description': "The best real score held for the CVE (EchelonGraph's, else CVSS), the number the matches are ranked by."}, 'vendor_severity': {'type': ['string', 'null']}, 'match_confidence': {'type': ['number', 'null']}, 'matched_criteria': {'type': ['string', 'null']}, 'version_evidence': {'type': ['string', 'null']}, 'echelongraph_score': {'type': ['number', 'null'], 'description': "EchelonGraph's 0-10 score: present only when score_assessed is true."}, 'effective_severity': {'type': ['string', 'null'], 'description': 'The band of effective_score; absent or empty when the CVE has no band at all (unrated, not harmless).'}, 'echelongraph_severity': {'type': ['string', 'null']}, 'score_unassessed_reason': {'type': ['string', 'null']}}, 'additionalProperties': {}}}, {'type': 'null'}]}, 'package': {'type': ['string', 'null']}, 'product': {'type': ['string', 'null']}, 'version': {'type': ['string', 'null']}, 'assessed': {'type': ['boolean', 'null'], 'description': 'Read first. true: the lookup evaluated this component. false: it did not, and count 0 says nothing about whether this version is affected.'}, 'degraded': {'type': ['boolean', 'null']}, 'excluded': {}, 'ecosystem': {'type': ['string', 'null']}, 'match_layer': {'type': ['string', 'null']}, 'undetermined': {'anyOf': [{'type': 'array', 'items': {'type': 'object', 'properties': {'cve_id': {'type': ['string', 'null']}, 'detail': {'type': ['string', 'null']}, 'reason': {'type': ['string', 'null']}, 'package': {'type': ['string', 'null']}, 'ecosystem': {'type': ['string', 'null']}}, 'additionalProperties': {}}}, {'type': 'null'}]}, 'excluded_count': {'type': ['number', 'null']}, 'candidate_count': {'type': ['number', 'null']}, 'candidates_capped': {'type': ['boolean', 'null']}, 'not_affected_count': {'type': ['number', 'null']}, 'undetermined_count': {'type': ['number', 'null']}, 'not_assessed_reason': {'anyOf': [{'anyOf': [{'enum': ['product_not_in_cpe_corpus', 'package_not_cpe_nameable', 'candidate_load_pending', 'candidate_window_truncated', 'package_not_in_advisory_corpus', 'no_decidable_advisory', 'advisory_lookup_failed'], 'type': 'string'}, {'type': 'string'}], 'description': 'Why assessed is false; empty or absent when it is true.'}, {'type': 'null'}]}, 'product_named_count': {'type': ['number', 'null']}, 'ecosystem_recognised': {'type': ['boolean', 'null']}, 'advisories_considered': {'type': ['number', 'null']}, 'vendor_advisory_count': {'type': ['number', 'null']}, 'undecided_candidate_count': {'type': ['number', 'null']}, 'undecidable_excluded_count': {'type': ['number', 'null']}}, 'additionalProperties': {}}, 'notes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Caveats, one sentence each.'}, 'state': {'enum': ['measured', 'not_assessed'], 'type': 'string', 'description': 'measured: a measurement of what was asked; an exposure count is measured only with measured_at and method. not_assessed: the answer holds no dated measurement of what was asked, so no count in it is presented as one; it can still relay a count, as what the source holds on record, undated, and its notes (and exposure_state, where the result carries it) say what each count is.'}, 'method': {'type': 'string', 'description': 'How the numbers were produced.'}, 'coverage': {'anyOf': [{'type': 'object', 'required': ['assessed', 'not_assessed_reason', 'lookup', 'match_layer', 'count', 'capped', 'candidates_capped', 'excluded_count', 'undetermined_count', 'not_affected_count', 'degraded'], 'properties': {'count': {'type': ['number', 'null']}, 'capped': {'type': ['boolean', 'null']}, 'lookup': {'enum': ['cpe', 'registry'], 'type': 'string', 'description': 'Which lookup path this call asked for.'}, 'assessed': {'type': ['boolean', 'null'], 'description': "The answer's assessed, first: null when the answer does not say."}, 'degraded': {'type': ['boolean', 'null']}, 'match_layer': {'type': ['string', 'null']}, 'excluded_count': {'type': ['number', 'null']}, 'candidates_capped': {'type': ['boolean', 'null']}, 'not_affected_count': {'type': ['number', 'null']}, 'undetermined_count': {'type': ['number', 'null']}, 'not_assessed_reason': {'anyOf': [{'anyOf': [{'enum': ['product_not_in_cpe_corpus', 'package_not_cpe_nameable', 'candidate_load_pending', 'candidate_window_truncated', 'package_not_in_advisory_corpus', 'no_decidable_advisory', 'advisory_lookup_failed'], 'type': 'string'}, {'type': 'string'}], 'description': 'Why assessed is false; empty or absent when it is true.'}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'null'}], 'description': 'What the answer covers; null where the answer says nothing about it.'}, 'freshness': {'type': 'null', 'description': "The producing radar's last completed check (last_run_at), where the API serves one."}, 'measured_at': {'anyOf': [{'type': 'string', 'description': 'An RFC 3339 instant.'}, {'type': 'null'}], 'description': 'When the underlying observation was made, as the API states it; null when the answer does not say or holds no observation.'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['state', 'measured_at', 'method', 'coverage', 'freshness', 'notes', 'error'], 'properties': {'error': {'type': 'object', 'required': ['kind', 'path', 'status', 'message'], 'properties': {'kind': {'enum': ['network', 'timeout', 'http', 'not_json', 'not_object', 'invalid_input', 'internal', 'unexpected_shape', 'radars'], 'type': 'string', 'description': 'What failed: the request (network, timeout), the answer (http, not_json, not_object, unexpected_shape), the input, or this server.'}, 'path': {'type': ['string', 'null'], 'description': 'The API path requested, when a request was made.'}, 'status': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}], 'description': 'The HTTP status, when the API answered one.'}, 'message': {'type': 'string', 'description': "The cause: the API's own message, or what went wrong."}}, 'additionalProperties': False}, 'notes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Caveats, one sentence each.'}, 'state': {'enum': ['failed', 'invalid_input'], 'type': 'string', 'description': 'failed: the lookup did not complete. invalid_input: the input was refused, so nothing was looked up. Neither is a finding.'}, 'method': {'type': 'null'}, 'coverage': {'anyOf': [{'type': 'object', 'required': ['assessed', 'not_assessed_reason', 'lookup', 'match_layer', 'count', 'capped', 'candidates_capped', 'excluded_count', 'undetermined_count', 'not_affected_count', 'degraded'], 'properties': {'count': {'type': ['number', 'null']}, 'capped': {'type': ['boolean', 'null']}, 'lookup': {'enum': ['cpe', 'registry'], 'type': 'string', 'description': 'Which lookup path this call asked for.'}, 'assessed': {'type': ['boolean', 'null'], 'description': "The answer's assessed, first: null when the answer does not say."}, 'degraded': {'type': ['boolean', 'null']}, 'match_layer': {'type': ['string', 'null']}, 'excluded_count': {'type': ['number', 'null']}, 'candidates_capped': {'type': ['boolean', 'null']}, 'not_affected_count': {'type': ['number', 'null']}, 'undetermined_count': {'type': ['number', 'null']}, 'not_assessed_reason': {'anyOf': [{'anyOf': [{'enum': ['product_not_in_cpe_corpus', 'package_not_cpe_nameable', 'candidate_load_pending', 'candidate_window_truncated', 'package_not_in_advisory_corpus', 'no_decidable_advisory', 'advisory_lookup_failed'], 'type': 'string'}, {'type': 'string'}], 'description': 'Why assessed is false; empty or absent when it is true.'}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'null'}]}, 'freshness': {'type': 'null'}, 'measured_at': {'type': 'null'}}, 'additionalProperties': False}], '$schema': 'https://json-schema.org/draft/2020-12/schema'}
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'sbom': {'anyOf': [{'type': 'string'}, {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}], 'description': 'a CycloneDX JSON or SPDX JSON document, as JSON text or as an object; its purls are read here and only they are sent'}, 'purls': {'type': 'array', 'items': {'type': 'string'}, 'description': 'package URLs to check, e.g. pkg:npm/lodash@4.17.20 or pkg:deb/debian/openssl@3.0.11-1~deb12u1?distro=debian-12 (up to 2,000 distinct, sent in batches of 200)'}}}
출력 스키마
{'type': 'object', 'oneOf': [{'type': 'object', 'required': ['state', 'measured_at', 'method', 'coverage', 'freshness', 'notes', 'data'], 'properties': {'data': {'type': 'object', 'properties': {'results': {'type': 'array', 'items': {'type': 'object', 'properties': {'code': {'type': ['string', 'null']}, 'purl': {'type': ['string', 'null']}, 'count': {'type': ['number', 'null']}, 'error': {'type': ['string', 'null']}, 'index': {'type': ['number', 'null']}, 'capped': {'type': ['boolean', 'null']}, 'cve_ids': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}]}, 'matches': {'anyOf': [{'type': 'array', 'items': {'type': 'object', 'properties': {'cve_id': {'type': ['string', 'null']}}, 'additionalProperties': {}}}, {'type': 'null'}]}, 'package': {'type': ['string', 'null']}, 'verdict': {'type': ['string', 'null'], 'description': 'affected (count > 0); not_affected (assessed, no match, nothing undetermined: the only clean verdict); undetermined (advisories name the package, at least one could not be decided, none matched: not clean); not_assessed (no verdict: not clean).'}, 'version': {'type': ['string', 'null']}, 'assessed': {'type': ['boolean', 'null'], 'description': 'Whether the matcher produced a verdict for this component. false is never clean.'}, 'ecosystem': {'type': ['string', 'null']}, 'input_kind': {'type': ['string', 'null']}, 'undetermined': {'anyOf': [{'type': 'array', 'items': {'type': 'object', 'properties': {'cve_id': {'type': ['string', 'null']}}, 'additionalProperties': {}}}, {'type': 'null'}]}, 'candidates_capped': {'type': ['boolean', 'null']}, 'not_affected_count': {'type': ['number', 'null']}, 'undetermined_count': {'type': ['number', 'null']}, 'not_assessed_reason': {'type': ['string', 'null'], 'description': 'Why assessed is false: package_not_in_advisory_corpus, no_decidable_advisory, advisory_lookup_failed, candidate_window_truncated, time_budget, distro_release_unknown, purl_type_unsupported, version_missing or invalid_component.'}, 'advisories_considered': {'type': ['number', 'null']}}, 'additionalProperties': {}}}, 'summary': {'type': 'object', 'properties': {'lookups': {'type': ['number', 'null']}, 'partial': {'type': ['boolean', 'null'], 'description': 'true when the time budget ran out before every component was looked up.'}, 'affected': {'type': ['number', 'null']}, 'components': {'type': ['number', 'null']}, 'elapsed_ms': {'type': ['number', 'null']}, 'not_affected': {'type': ['number', 'null'], 'description': 'Components with a decided, clean verdict.'}, 'not_assessed': {'type': ['number', 'null'], 'description': 'Components with no verdict: not clean.'}, 'undetermined': {'type': ['number', 'null'], 'description': 'Components whose advisories could not all be decided and none matched: not clean.'}, 'time_budget_ms': {'type': ['number', 'null']}, 'not_assessed_by_reason': {'anyOf': [{'type': 'object', 'properties': {'time_budget': {'type': 'number', 'description': "Components the batch's time budget ran out before: not clean; check them again."}, 'version_missing': {'type': 'number'}, 'invalid_component': {'type': 'number'}, 'no_decidable_advisory': {'type': 'number'}, 'purl_type_unsupported': {'type': 'number'}, 'advisory_lookup_failed': {'type': 'number'}, 'distro_release_unknown': {'type': 'number', 'description': 'deb, apk or rpm purls without a distro qualifier naming the release, which EchelonGraph does not guess.'}, 'candidate_window_truncated': {'type': 'number'}, 'package_not_in_advisory_corpus': {'type': 'number'}}, 'additionalProperties': {}}, {'type': 'null'}], 'description': 'The not_assessed components, counted by not_assessed_reason.'}, 'corpus_cache_max_age_ms': {'type': ['number', 'null']}}, 'additionalProperties': {}}, 'components': {'type': ['number', 'null']}, 'answered_at': {'type': ['string', 'null']}, 'match_layer': {'type': ['string', 'null']}, 'not_sent_purls': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'description': 'The distinct purls not sent (coverage.not_sent_reason says why): not checked, and not clean. Present only when some were not sent.'}}, 'additionalProperties': {}}, 'notes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Caveats, one sentence each.'}, 'state': {'enum': ['measured', 'not_assessed'], 'type': 'string', 'description': 'measured: a measurement of what was asked; an exposure count is measured only with measured_at and method. not_assessed: the answer holds no dated measurement of what was asked, so no count in it is presented as one; it can still relay a count, as what the source holds on record, undated, and its notes (and exposure_state, where the result carries it) say what each count is.'}, 'method': {'type': 'string', 'description': 'How the numbers were produced.'}, 'coverage': {'anyOf': [{'type': 'object', 'required': ['input', 'components_in_document', 'with_purl', 'without_purl', 'duplicates_removed', 'distinct_purls', 'batch_size', 'batches', 'batches_sent', 'sent', 'not_sent', 'not_sent_reason', 'rate_limit_waits', 'waited_ms', 'not_assessed', 'partial'], 'properties': {'sent': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'Distinct purls sent and answered.'}, 'input': {'enum': ['purls', 'cyclonedx', 'spdx'], 'type': 'string', 'description': 'What was passed: a purl list, a CycloneDX JSON document or an SPDX JSON document.'}, 'batches': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'Requests the distinct purls make, at batch_size each.'}, 'partial': {'type': ['boolean', 'null'], 'description': "true when not every purl was sent (not_sent above 0) or any batch's summary.partial was true (its time budget ran out first); otherwise the answer's summary.partial."}, 'not_sent': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'Distinct purls not sent, listed in data.not_sent_purls: not checked, and not clean.'}, 'waited_ms': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'Milliseconds spent in those waits.'}, 'with_purl': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'Of those, the ones carrying a purl.'}, 'batch_size': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': "The most purls one request carries (the API's cap per request)."}, 'batches_sent': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'Of those, the ones the API answered.'}, 'not_assessed': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}], 'description': 'Of those sent, the components with no verdict, as the answer counts them.'}, 'without_purl': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'The ones without a purl: not checked, and not clean.'}, 'distinct_purls': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'Distinct purls to check: sent plus not_sent.'}, 'not_sent_reason': {'anyOf': [{'enum': ['time_budget', 'rate_limited', 'request_failed'], 'type': 'string'}, {'type': 'null'}], 'description': "Why not_sent is above 0: time_budget (the call's 50 s budget ran out, before a batch or while one was unanswered, which is then cut off; or waiting out the API's Retry-After would pass it), rate_limited (a 429 without Retry-After, or a 429 after 10 waits), request_failed (a batch after the first failed; the note quotes how). null when every purl was sent."}, 'rate_limit_waits': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'How many times the API answered 429 and the tool waited its Retry-After before sending the batch again.'}, 'duplicates_removed': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'Purls that appeared more than once and were sent once.'}, 'components_in_document': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}], 'description': 'Components (CycloneDX) or packages (SPDX) in the document; null for a purl list.'}}, 'additionalProperties': False}, {'type': 'null'}], 'description': 'What the answer covers; null where the answer says nothing about it.'}, 'freshness': {'type': 'null', 'description': "The producing radar's last completed check (last_run_at), where the API serves one."}, 'measured_at': {'anyOf': [{'type': 'string', 'description': 'An RFC 3339 instant.'}, {'type': 'null'}], 'description': 'When the underlying observation was made, as the API states it; null when the answer does not say or holds no observation.'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['state', 'measured_at', 'method', 'coverage', 'freshness', 'notes', 'error'], 'properties': {'error': {'type': 'object', 'required': ['kind', 'path', 'status', 'message'], 'properties': {'kind': {'enum': ['network', 'timeout', 'http', 'not_json', 'not_object', 'invalid_input', 'internal', 'unexpected_shape', 'radars'], 'type': 'string', 'description': 'What failed: the request (network, timeout), the answer (http, not_json, not_object, unexpected_shape), the input, or this server.'}, 'path': {'type': ['string', 'null'], 'description': 'The API path requested, when a request was made.'}, 'status': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}], 'description': 'The HTTP status, when the API answered one.'}, 'message': {'type': 'string', 'description': "The cause: the API's own message, or what went wrong."}}, 'additionalProperties': False}, 'notes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Caveats, one sentence each.'}, 'state': {'enum': ['failed', 'invalid_input'], 'type': 'string', 'description': 'failed: the lookup did not complete. invalid_input: the input was refused, so nothing was looked up. Neither is a finding.'}, 'method': {'type': 'null'}, 'coverage': {'anyOf': [{'type': 'object', 'required': ['input', 'components_in_document', 'with_purl', 'without_purl', 'duplicates_removed', 'distinct_purls', 'batch_size', 'batches', 'batches_sent', 'sent', 'not_sent', 'not_sent_reason', 'rate_limit_waits', 'waited_ms', 'not_assessed', 'partial'], 'properties': {'sent': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'Distinct purls sent and answered.'}, 'input': {'enum': ['purls', 'cyclonedx', 'spdx'], 'type': 'string', 'description': 'What was passed: a purl list, a CycloneDX JSON document or an SPDX JSON document.'}, 'batches': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'Requests the distinct purls make, at batch_size each.'}, 'partial': {'type': ['boolean', 'null'], 'description': "true when not every purl was sent (not_sent above 0) or any batch's summary.partial was true (its time budget ran out first); otherwise the answer's summary.partial."}, 'not_sent': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'Distinct purls not sent, listed in data.not_sent_purls: not checked, and not clean.'}, 'waited_ms': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'Milliseconds spent in those waits.'}, 'with_purl': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'Of those, the ones carrying a purl.'}, 'batch_size': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': "The most purls one request carries (the API's cap per request)."}, 'batches_sent': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'Of those, the ones the API answered.'}, 'not_assessed': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}], 'description': 'Of those sent, the components with no verdict, as the answer counts them.'}, 'without_purl': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'The ones without a purl: not checked, and not clean.'}, 'distinct_purls': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'Distinct purls to check: sent plus not_sent.'}, 'not_sent_reason': {'anyOf': [{'enum': ['time_budget', 'rate_limited', 'request_failed'], 'type': 'string'}, {'type': 'null'}], 'description': "Why not_sent is above 0: time_budget (the call's 50 s budget ran out, before a batch or while one was unanswered, which is then cut off; or waiting out the API's Retry-After would pass it), rate_limited (a 429 without Retry-After, or a 429 after 10 waits), request_failed (a batch after the first failed; the note quotes how). null when every purl was sent."}, 'rate_limit_waits': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'How many times the API answered 429 and the tool waited its Retry-After before sending the batch again.'}, 'duplicates_removed': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'Purls that appeared more than once and were sent once.'}, 'components_in_document': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}], 'description': 'Components (CycloneDX) or packages (SPDX) in the document; null for a purl list.'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'freshness': {'type': 'null'}, 'measured_at': {'type': 'null'}}, 'additionalProperties': False}], '$schema': 'https://json-schema.org/draft/2020-12/schema'}
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['cve_id'], 'properties': {'cve_id': {'type': 'string', 'description': 'a CVE ID, e.g. CVE-2023-44487'}}}
출력 스키마
{'type': 'object', 'oneOf': [{'type': 'object', 'required': ['state', 'measured_at', 'method', 'coverage', 'freshness', 'notes', 'exposure_state', 'data'], 'properties': {'data': {'type': 'object', 'properties': {'cve_id': {'type': ['string', 'null']}, 'method': {'type': ['string', 'null']}, 'tracked': {'type': ['boolean', 'null']}, 'countries': {'type': ['number', 'null']}, 'last_seen': {'type': ['string', 'null']}, 'kev_listed': {'type': ['boolean', 'null']}, 'ransomware': {'type': ['boolean', 'null']}, 'generated_at': {'type': ['string', 'null']}, 'top_products': {'anyOf': [{'type': 'array', 'items': {'type': 'object', 'properties': {'hosts': {'type': ['number', 'null']}, 'product': {'type': ['string', 'null']}}, 'additionalProperties': {}}}, {'type': 'null'}]}, 'exposed_hosts': {'type': ['number', 'null']}, 'top_countries': {'anyOf': [{'type': 'array', 'items': {'type': 'object', 'properties': {'hosts': {'type': ['number', 'null']}, 'country': {'type': ['string', 'null']}}, 'additionalProperties': {}}}, {'type': 'null'}]}, 'kev_catalog_listed': {'type': ['boolean', 'null']}, 'kev_seen_in_observations': {'type': ['boolean', 'null']}}, 'additionalProperties': {}}, 'notes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Caveats, one sentence each.'}, 'state': {'enum': ['measured', 'not_assessed'], 'type': 'string', 'description': 'measured: a measurement of what was asked; an exposure count is measured only with measured_at and method. not_assessed: the answer holds no dated measurement of what was asked, so no count in it is presented as one; it can still relay a count, as what the source holds on record, undated, and its notes (and exposure_state, where the result carries it) say what each count is.'}, 'method': {'type': 'string', 'description': 'How the numbers were produced.'}, 'coverage': {'anyOf': [{'type': 'object', 'required': ['in_scope'], 'properties': {'in_scope': {'type': ['boolean', 'null'], 'description': "The API's tracked verdict: whether the CVE is in the radar's tracked set; null when the answer does not say."}}, 'additionalProperties': False}, {'type': 'null'}], 'description': 'What the answer covers; null where the answer says nothing about it.'}, 'freshness': {'type': 'null', 'description': "The producing radar's last completed check (last_run_at), where the API serves one."}, 'measured_at': {'anyOf': [{'type': 'string', 'description': 'An RFC 3339 instant.'}, {'type': 'null'}], 'description': 'When the underlying observation was made, as the API states it; null when the answer does not say or holds no observation.'}, 'exposure_state': {'anyOf': [{'enum': ['exposed', 'measured_zero', 'not_assessed', 'tracking_unknown'], 'type': 'string'}, {'type': 'null'}], 'description': "What the answer's count is, as the note's (exposure_state: â\x80¦) tag says; not state, which says whether the answer is a dated measurement. exposed: data.exposed_hosts counts the services the radar holds on record for the CVE, above 0. measured_zero: the API marks the CVE as tracked with 0 services, a zero in the radar's sample. not_assessed: the CVE is outside the radar's tracked set, so its count, if any, is not a current measurement. tracking_unknown: the API does not say whether the radar tracks the CVE, so its 0 is not evidence either way. null: the answer carries no count."}}, 'additionalProperties': False}, {'type': 'object', 'required': ['state', 'measured_at', 'method', 'coverage', 'freshness', 'notes', 'error'], 'properties': {'error': {'type': 'object', 'required': ['kind', 'path', 'status', 'message'], 'properties': {'kind': {'enum': ['network', 'timeout', 'http', 'not_json', 'not_object', 'invalid_input', 'internal', 'unexpected_shape', 'radars'], 'type': 'string', 'description': 'What failed: the request (network, timeout), the answer (http, not_json, not_object, unexpected_shape), the input, or this server.'}, 'path': {'type': ['string', 'null'], 'description': 'The API path requested, when a request was made.'}, 'status': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}], 'description': 'The HTTP status, when the API answered one.'}, 'message': {'type': 'string', 'description': "The cause: the API's own message, or what went wrong."}}, 'additionalProperties': False}, 'notes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Caveats, one sentence each.'}, 'state': {'enum': ['failed', 'invalid_input'], 'type': 'string', 'description': 'failed: the lookup did not complete. invalid_input: the input was refused, so nothing was looked up. Neither is a finding.'}, 'method': {'type': 'null'}, 'coverage': {'anyOf': [{'type': 'object', 'required': ['in_scope'], 'properties': {'in_scope': {'type': ['boolean', 'null'], 'description': "The API's tracked verdict: whether the CVE is in the radar's tracked set; null when the answer does not say."}}, 'additionalProperties': False}, {'type': 'null'}]}, 'freshness': {'type': 'null'}, 'measured_at': {'type': 'null'}}, 'additionalProperties': False}], '$schema': 'https://json-schema.org/draft/2020-12/schema'}
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['cve_id'], 'properties': {'cve_id': {'type': 'string', 'description': 'a CVE ID, e.g. CVE-2021-44228'}}}
출력 스키마
{'type': 'object', 'oneOf': [{'type': 'object', 'required': ['state', 'measured_at', 'method', 'coverage', 'freshness', 'notes', 'data'], 'properties': {'data': {'type': 'object', 'required': ['cve_id'], 'properties': {'cwes': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': ['string', 'null']}, 'cwe_id': {'type': ['string', 'null']}, 'source': {'type': ['string', 'null']}}, 'additionalProperties': {}}}, 'cve_id': {'type': 'string'}, 'exploits': {'type': 'array', 'items': {'type': 'object', 'properties': {'kind': {'type': ['string', 'null'], 'description': 'metasploit, exploit_db, nuclei_template, github_poc or vendor_poc.'}, 'source_url': {'type': ['string', 'null']}, 'description': {'type': ['string', 'null']}, 'source_name': {'type': ['string', 'null']}, 'first_seen_at': {'type': ['string', 'null']}, 'verified_status': {'type': ['string', 'null'], 'description': 'verified_status is the label stored with each reference: verified for a Metasploit module, for an Exploit-DB entry Exploit-DB marks verified, and for curated seed rows marked so; reported for a public artefact nothing has confirmed works (nuclei templates, GitHub proofs of concept, unverified Exploit-DB entries); unconfirmed where a curated row says so. It is a label from the source, not a guarantee that the exploit works against a given system.'}}, 'additionalProperties': {}}}, 'timeline': {'type': 'array', 'items': {'type': 'object', 'properties': {'enriched_at': {'type': ['string', 'null']}, 'score_delta': {'type': ['number', 'null']}, 'fields_changed': {}, 'enrichment_kind': {'type': ['string', 'null']}}, 'additionalProperties': {}}}, 'exploits_total': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}], 'description': 'Every exploit reference on record for the CVE, not only those listed in exploits.'}, 'fixed_versions': {'type': 'array', 'items': {'type': 'object', 'properties': {'source': {'type': ['string', 'null']}, 'ecosystem': {'type': ['string', 'null']}, 'package_name': {'type': ['string', 'null']}, 'fixed_version': {'type': ['string', 'null']}, 'vulnerable_range': {'type': ['string', 'null']}}, 'additionalProperties': {}}}, 'timeline_total': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'exploits_capped': {'type': 'boolean', 'description': 'true: exploits lists fewer references than exploits_total.'}, 'exploits_by_kind': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'number'}}, 'affected_packages': {'type': 'array', 'items': {'type': 'object', 'properties': {'source': {'type': ['string', 'null']}, 'ecosystem': {'type': ['string', 'null']}, 'package_name': {'type': ['string', 'null']}, 'fixed_version': {'type': ['string', 'null']}, 'version_range': {'type': ['string', 'null']}, 'dependents_count': {'type': ['number', 'null']}}, 'additionalProperties': {}}}, 'timeline_count_7d': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'exploits_by_status': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'number'}}, 'timeline_count_30d': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}}, 'additionalProperties': False}, 'notes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Caveats, one sentence each.'}, 'state': {'enum': ['measured', 'not_assessed'], 'type': 'string', 'description': 'measured: a measurement of what was asked; an exposure count is measured only with measured_at and method. not_assessed: the answer holds no dated measurement of what was asked, so no count in it is presented as one; it can still relay a count, as what the source holds on record, undated, and its notes (and exposure_state, where the result carries it) say what each count is.'}, 'method': {'type': 'string', 'description': 'How the numbers were produced.'}, 'coverage': {'anyOf': [{'type': 'object', 'required': ['sections_relayed', 'sections_failed', 'sections_left_out', 'exploits', 'affected_packages', 'fixed_versions', 'timeline'], 'properties': {'exploits': {'type': 'object', 'required': ['returned', 'api_row_limit'], 'properties': {'returned': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}], 'description': 'Rows the API returned; null when the section was not read.'}, 'api_row_limit': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'The most rows the API returns for this list per CVE: a list this long may be cut.'}}, 'additionalProperties': False}, 'timeline': {'type': 'object', 'required': ['returned', 'relayed', 'api_row_limit'], 'properties': {'relayed': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}], 'description': 'The newest rows relayed in data.timeline.'}, 'returned': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}]}, 'api_row_limit': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}}, 'additionalProperties': False}, 'fixed_versions': {'type': 'object', 'required': ['returned', 'api_row_limit'], 'properties': {'returned': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}], 'description': 'Rows the API returned; null when the section was not read.'}, 'api_row_limit': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'The most rows the API returns for this list per CVE: a list this long may be cut.'}}, 'additionalProperties': False}, 'sections_failed': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'description': 'The sections the API says it could not read (its failed_sections), left out of data; null when the answer does not say (an API older than failed_sections), so an empty list may be an unread section.'}, 'sections_relayed': {'type': 'array', 'items': {'type': 'string'}, 'description': 'The sections of the answer relayed in data.'}, 'affected_packages': {'type': 'object', 'required': ['returned', 'api_row_limit'], 'properties': {'returned': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}], 'description': 'Rows the API returned; null when the section was not read.'}, 'api_row_limit': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'The most rows the API returns for this list per CVE: a list this long may be cut.'}}, 'additionalProperties': False}, 'sections_left_out': {'type': 'array', 'items': {'type': 'string'}, 'description': 'The sections of the answer this tool does not relay.'}}, 'additionalProperties': False}, {'type': 'null'}], 'description': 'What the answer covers; null where the answer says nothing about it.'}, 'freshness': {'type': 'null', 'description': "The producing radar's last completed check (last_run_at), where the API serves one."}, 'measured_at': {'anyOf': [{'type': 'string', 'description': 'An RFC 3339 instant.'}, {'type': 'null'}], 'description': 'When the underlying observation was made, as the API states it; null when the answer does not say or holds no observation.'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['state', 'measured_at', 'method', 'coverage', 'freshness', 'notes', 'error'], 'properties': {'error': {'type': 'object', 'required': ['kind', 'path', 'status', 'message'], 'properties': {'kind': {'enum': ['network', 'timeout', 'http', 'not_json', 'not_object', 'invalid_input', 'internal', 'unexpected_shape', 'radars'], 'type': 'string', 'description': 'What failed: the request (network, timeout), the answer (http, not_json, not_object, unexpected_shape), the input, or this server.'}, 'path': {'type': ['string', 'null'], 'description': 'The API path requested, when a request was made.'}, 'status': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}], 'description': 'The HTTP status, when the API answered one.'}, 'message': {'type': 'string', 'description': "The cause: the API's own message, or what went wrong."}}, 'additionalProperties': False}, 'notes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Caveats, one sentence each.'}, 'state': {'enum': ['failed', 'invalid_input'], 'type': 'string', 'description': 'failed: the lookup did not complete. invalid_input: the input was refused, so nothing was looked up. Neither is a finding.'}, 'method': {'type': 'null'}, 'coverage': {'anyOf': [{'type': 'object', 'required': ['sections_relayed', 'sections_failed', 'sections_left_out', 'exploits', 'affected_packages', 'fixed_versions', 'timeline'], 'properties': {'exploits': {'type': 'object', 'required': ['returned', 'api_row_limit'], 'properties': {'returned': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}], 'description': 'Rows the API returned; null when the section was not read.'}, 'api_row_limit': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'The most rows the API returns for this list per CVE: a list this long may be cut.'}}, 'additionalProperties': False}, 'timeline': {'type': 'object', 'required': ['returned', 'relayed', 'api_row_limit'], 'properties': {'relayed': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}], 'description': 'The newest rows relayed in data.timeline.'}, 'returned': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}]}, 'api_row_limit': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}}, 'additionalProperties': False}, 'fixed_versions': {'type': 'object', 'required': ['returned', 'api_row_limit'], 'properties': {'returned': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}], 'description': 'Rows the API returned; null when the section was not read.'}, 'api_row_limit': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'The most rows the API returns for this list per CVE: a list this long may be cut.'}}, 'additionalProperties': False}, 'sections_failed': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'description': 'The sections the API says it could not read (its failed_sections), left out of data; null when the answer does not say (an API older than failed_sections), so an empty list may be an unread section.'}, 'sections_relayed': {'type': 'array', 'items': {'type': 'string'}, 'description': 'The sections of the answer relayed in data.'}, 'affected_packages': {'type': 'object', 'required': ['returned', 'api_row_limit'], 'properties': {'returned': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}], 'description': 'Rows the API returned; null when the section was not read.'}, 'api_row_limit': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'The most rows the API returns for this list per CVE: a list this long may be cut.'}}, 'additionalProperties': False}, 'sections_left_out': {'type': 'array', 'items': {'type': 'string'}, 'description': 'The sections of the answer this tool does not relay.'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'freshness': {'type': 'null'}, 'measured_at': {'type': 'null'}}, 'additionalProperties': False}], '$schema': 'https://json-schema.org/draft/2020-12/schema'}
입력 스키마
{'type': 'object', 'properties': {}}
출력 스키마
{'type': 'object', 'oneOf': [{'type': 'object', 'required': ['state', 'measured_at', 'method', 'coverage', 'freshness', 'notes', 'data'], 'properties': {'data': {'type': 'object', 'properties': {'poller': {'anyOf': [{'type': 'object', 'properties': {'interval': {'type': ['string', 'null'], 'description': "How often this instance's NVD poller polls."}, 'poll_count': {'type': ['number', 'null'], 'description': "Polls this instance's NVD poller made since the instance last started."}, 'poll_errors': {'type': ['number', 'null'], 'description': "Polls of this instance's NVD poller that failed since the instance last started: never the feed's reliability."}, 'cves_skipped': {'type': ['number', 'null'], 'description': "CVE records this instance's NVD poller skipped since the instance last started."}, 'http_retries': {'type': ['number', 'null'], 'description': "HTTP retries this instance's NVD poller made since the instance last started."}, 'last_poll_at': {'type': ['string', 'null'], 'description': "When this instance's NVD poller last polled: never the feed's freshness."}, 'cves_ingested': {'type': ['number', 'null'], 'description': "CVE records this instance's NVD poller wrote since the instance last started: never the feed's size or intake."}, 'last_poll_dur_ms': {'type': ['number', 'null'], 'description': 'How long that poll took, in milliseconds.'}}, 'additionalProperties': {}}, {'type': 'null'}], 'description': "poller holds the in-memory counters of the NVD poller of the one API instance that answered (cves_ingested, cves_skipped, http_retries, poll_count, poll_errors, last_poll_at, last_poll_dur_ms, interval), counted since that instance last started and zeroed on every restart: they describe that instance, never the feed's size, intake, reliability or freshness. Whenever the answer carries poller the note says so."}, 'summary': {'type': 'object', 'properties': {'low': {'type': ['number', 'null']}, 'high': {'type': ['number', 'null']}, 'none': {'type': ['number', 'null'], 'description': 'The active CVEs with no severity band from any source: CVEs not yet scored, not a severity rating of None.'}, 'total': {'type': ['number', 'null']}, 'medium': {'type': ['number', 'null']}, 'nvd_low': {'type': ['number', 'null'], 'description': "Of the active CVEs total counts, those whose NVD CVSS severity label is Low: NVD's label, as provenance, never EchelonGraph's severity band."}, 'critical': {'type': ['number', 'null']}, 'nvd_high': {'type': ['number', 'null'], 'description': "Of the active CVEs total counts, those whose NVD CVSS severity label is High: NVD's label, as provenance, never EchelonGraph's severity band."}, 'nvd_none': {'type': ['number', 'null'], 'description': 'Of the active CVEs total counts, those with no Critical, High, Medium or Low NVD CVSS severity label, many of them with an NVD CVSS v2 score instead: neither a count of CVEs rated None nor the count of CVEs with no severity, which is none.'}, 'rejected': {'type': ['number', 'null'], 'description': 'The CVE records rejected (withdrawn) by their numbering authority, which total and every other count here leave out: withdrawn records, never vulnerabilities.'}, 'unscored': {'type': ['number', 'null'], 'description': 'The same count as none, under its own name.'}, 'nvd_medium': {'type': ['number', 'null'], 'description': "Of the active CVEs total counts, those whose NVD CVSS severity label is Medium: NVD's label, as provenance, never EchelonGraph's severity band."}, 'last_updated': {'type': ['string', 'null']}, 'nvd_critical': {'type': ['number', 'null'], 'description': "Of the active CVEs total counts, those whose NVD CVSS severity label is Critical: NVD's label, as provenance, never EchelonGraph's severity band."}}, 'additionalProperties': {}}}, 'additionalProperties': {}}, 'notes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Caveats, one sentence each.'}, 'state': {'enum': ['measured', 'not_assessed'], 'type': 'string', 'description': 'measured: a measurement of what was asked; an exposure count is measured only with measured_at and method. not_assessed: the answer holds no dated measurement of what was asked, so no count in it is presented as one; it can still relay a count, as what the source holds on record, undated, and its notes (and exposure_state, where the result carries it) say what each count is.'}, 'method': {'type': 'string', 'description': 'How the numbers were produced.'}, 'coverage': {'type': 'null', 'description': 'What the answer covers; null where the answer says nothing about it.'}, 'freshness': {'type': 'null', 'description': "The producing radar's last completed check (last_run_at), where the API serves one."}, 'measured_at': {'anyOf': [{'type': 'string', 'description': 'An RFC 3339 instant.'}, {'type': 'null'}], 'description': 'When the underlying observation was made, as the API states it; null when the answer does not say or holds no observation.'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['state', 'measured_at', 'method', 'coverage', 'freshness', 'notes', 'error'], 'properties': {'error': {'type': 'object', 'required': ['kind', 'path', 'status', 'message'], 'properties': {'kind': {'enum': ['network', 'timeout', 'http', 'not_json', 'not_object', 'invalid_input', 'internal', 'unexpected_shape', 'radars'], 'type': 'string', 'description': 'What failed: the request (network, timeout), the answer (http, not_json, not_object, unexpected_shape), the input, or this server.'}, 'path': {'type': ['string', 'null'], 'description': 'The API path requested, when a request was made.'}, 'status': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}], 'description': 'The HTTP status, when the API answered one.'}, 'message': {'type': 'string', 'description': "The cause: the API's own message, or what went wrong."}}, 'additionalProperties': False}, 'notes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Caveats, one sentence each.'}, 'state': {'enum': ['failed', 'invalid_input'], 'type': 'string', 'description': 'failed: the lookup did not complete. invalid_input: the input was refused, so nothing was looked up. Neither is a finding.'}, 'method': {'type': 'null'}, 'coverage': {'type': 'null'}, 'freshness': {'type': 'null'}, 'measured_at': {'type': 'null'}}, 'additionalProperties': False}], '$schema': 'https://json-schema.org/draft/2020-12/schema'}
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['cve_id'], 'properties': {'cve_id': {'type': 'string', 'description': 'a CVE ID, e.g. CVE-2023-44487'}}}
출력 스키마
{'type': 'object', 'oneOf': [{'type': 'object', 'required': ['state', 'measured_at', 'method', 'coverage', 'freshness', 'notes', 'data'], 'properties': {'data': {'type': 'object', 'required': ['cve_id', 'series_kind', 'series_starts_at', 'current', 'points'], 'properties': {'cve_id': {'type': 'string'}, 'points': {'type': 'array', 'items': {'type': 'object', 'required': ['at', 'epss_score'], 'properties': {'at': {'type': 'string', 'description': 'When EchelonGraph recorded this change.'}, 'epss_score': {'type': 'number', 'description': 'The EPSS probability (0 to 1) from that change on.'}, 'epss_percentile': {'type': ['number', 'null'], 'description': 'Its percentile (0 to 1), null where the record held none.'}}, 'additionalProperties': {}}, 'description': 'Recorded changes, oldest first. Never a daily series.'}, 'current': {'type': 'object', 'properties': {'epss_score': {'type': ['number', 'null'], 'description': "The record's EPSS probability now; null when it holds none."}, 'epss_percentile': {'type': ['number', 'null']}, 'epss_updated_at': {'anyOf': [{'type': 'string', 'description': 'An RFC 3339 instant.'}, {'type': 'null'}], 'description': 'When EchelonGraph last wrote a changed EPSS value for this CVE.'}}, 'additionalProperties': {}}, 'series_kind': {'enum': ['change_only'], 'type': 'string', 'description': 'Always change_only: one point per recorded change, none for a day without one.'}, 'history_rows': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, {'type': 'null'}], 'description': 'Raw history rows read, before repeated records of one change were collapsed.'}, 'points_truncated': {'type': ['boolean', 'null'], 'description': 'True when only the newest rows were read, so the earliest points are missing.'}, 'series_starts_at': {'anyOf': [{'type': 'string', 'description': 'An RFC 3339 instant.'}, {'type': 'null'}], 'description': 'The earliest EPSS change EchelonGraph recorded for any CVE: when recording began. Null when nothing has been recorded.'}, 'latest_point_matches_current': {'type': ['boolean', 'null'], 'description': 'Whether the newest point equals current; false means a change is missing from the series; null when there is no point or no current value.'}}, 'additionalProperties': {}}, 'notes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Caveats, one sentence each.'}, 'state': {'enum': ['measured', 'not_assessed'], 'type': 'string', 'description': 'measured: a measurement of what was asked; an exposure count is measured only with measured_at and method. not_assessed: the answer holds no dated measurement of what was asked, so no count in it is presented as one; it can still relay a count, as what the source holds on record, undated, and its notes (and exposure_state, where the result carries it) say what each count is.'}, 'method': {'type': 'string', 'description': 'How the numbers were produced.'}, 'coverage': {'anyOf': [{'type': 'object', 'required': ['series_kind', 'series_starts_at', 'points', 'points_truncated'], 'properties': {'points': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'How many points the series holds.'}, 'series_kind': {'enum': ['change_only'], 'type': 'string'}, 'points_truncated': {'type': 'boolean'}, 'series_starts_at': {'anyOf': [{'type': 'string', 'description': 'An RFC 3339 instant.'}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'null'}], 'description': 'What the answer covers; null where the answer says nothing about it.'}, 'freshness': {'type': 'null', 'description': "The producing radar's last completed check (last_run_at), where the API serves one."}, 'measured_at': {'anyOf': [{'type': 'string', 'description': 'An RFC 3339 instant.'}, {'type': 'null'}], 'description': 'When the underlying observation was made, as the API states it; null when the answer does not say or holds no observation.'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['state', 'measured_at', 'method', 'coverage', 'freshness', 'notes', 'error'], 'properties': {'error': {'type': 'object', 'required': ['kind', 'path', 'status', 'message'], 'properties': {'kind': {'enum': ['network', 'timeout', 'http', 'not_json', 'not_object', 'invalid_input', 'internal', 'unexpected_shape', 'radars'], 'type': 'string', 'description': 'What failed: the request (network, timeout), the answer (http, not_json, not_object, unexpected_shape), the input, or this server.'}, 'path': {'type': ['string', 'null'], 'description': 'The API path requested, when a request was made.'}, 'status': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}], 'description': 'The HTTP status, when the API answered one.'}, 'message': {'type': 'string', 'description': "The cause: the API's own message, or what went wrong."}}, 'additionalProperties': False}, 'notes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Caveats, one sentence each.'}, 'state': {'enum': ['failed', 'invalid_input'], 'type': 'string', 'description': 'failed: the lookup did not complete. invalid_input: the input was refused, so nothing was looked up. Neither is a finding.'}, 'method': {'type': 'null'}, 'coverage': {'anyOf': [{'type': 'object', 'required': ['series_kind', 'series_starts_at', 'points', 'points_truncated'], 'properties': {'points': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'How many points the series holds.'}, 'series_kind': {'enum': ['change_only'], 'type': 'string'}, 'points_truncated': {'type': 'boolean'}, 'series_starts_at': {'anyOf': [{'type': 'string', 'description': 'An RFC 3339 instant.'}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'null'}]}, 'freshness': {'type': 'null'}, 'measured_at': {'type': 'null'}}, 'additionalProperties': False}], '$schema': 'https://json-schema.org/draft/2020-12/schema'}
입력 스키마
{'type': 'object', 'properties': {}}
출력 스키마
{'type': 'object', 'oneOf': [{'type': 'object', 'required': ['state', 'measured_at', 'method', 'coverage', 'freshness', 'notes', 'data'], 'properties': {'data': {'type': 'object', 'required': ['kev_exposure', 'exposed_databases', 'leaked_credentials', 'shadow_ai', 'mcp_servers'], 'properties': {'shadow_ai': {'type': 'object', 'properties': {'poller': {'type': 'object', 'required': ['running', 'last_run_at'], 'properties': {'running': {'type': 'boolean'}, 'last_run_at': {'type': 'string', 'description': 'An RFC 3339 instant.'}}, 'additionalProperties': False}, 'observed': {'type': 'object', 'properties': {'total': {'type': 'number'}, 'last_24h': {'type': 'number'}, 'trend_30d': {'type': 'array', 'items': {'type': 'object', 'required': ['date', 'count'], 'properties': {'date': {'type': 'string'}, 'count': {'type': 'number'}}, 'additionalProperties': False}}, 'by_category': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'number'}}, 'top_issuers': {'type': 'array', 'items': {'type': 'object', 'required': ['issuer', 'count'], 'properties': {'count': {'type': 'number'}, 'issuer': {'type': 'string'}}, 'additionalProperties': False}}, 'top_products': {'type': 'array', 'items': {'type': 'object', 'required': ['product', 'count'], 'properties': {'count': {'type': 'number'}, 'product': {'type': 'string'}}, 'additionalProperties': False}}, 'top_countries': {'type': 'array', 'items': {'type': 'object', 'required': ['country', 'count'], 'properties': {'count': {'type': 'number'}, 'country': {'type': 'string'}}, 'additionalProperties': False}}, 'last_observation': {'type': 'string', 'description': 'An RFC 3339 instant.'}}, 'additionalProperties': False}, 'authentication': {'type': 'object', 'properties': {'observed': {'type': 'number'}, 'not_determined': {'type': 'number'}}, 'additionalProperties': False}, 'confirmed_exposed': {'type': 'object', 'properties': {'total': {'type': 'number'}, 'window': {'type': 'object', 'required': ['from', 'to'], 'properties': {'to': {'type': 'string', 'description': 'An RFC 3339 instant.'}, 'from': {'type': 'string', 'description': 'An RFC 3339 instant.'}}, 'additionalProperties': False}, 'last_24h': {'type': 'number'}, 'by_category': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'number'}}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'mcp_servers': {'type': 'object', 'required': ['total', 'protected', 'pending_readjudication', 'not_assessed'], 'properties': {'era': {'type': 'object', 'required': ['legacy', 'dual', 'modern', 'unknown', 'not_measured'], 'properties': {'dual': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'legacy': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'modern': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'unknown': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'not_measured': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': False}, 'total': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'window': {'type': 'object', 'required': ['from', 'to'], 'properties': {'to': {'type': 'string', 'description': 'An RFC 3339 instant.'}, 'from': {'type': 'string', 'description': 'An RFC 3339 instant.'}}, 'additionalProperties': False}, 'enabled': {'type': 'boolean'}, 'prm_via': {'type': 'object', 'required': ['header', 'wellknown_path', 'wellknown_root'], 'properties': {'header': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'wellknown_path': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'wellknown_root': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': False}, 'protected': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'transport': {'type': 'object', 'required': ['streamable_http', 'legacy_sse', 'unknown', 'not_measured'], 'properties': {'unknown': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'legacy_sse': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'not_measured': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'streamable_http': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': False}, 'counted_at': {'type': 'string', 'description': 'An RFC 3339 instant.'}, 'last_run_at': {'type': 'string', 'description': 'An RFC 3339 instant.'}, 'not_assessed': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'own_controls_excluded': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'not_assessed_by_reason': {'type': 'object', 'required': ['identified_no_challenge', 'resource_mismatch', 'cross_origin_pointer', 'bare_challenge_no_prm', 'pointer_unreachable', 'pointer_invalid', 'no_authorization_servers', 'wellknown_unreachable', 'metadata_invalid', 'challenge_unadjudicated', 'no_http_answer', 'not_identified_as_mcp'], 'properties': {'no_http_answer': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'pointer_invalid': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'metadata_invalid': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'resource_mismatch': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'pointer_unreachable': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'cross_origin_pointer': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'bare_challenge_no_prm': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'not_identified_as_mcp': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'wellknown_unreachable': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'challenge_unadjudicated': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'identified_no_challenge': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'no_authorization_servers': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': False}, 'pending_readjudication': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': False}, 'kev_exposure': {'type': 'object', 'properties': {'trend': {'type': 'array', 'items': {'type': 'object', 'required': ['week', 'new_exposures'], 'properties': {'week': {'type': 'string'}, 'new_exposures': {'type': 'number'}}, 'additionalProperties': False}}, 'top_cves': {'type': 'array', 'items': {'type': 'object', 'required': ['cve_id', 'hosts'], 'properties': {'hosts': {'type': 'number'}, 'cve_id': {'type': 'string'}, 'severity': {'type': 'string'}, 'epss_score': {'type': 'number'}, 'ransomware': {'type': 'boolean'}, 'cvss_v3_score': {'type': 'number'}}, 'additionalProperties': False}}, 'newest_kev': {'type': 'array', 'items': {'type': 'object', 'required': ['cve_id', 'exposure_state'], 'properties': {'cve_id': {'type': 'string'}, 'severity': {'type': 'string'}, 'vuln_name': {'type': 'string'}, 'added_date': {'type': 'string'}, 'epss_score': {'type': 'number'}, 'ransomware': {'type': 'boolean'}, 'cvss_v3_score': {'type': 'number'}, 'exposed_hosts': {'type': 'number'}, 'exposure_state': {'enum': ['exposed', 'measured_zero', 'not_assessed'], 'type': 'string'}}, 'additionalProperties': False}}, 'last_run_at': {'type': 'string', 'description': 'An RFC 3339 instant.'}, 'correlations': {'type': 'number'}, 'generated_at': {'type': 'string', 'description': 'An RFC 3339 instant.'}, 'top_products': {'type': 'array', 'items': {'type': 'object', 'required': ['product', 'hosts'], 'properties': {'hosts': {'type': 'number'}, 'product': {'type': 'string'}}, 'additionalProperties': False}}, 'top_countries': {'type': 'array', 'items': {'type': 'object', 'required': ['country', 'hosts'], 'properties': {'hosts': {'type': 'number'}, 'country': {'type': 'string'}}, 'additionalProperties': False}}, 'distinct_hosts': {'type': 'number'}, 'ransomware_cves': {'type': 'number'}, 'kev_cves_exposed': {'type': 'number'}, 'ransomware_hosts': {'type': 'number'}}, 'additionalProperties': False}, 'exposed_databases': {'type': 'object', 'properties': {'window': {'type': 'object', 'required': ['from', 'to'], 'properties': {'to': {'type': 'string', 'description': 'An RFC 3339 instant.'}, 'from': {'type': 'string', 'description': 'An RFC 3339 instant.'}}, 'additionalProperties': False}, 'engines': {'type': 'number'}, 'pci_likely': {'type': 'number'}, 'pii_likely': {'type': 'number'}, 'last_run_at': {'type': 'string', 'description': 'An RFC 3339 instant.'}, 'top_engines': {'type': 'array', 'items': {'type': 'object', 'required': ['engine', 'hosts'], 'properties': {'hosts': {'type': 'number'}, 'engine': {'type': 'string'}}, 'additionalProperties': False}}, 'generated_at': {'type': 'string', 'description': 'An RFC 3339 instant.'}, 'top_countries': {'type': 'array', 'items': {'type': 'object', 'required': ['country', 'hosts'], 'properties': {'hosts': {'type': 'number'}, 'country': {'type': 'string'}}, 'additionalProperties': False}}, 'distinct_hosts': {'type': 'number'}}, 'additionalProperties': False}, 'leaked_credentials': {'type': 'object', 'properties': {'total': {'type': 'number'}, 'window': {'type': 'object', 'required': ['from', 'to'], 'properties': {'to': {'type': 'string', 'description': 'An RFC 3339 instant.'}, 'from': {'type': 'string', 'description': 'An RFC 3339 instant.'}}, 'additionalProperties': False}, 'top_types': {'type': 'array', 'items': {'type': 'object', 'required': ['secret_type', 'count'], 'properties': {'count': {'type': 'number'}, 'secret_type': {'type': 'string'}}, 'additionalProperties': False}}, 'last_run_at': {'type': 'string', 'description': 'An RFC 3339 instant.'}, 'generated_at': {'type': 'string', 'description': 'An RFC 3339 instant.'}, 'top_providers': {'type': 'array', 'items': {'type': 'object', 'required': ['provider', 'count'], 'properties': {'count': {'type': 'number'}, 'provider': {'type': 'string'}}, 'additionalProperties': False}}, 'distinct_repos': {'type': 'number'}, 'distinct_secrets': {'type': 'number'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'notes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Caveats, one sentence each.'}, 'state': {'enum': ['measured', 'not_assessed'], 'type': 'string', 'description': 'measured: a measurement of what was asked; an exposure count is measured only with measured_at and method. not_assessed: the answer holds no dated measurement of what was asked, so no count in it is presented as one; it can still relay a count, as what the source holds on record, undated, and its notes (and exposure_state, where the result carries it) say what each count is.'}, 'method': {'type': 'string', 'description': 'How the numbers were produced.'}, 'coverage': {'anyOf': [{'type': 'object', 'required': ['radars', 'answered', 'failed'], 'properties': {'failed': {'type': 'array', 'items': {'type': 'string'}, 'description': 'The radars that could not be read.'}, 'radars': {'type': 'array', 'items': {'type': 'string'}, 'description': 'The radars this tool reads.'}, 'answered': {'type': 'array', 'items': {'type': 'string'}, 'description': 'The radars that answered. On a failure their answers are withheld.'}}, 'additionalProperties': False}, {'type': 'null'}], 'description': 'What the answer covers; null where the answer says nothing about it.'}, 'freshness': {'anyOf': [{'type': 'object', 'required': ['kev_exposure', 'exposed_databases', 'leaked_credentials', 'shadow_ai', 'mcp_servers'], 'properties': {'shadow_ai': {'type': 'object', 'required': ['last_run_at', 'running'], 'properties': {'running': {'type': ['boolean', 'null']}, 'last_run_at': {'anyOf': [{'type': 'string', 'description': 'An RFC 3339 instant.'}, {'type': 'null'}]}}, 'additionalProperties': False}, 'mcp_servers': {'type': 'object', 'required': ['last_run_at', 'enabled'], 'properties': {'enabled': {'type': ['boolean', 'null']}, 'last_run_at': {'anyOf': [{'type': 'string', 'description': 'An RFC 3339 instant.'}, {'type': 'null'}]}}, 'additionalProperties': False}, 'kev_exposure': {'type': 'object', 'required': ['last_run_at'], 'properties': {'last_run_at': {'anyOf': [{'type': 'string', 'description': 'An RFC 3339 instant.'}, {'type': 'null'}]}}, 'additionalProperties': False}, 'exposed_databases': {'type': 'object', 'required': ['last_run_at'], 'properties': {'last_run_at': {'anyOf': [{'type': 'string', 'description': 'An RFC 3339 instant.'}, {'type': 'null'}]}}, 'additionalProperties': False}, 'leaked_credentials': {'type': 'object', 'required': ['last_run_at'], 'properties': {'last_run_at': {'anyOf': [{'type': 'string', 'description': 'An RFC 3339 instant.'}, {'type': 'null'}]}}, 'additionalProperties': False}}, 'additionalProperties': False}, {'type': 'null'}], 'description': "The producing radar's last completed check (last_run_at), where the API serves one."}, 'measured_at': {'anyOf': [{'type': 'string', 'description': 'An RFC 3339 instant.'}, {'type': 'null'}], 'description': 'When the underlying observation was made, as the API states it; null when the answer does not say or holds no observation.'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['state', 'measured_at', 'method', 'coverage', 'freshness', 'notes', 'error'], 'properties': {'error': {'type': 'object', 'required': ['kind', 'path', 'status', 'message'], 'properties': {'kind': {'enum': ['network', 'timeout', 'http', 'not_json', 'not_object', 'invalid_input', 'internal', 'unexpected_shape', 'radars'], 'type': 'string', 'description': 'What failed: the request (network, timeout), the answer (http, not_json, not_object, unexpected_shape), the input, or this server.'}, 'path': {'type': ['string', 'null'], 'description': 'The API path requested, when a request was made.'}, 'radars': {'type': 'array', 'items': {'type': 'object', 'required': ['radar', 'kind', 'path', 'status', 'message'], 'properties': {'kind': {'enum': ['network', 'timeout', 'http', 'not_json', 'not_object', 'unexpected_shape'], 'type': 'string'}, 'path': {'type': 'string'}, 'radar': {'type': 'string'}, 'status': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}]}, 'message': {'type': 'string'}}, 'additionalProperties': False}, 'description': 'Each radar that could not be read, and why.'}, 'status': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}], 'description': 'The HTTP status, when the API answered one.'}, 'message': {'type': 'string', 'description': "The cause: the API's own message, or what went wrong."}}, 'additionalProperties': False}, 'notes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Caveats, one sentence each.'}, 'state': {'enum': ['failed', 'invalid_input'], 'type': 'string', 'description': 'failed: the lookup did not complete. invalid_input: the input was refused, so nothing was looked up. Neither is a finding.'}, 'method': {'type': 'null'}, 'coverage': {'anyOf': [{'type': 'object', 'required': ['radars', 'answered', 'failed'], 'properties': {'failed': {'type': 'array', 'items': {'type': 'string'}, 'description': 'The radars that could not be read.'}, 'radars': {'type': 'array', 'items': {'type': 'string'}, 'description': 'The radars this tool reads.'}, 'answered': {'type': 'array', 'items': {'type': 'string'}, 'description': 'The radars that answered. On a failure their answers are withheld.'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'freshness': {'type': 'null'}, 'measured_at': {'type': 'null'}}, 'additionalProperties': False}], '$schema': 'https://json-schema.org/draft/2020-12/schema'}
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['cve_id'], 'properties': {'cve_id': {'type': 'string', 'description': 'a CVE ID, e.g. CVE-2023-44487'}}}
출력 스키마
{'type': 'object', 'oneOf': [{'type': 'object', 'required': ['state', 'measured_at', 'method', 'coverage', 'freshness', 'notes', 'data'], 'properties': {'data': {'type': 'object', 'properties': {'cve_id': {'type': ['string', 'null']}, 'ghsa_id': {'type': ['string', 'null']}, 'modified': {'type': ['string', 'null']}, 'severity': {'type': ['string', 'null']}, 'cpe_match': {'description': "The record's CPE match criteria as one flat list, every configuration's cpeMatch entries together: the AND/OR operator and negate of each configuration and node, versionStartExcluding and matchCriteriaId are not in it, so a CPE that is only a platform a product runs on reads as one more entry."}, 'published': {'type': ['string', 'null']}, 'epss_score': {'type': ['number', 'null']}, 'kev_listed': {'type': ['boolean', 'null']}, 'references': {}, 'updated_at': {'type': ['string', 'null']}, 'description': {'type': ['string', 'null']}, 'cvss_v3_score': {'type': ['number', 'null']}, 'cvss_v4_score': {'type': ['number', 'null']}, 'kev_added_date': {'type': ['string', 'null']}, 'kev_ransomware': {'type': ['boolean', 'null']}, 'score_assessed': {'type': ['boolean', 'null'], 'description': 'Whether EchelonGraph has scored the CVE. true: echelongraph_score, echelongraph_severity and echelongraph_risk are its score. false: the CVE is NOT YET SCORED, not scored 0, and any of those three it carries is a placeholder, not a rating; the API may leave them out. Absent (an API older than the field): the answer does not say whether the CVE was scored.'}, 'epss_percentile': {'type': ['number', 'null']}, 'cvss_v4_severity': {'type': ['string', 'null']}, 'score_confidence': {'type': ['string', 'null']}, 'echelongraph_risk': {'type': ['number', 'null'], 'description': "EchelonGraph's 0-100 risk priority, fused from the score, exploitation and automatability: a rating only when score_assessed is true. With score_assessed false it is a placeholder."}, 'cpe_configurations': {'anyOf': [{'type': 'array', 'items': {}}, {'type': 'null'}], 'description': "NVD's configurations array as NVD sent it: each configuration and node with its operator (AND, OR) and negate, and each cpeMatch with criteria, vulnerable, versionStartIncluding, versionStartExcluding, versionEndIncluding, versionEndExcluding and matchCriteriaId. A cpeMatch with vulnerable false inside an AND configuration is the platform the vulnerable product runs on, not an affected product. Absent: EchelonGraph holds no stored NVD configuration for the CVE, which is not a finding that no product is affected."}, 'echelongraph_score': {'type': ['number', 'null'], 'description': "EchelonGraph's 0-10 score for the CVE: a score only when score_assessed is true. With score_assessed false it is a placeholder, not a rating."}, 'echelongraph_severity': {'type': ['string', 'null'], 'description': 'The severity band of echelongraph_score: a rating only when score_assessed is true. With score_assessed false it is a placeholder (NONE).'}, 'score_unassessed_reason': {'type': ['string', 'null'], 'description': 'Why score_assessed is false: no_signal, no source has yet published severity data EchelonGraph can score; or rejected, the record was withdrawn by its numbering authority and is never scored. Absent when the CVE is scored.'}}, 'additionalProperties': {}}, 'notes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Caveats, one sentence each.'}, 'state': {'enum': ['measured', 'not_assessed'], 'type': 'string', 'description': 'measured: a measurement of what was asked; an exposure count is measured only with measured_at and method. not_assessed: the answer holds no dated measurement of what was asked, so no count in it is presented as one; it can still relay a count, as what the source holds on record, undated, and its notes (and exposure_state, where the result carries it) say what each count is.'}, 'method': {'type': 'string', 'description': 'How the numbers were produced.'}, 'coverage': {'type': 'null', 'description': 'What the answer covers; null where the answer says nothing about it.'}, 'freshness': {'type': 'null', 'description': "The producing radar's last completed check (last_run_at), where the API serves one."}, 'measured_at': {'anyOf': [{'type': 'string', 'description': 'An RFC 3339 instant.'}, {'type': 'null'}], 'description': 'When the underlying observation was made, as the API states it; null when the answer does not say or holds no observation.'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['state', 'measured_at', 'method', 'coverage', 'freshness', 'notes', 'error'], 'properties': {'error': {'type': 'object', 'required': ['kind', 'path', 'status', 'message'], 'properties': {'kind': {'enum': ['network', 'timeout', 'http', 'not_json', 'not_object', 'invalid_input', 'internal', 'unexpected_shape', 'radars'], 'type': 'string', 'description': 'What failed: the request (network, timeout), the answer (http, not_json, not_object, unexpected_shape), the input, or this server.'}, 'path': {'type': ['string', 'null'], 'description': 'The API path requested, when a request was made.'}, 'status': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}], 'description': 'The HTTP status, when the API answered one.'}, 'message': {'type': 'string', 'description': "The cause: the API's own message, or what went wrong."}}, 'additionalProperties': False}, 'notes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Caveats, one sentence each.'}, 'state': {'enum': ['failed', 'invalid_input'], 'type': 'string', 'description': 'failed: the lookup did not complete. invalid_input: the input was refused, so nothing was looked up. Neither is a finding.'}, 'method': {'type': 'null'}, 'coverage': {'type': 'null'}, 'freshness': {'type': 'null'}, 'measured_at': {'type': 'null'}}, 'additionalProperties': False}], '$schema': 'https://json-schema.org/draft/2020-12/schema'}
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['cwe_id'], 'properties': {'page': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'page of 50 CVEs (default 1, max 200)'}, 'cwe_id': {'type': 'string', 'description': 'a CWE ID, e.g. CWE-79 (or 79)'}}}
출력 스키마
{'type': 'object', 'oneOf': [{'type': 'object', 'required': ['state', 'measured_at', 'method', 'coverage', 'freshness', 'notes', 'data'], 'properties': {'data': {'type': 'object', 'properties': {'cves': {'type': 'array', 'items': {'type': 'object', 'properties': {'cve_id': {'type': ['string', 'null']}, 'severity': {'type': ['string', 'null']}, 'published': {'type': ['string', 'null']}, 'kev_listed': {'type': ['boolean', 'null']}, 'description': {'type': ['string', 'null']}, 'cvss_v2_score': {'type': ['number', 'null']}, 'cvss_v3_score': {'type': ['number', 'null']}, 'score_assessed': {'type': ['boolean', 'null'], 'description': 'Whether EchelonGraph has scored the CVE; false: NOT YET SCORED, not scored 0.'}, 'cvss_v2_severity': {'type': ['string', 'null']}, 'echelongraph_score': {'type': ['number', 'null'], 'description': "EchelonGraph's 0-10 score: a score only when score_assessed is true."}, 'echelongraph_severity': {'type': ['string', 'null']}}, 'additionalProperties': {}}}, 'name': {'type': ['string', 'null']}, 'page': {'type': ['number', 'null']}, 'order': {'type': ['string', 'null'], 'description': 'How cves is sorted, as the API states it; absent from an API older than the field, which sorted by CVE id.'}, 'total': {'type': ['number', 'null'], 'description': 'The active CVEs classified under the CWE, rejected and reserved records left out.'}, 'cwe_id': {'type': ['string', 'null']}, 'max_page': {'type': ['number', 'null'], 'description': 'The last page the API serves; a later page is answered as this one.'}, 'page_size': {'type': ['number', 'null']}, 'description': {'type': ['string', 'null']}, 'catalog_version': {'type': ['string', 'null'], 'description': 'The version of the MITRE CWE catalog name and description come from.'}}, 'additionalProperties': {}}, 'notes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Caveats, one sentence each.'}, 'state': {'enum': ['measured', 'not_assessed'], 'type': 'string', 'description': 'measured: a measurement of what was asked; an exposure count is measured only with measured_at and method. not_assessed: the answer holds no dated measurement of what was asked, so no count in it is presented as one; it can still relay a count, as what the source holds on record, undated, and its notes (and exposure_state, where the result carries it) say what each count is.'}, 'method': {'type': 'string', 'description': 'How the numbers were produced.'}, 'coverage': {'anyOf': [{'type': 'object', 'required': ['total', 'returned', 'page', 'page_requested', 'page_size', 'max_page'], 'properties': {'page': {'type': ['number', 'null'], 'description': 'The page served.'}, 'total': {'type': ['number', 'null']}, 'max_page': {'type': ['number', 'null']}, 'returned': {'type': ['number', 'null']}, 'page_size': {'type': ['number', 'null']}, 'page_requested': {'type': 'number', 'description': 'The page asked for.'}}, 'additionalProperties': False}, {'type': 'null'}], 'description': 'What the answer covers; null where the answer says nothing about it.'}, 'freshness': {'type': 'null', 'description': "The producing radar's last completed check (last_run_at), where the API serves one."}, 'measured_at': {'anyOf': [{'type': 'string', 'description': 'An RFC 3339 instant.'}, {'type': 'null'}], 'description': 'When the underlying observation was made, as the API states it; null when the answer does not say or holds no observation.'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['state', 'measured_at', 'method', 'coverage', 'freshness', 'notes', 'error'], 'properties': {'error': {'type': 'object', 'required': ['kind', 'path', 'status', 'message'], 'properties': {'kind': {'enum': ['network', 'timeout', 'http', 'not_json', 'not_object', 'invalid_input', 'internal', 'unexpected_shape', 'radars'], 'type': 'string', 'description': 'What failed: the request (network, timeout), the answer (http, not_json, not_object, unexpected_shape), the input, or this server.'}, 'path': {'type': ['string', 'null'], 'description': 'The API path requested, when a request was made.'}, 'status': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}], 'description': 'The HTTP status, when the API answered one.'}, 'message': {'type': 'string', 'description': "The cause: the API's own message, or what went wrong."}}, 'additionalProperties': False}, 'notes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Caveats, one sentence each.'}, 'state': {'enum': ['failed', 'invalid_input'], 'type': 'string', 'description': 'failed: the lookup did not complete. invalid_input: the input was refused, so nothing was looked up. Neither is a finding.'}, 'method': {'type': 'null'}, 'coverage': {'anyOf': [{'type': 'object', 'required': ['total', 'returned', 'page', 'page_requested', 'page_size', 'max_page'], 'properties': {'page': {'type': ['number', 'null'], 'description': 'The page served.'}, 'total': {'type': ['number', 'null']}, 'max_page': {'type': ['number', 'null']}, 'returned': {'type': ['number', 'null']}, 'page_size': {'type': ['number', 'null']}, 'page_requested': {'type': 'number', 'description': 'The page asked for.'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'freshness': {'type': 'null'}, 'measured_at': {'type': 'null'}}, 'additionalProperties': False}], '$schema': 'https://json-schema.org/draft/2020-12/schema'}
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['vendor', 'advisory_id'], 'properties': {'vendor': {'type': 'string', 'description': 'the vendor slug, e.g. microsoft, redhat, github'}, 'advisory_id': {'type': 'string', 'description': "the vendor's advisory ID, e.g. RHSA-2024:1234 or GHSA-xxxx-xxxx-xxxx"}}}
출력 스키마
{'type': 'object', 'oneOf': [{'type': 'object', 'required': ['state', 'measured_at', 'method', 'coverage', 'freshness', 'notes', 'data'], 'properties': {'data': {'type': 'object', 'properties': {'title': {'type': ['string', 'null']}, 'vendor': {'type': ['string', 'null']}, 'cve_ids': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}]}, 'summary': {'type': ['string', 'null']}, 'severity': {'type': ['string', 'null']}, 'withdrawn': {'type': ['boolean', 'null'], 'description': 'true: the vendor withdrew (rescinded) this advisory; report it as withdrawn.'}, 'references': {}, 'advisory_id': {'type': ['string', 'null']}, 'description': {'type': ['string', 'null']}, 'remediation': {'type': ['string', 'null']}, 'withdrawn_at': {'type': ['string', 'null']}, 'cvss_v3_score': {'type': ['number', 'null']}, 'known_cve_ids': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'description': "The CVE IDs of cve_ids that have a record in EchelonGraph's CVE feed."}, 'withdrawn_reason': {'type': ['string', 'null']}, 'affected_products': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}]}, 'our_first_seen_at': {'type': ['string', 'null'], 'description': "When EchelonGraph first recorded the advisory; not the vendor's date."}, 'vendor_advisory_id': {'type': ['string', 'null']}, 'vendor_modified_at': {'type': ['string', 'null']}, 'vendor_display_name': {'type': ['string', 'null']}, 'vendor_published_at': {'type': ['string', 'null'], 'description': 'The date the vendor gives for the advisory.'}}, 'additionalProperties': {}}, 'notes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Caveats, one sentence each.'}, 'state': {'enum': ['measured', 'not_assessed'], 'type': 'string', 'description': 'measured: a measurement of what was asked; an exposure count is measured only with measured_at and method. not_assessed: the answer holds no dated measurement of what was asked, so no count in it is presented as one; it can still relay a count, as what the source holds on record, undated, and its notes (and exposure_state, where the result carries it) say what each count is.'}, 'method': {'type': 'string', 'description': 'How the numbers were produced.'}, 'coverage': {'anyOf': [{'type': 'object', 'required': ['vendor_window'], 'properties': {'vendor_window': {'anyOf': [{'type': 'object', 'required': ['vendor', 'vendor_display_name', 'advisories', 'earliest_vendor_published_at', 'latest_vendor_published_at', 'history_backfill'], 'properties': {'vendor': {'type': 'string', 'description': 'The vendor slug.'}, 'advisories': {'type': ['number', 'null'], 'description': 'How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.'}, 'history_backfill': {'anyOf': [{'anyOf': [{'enum': ['complete', 'in_progress', 'not_started', 'not_supported'], 'type': 'string'}, {'type': 'string'}]}, {'type': 'null'}], 'description': "history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."}, 'vendor_display_name': {'type': ['string', 'null']}, 'latest_vendor_published_at': {'type': ['string', 'null'], 'description': 'The latest vendor_published_at among them; null when none is held.'}, 'earliest_vendor_published_at': {'type': ['string', 'null'], 'description': 'The earliest vendor_published_at among them; null when none is held. An advisory this vendor published before it is not held.'}}, 'additionalProperties': False}, {'type': 'null'}], 'description': "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."}}, 'additionalProperties': False}, {'type': 'null'}], 'description': 'What the answer covers; null where the answer says nothing about it.'}, 'freshness': {'type': 'null', 'description': "The producing radar's last completed check (last_run_at), where the API serves one."}, 'measured_at': {'anyOf': [{'type': 'string', 'description': 'An RFC 3339 instant.'}, {'type': 'null'}], 'description': 'When the underlying observation was made, as the API states it; null when the answer does not say or holds no observation.'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['state', 'measured_at', 'method', 'coverage', 'freshness', 'notes', 'error'], 'properties': {'error': {'type': 'object', 'required': ['kind', 'path', 'status', 'message'], 'properties': {'kind': {'enum': ['network', 'timeout', 'http', 'not_json', 'not_object', 'invalid_input', 'internal', 'unexpected_shape', 'radars'], 'type': 'string', 'description': 'What failed: the request (network, timeout), the answer (http, not_json, not_object, unexpected_shape), the input, or this server.'}, 'path': {'type': ['string', 'null'], 'description': 'The API path requested, when a request was made.'}, 'status': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}], 'description': 'The HTTP status, when the API answered one.'}, 'message': {'type': 'string', 'description': "The cause: the API's own message, or what went wrong."}}, 'additionalProperties': False}, 'notes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Caveats, one sentence each.'}, 'state': {'enum': ['failed', 'invalid_input'], 'type': 'string', 'description': 'failed: the lookup did not complete. invalid_input: the input was refused, so nothing was looked up. Neither is a finding.'}, 'method': {'type': 'null'}, 'coverage': {'anyOf': [{'type': 'object', 'required': ['vendor_window'], 'properties': {'vendor_window': {'anyOf': [{'type': 'object', 'required': ['vendor', 'vendor_display_name', 'advisories', 'earliest_vendor_published_at', 'latest_vendor_published_at', 'history_backfill'], 'properties': {'vendor': {'type': 'string', 'description': 'The vendor slug.'}, 'advisories': {'type': ['number', 'null'], 'description': 'How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.'}, 'history_backfill': {'anyOf': [{'anyOf': [{'enum': ['complete', 'in_progress', 'not_started', 'not_supported'], 'type': 'string'}, {'type': 'string'}]}, {'type': 'null'}], 'description': "history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."}, 'vendor_display_name': {'type': ['string', 'null']}, 'latest_vendor_published_at': {'type': ['string', 'null'], 'description': 'The latest vendor_published_at among them; null when none is held.'}, 'earliest_vendor_published_at': {'type': ['string', 'null'], 'description': 'The earliest vendor_published_at among them; null when none is held. An advisory this vendor published before it is not held.'}}, 'additionalProperties': False}, {'type': 'null'}], 'description': "This advisory's vendor's window in what EchelonGraph holds; null when the windows could not be read or carry none for this vendor."}}, 'additionalProperties': False}, {'type': 'null'}]}, 'freshness': {'type': 'null'}, 'measured_at': {'type': 'null'}}, 'additionalProperties': False}], '$schema': 'https://json-schema.org/draft/2020-12/schema'}
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'page size (default 50, max 200)'}, 'since': {'type': 'string', 'description': 'earliest kev_added_date to include, YYYY-MM-DD (an RFC 3339 timestamp is read as the date written in it)'}, 'until': {'type': 'string', 'description': 'latest kev_added_date to include, YYYY-MM-DD (an RFC 3339 timestamp is read as the date written in it)'}, 'cursor': {'type': 'string', 'description': 'next_cursor from the previous page'}, 'vendor': {'type': 'string', 'description': "CISA vendorProject, an exact case-insensitive match, e.g. 'Microsoft'"}, 'ransomware': {'type': 'boolean', 'description': 'true: only CVEs with known ransomware-campaign use; false: only those without'}}}
출력 스키마
{'type': 'object', 'oneOf': [{'type': 'object', 'required': ['state', 'measured_at', 'method', 'coverage', 'freshness', 'notes', 'data'], 'properties': {'data': {'type': 'object', 'properties': {'kev': {'type': 'array', 'items': {'type': 'object', 'properties': {'cve_id': {'type': ['string', 'null']}, 'severity': {'type': ['string', 'null']}, 'epss_score': {'type': ['number', 'null']}, 'kev_vendor': {'type': ['string', 'null']}, 'eg_kev_tier': {'type': ['number', 'null']}, 'kev_product': {'type': ['string', 'null']}, 'kev_due_date': {'type': ['string', 'null']}, 'cvss_v3_score': {'type': ['number', 'null']}, 'kev_vuln_name': {'type': ['string', 'null']}, 'kev_added_date': {'type': ['string', 'null']}, 'kev_ransomware': {'type': ['boolean', 'null']}, 'epss_percentile': {'type': ['number', 'null']}, 'our_first_seen_kev': {'type': ['string', 'null'], 'description': "When EchelonGraph's poller first recorded the CVE entering the catalog; null where no such record exists."}}, 'additionalProperties': {}}}, 'count': {'type': ['number', 'null']}, 'limit': {'type': ['number', 'null']}, 'notes': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}]}, 'order': {'type': ['string', 'null']}, 'total': {'type': ['number', 'null']}, 'method': {'type': ['string', 'null']}, 'catalog': {'anyOf': [{'type': 'object', 'properties': {'source': {'type': ['string', 'null']}, 'feed_url': {'type': ['string', 'null']}, 'catalog_count': {'type': ['number', 'null']}, 'date_released': {'type': ['string', 'null']}, 'catalog_version': {'type': ['string', 'null']}, 'last_successful_fetch_at': {'type': ['string', 'null']}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'filters': {'anyOf': [{'type': 'object', 'properties': {}, 'additionalProperties': {}}, {'type': 'null'}]}, 'next_cursor': {'type': ['string', 'null']}, 'generated_at': {'type': ['string', 'null']}, 'kev_listed_total': {'type': ['number', 'null']}}, 'additionalProperties': {}}, 'notes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Caveats, one sentence each.'}, 'state': {'enum': ['measured', 'not_assessed'], 'type': 'string', 'description': 'measured: a measurement of what was asked; an exposure count is measured only with measured_at and method. not_assessed: the answer holds no dated measurement of what was asked, so no count in it is presented as one; it can still relay a count, as what the source holds on record, undated, and its notes (and exposure_state, where the result carries it) say what each count is.'}, 'method': {'type': 'string', 'description': 'How the numbers were produced.'}, 'coverage': {'anyOf': [{'type': 'object', 'required': ['catalog', 'total', 'returned', 'kev_listed_total', 'catalog_count', 'limit', 'has_more'], 'properties': {'limit': {'type': ['number', 'null']}, 'total': {'type': ['number', 'null'], 'description': 'CVEs matching the filters.'}, 'catalog': {'type': 'string', 'const': 'CISA KEV catalog'}, 'has_more': {'type': ['boolean', 'null'], 'description': 'Whether next_cursor names a further page.'}, 'returned': {'type': ['number', 'null'], 'description': 'Rows in this page.'}, 'catalog_count': {'type': ['number', 'null'], 'description': "CISA's own count, in the catalog last fetched."}, 'kev_listed_total': {'type': ['number', 'null'], 'description': 'Every CVE EchelonGraph holds as KEV-listed.'}}, 'additionalProperties': False}, {'type': 'null'}], 'description': 'What the answer covers; null where the answer says nothing about it.'}, 'freshness': {'anyOf': [{'type': 'object', 'required': ['last_successful_fetch_at', 'catalog_version', 'date_released'], 'properties': {'date_released': {'type': ['string', 'null']}, 'catalog_version': {'type': ['string', 'null']}, 'last_successful_fetch_at': {'type': ['string', 'null'], 'description': 'When CISA last answered our poll of its feed: a 200 we applied, or a 304 Not Modified.'}}, 'additionalProperties': False}, {'type': 'null'}], 'description': "The producing radar's last completed check (last_run_at), where the API serves one."}, 'measured_at': {'anyOf': [{'type': 'string', 'description': 'An RFC 3339 instant.'}, {'type': 'null'}], 'description': 'When the underlying observation was made, as the API states it; null when the answer does not say or holds no observation.'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['state', 'measured_at', 'method', 'coverage', 'freshness', 'notes', 'error'], 'properties': {'error': {'type': 'object', 'required': ['kind', 'path', 'status', 'message'], 'properties': {'kind': {'enum': ['network', 'timeout', 'http', 'not_json', 'not_object', 'invalid_input', 'internal', 'unexpected_shape', 'radars'], 'type': 'string', 'description': 'What failed: the request (network, timeout), the answer (http, not_json, not_object, unexpected_shape), the input, or this server.'}, 'path': {'type': ['string', 'null'], 'description': 'The API path requested, when a request was made.'}, 'status': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}], 'description': 'The HTTP status, when the API answered one.'}, 'message': {'type': 'string', 'description': "The cause: the API's own message, or what went wrong."}}, 'additionalProperties': False}, 'notes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Caveats, one sentence each.'}, 'state': {'enum': ['failed', 'invalid_input'], 'type': 'string', 'description': 'failed: the lookup did not complete. invalid_input: the input was refused, so nothing was looked up. Neither is a finding.'}, 'method': {'type': 'null'}, 'coverage': {'anyOf': [{'type': 'object', 'required': ['catalog', 'total', 'returned', 'kev_listed_total', 'catalog_count', 'limit', 'has_more'], 'properties': {'limit': {'type': ['number', 'null']}, 'total': {'type': ['number', 'null'], 'description': 'CVEs matching the filters.'}, 'catalog': {'type': 'string', 'const': 'CISA KEV catalog'}, 'has_more': {'type': ['boolean', 'null'], 'description': 'Whether next_cursor names a further page.'}, 'returned': {'type': ['number', 'null'], 'description': 'Rows in this page.'}, 'catalog_count': {'type': ['number', 'null'], 'description': "CISA's own count, in the catalog last fetched."}, 'kev_listed_total': {'type': ['number', 'null'], 'description': 'Every CVE EchelonGraph holds as KEV-listed.'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'freshness': {'type': 'null'}, 'measured_at': {'type': 'null'}}, 'additionalProperties': False}], '$schema': 'https://json-schema.org/draft/2020-12/schema'}
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'sort': {'enum': ['published', 'modified', 'nvd', 'echelongraph', 'epss'], 'type': 'string', 'description': 'sort order (default: published)'}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'page size (default 20, max 50)'}, 'offset': {'type': 'integer', 'maximum': 10000, 'minimum': 0, 'description': 'rows to skip (default 0)'}, 'search': {'type': 'string', 'description': "free-text search (product, vendor, or keyword, e.g. 'tomcat')"}, 'min_cvss': {'type': 'number', 'maximum': 10, 'minimum': 0, 'description': 'minimum CVSS score'}, 'severity': {'enum': ['CRITICAL', 'HIGH', 'MEDIUM', 'LOW'], 'type': 'string', 'description': 'filter to one severity'}}}
출력 스키마
{'type': 'object', 'oneOf': [{'type': 'object', 'required': ['state', 'measured_at', 'method', 'coverage', 'freshness', 'notes', 'data'], 'properties': {'data': {'type': 'object', 'properties': {'cves': {'type': 'array', 'items': {'type': 'object', 'properties': {'cve_id': {'type': ['string', 'null']}, 'ghsa_id': {'type': ['string', 'null']}, 'modified': {'type': ['string', 'null']}, 'severity': {'type': ['string', 'null']}, 'cpe_match': {'description': "The record's CPE match criteria as one flat list, every configuration's cpeMatch entries together: the AND/OR operator and negate of each configuration and node, versionStartExcluding and matchCriteriaId are not in it, so a CPE that is only a platform a product runs on reads as one more entry."}, 'published': {'type': ['string', 'null']}, 'epss_score': {'type': ['number', 'null']}, 'kev_listed': {'type': ['boolean', 'null']}, 'references': {}, 'updated_at': {'type': ['string', 'null']}, 'description': {'type': ['string', 'null']}, 'cvss_v3_score': {'type': ['number', 'null']}, 'cvss_v4_score': {'type': ['number', 'null']}, 'kev_added_date': {'type': ['string', 'null']}, 'kev_ransomware': {'type': ['boolean', 'null']}, 'score_assessed': {'type': ['boolean', 'null'], 'description': 'Whether EchelonGraph has scored the CVE. true: echelongraph_score, echelongraph_severity and echelongraph_risk are its score. false: the CVE is NOT YET SCORED, not scored 0, and any of those three it carries is a placeholder, not a rating; the API may leave them out. Absent (an API older than the field): the answer does not say whether the CVE was scored.'}, 'epss_percentile': {'type': ['number', 'null']}, 'cvss_v4_severity': {'type': ['string', 'null']}, 'score_confidence': {'type': ['string', 'null']}, 'echelongraph_risk': {'type': ['number', 'null'], 'description': "EchelonGraph's 0-100 risk priority, fused from the score, exploitation and automatability: a rating only when score_assessed is true. With score_assessed false it is a placeholder."}, 'cpe_configurations': {'anyOf': [{'type': 'array', 'items': {}}, {'type': 'null'}], 'description': "NVD's configurations array as NVD sent it: each configuration and node with its operator (AND, OR) and negate, and each cpeMatch with criteria, vulnerable, versionStartIncluding, versionStartExcluding, versionEndIncluding, versionEndExcluding and matchCriteriaId. A cpeMatch with vulnerable false inside an AND configuration is the platform the vulnerable product runs on, not an affected product. Absent: EchelonGraph holds no stored NVD configuration for the CVE, which is not a finding that no product is affected."}, 'echelongraph_score': {'type': ['number', 'null'], 'description': "EchelonGraph's 0-10 score for the CVE: a score only when score_assessed is true. With score_assessed false it is a placeholder, not a rating."}, 'echelongraph_severity': {'type': ['string', 'null'], 'description': 'The severity band of echelongraph_score: a rating only when score_assessed is true. With score_assessed false it is a placeholder (NONE).'}, 'score_unassessed_reason': {'type': ['string', 'null'], 'description': 'Why score_assessed is false: no_signal, no source has yet published severity data EchelonGraph can score; or rejected, the record was withdrawn by its numbering authority and is never scored. Absent when the CVE is scored.'}}, 'additionalProperties': {}}}, 'limit': {'type': ['number', 'null']}, 'total': {'type': ['number', 'null']}, 'offset': {'type': ['number', 'null']}, 'total_counted': {'type': ['boolean', 'null']}, 'search_relaxed': {'type': ['boolean', 'null']}, 'total_is_lower_bound': {'type': ['boolean', 'null']}}, 'additionalProperties': {}}, 'notes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Caveats, one sentence each.'}, 'state': {'enum': ['measured', 'not_assessed'], 'type': 'string', 'description': 'measured: a measurement of what was asked; an exposure count is measured only with measured_at and method. not_assessed: the answer holds no dated measurement of what was asked, so no count in it is presented as one; it can still relay a count, as what the source holds on record, undated, and its notes (and exposure_state, where the result carries it) say what each count is.'}, 'method': {'type': 'string', 'description': 'How the numbers were produced.'}, 'coverage': {'anyOf': [{'type': 'object', 'required': ['total', 'total_counted', 'total_is_lower_bound', 'search_relaxed', 'returned', 'limit', 'offset'], 'properties': {'limit': {'type': ['number', 'null']}, 'total': {'type': ['number', 'null']}, 'offset': {'type': ['number', 'null']}, 'returned': {'type': ['number', 'null']}, 'total_counted': {'type': ['boolean', 'null']}, 'search_relaxed': {'type': ['boolean', 'null']}, 'total_is_lower_bound': {'type': ['boolean', 'null']}}, 'additionalProperties': False}, {'type': 'null'}], 'description': 'What the answer covers; null where the answer says nothing about it.'}, 'freshness': {'type': 'null', 'description': "The producing radar's last completed check (last_run_at), where the API serves one."}, 'measured_at': {'anyOf': [{'type': 'string', 'description': 'An RFC 3339 instant.'}, {'type': 'null'}], 'description': 'When the underlying observation was made, as the API states it; null when the answer does not say or holds no observation.'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['state', 'measured_at', 'method', 'coverage', 'freshness', 'notes', 'error'], 'properties': {'error': {'type': 'object', 'required': ['kind', 'path', 'status', 'message'], 'properties': {'kind': {'enum': ['network', 'timeout', 'http', 'not_json', 'not_object', 'invalid_input', 'internal', 'unexpected_shape', 'radars'], 'type': 'string', 'description': 'What failed: the request (network, timeout), the answer (http, not_json, not_object, unexpected_shape), the input, or this server.'}, 'path': {'type': ['string', 'null'], 'description': 'The API path requested, when a request was made.'}, 'status': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}], 'description': 'The HTTP status, when the API answered one.'}, 'message': {'type': 'string', 'description': "The cause: the API's own message, or what went wrong."}}, 'additionalProperties': False}, 'notes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Caveats, one sentence each.'}, 'state': {'enum': ['failed', 'invalid_input'], 'type': 'string', 'description': 'failed: the lookup did not complete. invalid_input: the input was refused, so nothing was looked up. Neither is a finding.'}, 'method': {'type': 'null'}, 'coverage': {'anyOf': [{'type': 'object', 'required': ['total', 'total_counted', 'total_is_lower_bound', 'search_relaxed', 'returned', 'limit', 'offset'], 'properties': {'limit': {'type': ['number', 'null']}, 'total': {'type': ['number', 'null']}, 'offset': {'type': ['number', 'null']}, 'returned': {'type': ['number', 'null']}, 'total_counted': {'type': ['boolean', 'null']}, 'search_relaxed': {'type': ['boolean', 'null']}, 'total_is_lower_bound': {'type': ['boolean', 'null']}}, 'additionalProperties': False}, {'type': 'null'}]}, 'freshness': {'type': 'null'}, 'measured_at': {'type': 'null'}}, 'additionalProperties': False}], '$schema': 'https://json-schema.org/draft/2020-12/schema'}
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'page size (default 20, max 50)'}, 'query': {'type': 'string', 'description': "free text, at most 100 bytes: a product, an advisory ID, a CVE ID or a keyword, e.g. 'exchange server'; 1 or 2 characters match whole words only"}, 'offset': {'type': 'integer', 'maximum': 10000, 'minimum': 0, 'description': 'rows to skip (default 0)'}, 'vendor': {'type': 'string', 'description': 'a vendor slug, e.g. microsoft, redhat, github'}, 'has_cve': {'type': 'boolean', 'description': 'true: only advisories naming a CVE; false: only those naming none'}, 'severity': {'enum': ['Critical', 'High', 'Medium', 'Low'], 'type': 'string', 'description': 'one severity band'}}}
출력 스키마
{'type': 'object', 'oneOf': [{'type': 'object', 'required': ['state', 'measured_at', 'method', 'coverage', 'freshness', 'notes', 'data'], 'properties': {'data': {'type': 'object', 'properties': {'limit': {'type': ['number', 'null']}, 'total': {'type': ['number', 'null'], 'description': 'The matches; when total_capped is true, a lower bound: 1,000 or more.'}, 'offset': {'type': ['number', 'null']}, 'advisories': {'anyOf': [{'type': 'array', 'items': {'type': 'object', 'properties': {'title': {'type': ['string', 'null']}, 'vendor': {'type': ['string', 'null']}, 'cve_ids': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}]}, 'summary': {'type': ['string', 'null']}, 'severity': {'type': ['string', 'null']}, 'withdrawn': {'type': ['boolean', 'null'], 'description': 'true: the vendor withdrew (rescinded) this advisory; report it as withdrawn.'}, 'advisory_id': {'type': ['string', 'null']}, 'cvss_v3_score': {'type': ['number', 'null']}, 'affected_products': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}]}, 'our_first_seen_at': {'type': ['string', 'null'], 'description': "When EchelonGraph first recorded the advisory; not the vendor's date."}, 'vendor_advisory_id': {'type': ['string', 'null']}, 'vendor_display_name': {'type': ['string', 'null']}, 'vendor_published_at': {'type': ['string', 'null'], 'description': 'The date the vendor gives for the advisory.'}}, 'additionalProperties': {}}}, {'type': 'null'}]}, 'search_match': {'type': ['string', 'null'], 'description': 'How the query was matched: word (a query of 1 or 2 characters, whole words only) or substring; null without a query.'}, 'total_capped': {'type': ['boolean', 'null'], 'description': 'true: the search stopped counting at total, so total is a lower bound (1,000+), not the count.'}, 'search_applied': {'type': ['boolean', 'null'], 'description': 'Whether a free-text search filtered this answer.'}}, 'additionalProperties': {}}, 'notes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Caveats, one sentence each.'}, 'state': {'enum': ['measured', 'not_assessed'], 'type': 'string', 'description': 'measured: a measurement of what was asked; an exposure count is measured only with measured_at and method. not_assessed: the answer holds no dated measurement of what was asked, so no count in it is presented as one; it can still relay a count, as what the source holds on record, undated, and its notes (and exposure_state, where the result carries it) say what each count is.'}, 'method': {'type': 'string', 'description': 'How the numbers were produced.'}, 'coverage': {'anyOf': [{'type': 'object', 'required': ['total', 'total_capped', 'returned', 'limit', 'offset', 'search_applied', 'search_match', 'vendor_windows'], 'properties': {'limit': {'type': ['number', 'null']}, 'total': {'type': ['number', 'null'], 'description': "The API's total; when total_capped is true, a lower bound, not the count."}, 'offset': {'type': ['number', 'null']}, 'returned': {'type': ['number', 'null']}, 'search_match': {'anyOf': [{'enum': ['word', 'substring'], 'type': 'string'}, {'type': 'null'}], 'description': 'word: a query of 1 or 2 characters, matched as a whole word only; substring: a longer query; null without a query.'}, 'total_capped': {'type': ['boolean', 'null'], 'description': "true: total is the API's cap on a search's count, so 1,000 or more match."}, 'search_applied': {'type': ['boolean', 'null']}, 'vendor_windows': {'anyOf': [{'type': 'array', 'items': {'type': 'object', 'required': ['vendor', 'vendor_display_name', 'advisories', 'earliest_vendor_published_at', 'latest_vendor_published_at', 'history_backfill'], 'properties': {'vendor': {'type': 'string', 'description': 'The vendor slug.'}, 'advisories': {'type': ['number', 'null'], 'description': 'How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.'}, 'history_backfill': {'anyOf': [{'anyOf': [{'enum': ['complete', 'in_progress', 'not_started', 'not_supported'], 'type': 'string'}, {'type': 'string'}]}, {'type': 'null'}], 'description': "history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."}, 'vendor_display_name': {'type': ['string', 'null']}, 'latest_vendor_published_at': {'type': ['string', 'null'], 'description': 'The latest vendor_published_at among them; null when none is held.'}, 'earliest_vendor_published_at': {'type': ['string', 'null'], 'description': 'The earliest vendor_published_at among them; null when none is held. An advisory this vendor published before it is not held.'}}, 'additionalProperties': False}}, {'type': 'null'}], 'description': "Each vendor's window in what EchelonGraph holds; null when the windows could not be read. An advisory a vendor published before its earliest_vendor_published_at is not held, so no advisory from a vendor is not a finding that it published none."}}, 'additionalProperties': False}, {'type': 'null'}], 'description': 'What the answer covers; null where the answer says nothing about it.'}, 'freshness': {'type': 'null', 'description': "The producing radar's last completed check (last_run_at), where the API serves one."}, 'measured_at': {'anyOf': [{'type': 'string', 'description': 'An RFC 3339 instant.'}, {'type': 'null'}], 'description': 'When the underlying observation was made, as the API states it; null when the answer does not say or holds no observation.'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['state', 'measured_at', 'method', 'coverage', 'freshness', 'notes', 'error'], 'properties': {'error': {'type': 'object', 'required': ['kind', 'path', 'status', 'message'], 'properties': {'kind': {'enum': ['network', 'timeout', 'http', 'not_json', 'not_object', 'invalid_input', 'internal', 'unexpected_shape', 'radars'], 'type': 'string', 'description': 'What failed: the request (network, timeout), the answer (http, not_json, not_object, unexpected_shape), the input, or this server.'}, 'path': {'type': ['string', 'null'], 'description': 'The API path requested, when a request was made.'}, 'status': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}], 'description': 'The HTTP status, when the API answered one.'}, 'message': {'type': 'string', 'description': "The cause: the API's own message, or what went wrong."}}, 'additionalProperties': False}, 'notes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Caveats, one sentence each.'}, 'state': {'enum': ['failed', 'invalid_input'], 'type': 'string', 'description': 'failed: the lookup did not complete. invalid_input: the input was refused, so nothing was looked up. Neither is a finding.'}, 'method': {'type': 'null'}, 'coverage': {'anyOf': [{'type': 'object', 'required': ['total', 'total_capped', 'returned', 'limit', 'offset', 'search_applied', 'search_match', 'vendor_windows'], 'properties': {'limit': {'type': ['number', 'null']}, 'total': {'type': ['number', 'null'], 'description': "The API's total; when total_capped is true, a lower bound, not the count."}, 'offset': {'type': ['number', 'null']}, 'returned': {'type': ['number', 'null']}, 'search_match': {'anyOf': [{'enum': ['word', 'substring'], 'type': 'string'}, {'type': 'null'}], 'description': 'word: a query of 1 or 2 characters, matched as a whole word only; substring: a longer query; null without a query.'}, 'total_capped': {'type': ['boolean', 'null'], 'description': "true: total is the API's cap on a search's count, so 1,000 or more match."}, 'search_applied': {'type': ['boolean', 'null']}, 'vendor_windows': {'anyOf': [{'type': 'array', 'items': {'type': 'object', 'required': ['vendor', 'vendor_display_name', 'advisories', 'earliest_vendor_published_at', 'latest_vendor_published_at', 'history_backfill'], 'properties': {'vendor': {'type': 'string', 'description': 'The vendor slug.'}, 'advisories': {'type': ['number', 'null'], 'description': 'How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.'}, 'history_backfill': {'anyOf': [{'anyOf': [{'enum': ['complete', 'in_progress', 'not_started', 'not_supported'], 'type': 'string'}, {'type': 'string'}]}, {'type': 'null'}], 'description': "history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."}, 'vendor_display_name': {'type': ['string', 'null']}, 'latest_vendor_published_at': {'type': ['string', 'null'], 'description': 'The latest vendor_published_at among them; null when none is held.'}, 'earliest_vendor_published_at': {'type': ['string', 'null'], 'description': 'The earliest vendor_published_at among them; null when none is held. An advisory this vendor published before it is not held.'}}, 'additionalProperties': False}}, {'type': 'null'}], 'description': "Each vendor's window in what EchelonGraph holds; null when the windows could not be read. An advisory a vendor published before its earliest_vendor_published_at is not held, so no advisory from a vendor is not a finding that it published none."}}, 'additionalProperties': False}, {'type': 'null'}]}, 'freshness': {'type': 'null'}, 'measured_at': {'type': 'null'}}, 'additionalProperties': False}], '$schema': 'https://json-schema.org/draft/2020-12/schema'}
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['cve_id'], 'properties': {'cve_id': {'type': 'string', 'description': 'a CVE ID, e.g. CVE-2024-21412'}}}
출력 스키마
{'type': 'object', 'oneOf': [{'type': 'object', 'required': ['state', 'measured_at', 'method', 'coverage', 'freshness', 'notes', 'data'], 'properties': {'data': {'type': 'object', 'properties': {'total': {'type': ['number', 'null']}, 'cve_id': {'type': ['string', 'null']}, 'advisories': {'anyOf': [{'type': 'array', 'items': {'type': 'object', 'properties': {'title': {'type': ['string', 'null']}, 'vendor': {'type': ['string', 'null']}, 'cve_ids': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}]}, 'summary': {'type': ['string', 'null']}, 'severity': {'type': ['string', 'null']}, 'withdrawn': {'type': ['boolean', 'null'], 'description': 'true: the vendor withdrew (rescinded) this advisory; report it as withdrawn.'}, 'advisory_id': {'type': ['string', 'null']}, 'cvss_v3_score': {'type': ['number', 'null']}, 'affected_products': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}]}, 'our_first_seen_at': {'type': ['string', 'null'], 'description': "When EchelonGraph first recorded the advisory; not the vendor's date."}, 'vendor_advisory_id': {'type': ['string', 'null']}, 'vendor_display_name': {'type': ['string', 'null']}, 'vendor_published_at': {'type': ['string', 'null'], 'description': 'The date the vendor gives for the advisory.'}}, 'additionalProperties': {}}}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'notes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Caveats, one sentence each.'}, 'state': {'enum': ['measured', 'not_assessed'], 'type': 'string', 'description': 'measured: a measurement of what was asked; an exposure count is measured only with measured_at and method. not_assessed: the answer holds no dated measurement of what was asked, so no count in it is presented as one; it can still relay a count, as what the source holds on record, undated, and its notes (and exposure_state, where the result carries it) say what each count is.'}, 'method': {'type': 'string', 'description': 'How the numbers were produced.'}, 'coverage': {'anyOf': [{'type': 'object', 'required': ['returned', 'cap', 'at_cap', 'cve_year', 'vendor_windows', 'vendors_not_fully_held'], 'properties': {'cap': {'type': 'number', 'description': 'The most the API returns for one CVE, newest first.'}, 'at_cap': {'type': ['boolean', 'null'], 'description': 'true: the answer is full, so the vendor feeds may hold more advisories for this CVE than it lists.'}, 'cve_year': {'type': 'number', 'description': 'The year in the CVE ID.'}, 'returned': {'type': ['number', 'null'], 'description': 'The advisories in this answer.'}, 'vendor_windows': {'anyOf': [{'type': 'array', 'items': {'type': 'object', 'required': ['vendor', 'vendor_display_name', 'advisories', 'earliest_vendor_published_at', 'latest_vendor_published_at', 'history_backfill'], 'properties': {'vendor': {'type': 'string', 'description': 'The vendor slug.'}, 'advisories': {'type': ['number', 'null'], 'description': 'How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.'}, 'history_backfill': {'anyOf': [{'anyOf': [{'enum': ['complete', 'in_progress', 'not_started', 'not_supported'], 'type': 'string'}, {'type': 'string'}]}, {'type': 'null'}], 'description': "history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."}, 'vendor_display_name': {'type': ['string', 'null']}, 'latest_vendor_published_at': {'type': ['string', 'null'], 'description': 'The latest vendor_published_at among them; null when none is held.'}, 'earliest_vendor_published_at': {'type': ['string', 'null'], 'description': 'The earliest vendor_published_at among them; null when none is held. An advisory this vendor published before it is not held.'}}, 'additionalProperties': False}}, {'type': 'null'}], 'description': "Each vendor's window in what EchelonGraph holds; null when the windows could not be read. An advisory a vendor published before its earliest_vendor_published_at is not held, so no advisory from a vendor is not a finding that it published none."}, 'vendors_not_fully_held': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'description': 'The vendors with no advisory in this answer that may have published one EchelonGraph does not hold: none held, the earliest held dated after 1 January of cve_year, or history_backfill in_progress or not_started. No advisory from them is not a finding that they published none. null when the windows could not be read.'}}, 'additionalProperties': False}, {'type': 'null'}], 'description': 'What the answer covers; null where the answer says nothing about it.'}, 'freshness': {'type': 'null', 'description': "The producing radar's last completed check (last_run_at), where the API serves one."}, 'measured_at': {'anyOf': [{'type': 'string', 'description': 'An RFC 3339 instant.'}, {'type': 'null'}], 'description': 'When the underlying observation was made, as the API states it; null when the answer does not say or holds no observation.'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['state', 'measured_at', 'method', 'coverage', 'freshness', 'notes', 'error'], 'properties': {'error': {'type': 'object', 'required': ['kind', 'path', 'status', 'message'], 'properties': {'kind': {'enum': ['network', 'timeout', 'http', 'not_json', 'not_object', 'invalid_input', 'internal', 'unexpected_shape', 'radars'], 'type': 'string', 'description': 'What failed: the request (network, timeout), the answer (http, not_json, not_object, unexpected_shape), the input, or this server.'}, 'path': {'type': ['string', 'null'], 'description': 'The API path requested, when a request was made.'}, 'status': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'null'}], 'description': 'The HTTP status, when the API answered one.'}, 'message': {'type': 'string', 'description': "The cause: the API's own message, or what went wrong."}}, 'additionalProperties': False}, 'notes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Caveats, one sentence each.'}, 'state': {'enum': ['failed', 'invalid_input'], 'type': 'string', 'description': 'failed: the lookup did not complete. invalid_input: the input was refused, so nothing was looked up. Neither is a finding.'}, 'method': {'type': 'null'}, 'coverage': {'anyOf': [{'type': 'object', 'required': ['returned', 'cap', 'at_cap', 'cve_year', 'vendor_windows', 'vendors_not_fully_held'], 'properties': {'cap': {'type': 'number', 'description': 'The most the API returns for one CVE, newest first.'}, 'at_cap': {'type': ['boolean', 'null'], 'description': 'true: the answer is full, so the vendor feeds may hold more advisories for this CVE than it lists.'}, 'cve_year': {'type': 'number', 'description': 'The year in the CVE ID.'}, 'returned': {'type': ['number', 'null'], 'description': 'The advisories in this answer.'}, 'vendor_windows': {'anyOf': [{'type': 'array', 'items': {'type': 'object', 'required': ['vendor', 'vendor_display_name', 'advisories', 'earliest_vendor_published_at', 'latest_vendor_published_at', 'history_backfill'], 'properties': {'vendor': {'type': 'string', 'description': 'The vendor slug.'}, 'advisories': {'type': ['number', 'null'], 'description': 'How many advisories EchelonGraph holds from this vendor, withdrawn ones not counted.'}, 'history_backfill': {'anyOf': [{'anyOf': [{'enum': ['complete', 'in_progress', 'not_started', 'not_supported'], 'type': 'string'}, {'type': 'string'}]}, {'type': 'null'}], 'description': "history_backfill: complete (the vendor's published history has been read back as far as its source goes), in_progress or not_started (it is still being read, so the vendor's older advisories are not all held yet), or not_supported (EchelonGraph has no history read for that vendor, so what it holds is what the vendor's feed has carried)."}, 'vendor_display_name': {'type': ['string', 'null']}, 'latest_vendor_published_at': {'type': ['string', 'null'], 'description': 'The latest vendor_published_at among them; null when none is held.'}, 'earliest_vendor_published_at': {'type': ['string', 'null'], 'description': 'The earliest vendor_published_at among them; null when none is held. An advisory this vendor published before it is not held.'}}, 'additionalProperties': False}}, {'type': 'null'}], 'description': "Each vendor's window in what EchelonGraph holds; null when the windows could not be read. An advisory a vendor published before its earliest_vendor_published_at is not held, so no advisory from a vendor is not a finding that it published none."}, 'vendors_not_fully_held': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'description': 'The vendors with no advisory in this answer that may have published one EchelonGraph does not hold: none held, the earliest held dated after 1 January of cve_year, or history_backfill in_progress or not_started. No advisory from them is not a finding that they published none. null when the windows could not be read.'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'freshness': {'type': 'null'}, 'measured_at': {'type': 'null'}}, 'additionalProperties': False}], '$schema': 'https://json-schema.org/draft/2020-12/schema'}
최근 도구 변경
유사한 MCP 서버
hyperion
Acts as a paid MCP tool marketplace and utility gateway with server discovery, HTTP and JavaScript tools, research, data conversi…
Vee3
Manages Clerk authentication infrastructure, including users, organizations, domains, sessions, tokens, OAuth, SSO, machines, per…
IA-QA — 130+ QA & Dev Tools for AI Agents
Provides deterministic QA, evaluation, testing, code analysis, prompt and RAG checks, model comparison, and web security diagnost…
validoria-mcp
Runs continuous website, API, and webshop tests covering security, SEO, performance, accessibility, browser journeys, and inciden…
HubVibe: Pay-per-Call Tools for AI Agents: Web Search, Email Verify, KYC, Stocks, Crypto, News, Data
Offers paid utilities for web audits, HTTP fetching and extraction, BigQuery analysis, LLM processing, code execution, blockchain…
developer-tools
Provides general-purpose developer utilities for encoding, hashing, encryption, JSON, HTML, CSS, networking, and related data tra…
Qiniso
Provides deterministic formatting, parsing, holiday and tax lookups, address handling, and checksum or structure validation for i…
ContrastAPI
Provides security research and assessment tools covering CVEs, IOCs, dependencies, secrets, injection risks, HTTP headers, domain…