Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Rozhraní AKS Vulnerability Data API poskytuje programový přehled o ohroženích zabezpečení zjištěných v komponentách platformy spravované službou AKS jen pro čtení. Toto rozhraní API je určené pro týmy zabezpečení, týmy dodržování předpisů a vlastníky platforem, kteří potřebují autoritativní informace o ohroženích zabezpečení ovlivňujících artefakty spravované službou AKS nezávisle na konkrétním stavu modulu runtime clusteru.
V tomto článku se dozvíte, jak pomocí rozhraní AKS Vulnerability Data API programově získávat reporty CVE pro artefakty spravované službou AKS, včetně vydání AKS, verzí Kubernetes, imagí uzlů, imagí kontejnerů a balíčků operačního systému. Poskytuje příklady požadavků rozhraní API a ukazuje, jak interpretovat odpovědi na podporu rozsáhlé analýzy CVE, automatizace a korelace se zjištěními kontroly zabezpečení. Přehled konceptů rozhraní API najdete v článku Přehled rozhraní Vulnerability Data API pro Azure Kubernetes Service (AKS).
Vyhledat zprávy CVE
Následující příklady ukazují, jak pomocí rozhraní AKS Vulnerability Data API získat reporty CVE pro vydání AKS, verze Kubernetes, image uzlů, image kontejnerů a balíčky operačního systému.
Dotazování na CVE pro vydání AKS
# 1. List available AKS releases
curl -s https://cve-api.prod-aks.azure.com/api/v1/aks-releases/_index | jq '.aks_release_versions'
# 2. Get CVE report for a specific release
curl -s https://cve-api.prod-aks.azure.com/api/v1/aks-releases/v20260104/scan-reports | jq '.'
Vyhledání CVE pro verzi Kubernetes
# 1. List available Kubernetes versions
curl -s https://cve-api.prod-aks.azure.com/api/v1/aks-k8s-releases/_index | jq '.k8s_versions'
# 2. Get CVE report for a specific Kubernetes version
curl -s https://cve-api.prod-aks.azure.com/api/v1/aks-k8s-releases/1.32.9/scan-reports | jq '.'
Dotazovat se na CVE pro image uzlu (VHD)
# 1. List available VHD releases
curl -s https://cve-api.prod-aks.azure.com/api/v1/vhd-releases/_index | jq '.vhd_release_versions'
# 2. Get CVE report for a specific VHD
curl -s https://cve-api.prod-aks.azure.com/api/v1/vhd-releases/AKSUbuntu-gen2-2204containerd/202601.13.0/scan-reports | jq '.'
Dotazování na CVE pro konkrétní bitovou kopii kontejneru
# Get CVE scan report for a specific tagged container image
curl -s https://cve-api.prod-aks.azure.com/api/v1/container-images/mcr.microsoft.com/oss/kubernetes/kube-proxy:v1.31.11/scan-reports | jq '.'
# Get CVE mitigation history for a container image repository
curl -s https://cve-api.prod-aks.azure.com/api/v1/container-images/mcr.microsoft.com/oss/kubernetes/kube-proxy/mitigation-reports | jq '.'
Dotaz na CVE pro konkrétní balíček OS
# Get CVE scan report for a specific OS package version
curl -s https://cve-api.prod-aks.azure.com/api/v1/vhd-packages/openssl/3.0.2-0ubuntu1.20/scan-reports | jq '.'
# Get CVE mitigation history for an OS package
curl -s https://cve-api.prod-aks.azure.com/api/v1/vhd-packages/openssl/mitigation-reports | jq '.'
Koncové body
Rozhraní AKS Vulnerability Data API zveřejňuje koncové body pro načítání sestav CVE pro verze AKS, verze Kubernetes, image uzlů, image kontejnerů a balíčky operačního systému. Každý koncový bod rozhraní poskytuje přístup buď k seznamu dostupných verzí, nebo k podrobné zprávě o kontrole pro konkrétní verzi nebo artefakt. Následující části popisují jednotlivé koncové body, dostupné operace a očekávané formáty požadavků a odpovědí.
Vydané verze AKS
Získání indexu vydaných verzí AKS
Následující koncový bod rozhraní vrací index všech verzí vydání AKS s dostupnými zprávami CVE:
GET /api/v1/aks-releases/_index
Příklad požadavku:
curl -s https://cve-api.prod-aks.azure.com/api/v1/aks-releases/_index
Příklad odpovědi:
{
"aks_release_versions": [
"v20250427",
"v20250519",
"v20250617",
"v20250720",
"v20250808",
"v20250829",
"v20250921",
"v20251012",
"v20260104"
],
"report_time": "2026-01-27T16:19:36.181877605Z"
}
Pole odpovědi:
| Pole | Typ | Description |
|---|---|---|
aks_release_versions |
string[] | Dostupné verze AKS seřazené chronologicky |
report_time |
string (ISO 8601) | Kdy byl tento index naposledy vygenerován |
Získání sestavy CVE vydané verze AKS
Následující endpoint vrací podrobnou zprávu o CVE pro konkrétní verzi vydání AKS, včetně všech imagí kontejnerů v systémových jmenných prostorech, jejich aktivních CVE a rozdílu v CVE oproti předchozí verzi vydání:
GET /api/v1/aks-releases/{version}/scan-reports
Parametry cesty:
| Parametr | Typ | Description | Příklad |
|---|---|---|---|
version |
řetězec | Verze vydání AKS z indexu | v20260104 |
Příklad požadavku:
curl -s https://cve-api.prod-aks.azure.com/api/v1/aks-releases/v20260104/scan-reports
Příklad odpovědi (zkráceně):
{
"aks_release_version": "v20260104",
"previous_aks_release_version": "v20251012",
"container_targets": [
{
"pod_namespace": "kube-system",
"container_name": "coredns",
"active_container_images": {
"image_repo_tags": [
"mcr.microsoft.com/oss/v2/kubernetes/coredns:v1.9.4-9"
],
"image_repo_digests": [
"mcr.microsoft.com/oss/v2/kubernetes/coredns:v1.9.4-9@sha256:718de5d12a..."
]
},
"active_cves": [
{"id": "CVE-2025-47914"},
{"id": "CVE-2025-58181"},
{"id": "CVE-2025-61727"},
{"id": "CVE-2025-61729"}
],
"removed_container_images_from_previous_release": {
"image_repo_tags": [],
"image_repo_digests": []
},
"mitigated_cves_from_previous_release": []
},
{
"pod_namespace": "gatekeeper-system",
"container_name": "azure-policy-audit",
"active_container_images": {
"image_repo_tags": [
"mcr.microsoft.com/azure-policy/policy-kubernetes-audit:1.15.3"
],
"image_repo_digests": [
"mcr.microsoft.com/azure-policy/policy-kubernetes-audit:1.15.3@sha256:67745758..."
]
},
"active_cves": [
{"id": "CVE-2025-61727"},
{"id": "CVE-2025-61729"}
],
"removed_container_images_from_previous_release": {
"image_repo_tags": [
"mcr.microsoft.com/azure-policy/policy-kubernetes-audit:1.14.2"
],
"image_repo_digests": [
"mcr.microsoft.com/azure-policy/policy-kubernetes-audit:1.14.2@sha256:33218f96..."
]
},
"mitigated_cves_from_previous_release": [
{"id": "CVE-2025-47912"},
{"id": "CVE-2025-47914"},
{"id": "CVE-2025-58181"}
]
}
],
"report_time": "2026-01-27T16:19:36.181877605Z"
}
Pole odpovědi:
| Pole | Typ | Description |
|---|---|---|
aks_release_version |
řetězec | Aktuální verze AKS |
previous_aks_release_version |
řetězec | Předchozí verze vydání (použitá pro výpočty rozdílů) |
container_targets |
AKSReleaseContainerTarget[] | Všechny komponenty kontejneru v této verzi |
report_time |
string (ISO 8601) | Časové razítko vygenerování reportu |
Vydání verzí Kubernetes
Získání indexu verzí Kubernetes
Následující endpoint vrací index všech verzí Kubernetes s dostupnými reporty CVE:
GET /api/v1/aks-k8s-releases/_index
Příklad požadavku:
curl -s https://cve-api.prod-aks.azure.com/api/v1/aks-k8s-releases/_index
Příklad odpovědi:
{
"k8s_versions": [
"1.27.102",
"1.27.103",
"1.28.100",
"1.29.14",
"1.30.0",
"1.30.14",
"1.31.1",
"1.32.0",
"1.32.10",
"1.33.0",
"1.33.6",
"1.34.0",
"1.34.2"
],
"report_time": "2026-01-27T16:14:37.928201259Z"
}
Pole odpovědi:
| Pole | Typ | Description |
|---|---|---|
k8s_versions |
string[] | Dostupné verze Kubernetes seřazené podle semveru |
report_time |
string (ISO 8601) | Kdy byl tento index naposledy vygenerován |
Získat sestavu CVE pro verzi Kubernetes
Následující koncový bod vrátí sestavu CVE pro konkrétní verzi Kubernetes, která podrobně popisuje ohrožení zabezpečení v imagích kontejnerů používaných základními komponentami Kubernetes a doplňky AKS pro danou verzi:
GET /api/v1/aks-k8s-releases/{version}/scan-reports
Parametry cesty:
| Parametr | Typ | Description | Příklad |
|---|---|---|---|
version |
řetězec | Verze Kubernetes z indexu | 1.33.2 |
Příklad požadavku:
curl -s https://cve-api.prod-aks.azure.com/api/v1/aks-k8s-releases/1.33.2/scan-reports
Příklad odpovědi (zkráceně):
{
"k8s_version": "1.33.2",
"container_targets": [
{
"container_image": "mcr.microsoft.com/oss/kubernetes/kube-apiserver",
"active_container_images": {
"image_repo_tags": [
"mcr.microsoft.com/oss/kubernetes/kube-apiserver:v1.33.2"
],
"image_repo_digests": [
"mcr.microsoft.com/oss/kubernetes/kube-apiserver:v1.33.2@sha256:abc123..."
]
},
"active_cves": [
{"id": "CVE-2025-47912"},
{"id": "CVE-2025-58181"}
]
},
{
"container_image": "mcr.microsoft.com/aks/aks-app-routing-operator",
"active_container_images": {
"image_repo_tags": [
"mcr.microsoft.com/aks/aks-app-routing-operator:0.0.3"
],
"image_repo_digests": [
"mcr.microsoft.com/aks/aks-app-routing-operator:0.0.3@sha256:c1ff16ca..."
]
},
"active_cves": [
{"id": "CVE-2023-39318"},
{"id": "CVE-2023-39319"},
{"id": "CVE-2023-39325"}
]
}
],
"report_time": "2026-01-27T16:14:37.928201259Z"
}
Pole odpovědi:
| Pole | Typ | Description |
|---|---|---|
k8s_version |
řetězec | Verze Kubernetes (například "1.33.2") |
container_targets |
AKSK8SContainerTarget[] | Image kontejnerů pro tuto verzi Kubernetess |
report_time |
string (ISO 8601) | Časové razítko vygenerování reportu |
Verze VHD (bitové kopie uzlu)
Získat index verzí VHD
Následující koncový bod API vrací index všech vydání VHD s dostupnými zprávami CVE:
GET /api/v1/vhd-releases/_index
Příklad požadavku:
curl -s https://cve-api.prod-aks.azure.com/api/v1/vhd-releases/_index
Příklad odpovědi (zkráceně):
{
"vhd_release_versions": [
"AKSAzureLinux-gen1/202507.02.0",
"AKSAzureLinux-gen2/202512.06.0",
"AKSAzureLinux-gen2fips/202510.03.0",
"AKSAzureLinuxV3-gen2/202511.20.0",
"AKSCBLMarinerV2-gen2/202508.20.0",
"AKSUbuntu-gen1-2204containerd/202601.13.0",
"AKSUbuntu-gen2-2404containerd/202601.13.0"
],
"report_time": "2026-01-27T16:21:23.056129543Z"
}
Pole odpovědi:
| Pole | Typ | Description |
|---|---|---|
vhd_release_versions |
string[] | Dostupné verze VHD ve formátu {distro}/{version} |
report_time |
string (ISO 8601) | Kdy byl tento index naposledy vygenerován |
Dostupné distribuce:
| Předpona distribuce | Description |
|---|---|
AKSAzureLinux-gen1 |
Azure Linux V2, generace 1 |
AKSAzureLinux-gen2 |
Azure Linux V2, generace 2 |
AKSAzureLinux-gen1fips |
Azure Linux V2, Gen 1, s podporou FIPS |
AKSAzureLinux-gen2fips |
Azure Linux V2, Gen2, s podporou FIPS |
AKSAzureLinux-gen2kata |
Azure Linux V2, Gen2, Kata containers |
AKSAzureLinux-gen2tl |
Azure Linux V2, Gen2, TL varianta |
AKSAzureLinuxV3-gen1 |
Azure Linux V3, generace 1 |
AKSAzureLinuxV3-gen2 |
Azure Linux V3, generace 2 |
AKSAzureLinuxV3-gen1fips |
Azure Linux V3, Gen 1, s podporou FIPS |
AKSAzureLinuxV3-gen2fips |
Azure Linux V3, Gen2, s podporou FIPS |
AKSAzureLinuxV3-gen2tl |
Azure Linux V3, Gen2, TL varianta |
AKSCBLMarinerV2-gen1 |
CBL-Mariner V2, generace 1 |
AKSCBLMarinerV2-gen2 |
CBL-Mariner V2, Generace 2 |
AKSCBLMarinerV2-gen1fips |
CBL-Mariner V2, Gen1, s podporou FIPS |
AKSCBLMarinerV2-gen2fips |
CBL-Mariner V2, Gen2, s podporou FIPS |
AKSCBLMarinerV2-gen2kata |
CBL-Mariner V2, Gen2, Kata containers |
AKSCBLMarinerV2-gen2tl |
CBL-Mariner V2, Gen2, TL varianta |
AKSUbuntu-gen1-2004fipscontainerd |
Ubuntu 20.04, Gen 1, FIPS |
AKSUbuntu-gen1-2204containerd |
Ubuntu 22.04, generace 1 |
AKSUbuntu-gen1-2404containerd |
Ubuntu 24.04, generace 1 |
AKSUbuntu-gen2-2004cvmcontainerd |
Ubuntu 20.04, Gen 2, důvěrný virtuální počítač |
AKSUbuntu-gen2-2004fipscontainerd |
Ubuntu 20.04, Gen 2, FIPS |
AKSUbuntu-gen2-2204containerd |
Ubuntu 22.04, generace 2 |
AKSUbuntu-gen2-2404containerd |
Ubuntu 24.04, generace 2 |
AKSUbuntu-gen2-2204tlcontainerd |
Ubuntu 22.04, Gen 2, TL varianta |
AKSUbuntu-gen2-2404tlcontainerd |
Ubuntu 24.04, Gen 2, TL varianta |
Získejte zprávu CVE pro vydání VHD
Následující koncový bod vrátí sestavu CVE pro konkrétní verzi virtuálního pevného disku, včetně balíčků operačního systému i i imagí kontejnerů, které jsou součástí této verze:
GET /api/v1/vhd-releases/{distro}/{version}/scan-reports
Parametry cesty:
| Parametr | Typ | Description | Příklad |
|---|---|---|---|
distro |
řetězec | Identifikátor distribuce Linuxu | AKSUbuntu-gen2-2204containerd |
version |
řetězec | Verze vydání VHD | 202601.13.0 |
Příklad požadavku:
curl -s https://cve-api.prod-aks.azure.com/api/v1/vhd-releases/AKSUbuntu-gen2-2204containerd/202601.13.0/scan-reports
Příklad odpovědi (zkráceně):
{
"distro_name": "AKSUbuntu/gen2/2204containerd",
"vhd_release_version": "202601.13.0",
"previous_vhd_release_version": "202512.06.0",
"os_package_targets": [
{
"name": "libtasn1-6",
"version": "4.18.0-4ubuntu0.2",
"active_cves": [],
"previous_version": "4.18.0-4ubuntu0.1",
"mitigated_cves_from_previous_release": [
{"id": "CVE-2021-46848"},
{"id": "CVE-2025-13151"}
]
},
{
"name": "python3.10",
"version": "3.10.12-1~22.04.13",
"active_cves": [],
"previous_version": "3.10.12-1~22.04.12",
"mitigated_cves_from_previous_release": [
{"id": "CVE-2025-13836"}
]
}
],
"container_targets": [
{
"container_image": "mcr.microsoft.com/azuremonitor/containerinsights/ciprod/prometheus-collector/images",
"active_container_images": {
"image_repo_tags": [
"mcr.microsoft.com/azuremonitor/containerinsights/ciprod/prometheus-collector/images:6.24.1-main-11-14-2025-15146744-cfg"
],
"image_repo_digests": [
"mcr.microsoft.com/azuremonitor/containerinsights/ciprod/prometheus-collector/images:6.24.1-main-11-14-2025-15146744-cfg@sha256:6ce08d12..."
]
},
"active_cves": [],
"removed_container_images_from_previous_release": {
"image_repo_tags": [
"mcr.microsoft.com/azuremonitor/containerinsights/ciprod/prometheus-collector/images:6.24.0-main-10-20-2025-fe8f6d51-targetallocator"
],
"image_repo_digests": [
"mcr.microsoft.com/azuremonitor/containerinsights/ciprod/prometheus-collector/images:6.24.0-main-10-20-2025-fe8f6d51-targetallocator@sha256:314e20ca..."
]
},
"mitigated_cves_from_previous_release": [
{"id": "CVE-2025-47914"},
{"id": "CVE-2025-4802"},
{"id": "CVE-2025-58181"},
{"id": "CVE-2025-61727"},
{"id": "CVE-2025-61729"}
]
}
],
"report_time": "2026-01-27T16:21:23.056129543Z"
}
Pole odpovědi:
| Pole | Typ | Description |
|---|---|---|
distro_name |
řetězec | Linux distribution name (například "AKSAzureLinux/gen2") |
vhd_release_version |
řetězec | Aktuální verze vydání VHD |
previous_vhd_release_version |
řetězec | Předchozí vydaná verze VHD |
os_package_targets |
AKSVHDOSPackageTarget[] | Balíčky operačního systému v tomto VHD |
container_targets |
AKSVHDContainerTarget[] | Bitové kopie kontejnerů obsažené v tomto VHD |
report_time |
string (ISO 8601) | Časové razítko vygenerování reportu |
Obrázky kontejnerů
Koncové body pro image kontejnerů poskytují pro jednotlivé image zprávy o skenování CVE a sledování nápravných opatření napříč vydáními. Tyto koncové body nemají _index výpis. Přejdete na celou cestu k obrázku.
Získat sestavu kontroly ohrožení zabezpečení CVE image kontejneru
Následující endpoint načte zprávu o kontrole CVE pro konkrétní bitovou kopii kontejneru identifikovanou pomocí úplné cesty k bitové kopii a její značky:
GET /api/v1/container-images/{image}:{tag}/scan-reports
Parametry cesty:
| Parametr | Typ | Description | Příklad |
|---|---|---|---|
image |
řetězec | Úplný název obrazu včetně registru | mcr.microsoft.com/oss/kubernetes/kube-proxy |
tag |
řetězec | Značka obrázku | v1.31.11 |
Příklad požadavku:
curl -s https://cve-api.prod-aks.azure.com/api/v1/container-images/mcr.microsoft.com/oss/kubernetes/kube-proxy:v1.31.11/scan-reports
Příklad odpovědi (zkráceně):
{
"image_repo_tags": [
"mcr.microsoft.com/oss/kubernetes/kube-proxy:v1.31.11"
],
"image_repo_digests": [
"mcr.microsoft.com/oss/kubernetes/kube-proxy:v1.31.11@sha256:abc123..."
],
"report_time": "2026-02-20T16:12:42.081442479Z",
"active_cves": [
{
"scanner": {
"name": "trivy",
"version": "0.69.1"
},
"cves": [
{"id": "CVE-2024-13176"},
{"id": "CVE-2025-47914"}
]
}
]
}
Pole odpovědi:
| Pole | Typ | Description |
|---|---|---|
image_repo_tags |
string[] | Značky obrázků pro naskenovaný obrázek |
image_repo_digests |
string[] | Přehledy obrázků pro všechny podporované platformy |
report_time |
string (ISO 8601) | Časové razítko vygenerování reportu |
active_cves |
CVEList[] | Aktivní CVE seskupené podle skeneru |
Získat zprávu o opatřeních ke zmírnění CVE pro image kontejneru
Následující endpoint načte sestavu o mitigaci CVE pro konkrétní repozitář imagí kontejnerů a ukáže, které CVE byly zaznamenány v kterých verzích komponent a vydáních a ve kterých verzích a vydáních byly mitigovány:
GET /api/v1/container-images/{image}/mitigation-reports
Parametry cesty:
| Parametr | Typ | Description | Příklad |
|---|---|---|---|
image |
řetězec | Úplný název obrazu včetně registru (bez tagu) | mcr.microsoft.com/oss/kubernetes/kube-proxy |
Příklad požadavku:
curl -s https://cve-api.prod-aks.azure.com/api/v1/container-images/mcr.microsoft.com/oss/kubernetes/kube-proxy/mitigation-reports
Příklad odpovědi (zkráceně):
{
"container_image": "mcr.microsoft.com/oss/kubernetes/kube-proxy",
"mitigations": [
{
"cve": {"id": "CVE-2023-2253"},
"seen_in_component_versions": ["v1.27.102-akslts"],
"seen_in_aks_release_versions": [],
"seen_in_aks_k8s_release_versions": [],
"seen_in_vhd_release_versions": ["AKSAzureLinux-gen1/202507.02.0"],
"mitigated_in_component_versions": [],
"mitigated_in_aks_release_versions": [],
"mitigated_in_aks_k8s_release_versions": [],
"mitigated_in_vhd_release_versions": []
}
]
}
Pole odpovědi:
| Pole | Typ | Description |
|---|---|---|
container_image |
řetězec | Název image bez tagu |
mitigations |
CVEMitigation[] | Položky pro zmírnění rizika CVE pro tento obrázek |
Balíčky operačního systému VHD
Koncové body balíčků operačního systému ve VHD poskytují pro jednotlivé balíčky OS nainstalované v bitových kopiích uzlů VHD zprávy o skenování CVE pro každý balíček a sledování mitigací napříč vydáními. Tyto endpointy nemají vlastní seznam _index; navigujete podle názvu balíčku.
Získejte zprávu z kontroly CVE pro balíček VHD OS
Následující koncový bod načte sestavu kontroly CVE pro konkrétní verzi balíčku operačního systému nainstalovanou v imagích uzlů virtuálního pevného disku:
GET /api/v1/vhd-packages/{name}/{version}/scan-reports
Parametry cesty:
| Parametr | Typ | Description | Příklad |
|---|---|---|---|
name |
řetězec | Název balíčku operačního systému (malá písmena) | openssl |
version |
řetězec | Verze balíčku | 3.0.2-0ubuntu1.20 |
Příklad požadavku:
curl -s https://cve-api.prod-aks.azure.com/api/v1/vhd-packages/openssl/3.0.2-0ubuntu1.20/scan-reports
Příklad odpovědi:
{
"name": "openssl",
"version": "3.0.2-0ubuntu1.20",
"active_cves": [
{"id": "CVE-2025-15467"},
{"id": "CVE-2025-68160"}
],
"report_time": "2026-02-20T16:14:09.253455099Z"
}
Pole odpovědi:
| Pole | Typ | Description |
|---|---|---|
name |
řetězec | Název balíčku |
version |
řetězec | Verze balíčku |
active_cves |
CVE[] | Aktivní CVEs s dostupnými opravami |
report_time |
string (ISO 8601) | Časové razítko vygenerování reportu |
Získejte zprávu o zmírnění rizik CVE pro balíček VHD OS
Následující koncový bod rozhraní API načte zprávu o zmírnění zranitelností CVE pro konkrétní balíček operačního systému a ukáže, ve kterých verzích balíčků a vydáních VHD byly jednotlivé CVE zaznamenány a ve kterých verzích byly zmírněny:
GET /api/v1/vhd-packages/{name}/mitigation-reports
Parametry cesty:
| Parametr | Typ | Description | Příklad |
|---|---|---|---|
name |
řetězec | Název balíčku operačního systému (malá písmena) | openssl |
Příklad požadavku:
curl -s https://cve-api.prod-aks.azure.com/api/v1/vhd-packages/openssl/mitigation-reports
Příklad odpovědi (zkráceně):
{
"package_name": "openssl",
"mitigations": [
{
"cve": {"id": "CVE-2025-15467"},
"seen_in_component_versions": ["3.3.3-2.azl3", "3.3.3-3.azl3"],
"seen_in_aks_release_versions": [],
"seen_in_aks_k8s_release_versions": [],
"seen_in_vhd_release_versions": ["AKSAzureLinuxV3-gen1/202507.02.0"],
"mitigated_in_component_versions": [],
"mitigated_in_aks_release_versions": [],
"mitigated_in_aks_k8s_release_versions": [],
"mitigated_in_vhd_release_versions": []
}
]
}
Pole odpovědi:
| Pole | Typ | Description |
|---|---|---|
package_name |
řetězec | Název balíčku operačního systému |
mitigations |
CVEMitigation[] | Položky pro zmírnění rizik CVE pro tento balíček |
Datové modely
Následující části popisují datové modely vrácené rozhraním API pro data ohrožení zabezpečení AKS, včetně struktury položek CVE, odkazů na image kontejneru, součástí verze AKS, balíčků operačního systému VHD a vztahů mezi nimi.
CVE
Datový model CVE je identifikátor Common Vulnerabilities and Exposures.
| Pole | Typ | Description |
|---|---|---|
id |
řetězec | IDENTIFIKÁTOR CVE (například "CVE-2024-13176", "GHSA-2464-8j7c-4cjm") |
ContainerImages
Datový model ContainerImages představuje sadu odkazů na image kontejnerů, včetně tagů čitelných pro člověka i digestů adresovatelných podle obsahu.
| Pole | Typ | Description |
|---|---|---|
image_repo_tags |
string[] | Značky obrázků (například "mcr.microsoft.com/oss/kubernetes/coredns:v1.9.4-9") |
image_repo_digests |
string[] | Přehledy obrazu pro všechny podporované platformy (například "mcr.microsoft.com/oss/kubernetes/coredns:v1.9.4-9@sha256:abc...") |
Note
Algoritmy Digest zahrnují všechny varianty platformy Linux (amd64, arm64) z manifestů s více archy. To umožňuje spárování dat CVE bez ohledu na to, který digest specifický pro danou platformu váš uzel stáhl.
AKSReleaseContainerTarget
Datový model AKSReleaseContainerTarget představuje kontejnerovou komponentu v rámci konkrétního vydání AKS, která je určena oborem názvů podu a názvem kontejneru, ve kterém běží, spolu s bitovými kopiemi kontejneru, které používá, a identifikátory CVE, které ji ovlivňují.
| Pole | Typ | Description |
|---|---|---|
pod_namespace |
řetězec | Obor názvů Kubernetes (například "kube-system", "calico-system") |
container_name |
řetězec | Název kontejneru (například "coredns", "calico-node") |
active_container_images |
ContainerImages | Image kontejneru aktuálně spuštěné pro tuto komponentu |
active_cves |
CVE[] | CvEs s dostupnými opravami, které aktuálně ovlivňují tuto komponentu |
removed_container_images_from_previous_release |
ContainerImages | Image, které byly přítomné v předchozí verzi, ale už nejsou spuštěné |
mitigated_cves_from_previous_release |
CVE[] | CVE, které existovaly v předchozím vydání, ale byly opraveny v tomto vydání. |
AKSK8SContainerTarget
Datový model AKSK8SContainerTarget představuje image kontejneru přidruženou ke konkrétní verzi Kubernetes, včetně označených odkazů na image a hodnot hash pro danou image a identifikátorů CVE, které ji ovlivňují.
| Pole | Typ | Description |
|---|---|---|
container_image |
řetězec | Název obrázku bez značky (například "mcr.microsoft.com/oss/kubernetes/kube-apiserver") |
active_container_images |
ContainerImages | Označené odkazy na obrázky a přehledy |
active_cves |
CVE[] | Aktivní CVEs s dostupnými opravami |
AKSVHDContainerTarget
Datový model AKSVHDContainerTarget představuje bitovou kopii kontejneru, která je zahrnuta v bitové kopii uzlu VHD, spolu s odkazy na bitové kopie se značkami, kontrolními součty a identifikátory CVE, které ji ovlivňují.
| Pole | Typ | Description |
|---|---|---|
container_image |
řetězec | Název image bez tagu |
active_container_images |
ContainerImages | Označené odkazy na obrázky a přehledy |
active_cves |
CVE[] | Aktivní CVEs s dostupnými opravami |
removed_container_images_from_previous_release |
ContainerImages | Image odstraněné od předchozí verze VHD |
mitigated_cves_from_previous_release |
CVE[] | CVE opravené od předchozího vydání VHD |
AKSVHDOSPackageTarget
Datový model AKSVHDOSPackageTarget představuje balíček na úrovni operačního systému nainstalovaný v bitové kopii uzlu VHD spolu s nainstalovanou verzí, CVE, které se ho týkají, a veškerými změnami oproti předchozímu vydání VHD.
| Pole | Typ | Description |
|---|---|---|
name |
řetězec | Název balíčku (například "kernel", "containerd", "systemd") |
version |
řetězec | Verze balíčku (například "6.1.109.2-1.cm2") |
active_cves |
CVE[] | Aktivní CVEs s dostupnými opravami |
previous_version |
řetězec | Verze z předchozího vydání VHD (prázdná, pokud beze změny) |
mitigated_cves_from_previous_release |
CVE[] | CVE opravené od předchozího vydání VHD |
CVEScanner
Datový model CVEScanner představuje metadata skeneru zranitelností, který vytváří výsledky skenování CVE pro obrazy kontejnerů.
| Pole | Typ | Description |
|---|---|---|
name |
řetězec | Název skeneru (například "trivy") |
version |
řetězec | Verze skeneru (například "0.69.1") |
CVEList
Datový model CVEList představuje sadu CVE zjištěných konkrétní kontrolou ohrožení zabezpečení pro danou image kontejneru. Každá položka přiřazuje metadata skeneru k seznamu CVE, které skener zjistil.
| Pole | Typ | Description |
|---|---|---|
scanner |
CVEScanner | Skener, který tyto výsledky vytvořil |
cves |
CVE[] | CVE zjištěná tímto skenerem |
CVEMitigation
Datový model CVEMitigation sleduje jednu chybu CVE napříč verzemi komponent a typy verzí, která ukazuje, kde byla zjištěna a kde byla zmírněná.
| Pole | Typ | Description |
|---|---|---|
cve |
CVE | Sledované CVE |
seen_in_component_versions |
string[] | Verze komponent (tagy imagí nebo verze balíčků), ve kterých bylo toto CVE zjištěno |
seen_in_aks_release_versions |
string[] | Verze AKS, ve kterých byla zjištěna tato CVE |
seen_in_aks_k8s_release_versions |
string[] | Verze Kubernetes, ve kterých byla zjištěna tato CVE |
seen_in_vhd_release_versions |
string[] | Verze VHD, ve kterých byla zjištěna tato CVE |
mitigated_in_component_versions |
string[] | Verze součástí, ve kterých byla opravena tato CVE |
mitigated_in_aks_release_versions |
string[] | Verze AKS, ve kterých byla tato CVE opravena |
mitigated_in_aks_k8s_release_versions |
string[] | Verze Kubernetes, ve kterých byla opravena tato CVE |
mitigated_in_vhd_release_versions |
string[] | Verze VHD, ve kterých byla tato CVE opravena |
Rozdílové sledování
Zprávy o vydání AKS a VHD zahrnují delta pole, která porovnávají aktuální vydání s předchozím:
-
mitigated_cves_from_previous_release: CVE, které byly přítomny v předchozí verzi, ale již nebyly zjištěny. To znamená, že zranitelnost byla opravena (například zvýšením verze komponenty). -
removed_container_images_from_previous_release: Obrazy kontejnerů, které byly spuštěny v předchozí verzi, ale v aktuální verzi chybí.
Note
Hlášení o verzích Kubernetes neobsahují pole delta.
Přehledy více architektur
Každá image kontejneru může obsahovat několik odkazů na přehled, které pokrývají různé architektury procesoru (amd64, arm64). Rozhraní API zahrnuje všechny otisky platforem Linux z manifestů pro více architektur, takže můžete porovnat data CVE bez ohledu na to, který konkrétní otisk platformy si váš uzel stáhl.
Formáty verzí sestavy
Sestavy rozhraní API pro data ohrožení zabezpečení AKS používají různá schémata správy verzí v závislosti na typu ohlášené verze. Následující tabulka shrnuje formáty používané pro verze AKS, verze Kubernetes a verze VHD:
| Typ vydání | Formát | Příklad |
|---|---|---|
| Verze AKS | v{YYYYMMDD} |
v20260104 |
| Verze Kubernetes | Semver | 1.33.2 |
| Vydání VHD | {distro}/{YYYYMM.DD.patch} |
AKSAzureLinux-gen2/202512.06.0 |
Související obsah
Další informace o rozhraní Vulnerability Data API pro data o ohroženích zabezpečení v AKS najdete v článku Přehled rozhraní Vulnerability Data API pro Azure Kubernetes Service (AKS).