De Azure Kubernetes Service (AKS) Data-API voor beveiligingsproblemen gebruiken

De AKS Vulnerability Data-API biedt programmatische, alleen-lezen zichtbaarheid van beveiligingsproblemen die zijn gedetecteerd in door AKS beheerde platformonderdelen. Deze API is bedoeld voor beveiligingsteams, complianceteams en platformeigenaren die gezaghebbende informatie nodig hebben over beveiligingsproblemen die van invloed zijn op door AKS beheerde artefacten, onafhankelijk van een specifieke runtimestatus van het cluster.

In dit artikel leert u hoe u de AKS-API voor gegevens over beveiligingsproblemen gebruikt om cve-rapporten programmatisch op te halen voor door AKS beheerde artefacten, waaronder AKS-releases, Kubernetes-versies, knooppuntinstallatiekopieën, containerinstallatiekopieën en besturingssysteempakketten. Het biedt voorbeelden van API-aanvragen en laat zien hoe u de antwoorden interpreteert ter ondersteuning van grootschalige CVE-analyse, automatisering en correlatie met bevindingen van beveiligingsscanners. Zie Vulnerability Data-API voor Azure Kubernetes Service (AKS) overzicht voor een overzicht van de concepten achter de API.

Query uitvoeren op CVE-rapporten

In de volgende voorbeelden ziet u hoe u een query uitvoert op de AKS-API voor gegevens over beveiligingsproblemen om CVE-rapporten op te halen voor AKS-releases, Kubernetes-versies, knooppuntinstallatiekopieën, containerinstallatiekopieën en besturingssysteempakketten.

CVE's opvragen voor een AKS-release

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

CVE's opvragen voor een Kubernetes-versie

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

Zoeken naar CVE's voor een knooppuntafbeelding (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 '.'

CVE's opvragen voor een specifieke containerimage

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

Zoek CVE's voor een specifiek besturingssysteempakket

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

Eindpunten

De AKS Vulnerability Data-API biedt eindpunten voor het ophalen van CVE-rapporten voor AKS-releases, Kubernetes-versies, knooppuntinstallatiekopieën, containerinstallatiekopieën en os-pakketten. Elk eindpunt biedt toegang tot een index van beschikbare versies of een gedetailleerd scanrapport voor een specifieke versie of artefact. In de volgende secties worden elk eindpunt, de beschikbare bewerkingen en de verwachte aanvraag- en antwoordindelingen beschreven.

AKS-uitgaven

AKS-releaseindex ophalen

Het volgende eindpunt retourneert een index van alle AKS-releaseversies met beschikbare CVE-rapporten:

GET /api/v1/aks-releases/_index

Voorbeeldaanvraag:

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

Voorbeeldantwoord:

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

Antwoordvelden:

Veld Type Description
aks_release_versions string[] Beschikbare AKS-releaseversies, chronologisch gesorteerd
report_time tekenreeks (ISO 8601) Wanneer deze index voor het laatst is gegenereerd

CVE-rapport van een AKS-release ophalen

Het volgende eindpunt retourneert een gedetailleerd CVE-rapport voor een specifieke AKS-releaseversie, inclusief alle containerimages in systeemnaamruimten, hun actieve CVE's en de delta in CVE's ten opzichte van de vorige release:

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

Padparameters:

Parameter Type Description Voorbeeld
version tekenreeks AKS-releaseversie van de index v20260104

Voorbeeldaanvraag:

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

Voorbeeldantwoord (afgekort):

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

Antwoordvelden:

Veld Type Description
aks_release_version tekenreeks Huidige AKS-releaseversie
previous_aks_release_version tekenreeks Vorige releaseversie (gebruikt voor deltaberekeningen)
container_targets AKSReleaseContainerTarget[] Alle containercomponenten in deze release
report_time tekenreeks (ISO 8601) Tijdstempel voor het genereren van rapporten

Kubernetes-versie-updates

Index van Kubernetes-versies ophalen

Het volgende eindpunt retourneert een index van alle Kubernetes-versies met beschikbare CVE-rapporten:

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

Voorbeeldaanvraag:

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

Voorbeeldantwoord:

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

Antwoordvelden:

Veld Type Description
k8s_versions string[] Beschikbare Kubernetes-versies, gesorteerd op semver
report_time tekenreeks (ISO 8601) Wanneer deze index voor het laatst is gegenereerd

CVE-rapport van Kubernetes-versie ophalen

Het volgende eindpunt retourneert het CVE-rapport voor een specifieke Kubernetes-versie, met informatie over beveiligingsproblemen in de containerinstallatiekopieën die worden gebruikt door de belangrijkste Kubernetes-onderdelen en AKS-invoegtoepassingen voor die versie:

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

Padparameters:

Parameter Type Description Voorbeeld
version tekenreeks Kubernetes-versie uit de index 1.33.2

Voorbeeldaanvraag:

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

Voorbeeldantwoord (afgekort):

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

Antwoordvelden:

Veld Type Description
k8s_version tekenreeks Kubernetes-versie (bijvoorbeeld "1.33.2")
container_targets AKSK8SContainerTarget[] Containerimages voor deze Kubernetes-versie
report_time tekenreeks (ISO 8601) Tijdstempel voor het genereren van rapporten

VHD-releases (knooppuntinstallatiekopieën)

Index voor VHD-releases ophalen

Het volgende eindpunt retourneert een index van alle VHD-releases met beschikbare CVE-rapporten:

GET /api/v1/vhd-releases/_index

Voorbeeldaanvraag:

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

Voorbeeldantwoord (afgekort):

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

Antwoordvelden:

Veld Type Description
vhd_release_versions string[] Beschikbare VHD-releases in {distro}/{version} indeling
report_time tekenreeks (ISO 8601) Wanneer deze index voor het laatst is gegenereerd

Beschikbare distributies:

Voorvoegsel voor distributie Description
AKSAzureLinux-gen1 Azure Linux V2, generatie 1
AKSAzureLinux-gen2 Azure Linux V2, generatie 2
AKSAzureLinux-gen1fips Azure Linux V2, Gen 1, FIPS ingeschakeld
AKSAzureLinux-gen2fips Azure Linux V2, Gen 2, FIPS ingeschakeld
AKSAzureLinux-gen2kata Azure Linux V2, Gen 2, Kata containers
AKSAzureLinux-gen2tl Azure Linux V2, Gen 2, TL-variant
AKSAzureLinuxV3-gen1 Azure Linux V3, generatie 1
AKSAzureLinuxV3-gen2 Azure Linux V3, generatie 2
AKSAzureLinuxV3-gen1fips Azure Linux V3, Gen 1, FIPS ingeschakeld
AKSAzureLinuxV3-gen2fips Azure Linux V3, Gen 2, FIPS ingeschakeld
AKSAzureLinuxV3-gen2tl Azure Linux V3, Gen 2, TL-variant
AKSCBLMarinerV2-gen1 CBL-Mariner V2, generatie 1
AKSCBLMarinerV2-gen2 CBL-Mariner V2, generatie 2
AKSCBLMarinerV2-gen1fips CBL-Mariner V2, Gen 1, FIPS ingeschakeld
AKSCBLMarinerV2-gen2fips CBL-Mariner V2, Gen 2, FIPS ingeschakeld
AKSCBLMarinerV2-gen2kata CBL-Mariner V2, Gen 2, Kata-containers
AKSCBLMarinerV2-gen2tl CBL-Mariner V2, Gen 2, TL-variant
AKSUbuntu-gen1-2004fipscontainerd Ubuntu 20.04, Gen 1, FIPS
AKSUbuntu-gen1-2204containerd Ubuntu 22.04, Generatie 1
AKSUbuntu-gen1-2404containerd Ubuntu 24.04, Generatie 1
AKSUbuntu-gen2-2004cvmcontainerd Ubuntu 20.04, Gen 2, Vertrouwelijke VM
AKSUbuntu-gen2-2004fipscontainerd Ubuntu 20.04, Gen 2, FIPS
AKSUbuntu-gen2-2204containerd Ubuntu 22.04, Generatie 2
AKSUbuntu-gen2-2404containerd Ubuntu 24.04, Generatie 2
AKSUbuntu-gen2-2204tlcontainerd Ubuntu 22.04, Gen 2, TL-variant
AKSUbuntu-gen2-2404tlcontainerd Ubuntu 24.04, Gen 2, TL-variant

CVE-rapport voor VHD-release ophalen

Het volgende eindpunt retourneert het CVE-rapport voor een specifieke VHD-release, inclusief zowel de besturingssysteempakketten als containerinstallatiekopieën die zijn opgenomen in die release:

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

Padparameters:

Parameter Type Description Voorbeeld
distro tekenreeks Linux-distributie-id AKSUbuntu-gen2-2204containerd
version tekenreeks VHD-releaseversie 202601.13.0

Voorbeeldaanvraag:

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

Voorbeeldantwoord (afgekort):

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

Antwoordvelden:

Veld Type Description
distro_name tekenreeks Linux-distributienaam (bijvoorbeeld "AKSAzureLinux/gen2")
vhd_release_version tekenreeks Huidige VHD-releaseversie
previous_vhd_release_version tekenreeks Vorige releaseversie van VHD
os_package_targets AKSVHDOSPackageTarget[] OS-pakketten in deze VHD
container_targets AKSVHDContainerTarget[] Containerimages die in deze VHD zijn opgenomen
report_time tekenreeks (ISO 8601) Tijdstempel voor het genereren van rapporten

Containerafbeeldingen

De eindpunten voor containerimages bieden CVE-scanrapporten per image en het bijhouden van mitigerende maatregelen over releases heen voor afzonderlijke containerimages. Deze eindpunten hebben geen een _index vermelding; u navigeert via het volledige imagepad.

CVE-scanrapport voor containerimage ophalen

Het volgende eindpunt haalt een CVE-scanrapport op voor een specifieke containerimage die wordt geïdentificeerd aan de hand van het volledige imagepad en de tag:

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

Padparameters:

Parameter Type Description Voorbeeld
image tekenreeks Volledige imagenaam inclusief registry mcr.microsoft.com/oss/kubernetes/kube-proxy
tag tekenreeks Afbeeldingstag v1.31.11

Voorbeeldaanvraag:

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

Voorbeeldantwoord (afgekort):

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

Antwoordvelden:

Veld Type Description
image_repo_tags string[] Afbeeldingstags voor de gescande afbeelding
image_repo_digests string[] Afbeeldingssamenvatten voor alle ondersteunde platforms
report_time tekenreeks (ISO 8601) Tijdstempel voor het genereren van rapporten
active_cves CVEList[] Actieve CV's gegroepeerd op scanner

CVE-mitigatierapport voor containerimages ophalen

Het volgende eindpunt haalt een CVE-risicobeperkingsrapport op voor een specifieke opslagplaats voor containerinstallatiekopieën en toont welke CVE's zijn gezien in welke onderdeelversies en releases, en in welke versies en releases ze zijn beperkt:

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

Padparameters:

Parameter Type Description Voorbeeld
image tekenreeks Volledige imagenaam met registry (zonder tag) mcr.microsoft.com/oss/kubernetes/kube-proxy

Voorbeeldaanvraag:

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

Voorbeeldantwoord (afgekort):

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

Antwoordvelden:

Veld Type Description
container_image tekenreeks Afbeeldingsnaam zonder tag
mitigations CVEMitigation[] CVE-beperkingsvermeldingen voor deze afbeelding

VHD OS-pakketten

De eindpunten voor VHD OS-pakketten bieden CVE-scanrapporten per pakket en het bijhouden van mitigaties over verschillende releases heen voor afzonderlijke OS-pakketten die in VHD-node-images zijn geïnstalleerd. Deze eindpunten hebben _index geen vermelding. U navigeert door de pakketnaam.

CVE-scanrapport voor VHD-besturingssysteempakket ophalen

Met het volgende eindpunt wordt een CVE-scanrapport opgehaald voor een specifieke versie van het besturingssysteempakket die is geïnstalleerd in VHD-knooppuntinstallatiekopieën:

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

Padparameters:

Parameter Type Description Voorbeeld
name tekenreeks Naam van besturingssysteempakket (kleine letter) openssl
version tekenreeks Versie van het pakket 3.0.2-0ubuntu1.20

Voorbeeldaanvraag:

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

Voorbeeldantwoord:

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

Antwoordvelden:

Veld Type Description
name tekenreeks Naam van het pakket
version tekenreeks Versie van het pakket
active_cves CVE[] Actieve CVE’s met beschikbare oplossingen
report_time tekenreeks (ISO 8601) Tijdstempel voor het genereren van rapporten

CVE-beperkingsrapport voor VHD-OS-pakket ophalen

Het volgende eindpunt haalt een CVE-risicobeperkingsrapport op voor een specifiek besturingssysteempakket en toont welke CVE's zijn gezien in welke pakketversies en VHD-releases, en in welke versies ze zijn beperkt:

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

Padparameters:

Parameter Type Description Voorbeeld
name tekenreeks Naam van besturingssysteempakket (kleine letter) openssl

Voorbeeldaanvraag:

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

Voorbeeldantwoord (afgekort):

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

Antwoordvelden:

Veld Type Description
package_name tekenreeks Naam van besturingssysteempakket
mitigations CVEMitigation[] CVE-beperkingsvermeldingen voor dit pakket

Gegevensmodellen

In de volgende secties worden de gegevensmodellen beschreven die worden geretourneerd door de AKS Vulnerability Data-API, waaronder de structuur van CVE-vermeldingen, containerinstallatiekopieën, AKS-releaseonderdelen, VHD-besturingssysteempakketten en de relaties ertussen.

CVE

Het gegevensmodel voor CVE is een identificatiecode voor Common Vulnerabilities and Exposures.

Veld Type Description
id tekenreeks CVE-id (bijvoorbeeld , "CVE-2024-13176""GHSA-2464-8j7c-4cjm")

ContainerImages

Het ContainerImages-gegevensmodel is een verzameling container-imageverwijzingen, waaronder zowel voor mensen leesbare tags als inhoudsgeadresseerde digests.

Veld Type Description
image_repo_tags string[] Afbeeldingstags (bijvoorbeeld "mcr.microsoft.com/oss/kubernetes/coredns:v1.9.4-9")
image_repo_digests string[] Afbeeldingssamenvatingen voor alle ondersteunde platforms (bijvoorbeeld "mcr.microsoft.com/oss/kubernetes/coredns:v1.9.4-9@sha256:abc...")

Note

Digests omvatten alle Linux-platformvarianten (amd64, arm64) uit multi-arch manifesten. Hierdoor kunnen overeenkomende CVE-gegevens worden gevonden, ongeacht welke platformspecifieke digest uw knooppunt heeft opgehaald.

AKSReleaseContainerTarget

Het gegevensmodel AKSReleaseContainerTarget is een representatie van een containercomponent binnen een specifieke AKS-release, geïdentificeerd door de pod-namespace en de containernaam waarin deze wordt uitgevoerd, samen met de containerimages die het gebruikt en de CVE's die hierop van invloed zijn.

Veld Type Description
pod_namespace tekenreeks Kubernetes-naamruimte (bijvoorbeeld "kube-system", "calico-system")
container_name tekenreeks Containernaam (bijvoorbeeld , "coredns""calico-node")
active_container_images ContainerImages Containerimages die momenteel voor dit onderdeel draaien
active_cves CVE[] CVE’s met beschikbare fixes die momenteel gevolgen hebben voor dit onderdeel
removed_container_images_from_previous_release ContainerImages Images die aanwezig waren in de vorige release, maar niet meer actief zijn
mitigated_cves_from_previous_release CVE[] CVE's die in de vorige versie aanwezig waren, maar in deze versie zijn opgelost

AKSK8SContainerTarget

Het gegevensmodel AKSK8SContainerTarget beschrijft een containerimage die is gekoppeld aan een specifieke Kubernetes-versie, inclusief de getagde imageverwijzingen en digests voor die image en de CVE's die daarop van invloed zijn.

Veld Type Description
container_image tekenreeks Afbeeldingsnaam zonder tag (bijvoorbeeld "mcr.microsoft.com/oss/kubernetes/kube-apiserver")
active_container_images ContainerImages Gelabelde afbeeldingsverwijzingen en samenvattingen
active_cves CVE[] Actieve CVE’s met beschikbare oplossingen

AKSVHDContainerTarget

Het gegevensmodel AKSVHDContainerTarget staat voor een containerinstallatiekopie die is opgenomen in een VHD-knooppuntimage, samen met de getagde imageverwijzingen, digests en CVE's die hierop van invloed zijn.

Veld Type Description
container_image tekenreeks Afbeeldingsnaam zonder tag
active_container_images ContainerImages Gelabelde afbeeldingsverwijzingen en samenvattingen
active_cves CVE[] Actieve CVE’s met beschikbare oplossingen
removed_container_images_from_previous_release ContainerImages Images die sinds de vorige VHD-release zijn verwijderd
mitigated_cves_from_previous_release CVE[] CV's opgelost sinds de vorige VHD-release

AKSVHDOSPackageTarget

Het AKSVHDOSPackageTarget-gegevensmodel vertegenwoordigt een pakket op besturingssysteemniveau dat is geïnstalleerd in een VHD-knooppuntinstallatiekopieën, samen met de geïnstalleerde versie, de CVE's die dit beïnvloeden en eventuele wijzigingen uit de vorige VHD-release.

Veld Type Description
name tekenreeks Pakketnaam (bijvoorbeeld"kernel", , "containerd""systemd")
version tekenreeks Pakketversie (bijvoorbeeld "6.1.109.2-1.cm2")
active_cves CVE[] Actieve CVE’s met beschikbare oplossingen
previous_version tekenreeks Versie van de vorige VHD-release (leeg indien ongewijzigd)
mitigated_cves_from_previous_release CVE[] CV's opgelost sinds de vorige VHD-release

CVEScanner

Het CVEScanner-gegevensmodel beschrijft de metagegevens van een kwetsbaarheidsscanner die CVE-scanresultaten voor containerimages genereert.

Veld Type Description
name tekenreeks Naam van scanner (bijvoorbeeld "trivy")
version tekenreeks Scannerversie (bijvoorbeeld "0.69.1")

CVEList

Het CVEList-gegevensmodel vertegenwoordigt een set CVE's die zijn gedetecteerd door een bepaalde scanner voor beveiligingsproblemen voor een bepaalde containerinstallatiekopie. Elke vermelding koppelt de metagegevens van de scanner aan de lijst van CVE's die deze heeft gedetecteerd.

Veld Type Description
scanner CVEScanner De scanner die deze resultaten heeft geproduceerd
cves CVE[] Door deze scanner gedetecteerde CVE's

CVEMitigation

Het CVEMitigation-gegevensmodel houdt één CVE bij voor onderdelenversies en releasetypen, waarin wordt aangegeven waar het is waargenomen en waar het werd verzacht.

Veld Type Description
cve CVE De CVE die wordt gevolgd
seen_in_component_versions string[] Onderdeelversies (afbeeldingstags of pakketversies) waar deze CVE is gedetecteerd
seen_in_aks_release_versions string[] AKS-releaseversies waar deze CVE is gedetecteerd
seen_in_aks_k8s_release_versions string[] Kubernetes-releaseversies waar deze CVE is gedetecteerd
seen_in_vhd_release_versions string[] VHD-releaseversies waar deze CVE is gedetecteerd
mitigated_in_component_versions string[] Onderdeelversies waarbij deze CVE is opgelost
mitigated_in_aks_release_versions string[] AKS-releaseversies waarbij deze CVE is opgelost
mitigated_in_aks_k8s_release_versions string[] Kubernetes-releaseversies waarbij deze CVE is opgelost
mitigated_in_vhd_release_versions string[] VHD-releaseversies waarbij deze CVE is opgelost

Delta-tracering

AKS-release- en VHD-releaserapporten bevatten deltavelden die de huidige release vergelijken met de vorige:

  • mitigated_cves_from_previous_release: CVE’s die in de vorige versie aanwezig waren, maar niet langer worden gedetecteerd. Dit betekent dat het beveiligingsprobleem is opgelost (bijvoorbeeld via een bump van een onderdeelversie).
  • removed_container_images_from_previous_release: Containerimages die in de vorige release actief waren, maar die niet aanwezig zijn in de huidige release.

Note

Kubernetes-versierapporten bevatten geen deltavelden.

Samenvattingen met meerdere architectuur

Elke containerimage kan meerdere digestverwijzingen bevatten voor verschillende CPU-architecturen (amd64, arm64). De API bevat alle Linux-platformsamenvatingen van manifesten met meerdere architectuur, zodat u de CVE-gegevens kunt vergelijken, ongeacht welk specifiek platform uw knooppunt heeft opgehaald.

Indelingen van rapportversies

In de AKS-rapporten voor gegevens over beveiligingsproblemen worden verschillende versiebeheerschema's gebruikt, afhankelijk van het type release dat wordt gerapporteerd. De volgende tabel bevat een overzicht van de indelingen die worden gebruikt voor AKS-releases, Kubernetes-versies en VHD-versies:

Type van vrijgave Format Voorbeeld
AKS-release v{YYYYMMDD} v20260104
Kubernetes-versie Semver 1.33.2
VHD-uitgave {distro}/{YYYYMM.DD.patch} AKSAzureLinux-gen2/202512.06.0

Verwante inhoud

Zie Vulnerability Data-API voor Azure Kubernetes Service (AKS) overzicht voor meer informatie over de AKS Vulnerability Data-API.

  • Laatst bijgewerkt om