Gunakan API Data Kerentanan untuk Azure Kubernetes Service (AKS)

API Data Kerentanan AKS memberi Anda visibilitas baca-saja terprogram ke dalam kerentanan yang terdeteksi dalam komponen platform yang dikelola AKS. API ini ditujukan untuk tim keamanan, tim kepatuhan, dan pemilik platform yang membutuhkan informasi otoritatif tentang kerentanan yang memengaruhi artefak yang dikelola AKS yang independen dari status runtime kluster tertentu.

Dalam artikel ini, Anda mempelajari cara menggunakan API Data Kerentanan AKS untuk mengambil laporan CVE secara terprogram untuk artefak yang dikelola AKS, termasuk rilis AKS, versi Kubernetes, gambar simpul, gambar kontainer, dan paket OS. Ini memberikan contoh permintaan API dan menunjukkan cara menginterpretasikan respons untuk mendukung analisis CVE skala besar, otomatisasi, dan korelasi dengan temuan pemindai keamanan. Untuk ringkasan konsep di balik API ini, lihat gambaran umum API Data Kerentanan untuk Azure Kubernetes Service (AKS).

Telusuri laporan CVE

Contoh berikut menunjukkan cara mengkueri API Data Kerentanan AKS untuk mengambil laporan CVE untuk rilis AKS, versi Kubernetes, gambar simpul, gambar kontainer, dan paket OS.

Mengkueri CVE untuk rilis 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 '.'

Menelusuri CVE untuk versi 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 '.'

Mengkueri CVE untuk gambar simpul (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 '.'

Telusuri CVE untuk image kontainer tertentu

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

Mengkueri CVE untuk paket OS tertentu

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

Beberapa Endpoint

API Data Kerentanan AKS menyediakan endpoint untuk mendapatkan laporan CVE bagi rilis AKS, versi Kubernetes, image node, image kontainer, dan paket OS. Setiap titik akhir menyediakan akses ke indeks versi yang tersedia atau laporan pemindaian terperinci untuk versi atau artefak tertentu. Bagian berikut menjelaskan setiap titik akhir, operasi yang tersedia, serta format permintaan dan respons yang diharapkan.

Rilis AKS

Dapatkan indeks rilis AKS

Titik akhir berikut mengembalikan indeks semua versi rilis AKS dengan laporan CVE yang tersedia:

GET /api/v1/aks-releases/_index

Contoh permintaan:

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

Contoh respons:

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

Bidang respons:

Ladang Tipe Description
aks_release_versions string[] Versi rilis AKS yang tersedia, diurutkan secara kronologis
report_time string (ISO 8601) Ketika indeks ini terakhir dibuat

Dapatkan laporan CVE untuk rilis AKS

Titik akhir berikut mengembalikan laporan CVE terperinci untuk versi rilis AKS tertentu, termasuk semua gambar kontainer di namespace sistem, CVE aktifnya, dan delta CVE dibandingkan dengan rilis sebelumnya:

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

Parameter jalur:

Parameter Tipe Description Example
version string Versi rilis AKS dari indeks v20260104

Contoh permintaan:

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

Contoh respons (disingkat):

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

Bidang respons:

Ladang Tipe Description
aks_release_version string Versi rilis AKS saat ini
previous_aks_release_version string Versi rilis sebelumnya (digunakan untuk perhitungan delta)
container_targets AKSReleaseContainerTarget[] Semua komponen kontainer dalam rilis ini
report_time string (ISO 8601) Stempel waktu pembuatan laporan

Rilis versi Kubernetes

Mendapatkan indeks versi Kubernetes

Titik akhir berikut mengembalikan indeks semua versi Kubernetes dengan laporan CVE yang tersedia:

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

Contoh permintaan:

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

Contoh respons:

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

Bidang respons:

Ladang Tipe Description
k8s_versions string[] Versi Kubernetes yang tersedia, diurutkan menurut semver
report_time string (ISO 8601) Ketika indeks ini terakhir dibuat

Dapatkan laporan CVE versi Kubernetes

Titik akhir berikut mengembalikan laporan CVE untuk versi Kubernetes tertentu, yang merinci kerentanan dalam gambar kontainer yang digunakan oleh komponen kubernetes inti dan add-on AKS untuk versi tersebut:

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

Parameter jalur:

Parameter Tipe Description Example
version string Versi Kubernetes dari indeks 1.33.2

Contoh permintaan:

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

Contoh respons (disingkat):

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

Bidang respons:

Ladang Tipe Description
k8s_version string Versi Kubernetes (misalnya, "1.33.2")
container_targets AKSK8SContainerTarget[] Gambar kontainer untuk versi Kubernetess ini
report_time string (ISO 8601) Stempel waktu pembuatan laporan

Rilis VHD (gambar node)

Dapatkan indeks versi rilis VHD

Titik akhir berikut mengembalikan indeks semua rilis VHD dengan laporan CVE yang tersedia:

GET /api/v1/vhd-releases/_index

Contoh permintaan:

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

Contoh respons (disingkat):

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

Bidang respons:

Ladang Tipe Description
vhd_release_versions string[] Rilis VHD yang tersedia dalam format {distro}/{version}
report_time string (ISO 8601) Ketika indeks ini terakhir dibuat

Distro yang tersedia:

Prefiks distro Description
AKSAzureLinux-gen1 Azure Linux V2, Generasi 1
AKSAzureLinux-gen2 Azure Linux V2, Generasi 2
AKSAzureLinux-gen1fips Azure Linux V2, Gen 1, berkemampuan FIPS
AKSAzureLinux-gen2fips Azure Linux V2, Gen 2, berkemampuan FIPS
AKSAzureLinux-gen2kata Azure Linux V2, Gen 2, kontainer Kata
AKSAzureLinux-gen2tl Azure Linux V2, Gen 2, varian TL
AKSAzureLinuxV3-gen1 Azure Linux V3, Generasi 1
AKSAzureLinuxV3-gen2 Azure Linux V3, Generasi 2
AKSAzureLinuxV3-gen1fips Azure Linux V3, Gen 1, berkemampuan FIPS
AKSAzureLinuxV3-gen2fips Azure Linux V3, Gen 2, berkemampuan FIPS
AKSAzureLinuxV3-gen2tl Azure Linux V3, Gen 2, varian TL
AKSCBLMarinerV2-gen1 CBL-Mariner V2, Generasi 1
AKSCBLMarinerV2-gen2 CBL-Mariner V2, Generasi 2
AKSCBLMarinerV2-gen1fips CBL-Mariner V2, Gen 1, berkemampuan FIPS
AKSCBLMarinerV2-gen2fips CBL-Mariner V2, Gen 2, dengan dukungan FIPS
AKSCBLMarinerV2-gen2kata CBL-Mariner V2, Gen 2, kontainer Kata
AKSCBLMarinerV2-gen2tl varian CBL-Mariner V2, Gen 2, TL
AKSUbuntu-gen1-2004fipscontainerd Ubuntu 20.04, Gen 1, FIPS
AKSUbuntu-gen1-2204containerd Ubuntu 22.04, Generasi 1
AKSUbuntu-gen1-2404containerd Ubuntu 24.04, Generasi 1
AKSUbuntu-gen2-2004cvmcontainerd Ubuntu 20.04, Gen 2, VM Rahasia
AKSUbuntu-gen2-2004fipscontainerd Ubuntu 20.04, Gen 2, FIPS
AKSUbuntu-gen2-2204containerd Ubuntu 22.04, Generasi 2
AKSUbuntu-gen2-2404containerd Ubuntu 24.04, Generasi 2
AKSUbuntu-gen2-2204tlcontainerd Varian Ubuntu 22.04, Gen 2, TL
AKSUbuntu-gen2-2404tlcontainerd Ubuntu 24.04, Gen 2, varian TL

Dapatkan laporan CVE untuk rilis VHD

Titik akhir berikut mengembalikan laporan CVE untuk rilis VHD tertentu, termasuk paket OS dan gambar kontainer yang disertakan dalam rilis tersebut:

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

Parameter jalur:

Parameter Tipe Description Example
distro string Pengidentifikasi distribusi Linux AKSUbuntu-gen2-2204containerd
version string Versi rilis untuk VHD 202601.13.0

Contoh permintaan:

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

Contoh respons (disingkat):

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

Bidang respons:

Ladang Tipe Description
distro_name string Nama distribusi Linux (misalnya, "AKSAzureLinux/gen2")
vhd_release_version string Versi rilis VHD saat ini
previous_vhd_release_version string Versi rilis VHD sebelumnya
os_package_targets AKSVHDOSPackageTarget[] Paket sistem operasi dalam VHD ini
container_targets AKSVHDContainerTarget[] Gambar kontainer yang dibundel dalam VHD ini
report_time string (ISO 8601) Stempel waktu pembuatan laporan

Gambar kontainer

Titik akhir gambar kontainer menyediakan laporan pemindaian CVE per gambar dan pelacakan mitigasi lintas rilis untuk gambar kontainer individual. Endpoint ini tidak memiliki listing _index; Anda mengaksesnya menggunakan path image lengkap.

Dapatkan laporan pemindaian CVE gambar kontainer

Titik akhir berikut mengambil laporan pemindaian CVE untuk gambar kontainer tertentu yang diidentifikasi oleh jalur dan tag gambar lengkapnya:

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

Parameter jalur:

Parameter Tipe Description Example
image string Nama gambar lengkap termasuk registri mcr.microsoft.com/oss/kubernetes/kube-proxy
tag string Tag gambar v1.31.11

Contoh permintaan:

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

Contoh respons (disingkat):

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

Bidang respons:

Ladang Tipe Description
image_repo_tags string[] Tag gambar untuk gambar hasil pemindaian
image_repo_digests string[] Hash gambar untuk semua platform yang didukung
report_time string (ISO 8601) Stempel waktu pembuatan laporan
active_cves CVEList[] CVE aktif yang dikelompokkan menurut pemindai

Dapatkan laporan mitigasi CVE untuk image kontainer

Titik akhir berikut mengambil laporan mitigasi CVE untuk repositori gambar kontainer tertentu dan menunjukkan CVE mana yang terlihat di versi dan rilis komponen mana, dan di mana versi dan rilis mereka dimitigasi:

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

Parameter jalur:

Parameter Tipe Description Example
image string Nama gambar lengkap termasuk registri (tanpa tag) mcr.microsoft.com/oss/kubernetes/kube-proxy

Contoh permintaan:

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

Contoh respons (disingkat):

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

Bidang respons:

Ladang Tipe Description
container_image string Nama gambar tanpa tag
mitigations CVEMitigation[] Entri mitigasi CVE untuk gambar ini

Paket OS VHD

Endpoint paket OS VHD menyediakan laporan pemindaian CVE untuk setiap paket serta pelacakan mitigasi lintas rilis untuk masing-masing paket OS yang diinstal pada image node VHD. Titik akhir ini tidak memiliki _index daftar; Anda menavigasi berdasarkan nama paket.

Dapatkan laporan pemindaian CVE paket OS VHD

Endpoint berikut mengambil laporan hasil pemindaian CVE untuk versi tertentu dari paket OS yang diinstal pada image node VHD:

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

Parameter jalur:

Parameter Tipe Description Example
name string Nama paket OS (huruf kecil) openssl
version string Versi paket 3.0.2-0ubuntu1.20

Contoh permintaan:

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

Contoh respons:

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

Bidang respons:

Ladang Tipe Description
name string Nama paket
version string Versi paket
active_cves CVE[] CVE yang aktif dengan perbaikan yang tersedia
report_time string (ISO 8601) Stempel waktu pembuatan laporan

Dapatkan laporan mitigasi CVE paket OS VHD

Endpoint berikut mengambil laporan mitigasi CVE untuk paket OS tertentu dan menunjukkan CVE mana yang ditemukan pada versi paket dan rilis VHD tertentu, serta pada versi mana CVE tersebut telah dimitigasi:

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

Parameter jalur:

Parameter Tipe Description Example
name string Nama paket OS (huruf kecil) openssl

Contoh permintaan:

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

Contoh respons (disingkat):

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

Bidang respons:

Ladang Tipe Description
package_name string Nama paket OS
mitigations CVEMitigation[] Entri mitigasi CVE untuk paket ini

Pemodelan data

Bagian berikut menjelaskan model data yang dikembalikan oleh API Data Kerentanan AKS, termasuk struktur entri CVE, referensi gambar kontainer, komponen rilis AKS, paket OS VHD, dan hubungan di antaranya.

CVE

Model data CVE adalah pengidentifikasi Kerentanan dan Paparan Umum.

Ladang Tipe Description
id string Pengidentifikasi CVE (misalnya, "CVE-2024-13176", "GHSA-2464-8j7c-4cjm")

ContainerImages

Model data ContainerImages mewakili sekumpulan referensi image kontainer, termasuk tag yang dapat dibaca manusia dan digest yang dapat dialamatkan berdasarkan konten.

Ladang Tipe Description
image_repo_tags string[] Tag gambar (misalnya, "mcr.microsoft.com/oss/kubernetes/coredns:v1.9.4-9")
image_repo_digests string[] Hash gambar untuk semua platform yang didukung (misalnya, "mcr.microsoft.com/oss/kubernetes/coredns:v1.9.4-9@sha256:abc...")

Note

Digest mencakup semua varian platform Linux (amd64, arm64) dari manifes multi-arsitektur. Ini memungkinkan pencocokan data CVE terlepas dari digest spesifik platform mana yang diambil oleh node Anda.

AKSReleaseContainerTarget

Model data AKSReleaseContainerTarget mewakili komponen kontainer dalam rilis AKS tertentu, yang diidentifikasi oleh namespace pod dan nama kontainer tempatnya berjalan, bersama dengan gambar kontainer yang digunakannya dan CVE yang memengaruhinya.

Ladang Tipe Description
pod_namespace string Namespace Layanan Kubernetes (misalnya, , "kube-system""calico-system")
container_name string Nama kontainer (misalnya, "coredns", "calico-node")
active_container_images ContainerImages Image kontainer yang sedang berjalan untuk komponen ini
active_cves CVE[] CVE yang telah tersedia perbaikannya yang saat ini memengaruhi komponen ini
removed_container_images_from_previous_release ContainerImages Image yang terdapat pada rilis sebelumnya tetapi tidak lagi berjalan
mitigated_cves_from_previous_release CVE[] CVE yang ada di rilis sebelumnya tetapi telah diperbaiki dalam rilis ini

AKSK8SContainerTarget

Model data AKSK8SContainerTarget merepresentasikan image kontainer yang terkait dengan versi Kubernetes tertentu, termasuk referensi image yang diberi tag, digest untuk image tersebut, dan CVE yang memengaruhinya.

Ladang Tipe Description
container_image string Nama gambar tanpa tag (misalnya, "mcr.microsoft.com/oss/kubernetes/kube-apiserver")
active_container_images ContainerImages Referensi dan hash gambar yang diberi tag
active_cves CVE[] CVE yang aktif dengan perbaikan yang tersedia

AKSVHDContainerTarget

Model data AKSVHDContainerTarget merepresentasikan image kontainer yang disertakan dalam image node VHD, beserta referensi image bertag, digest, dan CVE yang memengaruhinya.

Ladang Tipe Description
container_image string Nama gambar tanpa tag
active_container_images ContainerImages Referensi dan hash gambar yang diberi tag
active_cves CVE[] CVE yang aktif dengan perbaikan yang tersedia
removed_container_images_from_previous_release ContainerImages Gambar dihapus sejak rilis VHD sebelumnya
mitigated_cves_from_previous_release CVE[] CVE diperbaiki sejak rilis VHD sebelumnya

AKSVHDOSPackageTarget

Model data AKSVHDOSPackageTarget mewakili paket pada level OS yang diinstal dalam image node VHD, beserta versi yang terinstal, CVE yang memengaruhinya, dan setiap perubahan dibandingkan dengan rilis VHD sebelumnya.

Ladang Tipe Description
name string Nama paket (misalnya, "kernel", "containerd", "systemd")
version string Versi paket (misalnya, "6.1.109.2-1.cm2")
active_cves CVE[] CVE yang aktif dengan perbaikan yang tersedia
previous_version string Versi dari rilis VHD sebelumnya (kosong jika tidak berubah)
mitigated_cves_from_previous_release CVE[] CVE diperbaiki sejak rilis VHD sebelumnya

CVEScanner

Model data CVEScanner mewakili metadata untuk pemindai kerentanan yang menghasilkan hasil pemindaian CVE untuk gambar kontainer.

Ladang Tipe Description
name string Nama pemindai (misalnya, "trivy")
version string Versi pemindai (misalnya, "0.69.1")

CVEList

Model data CVEList mewakili sekumpulan CVE yang terdeteksi oleh pemindai kerentanan tertentu untuk gambar kontainer tertentu. Setiap entri mengaitkan metadata pemindai dengan daftar CVE yang terdeteksi.

Ladang Tipe Description
scanner CVEScanner Pemindai yang menghasilkan hasil ini
cves CVE[] CVE yang terdeteksi oleh pemindai ini

CVEMitigation

Model data CVEMitigation melacak satu CVE di berbagai versi komponen dan jenis rilis, serta menunjukkan tempat CVE tersebut teramati dan tempat CVE tersebut dimitigasi.

Ladang Tipe Description
cve CVE CVE yang sedang dilacak
seen_in_component_versions string[] Versi komponen (tag gambar atau versi paket) tempat CVE ini terdeteksi
seen_in_aks_release_versions string[] Versi rilis AKS tempat CVE ini terdeteksi
seen_in_aks_k8s_release_versions string[] Versi rilis Kubernetes tempat CVE ini terdeteksi
seen_in_vhd_release_versions string[] Versi rilis VHD tempat CVE ini terdeteksi
mitigated_in_component_versions string[] Versi komponen tempat CVE ini diperbaiki
mitigated_in_aks_release_versions string[] Versi rilis AKS yang telah memperbaiki CVE ini
mitigated_in_aks_k8s_release_versions string[] Versi rilis Kubernetes yang telah memperbaiki CVE ini
mitigated_in_vhd_release_versions string[] Versi rilis VHD tempat CVE ini diperbaiki

Pelacakan delta

Rilis AKS dan laporan rilis VHD mencakup bidang delta yang membandingkan rilis saat ini dengan yang sebelumnya:

  • mitigated_cves_from_previous_release: CVE yang ada di rilis sebelumnya tetapi tidak lagi terdeteksi. Ini berarti kerentanan telah diperbaiki (misalnya, melalui peningkatan versi komponen).
  • removed_container_images_from_previous_release: Gambar kontainer yang berjalan di rilis sebelumnya tetapi tidak ada dalam rilis saat ini.

Note

Laporan versi Kubernetes tidak menyertakan bidang delta.

Digest multi-arsitektur

Setiap image kontainer mungkin menyertakan beberapa referensi digest untuk berbagai arsitektur CPU (amd64, arm64). API mencakup semua digest platform Linux dari manifes multiarsitektur, sehingga Anda dapat mencocokkan data CVE terlepas dari digest platform spesifik mana pun yang ditarik oleh node Anda.

Format versi laporan

Laporan API Data Kerentanan AKS menggunakan skema penerapan versi yang berbeda tergantung pada jenis rilis yang dilaporkan. Tabel berikut merangkum format yang digunakan untuk rilis AKS, versi Kubernetes, dan rilis VHD:

Jenis rilis Format Example
Rilis AKS v{YYYYMMDD} v20260104
Versi Kubernetes Semver 1.33.2
Rilis VHD {distro}/{YYYYMM.DD.patch} AKSAzureLinux-gen2/202512.06.0

Konten terkait

Untuk informasi selengkapnya tentang API Data Kerentanan AKS, lihat Ikhtisar API Data Kerentanan untuk Azure Kubernetes Service (AKS).

  • Terakhir diperbarui pada