Az Azure Kubernetes Service (AKS) biztonsági rési adataihoz készült API használata

Az AKS Sebezhetőségi adatok APIprogramozott, írásvédett betekintést biztosít az AKS által felügyelt platformösszetevőkben észlelt biztonsági résekbe. Ez az API biztonsági csapatoknak, megfelelőségi csapatoknak és platformtulajdonosoknak készült, akiknek mérvadó információkra van szükségük az AKS által felügyelt összetevőket érintő biztonsági résekről, függetlenül a fürt futásidejének adott állapotától.

Ebből a cikkből megtudhatja, hogyan használhatja az AKS biztonságirés-adat API-t az AKS által felügyelt összetevők CVE-jelentéseinek programozott lekérésére, beleértve az AKS-kiadásokat, a Kubernetes-verziókat, a csomópontrendszerképeket, a tárolólemezképeket és az operációsrendszer-csomagokat. Példákat kínál az API-kérelmekre, és bemutatja, hogyan értelmezheti a válaszokat a nagy méretű CVE-elemzések, automatizálás és a biztonsági szkenner eredményeivel való korreláció támogatására. Az API mögötti fogalmak áttekintéséért tekintse meg a Vulnerability Data API Azure Kubernetes Service (AKS) áttekintését.

CVE-jelentések lekérdezése

Az alábbi példák bemutatják, hogyan kérdezhető le az AKS biztonságirés-adat API az AKS-kiadásokról, a Kubernetes-verziókról, a csomópontlemezképekről, a tárolólemezképekről és az operációsrendszer-csomagokról készült CVE-jelentések lekéréséhez.

AKS-verzióhoz tartozó CVE-k lekérdezése

# 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 '.'

CvEs lekérdezése Kubernetes-verzióhoz

# 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 '.'

Egy csomópont lemezképének (VHD) CVE-inek lekérdezése

# 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 '.'

CvEs lekérdezése egy adott tárolórendszerképhez

# 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 '.'

Adott operációsrendszer-csomag cves-einek lekérdezése

# 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 '.'

Végpontok

Az AKS Biztonságirés-adat API végpontokat tesz elérhetővé az AKS-kiadásokhoz, a Kubernetes-verziókhoz, a csomópontlemezképekhez, a tárolólemezképekhez és az operációsrendszer-csomagokhoz készült CVE-jelentések lekéréséhez. Minden végpont hozzáférést biztosít az elérhető verziók indexéhez, vagy egy adott verzió vagy összetevő részletes vizsgálati jelentéséhez. A következő szakaszok ismertetik az egyes végpontokat, az elérhető műveleteket, valamint a várt kérés- és válaszformátumokat.

AKS-kiadások

Az AKS kiadási indexének lekérése

Az alábbi végpont az összes elérhető CVE-jelentéssel rendelkező AKS-kiadási verzió indexét adja vissza:

GET /api/v1/aks-releases/_index

Példakérés:

curl -s https://cve-api.prod-aks.azure.com/api/v1/aks-releases/_index

Példa válasz:

{
  "aks_release_versions": [
    "v20250427",
    "v20250519",
    "v20250617",
    "v20250720",
    "v20250808",
    "v20250829",
    "v20250921",
    "v20251012",
    "v20260104"
  ],
  "report_time": "2026-01-27T16:19:36.181877605Z"
}

Válaszmezők:

Field	Típus	Description
`aks_release_versions`	string[]	Elérhető AKS kiadási verziók, időrendben rendezve
`report_time`	karakterlánc (ISO 8601)	Az index legutóbbi létrehozásakor

Az AKS-kiadáshoz tartozó CVE-jelentés lekérése

A következő végpont egy adott AKS-kiadási verzióhoz tartozó részletes CVE-jelentést ad vissza, beleértve a rendszernévterekben található összes konténerképet, azok aktív CVE-it, valamint a CVE-k előző kiadáshoz viszonyított eltérését:

GET /api/v1/aks-releases/{version}/scan-reports

Elérési út paraméterei:

Paraméter	Típus	Description	Example
`version`	karakterlánc	Az AKS kiadási verziója az indexből	`v20260104`

Példakérés:

curl -s https://cve-api.prod-aks.azure.com/api/v1/aks-releases/v20260104/scan-reports

Példa válasz (rövidített):

{
  "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"
}

Válaszmezők:

Field	Típus	Description
`aks_release_version`	karakterlánc	Az AKS jelenlegi kiadási verziója
`previous_aks_release_version`	karakterlánc	Korábbi kiadási verzió (deltaszámításokhoz használatos)
`container_targets`	AKSReleaseContainerTarget[]	A jelen kiadás összes tárolóösszetevője
`report_time`	karakterlánc (ISO 8601)	Jelentéskészítési időbélyeg

Kubernetes-verziók kiadásai

Kubernetes-verziók indexének lekérése

Az alábbi végpont az elérhető CVE-jelentésekkel rendelkező kubernetes-verziók indexét adja vissza:

GET /api/v1/aks-k8s-releases/_index

Példakérés:

curl -s https://cve-api.prod-aks.azure.com/api/v1/aks-k8s-releases/_index

Példa válasz:

{
  "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"
}

Válaszmezők:

Field	Típus	Description
`k8s_versions`	string[]	Elérhető Kubernetes-verziók, szemver szerint rendezve
`report_time`	karakterlánc (ISO 8601)	Az index legutóbbi létrehozásakor

A Kubernetes CVE-verzió jelentésének lekérése

A következő végpont egy adott Kubernetes-verzió CVE-jelentését adja vissza, amely részletesen ismerteti az adott verzió alapvető Kubernetes-összetevői és AKS-bővítményei által használt tárolórendszerképek biztonsági réseit:

GET /api/v1/aks-k8s-releases/{version}/scan-reports

Elérési út paraméterei:

Paraméter	Típus	Description	Example
`version`	karakterlánc	Kubernetes-verzió az indexből	`1.33.2`

Példakérés:

curl -s https://cve-api.prod-aks.azure.com/api/v1/aks-k8s-releases/1.33.2/scan-reports

Példa válasz (rövidített):

{
  "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"
}

Válaszmezők:

Field	Típus	Description
`k8s_version`	karakterlánc	Kubernetes-verzió (például `"1.33.2"`)
`container_targets`	AKSK8SContainerTarget[]	Tárolólemezképek ehhez a Kubernetess-verzióhoz
`report_time`	karakterlánc (ISO 8601)	Jelentéskészítési időbélyeg

VHD -kiadások (csomópontkép)

VHD-kiadások indexének lekérése

A következő végpont az összes elérhető CVE-jelentéssel rendelkező VHD-kiadás indexét adja vissza:

GET /api/v1/vhd-releases/_index

Példakérés:

curl -s https://cve-api.prod-aks.azure.com/api/v1/vhd-releases/_index

Példa válasz (rövidített):

{
  "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"
}

Válaszmezők:

Field	Típus	Description
`vhd_release_versions`	string[]	Elérhető VHD-kiadások `{distro}/{version}` formátumban
`report_time`	karakterlánc (ISO 8601)	Az index legutóbbi létrehozásakor

Elérhető disztribúciók:

Disztribúcióelőtag	Description
`AKSAzureLinux-gen1`	Azure Linux V2, 1. generációs
`AKSAzureLinux-gen2`	Azure 2. generációs Linux V2
`AKSAzureLinux-gen1fips`	Azure Linux V2, Gen 1, FIPS-kompatibilis
`AKSAzureLinux-gen2fips`	Azure Linux V2, Gen 2, FIPS-kompatibilis
`AKSAzureLinux-gen2kata`	Azure Linux V2, Gen 2, Kata-konténerek
`AKSAzureLinux-gen2tl`	Azure Linux V2, Gen 2, TL variáns
`AKSAzureLinuxV3-gen1`	Azure Linux V3, 1. generációs
`AKSAzureLinuxV3-gen2`	Azure 2. generációs Linux V3
`AKSAzureLinuxV3-gen1fips`	Azure Linux V3, Gen 1, FIPS-kompatibilis
`AKSAzureLinuxV3-gen2fips`	Azure Linux V3, Gen 2, FIPS-kompatibilis
`AKSAzureLinuxV3-gen2tl`	Azure Linux V3, Gen 2, TL variáns
`AKSCBLMarinerV2-gen1`	CBL-Mariner V2, 1. generációs
`AKSCBLMarinerV2-gen2`	CBL-Mariner 2. generációs V2
`AKSCBLMarinerV2-gen1fips`	CBL-Mariner V2, Gen 1, FIPS-kompatibilis
`AKSCBLMarinerV2-gen2fips`	CBL-Mariner V2, Gen 2, FIPS-kompatibilis
`AKSCBLMarinerV2-gen2kata`	CBL-Mariner V2, Gen 2, Kata-konténerek
`AKSCBLMarinerV2-gen2tl`	CBL-Mariner V2, Gen 2, TL változat
`AKSUbuntu-gen1-2004fipscontainerd`	Ubuntu 20.04, Gen 1, FIPS
`AKSUbuntu-gen1-2204containerd`	Ubuntu 22.04, 1. generáció
`AKSUbuntu-gen1-2404containerd`	Ubuntu 24.04, 1. generáció
`AKSUbuntu-gen2-2004cvmcontainerd`	Ubuntu 20.04, Gen 2, Bizalmas virtuális gép
`AKSUbuntu-gen2-2004fipscontainerd`	Ubuntu 20.04, Gen 2, FIPS
`AKSUbuntu-gen2-2204containerd`	Ubuntu 22.04, 2. generáció
`AKSUbuntu-gen2-2404containerd`	Ubuntu 24.04, 2. generáció
`AKSUbuntu-gen2-2204tlcontainerd`	Ubuntu 22.04, Gen 2, TL változat
`AKSUbuntu-gen2-2404tlcontainerd`	Ubuntu 24.04, Gen 2, TL változat

A VHD-kiadáshoz tartozó CVE-jelentés lekérése

A következő végpont egy adott VHD-kiadás CVE-jelentését adja vissza, beleértve a kiadásban szereplő operációsrendszer-csomagokat és tárolólemezképeket is:

GET /api/v1/vhd-releases/{distro}/{version}/scan-reports

Elérési út paraméterei:

Paraméter	Típus	Description	Example
`distro`	karakterlánc	Linux-disztribúció azonosítója	`AKSUbuntu-gen2-2204containerd`
`version`	karakterlánc	A VHD kiadási verziója	`202601.13.0`

Példakérés:

curl -s https://cve-api.prod-aks.azure.com/api/v1/vhd-releases/AKSUbuntu-gen2-2204containerd/202601.13.0/scan-reports

Példa válasz (rövidített):

{
  "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"
}

Válaszmezők:

Field	Típus	Description
`distro_name`	karakterlánc	Linux-disztribúció neve (például `"AKSAzureLinux/gen2"`)
`vhd_release_version`	karakterlánc	A VHD jelenlegi kiadási verziója
`previous_vhd_release_version`	karakterlánc	Korábbi VHD-kiadási verzió
`os_package_targets`	AKSVHDOSPackageTarget[]	Operációsrendszer-csomagok ebben a VHD-ben
`container_targets`	AKSVHDContainerTarget[]	Ebben a VHD-ben csomagolt tárolólemezképek
`report_time`	karakterlánc (ISO 8601)	Jelentéskészítési időbélyeg

Konténerképek

A tárolólemezképek végpontjai képenkénti CVE-vizsgálati jelentéseket és kiadásonkénti kockázatcsökkentési nyomkövetést biztosítanak az egyes tárolólemezképekhez. Ezek a végpontok nem rendelkeznek listajelekkel _index ; a teljes képútvonalon navigálhat.

Tárolórendszerkép CVE-vizsgálati jelentésének lekérése

A következő végpont lekéri egy, a teljes képelérési útja és címkéje alapján azonosított konkrét konténerkép CVE-vizsgálati jelentését:

GET /api/v1/container-images/{image}:{tag}/scan-reports

Elérési út paraméterei:

Paraméter	Típus	Description	Example
`image`	karakterlánc	Teljes képnév a regiszterrel együtt	`mcr.microsoft.com/oss/kubernetes/kube-proxy`
`tag`	karakterlánc	Képcímke	`v1.31.11`

Példakérés:

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élda válasz (rövidített):

{
  "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"}
      ]
    }
  ]
}

Válaszmezők:

Field	Típus	Description
`image_repo_tags`	string[]	Képcímkék a beolvasott képhez
`image_repo_digests`	string[]	Képkivonatok az összes támogatott platformhoz
`report_time`	karakterlánc (ISO 8601)	Jelentéskészítési időbélyeg
`active_cves`	CVEList[]	Aktív CVE-k képolvasó szerint csoportosítva

Tárolólemezkép CVE-kockázatcsökkentési jelentésének lekérése

Az alábbi végpont egy CVE-kockázatcsökkentési jelentést kér le egy adott tárolórendszerkép-adattárhoz, és megjeleníti, hogy mely CVE-k voltak láthatók az összetevők verzióiban és kiadásaiban, valamint hogy mely verziókban és kiadásokban voltak enyhítve:

GET /api/v1/container-images/{image}/mitigation-reports

Elérési út paraméterei:

Paraméter	Típus	Description	Example
`image`	karakterlánc	Teljes képnév, beleértve a beállításjegyzéket (címke nélkül)	`mcr.microsoft.com/oss/kubernetes/kube-proxy`

Példakérés:

curl -s https://cve-api.prod-aks.azure.com/api/v1/container-images/mcr.microsoft.com/oss/kubernetes/kube-proxy/mitigation-reports

Példa válasz (rövidített):

{
  "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": []
    }
  ]
}

Válaszmezők:

Field	Típus	Description
`container_image`	karakterlánc	Kép neve címke nélkül
`mitigations`	CVEMitigation[]	A kép CVE-kockázatcsökkentési bejegyzései

VHD operációsrendszer-csomagok

A VHD operációsrendszer-csomagvégpontok csomagonkénti CVE vizsgálati jelentéseket és kiadásközi kockázatcsökkentési nyomkövetést biztosítanak a VHD-csomópontlemezképekben telepített egyes operációsrendszer-csomagokhoz. Ezek a végpontok nem rendelkeznek listaelemekkel _index , a csomag neve alapján navigálhat.

VHD operációs rendszer csomag CVE vizsgálati jelentésének lekérése

A következő végpont lekéri a VHD-csomópont lemezképeiben telepített operációsrendszer-csomag egy adott verziójára vonatkozó CVE-vizsgálati jelentést:

GET /api/v1/vhd-packages/{name}/{version}/scan-reports

Elérési út paraméterei:

Paraméter	Típus	Description	Example
`name`	karakterlánc	Operációsrendszer-csomag neve (kisbetű)	`openssl`
`version`	karakterlánc	Csomag verziója	`3.0.2-0ubuntu1.20`

Példakérés:

curl -s https://cve-api.prod-aks.azure.com/api/v1/vhd-packages/openssl/3.0.2-0ubuntu1.20/scan-reports

Példa válasz:

{
  "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"
}

Válaszmezők:

Field	Típus	Description
`name`	karakterlánc	A csomag neve
`version`	karakterlánc	Csomag verziója
`active_cves`	CVE[]	Aktív CVE-k elérhető javításokkal
`report_time`	karakterlánc (ISO 8601)	Jelentéskészítési időbélyeg

VHD operációs rendszer csomag CVE-kockázatcsökkentési jelentésének lekérése

A következő végpont lekéri egy CVE-kockázatcsökkentési jelentést egy adott operációsrendszer-csomagról, és megjeleníti, hogy mely CVE-k voltak láthatók a csomagverziókban és a VHD-kiadásokban, és mely verziókban enyhítették őket:

GET /api/v1/vhd-packages/{name}/mitigation-reports

Elérési út paraméterei:

Paraméter	Típus	Description	Example
`name`	karakterlánc	Operációsrendszer-csomag neve (kisbetű)	`openssl`

Példakérés:

curl -s https://cve-api.prod-aks.azure.com/api/v1/vhd-packages/openssl/mitigation-reports

Példa válasz (rövidített):

{
  "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": []
    }
  ]
}

Válaszmezők:

Field	Típus	Description
`package_name`	karakterlánc	Operációsrendszer-csomag neve
`mitigations`	CVEMitigation[]	A csomag CVE-kockázatcsökkentési bejegyzései

Adatmodellek

A következő szakaszok az AKS Biztonságirés-adat API által visszaadott adatmodelleket ismertetik, beleértve a CVE-bejegyzések struktúráját, a tárolórendszerkép-hivatkozásokat, az AKS kiadási összetevőit, a VHD OPERÁCIÓS-csomagokat és a köztük lévő kapcsolatokat.

CVE

A CVE adatmodell egy gyakori biztonsági rések és expozíciós azonosító.

Field	Típus	Description
`id`	karakterlánc	CVE-azonosító (például `"CVE-2024-13176"`, `"GHSA-2464-8j7c-4cjm"`)

ContainerImages

A ContainerImages adatmodell tárolórendszerkép-hivatkozások készletét jelöli, beleértve az ember által olvasható címkéket és a tartalomcímkéket is.

Field	Típus	Description
`image_repo_tags`	string[]	Képcímkék (például `"mcr.microsoft.com/oss/kubernetes/coredns:v1.9.4-9"`)
`image_repo_digests`	string[]	Image-digesztek minden támogatott platformhoz (például `"mcr.microsoft.com/oss/kubernetes/coredns:v1.9.4-9@sha256:abc..."`)

Note

A kivonatok tartalmazzák a többíves jegyzékekből származó összes Linux-platformvariánst (amd64, arm64). Ez lehetővé teszi az egyező CVE-adatokat, függetlenül attól, hogy melyik platformspecifikus kivonatot húzta le a csomópont.

AKSReleaseContainerTarget

Az AKSReleaseContainerTarget adatmodell egy tárolóösszetevőt jelöl egy adott AKS-kiadásban, amelyet a podnévtér és a tároló neve azonosít, ahol fut, valamint az általa használt tárolórendszerképekkel és az azt befolyásoló CVE-kkel együtt.

Field	Típus	Description
`pod_namespace`	karakterlánc	Kubernetes-névtér (például `"kube-system"`, `"calico-system"`)
`container_name`	karakterlánc	Konténer neve (például `"coredns"`, `"calico-node"`)
`active_container_images`	ContainerImages	Az összetevőhöz jelenleg futó konténerképek
`active_cves`	CVE[]	Az összetevőt jelenleg érintő elérhető javításokkal rendelkező CVE-k
`removed_container_images_from_previous_release`	ContainerImages	Az előző kiadásban jelen lévő, de már nem futó képek
`mitigated_cves_from_previous_release`	CVE[]	Az előző kiadásban már létező, de ebben a kiadásban kijavított CVE-k

AKSK8SContainerTarget

Az AKSK8SContainerTarget adatmodell egy adott Kubernetes-verzióhoz társított tárolórendszerképet jelöl, beleértve a rendszerkép címkézett képhivatkozásait és kivonatait, valamint az azt befolyásoló CVE-ket.

Field	Típus	Description
`container_image`	karakterlánc	Kép neve címke nélkül (például `"mcr.microsoft.com/oss/kubernetes/kube-apiserver"`)
`active_container_images`	ContainerImages	Címkézett képhivatkozások és -kivonatok
`active_cves`	CVE[]	Aktív CVE-k elérhető javításokkal

AKSVHDContainerTarget

Az AKSVHDContainerTarget adatmodell egy VHD-csomópont lemezképében található tárolórendszerképet, valamint az azt befolyásoló címkézett képhivatkozásokat, kivonatokat és CVE-ket jelöli.

Field	Típus	Description
`container_image`	karakterlánc	Kép neve címke nélkül
`active_container_images`	ContainerImages	Címkézett képhivatkozások és -kivonatok
`active_cves`	CVE[]	Aktív CVE-k elérhető javításokkal
`removed_container_images_from_previous_release`	ContainerImages	Az előző VHD-kiadás óta eltávolított képek
`mitigated_cves_from_previous_release`	CVE[]	Az előző VHD-kiadás óta kijavított CVE-k

AKSVHDOSPackageTarget

Az AKSVHDOSPackageTarget adatmodell egy operációsrendszer-szintű csomagot jelöl, amely egy VHD-csomópont lemezképében van telepítve, valamint a telepített verziót, az azt érintő CVE-ket és az előző VHD-kiadás módosításait.

Field	Típus	Description
`name`	karakterlánc	Csomag neve (például `"kernel"`, `"containerd"`, `"systemd"`)
`version`	karakterlánc	Csomag verziója (például `"6.1.109.2-1.cm2"`)
`active_cves`	CVE[]	Aktív CVE-k elérhető javításokkal
`previous_version`	karakterlánc	Az előző VHD-kiadás verziója (üres, ha változatlan)
`mitigated_cves_from_previous_release`	CVE[]	Az előző VHD-kiadás óta kijavított CVE-k

CVEScanner

A CVEScanner adatmodell egy biztonságirés-ellenőrző metaadatait jelöli, amely CVE-vizsgálati eredményeket hoz létre a tárolólemezképekhez.

Field	Típus	Description
`name`	karakterlánc	Képolvasó neve (például `"trivy"`)
`version`	karakterlánc	Képolvasó verziója (például `"0.69.1"`)

CVEList

A CVEList adatmodell egy adott tárolórendszerkép biztonságirés-ellenőrzője által észlelt CVE-k készletét jelöli. Minden bejegyzés társítja a képolvasó metaadatait az észlelt CVE-k listájához.

Field	Típus	Description
`scanner`	CVEScanner	Az eredményeket előállító képolvasó
`cves`	CVE[]	A képolvasó által észlelt CVE-k

CVEMitigation

A CVEMitigation adatmodell egyetlen CVE-t követ nyomon az összetevőverziókon és a kiadástípusokon átívelően, megmutatva, hogy hol észlelték, és hol enyhítették.

Field	Típus	Description
`cve`	CVE	A nyomon követett CVE
`seen_in_component_versions`	string[]	Összetevő-verziók (képcímkék vagy csomagverziók), amelyekben ezt a CVE-t észlelték
`seen_in_aks_release_versions`	string[]	Az AKS kiadási verziói, ahol ezt a CVE-t észlelték
`seen_in_aks_k8s_release_versions`	string[]	Kubernetes kiadási verziók, ahol ezt a CVE-t észlelték
`seen_in_vhd_release_versions`	string[]	VHD kiadási verziók, ahol ezt a CVE-t észlelték
`mitigated_in_component_versions`	string[]	Összetevőverziók, ahol ezt a CVE-t kijavították
`mitigated_in_aks_release_versions`	string[]	Az AKS kiadási verziói, ahol ezt a CVE-t kijavították
`mitigated_in_aks_k8s_release_versions`	string[]	Kubernetes kiadási verziók, ahol ezt a CVE-t kijavították
`mitigated_in_vhd_release_versions`	string[]	VHD kiadási verziók, ahol ez a CVE ki lett javítva

Változáskövetés

Az AKS- és VHD-kiadási jelentések delta mezőket tartalmaznak, amelyek az aktuális kiadást az előzővel hasonlítják össze:

mitigated_cves_from_previous_release: Az előző kiadásban jelen lévő, de már nem észlelt CVE-k. Ez azt jelenti, hogy a sérülékenységet javították (például egy összetevő verziójának emelésével).
removed_container_images_from_previous_release: Az előző kiadásban futó, de az aktuális kiadásból hiányzó konténerképek.

Note

A Kubernetes verziójelentései nem tartalmaznak deltamezőket.

Többarchitektúra-kivonatok

Minden tárolórendszerkép több kivonatolt hivatkozást tartalmazhat, amelyek különböző CPU-architektúrákat (amd64, arm64) fednek le. Az API a többarchitektúra-jegyzékekből származó összes Linux-platform-kivonatot tartalmazza, így a CVE-adatok attól függetlenül megegyezhetnek, hogy melyik adott platform emészti le a csomópontot.

Jelentés verzióformátumai

Az AKS Biztonságirés-adat API-jelentések különböző verziószámozási sémákat használnak a jelentett kiadás típusától függően. Az alábbi táblázat összefoglalja az AKS-kiadásokhoz, a Kubernetes-verziókhoz és a VHD-kiadásokhoz használt formátumokat:

Kiadás típusa	Formátum	Example
AKS-kiadás	`v{YYYYMMDD}`	`v20260104`
Kubernetes-verzió	Semver	`1.33.2`
VHD-kiadás	`{distro}/{YYYYMM.DD.patch}`	`AKSAzureLinux-gen2/202512.06.0`

Az AKS sérülékenységi adatok API-jával kapcsolatos további információkért tekintse meg a Az Azure Kubernetes Service-hez (AKS) készült sérülékenységi adatok API-jának áttekintését.

Visszajelzés

Hasznosnak találta ezt az oldalt?

Utolsó frissítés időpontja: 2026-05-20

Az Azure Kubernetes Service (AKS) biztonsági rési adataihoz készült API használata

CVE-jelentések lekérdezése

AKS-verzióhoz tartozó CVE-k lekérdezése

CvEs lekérdezése Kubernetes-verzióhoz

Egy csomópont lemezképének (VHD) CVE-inek lekérdezése

CvEs lekérdezése egy adott tárolórendszerképhez

Adott operációsrendszer-csomag cves-einek lekérdezése

Végpontok

AKS-kiadások

Az AKS kiadási indexének lekérése

Az AKS-kiadáshoz tartozó CVE-jelentés lekérése

Kubernetes-verziók kiadásai

Kubernetes-verziók indexének lekérése

A Kubernetes CVE-verzió jelentésének lekérése

VHD -kiadások (csomópontkép)

VHD-kiadások indexének lekérése

A VHD-kiadáshoz tartozó CVE-jelentés lekérése

Konténerképek

Tárolórendszerkép CVE-vizsgálati jelentésének lekérése

Tárolólemezkép CVE-kockázatcsökkentési jelentésének lekérése

VHD operációsrendszer-csomagok

VHD operációs rendszer csomag CVE vizsgálati jelentésének lekérése

VHD operációs rendszer csomag CVE-kockázatcsökkentési jelentésének lekérése

Adatmodellek

CVE

ContainerImages

AKSReleaseContainerTarget

AKSK8SContainerTarget

AKSVHDContainerTarget

AKSVHDOSPackageTarget

CVEScanner

CVEList

CVEMitigation

Változáskövetés

Többarchitektúra-kivonatok

Jelentés verzióformátumai

Kapcsolódó tartalom

Visszajelzés

További források