Cihaz başına yazılım güvenlik açıkları değerlendirmesi dışarı aktarma

  • Şunlara uygulanır: Microsoft Defender for Endpoint Plan 1, Microsoft Defender for Endpoint Plan 2, Microsoft Defender Vulnerability Management

Cihaz başına yazılım güvenlik açıklarını dışarı aktarma özelliği, bilinen tüm yazılım güvenlik açıklarını ve bunların tüm cihazlara ilişkin ayrıntılarını cihaz başına temel alarak döndürür. Aksi belirtilmedikçe, listelenen tüm dışarı aktarma değerlendirme yöntemleri tam dışarı aktarma ve cihaza göredir ( cihaz başına olarak da adlandırılır).

Farklı API çağrıları farklı veri türleri alır. Veri miktarı büyük olabileceğinden, alınabilmesinin üç yolu vardır:

  1. Yazılım güvenlik açıklarını dışarı aktarma değerlendirmesi: JSON yanıtı API, kuruluşunuzdaki tüm verileri Json yanıtları olarak çeker. Bu yöntem, 100 K'den az cihazı olan küçük kuruluşlar için en iyisidir. Yanıt sayfalandırılır, böylece yanıttan @odata.nextLink alanını kullanarak sonraki sonuçları getirebilirsiniz.

  2. Yazılım güvenlik açıklarını dışarı aktarma değerlendirmesi: dosyalar aracılığıyla Bu API çözümü, daha fazla miktarda veriyi daha hızlı ve daha güvenilir bir şekilde çekmenizi sağlar. 100 K'den fazla cihazı olan büyük kuruluşlar için via-files önerilir. Bu API, kuruluşunuzdaki tüm verileri indirme dosyaları olarak çeker. Yanıt, Azure Depolama'dan tüm verileri indirmek için URL'ler içerir. Bu API, tüm verilerinizi Azure Depolama'dan aşağıdaki gibi indirmenizi sağlar:

    • Tüm kuruluş verilerinizi içeren indirme URL'lerinin listesini almak için API'yi çağırın.
    • İndirme URL'lerini kullanarak tüm dosyaları indirin ve verileri istediğiniz gibi işleyin.

  3. Delta dışarı aktarma yazılımı güvenlik açıkları değerlendirmesi: JSON yanıtı DeviceId, SoftwareVendor, SoftwareName, SoftwareVersion, CveId ve EventTimestamp'ın her benzersiz bileşimi için bir giriş içeren bir tablo döndürür. API, kuruluşunuzdaki verileri Json yanıtları olarak çeker. Yanıt sayfalandırılmış olduğundan, sonraki sonuçları getirmek için yanıttan alınan alanı kullanabilirsiniz @odata.nextLink .

    Tam "yazılım güvenlik açıkları değerlendirmesi (JSON yanıtı)" kuruluşunuzun yazılım güvenlik açıkları değerlendirmesinin tüm anlık görüntüsünü cihaza göre almak için kullanılır. Ancak, delta dışarı aktarma API çağrısı yalnızca seçili tarih ile geçerli tarih ("delta" API çağrısı) arasında gerçekleşen değişiklikleri getirmek için kullanılır. Her seferinde büyük miktarda veriyle tam dışarı aktarma almak yerine yalnızca yeni, sabit ve güncelleştirilmiş güvenlik açıkları hakkında belirli bilgiler alırsınız. Delta dışarı aktarma JSON yanıt API'si çağrısı, "kaç güvenlik açığı düzeltildi?" veya "Kuruluşuma kaç yeni güvenlik açığı eklendi?" gibi farklı KPI'leri hesaplamak için de kullanılabilir.

    Yazılım güvenlik açıkları için Delta dışarı aktarma JSON yanıt API çağrısı yalnızca hedeflenen bir tarih aralığına ait verileri döndürdüğünden, tam dışarı aktarma olarak kabul edilmez.

Toplanan veriler ( Json yanıtı veya dosyalar aracılığıyla) geçerli durum anlık görüntüsüdür. Geçmiş verileri içermez. Geçmiş verileri toplamak için müşterilerin verileri kendi veri depolamalarına kaydetmesi gerekir.

1. Yazılım güvenlik açıklarını dışarı aktarma değerlendirmesi (JSON yanıtı)

1.1 API yöntemi açıklaması

Bu API yanıtı, cihaz başına yüklü yazılımların tüm verilerini içerir. DeviceId, SoftwareVendor, SoftwareName, SoftwareVersion ve CVEID'nin her benzersiz bileşimi için bir giriş içeren bir tablo döndürür.

1.1.1 Sınırlamaları

  • En büyük sayfa boyutu 200.000'dir.
  • Bu API için hız sınırlamaları dakikada 30 çağrı ve saatte 1.000 çağrıdır.

1.2 İzinler

Bu API'yi çağırmak için aşağıdaki izinlerden biri gereklidir. İzinlerin nasıl seçileceği de dahil olmak üzere daha fazla bilgi edinmek için ayrıntılar için bkz. Uç Nokta için Microsoft Defender API'lerini kullanma.

İzin türü İzin İzin görünen adı
Uygulama Vulnerability.Read.All 'Tehdit ve Güvenlik Açığı Yönetimi güvenlik açığı bilgilerini okuyun'
Temsilci (iş veya okul hesabı) Vulnerability.Read 'Tehdit ve Güvenlik Açığı Yönetimi güvenlik açığı bilgilerini okuyun'

1.3 URL

GET /api/machines/SoftwareVulnerabilitiesByMachine

1.4 Parametreler

  • pageSize (varsayılan = 50.000): Yanıt olarak sonuç sayısı.
  • $top: Döndürülecek sonuç sayısı (döndürmez @odata.nextLink ve bu nedenle tüm verileri çekmez).

1.5 Özellikleri

  • Her kayıt 1 KB veridir. Sizin için doğru pageSize parametresini seçerken bu boyutu dikkate almanız gerekir.
  • Yanıtta başka bazı sütunlar döndürülebilir. Bu sütunlar geçicidir ve kaldırılabilir, bu nedenle yalnızca belgelenmiş sütunları kullanın.
  • Aşağıdaki tabloda tanımlanan özellikler, özellik kimliğine göre alfabetik olarak listelenir. Bu API çalıştırılırken, sonuçta elde edilen çıktının bu tabloda listelenen sırayla döndürülmesi gerekmez.
Özellik (Kimlik) Veri türü Açıklama Döndürülen değer örneği
CveId Dize Ortak Güvenlik Açıkları ve Etkilenmeler (CVE) sistemi altında güvenlik açığına atanan benzersiz tanımlayıcı. CVE-2020-15992
CvssScore Çift CVE'nin CVSS puanı. 6.2
Deviceıd Dize Hizmetteki cihaz için benzersiz tanımlayıcı. 9eaf3a8b5962e0e6b1af9ec756664a9b823df2d1
DeviceName Dize Cihazın tam etki alanı adı (FQDN). johnlaptop.europe.contoso.com
DiskPath'ler Dizi[dize] Ürünün cihaza yüklendiğini gösteren disk kanıtı. ["C:\Program Files (x86)\Microsoft\Silverlight\Application\silverlight.exe"]
ExploitabilityLevel Dize Bu güvenlik açığının kötüye kullanılabilirlik düzeyi (NoExploit, ExploitIsPublic, ExploitIsVerified, ExploitIsInKit) ExploitIsInKit
FirstSeenTimestamp Dize Bu ürün CVE cihazda ilk kez görüldü. 2020-11-03 10:13:34.8476880
Kimlik Dize Kayıt için benzersiz tanımlayıcı. 123ABG55_573AG&mnp!
LastSeenTimestamp Dize Yazılımın cihazda son bildirildiği zaman. 2020-11-03 10:13:34.8476880
OSPlatform Dize Cihazda çalışan işletim sisteminin platformu. Bu özellik, Windows 10 ve Windows 11 gibi aynı aile içinde varyasyonları olan belirli işletim sistemlerini gösterir. Ayrıntılar için desteklenen Microsoft Defender Güvenlik Açığı Yönetimi işletim sistemlerine ve platformlara bakın. Windows10 ve Windows 11
RbacGroupName Dize Rol tabanlı erişim denetimi (RBAC) grubu. Bu cihaz herhangi bir RBAC grubuna atanmamışsa, değer "Atanmamış" olur. Kuruluş herhangi bir RBAC grubu içermiyorsa, değer "Yok" olur. Sunucular
RecommendationReference Dize Bu yazılımla ilgili öneri kimliğine başvuru. va-microsoft-silverlight
RecommendedSecurityUpdate (isteğe bağlı) Dize Güvenlik açığını gidermek için yazılım satıcısı tarafından sağlanan güvenlik güncelleştirmesinin adı veya açıklaması. Nisan 2020 Güvenlik Güncelleştirmeler
RecommendedSecurityUpdateId (isteğe bağlı) Dize İlgili kılavuz veya bilgi bankası (KB) makaleleri için geçerli güvenlik güncelleştirmelerinin veya tanımlayıcısının tanımlayıcısı 4550961
RegistryPaths Dizi[dize] Ürünün cihaza yüklendiğine dair kayıt defteri kanıtı. ["HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\MicrosoftSilverlight"]
SecurityUpdateAvailable Boole Yazılım için bir güvenlik güncelleştirmesi olup olmadığını gösterir. Olası değerler true veya false olabilir.
SoftwareName Dize Yazılım ürününün adı. Chrome
SoftwareVendor Dize Yazılım satıcısının adı. Google
SoftwareVersion Dize Yazılım ürününün sürüm numarası. 81.0.4044.138
VulnerabilitySeverityLevel Dize CVSS puanına göre güvenlik açığına atanan önem düzeyi. Orta

1.6 Örnekler

1.6.1 İstek örneği

GET https://api.security.microsoft.com/api/machines/SoftwareVulnerabilitiesByMachine?pageSize=5

1.6.2 Yanıt örneği

{
    "@odata.context": "https://api.security.microsoft.com/api/$metadata#Collection(microsoft.windowsDefenderATP.api.AssetVulnerability)",
    "value": [
        {
            "id": "00044f612345baf759462dbe6db733b6a9c59ab4_edge_10.0.17763.1637__",
            "deviceId": "00044f612345daf756462bde6bd733b9a9c59ab4",
            "rbacGroupName": "hhh",
            "deviceName": "ComputerPII_18663b45912eed224b2de2f5ea3142726e63f16a.DomainPII_21eeb80d089e79bdfa178eabfa25e8de9acfa346.corp.contoso.com",
            "osPlatform": "Windows10" "Windows11",
            "osVersion": "10.0.17763.1637",
            "osArchitecture": "x64",
            "softwareVendor": "microsoft",
            "softwareName": "edge",
            "softwareVersion": "10.0.17763.1637",
            "cveId": null,
            "vulnerabilitySeverityLevel": null,
            "recommendedSecurityUpdate": null,
            "recommendedSecurityUpdateId": null,
            "recommendedSecurityUpdateUrl": null,
            "diskPaths": [],
            "registryPaths": [],
            "lastSeenTimestamp": "2020-12-30 14:17:26",
            "firstSeenTimestamp": "2020-12-30 11:07:15",
            "exploitabilityLevel": "NoExploit",
            "recommendationReference": "va-_-microsoft-_-edge",
            "securityUpdateAvailable": true
        },
        {
            "id": "00044f912345baf756462bde6db733b9a9c56ad4_.net_framework_4.0.0.0__",
            "deviceId": "00044f912345daf756462bde6db733b6a9c59ad4",
            "rbacGroupName": "hhh",
            "deviceName": "ComputerPII_18663b45912eed224b2be2f5ea3142726e63f16a.DomainPII_21eeb80b086e79bdfa178eabfa25e8de6acfa346.corp.contoso.com",
            "osPlatform": "Windows10" "Windows11",
            "osVersion": "10.0.17763.1637",
            "osArchitecture": "x64",
            "softwareVendor": "microsoft",
            "softwareName": ".net_framework",
            "softwareVersion": "4.0.0.0",
            "cveId": null,
            "vulnerabilitySeverityLevel": null,
            "recommendedSecurityUpdate": null,
            "recommendedSecurityUpdateId": null,
            "recommendedSecurityUpdateUrl": null,
            "diskPaths": [],
            "registryPaths": [
                "SOFTWARE\\Microsoft\\NET Framework Setup\\NDP\\v4.0\\Client\\Install"
            ],
            "lastSeenTimestamp": "2020-12-30 13:18:33",
            "firstSeenTimestamp": "2020-12-30 11:07:15",
            "exploitabilityLevel": "NoExploit",
            "recommendationReference": "va-_-microsoft-_-.net_framework",
            "securityUpdateAvailable": true
        },
        {
            "id": "00044f912345baf756462dbe6db733d6a9c59ab4_system_center_2012_endpoint_protection_4.10.209.0__",
            "deviceId": "00044f912345daf756462bde6db733b6a9c59ab4",
            "rbacGroupName": "hhh",
            "deviceName": "ComputerPII_18663b45912eed224b2be2f5ea3142726e63f16a.DomainPII_21eed80b089e79bdfa178eadfa25e8be6acfa346.corp.contoso.com",
            "osPlatform": "Windows10" "Windows11",
            "osVersion": "10.0.17763.1637",
            "osArchitecture": "x64",
            "softwareVendor": "microsoft",
            "softwareName": "system_center_2012_endpoint_protection",
            "softwareVersion": "4.10.209.0",
            "cveId": null,
            "vulnerabilitySeverityLevel": null,
            "recommendedSecurityUpdate": null,
            "recommendedSecurityUpdateId": null,
            "recommendedSecurityUpdateUrl": null,
            "diskPaths": [],
            "registryPaths": [
                "HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\Microsoft Security Client"
            ],
            "lastSeenTimestamp": "2020-12-30 14:17:26",
            "firstSeenTimestamp": "2020-12-30 11:07:15",
            "exploitabilityLevel": "NoExploit",
            "recommendationReference": "va-_-microsoft-_-system_center_2012_endpoint_protection",
            "securityUpdateAvailable": true
        },
        {
            "id": "00044f612345bdaf759462dbe6bd733b6a9c59ab4_onedrive_20.245.1206.2__",
            "deviceId": "00044f91234daf759492dbe6bd733b6a9c59ab4",
            "rbacGroupName": "hhh",
            "deviceName": "ComputerPII_189663d45612eed224b2be2f5ea3142729e63f16a.DomainPII_21eed80b086e79bdfa178eadfa25e8de6acfa346.corp.contoso.com",
            "osPlatform": "Windows10" "Windows11",
            "osVersion": "10.0.17763.1637",
            "osArchitecture": "x64",
            "softwareVendor": "microsoft",
            "softwareName": "onedrive",
            "softwareVersion": "20.245.1206.2",
            "cveId": null,
            "vulnerabilitySeverityLevel": null,
            "recommendedSecurityUpdate": null,
            "recommendedSecurityUpdateId": null,
            "recommendedSecurityUpdateUrl": null,
            "diskPaths": [],
            "registryPaths": [
                "HKEY_USERS\\S-1-5-21-2944539346-1310925172-2349113062-1001\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\OneDriveSetup.exe"
            ],
            "lastSeenTimestamp": "2020-12-30 13:18:33",
            "firstSeenTimestamp": "2020-12-30 11:07:15",
            "exploitabilityLevel": "NoExploit",
            "recommendationReference": "va-_-microsoft-_-onedrive",
            "securityUpdateAvailable": true
        },
        {
            "id": "00044f912345daf759462bde6db733b6a9c56ab4_windows_10_10.0.17763.1637__",
            "deviceId": "00044f912345daf756462dbe6db733d6a9c59ab4",
            "rbacGroupName": "hhh",
            "deviceName": "ComputerPII_18663b45912eeb224d2be2f5ea3142729e63f16a.DomainPII_21eeb80d086e79bdfa178eadfa25e8de6acfa346.corp.contoso.com",
            "osPlatform": "Windows10" "Windows11",
            "osVersion": "10.0.17763.1637",
            "osArchitecture": "x64",
            "softwareVendor": "microsoft",
            "softwareName": "windows_10" "Windows_11",
            "softwareVersion": "10.0.17763.1637",
            "cveId": null,
            "vulnerabilitySeverityLevel": null,
            "recommendedSecurityUpdate": null,
            "recommendedSecurityUpdateId": null,
            "recommendedSecurityUpdateUrl": null,
            "diskPaths": [],
            "registryPaths": [],
            "lastSeenTimestamp": "2020-12-30 14:17:26",
            "firstSeenTimestamp": "2020-12-30 11:07:15",
            "exploitabilityLevel": "NoExploit",
            "recommendationReference": "va-_-microsoft-_-windows_10" "va-_-microsoft-_-windows_11",
            "securityUpdateAvailable": true
        }
    ],
    "@odata.nextLink": "https://api.security.microsoft.com/api/machines/SoftwareVulnerabilitiesByMachine?pagesize=5&$skiptoken=eyJFeHBvcnREZWZpbml0aW9uIjp7IlRpbWVQYXRoIjoiMjAyMS0wMS0xMS8xMTAxLyJ9LCJFeHBvcnRGaWxlSW5kZXgiOjAsIkxpbmVTdG9wcGVkQXQiOjV9"
}

2. Yazılım güvenlik açıklarını değerlendirmeyi dışarı aktarma (dosyalar aracılığıyla)

2.1 API yöntemi açıklaması

Bu API yanıtı, cihaz başına yüklü yazılımların tüm verilerini içerir. DeviceId, SoftwareVendor, SoftwareName, SoftwareVersion, CVEID'nin her benzersiz bileşimi için bir giriş içeren bir tablo döndürür.

2.1.2 Sınırlamaları

Bu API için hız sınırlamaları dakikada 5 çağrı ve saatte 20 çağrıdır.

2.2 İzinler

Bu API'yi çağırmak için aşağıdaki izinlerden biri gereklidir. İzinlerin nasıl seçileceği de dahil olmak üzere daha fazla bilgi edinmek için ayrıntılar için bkz. Uç Nokta için Microsoft Defender API'lerini kullanma.

İzin türü İzin İzin görünen adı
Uygulama Vulnerability.Read.All 'Tehdit ve Güvenlik Açığı Yönetimi güvenlik açığı bilgilerini okuyun'
Temsilci (iş veya okul hesabı) Vulnerability.Read 'Tehdit ve Güvenlik Açığı Yönetimi güvenlik açığı bilgilerini okuyun'

2.3 URL

GET /api/machines/SoftwareVulnerabilitiesExport

2.4 Parametreler

  • sasValidHours: İndirme URL'lerinin geçerli olduğu saat sayısı. Maksimum değer 6 saattir.

2.5 Özellikleri

  • Dosyalar, çok satırlı JSON biçiminde GZIP sıkıştırılmış &.
  • parametresi kullanılmadığı sürece sasValidHours indirme URL'leri 1 saat boyunca geçerlidir.
  • Verilerinizin en yüksek indirme hızı için, verilerinizin bulunduğu aynı Azure bölgeden indirme yaptığınızdan emin olabilirsiniz.
  • Her kayıt 1 KB veridir. Sizin için doğru pageSize parametresini seçerken bunu dikkate almanız gerekir.
  • Yanıtta bazı ek sütunlar döndürülebilir. Bu sütunlar geçicidir ve kaldırılabilir, bu nedenle yalnızca belgelenmiş sütunları kullanın.
Özellik (Kimlik) Veri türü Açıklama Döndürülen değer örneği
Dosyaları dışarı aktarma array[string] Kuruluşun geçerli anlık görüntüsünü içeren dosyalar için indirme URL'lerinin listesi. ["https://tvmexportstrstgeus.blob.core.windows.net/tvm-export...1", "https://tvmexportstrstgeus.blob.core.windows.net/tvm-export...2"]
GeneratedTime Dize Dışarı aktarmanın oluşturulduğu zaman. 2021-05-20T08:00:00Z

2.6 Örnekler

2.6.1 İstek örneği

GET https://api.security.microsoft.com/api/machines/SoftwareVulnerabilitiesExport

2.6.2 Yanıt örneği

{
    "@odata.context": "https://api.security.microsoft.com/api/$metadata#microsoft.windowsDefenderATP.api.ExportFilesResponse",
    "exportFiles": [
        "https://tvmexportstrstgeus.blob.core.windows.net/tvm-export/2021-01-11/1101/VaExport/json/OrgId=12345678-195f-4223-9c7a-99fb420fd000/part-00393-bcc26c4f-e531-48db-9892-c93ac5d72d5c.c000.json.gz?sv=2019-12-12&st=2021-01-11T11%3A35%3A13Z&se=2021-01-11T14%3A35%3A13Z&sr=b&sp=r&sig=...",
        "https://tvmexportstrstgeus.blob.core.windows.net/tvm-export/2021-01-11/1101/VaExport/json/OrgId=12345678-195f-4223-9c7a-99fb420fd000/part-00393-bcc26c4f-e531-48db-9892-c93ac5d72d5c.c001.json.gz?sv=2019-12-12&st=2021-01-11T11%3A35%3A13Z&se=2021-01-11T14%3A35%3A13Z&sr=b&sp=r&sig=...",
        "https://tvmexportstrstgeus.blob.core.windows.net/tvm-export/2021-01-11/1101/VaExport/json/OrgId=12345678-195f-4223-9c7a-99fb420fd000/part-00393-bcc26c4f-e531-48db-9892-c93ac5d72d5c.c002.json.gz?sv=2019-12-12&st=2021-01-11T11%3A35%3A13Z&se=2021-01-11T14%3A35%3A13Z&sr=b&sp=r&sig=..."
    ],
    "generatedTime": "2021-01-11T11:01:00Z"
}

3. Delta dışarı aktarma yazılımı güvenlik açıkları değerlendirmesi (JSON yanıtı)

3.1 API yöntemi açıklaması

DeviceId, SoftwareVendor, SoftwareName, SoftwareVersion, CveId'nin her benzersiz bileşimi için bir giriş içeren bir tablo döndürür. API, kuruluşunuzdaki verileri Json yanıtları olarak çeker. Yanıt sayfalandırılmış olduğundan, sonraki sonuçları getirmek için yanıttan alınan alanı kullanabilirsiniz @odata.nextLink . Cihazınıza göre kuruluşunuzun yazılım güvenlik açıkları değerlendirmesinin tüm anlık görüntüsünü almak için kullanılan tam yazılım güvenlik açıkları değerlendirmesinin (JSON yanıtı) aksine, delta dışarı aktarma JSON yanıt API çağrısı yalnızca seçilen tarih ile geçerli tarih ("delta" API çağrısı) arasında gerçekleşen değişiklikleri getirmek için kullanılır. Her seferinde büyük miktarda veriyle tam dışarı aktarma almak yerine yalnızca yeni, sabit ve güncelleştirilmiş güvenlik açıkları hakkında belirli bilgiler alırsınız. Delta dışarı aktarma JSON yanıt API'si çağrısı, "kaç güvenlik açığı düzeltildi?" veya "Kuruluşuma kaç yeni güvenlik açığı eklendi?" gibi farklı KPI'leri hesaplamak için de kullanılabilir.

TamYazılım Güvenlik Açıkları Değerlendirmesi'ni (Düz/Tam VA) Cihaz her altı saatte bir dışarı aktararak yeniler ve her anlık görüntüyü blob depolamada depolarız. API her zaman en son anlık görüntüye hizmet eder; Uç Noktayı Al çağrısının bir nesli tetiklemeyeceğini vurgular, çağrı alma uç noktası yalnızca sinceTime'dan sonra en son Düz VEYA Delta'yı okur.

Tam VA dışarı aktarma işleminin başarıyla tamamlanması, Delta tarafından işlenen en son Düz VA'dan yeni Düz VA'ya yapılan değişiklikleri yakalayan delta dışarı aktarmayı tetikler.

RBAC kapsamlı yinelemeler:

Dışarı aktarmaların kapsamı RBACGroup tarafından belirlenmiştir. Bir RBAC grubundan diğerine taşınan bir cihaz, genel görünümle () sorguladığınızda Delta dışarı aktarmada RBACGroup=*, bir kez "Düzeltildi" durumuyla önceki grubunun altında ve bir kez de "Yeni" durumuyla geçerli grubunun altında görüntülenir. rbacGroupId Cihaz başına tek bir yetkili kayda ihtiyacınız varsa ve cihaz tanımlayıcılarını birlikte kullanın (veya sizin tarafınızda yinelenenleri kaldırın).

  1. Temel – Tercih ettiğiniz tempoda tam VA (Düz VA) dışarı aktarmayı indirin (haftalık genellikle yeterlidir).

  2. Güncel kalın – tam anlık görüntüler arasında delta dışarı aktarma (Delta geçmişte 14 güne kadar sorgulanabilir).

  3. RBAC taşımalarını işleme – Delta işlenirken, aynı Id(deviceId_software_ _ cve)sürümünün birden çok rbacGroupId değer altında göründüğü girişlerin yinelenenlerini kaldırın.

  4. "Durum" = Düzeltildiğinde" "EventTimestamp"- "FirstSeenTimestamp" hesaplaması, CVE'nin 6 saatlik ayrıntı düzeyine (Delta çalışanı çalıştırma aralığı nedeniyle) ne zaman düzeltildiğine ilişkin bir tahminde bulunmalıdır.

3.1.1 Sınırlamaları

  • En büyük sayfa boyutu 200.000'dir.
  • sinceTime parametresi en fazla 14 güne sahiptir.
  • Bu API için hız sınırlamaları dakikada 30 çağrı ve saatte 1.000 çağrıdır.

3.2 İzinler

Bu API'yi çağırmak için aşağıdaki izinlerden biri gereklidir. İzinlerin nasıl seçileceği de dahil olmak üzere daha fazla bilgi edinmek için ayrıntılar için bkz. Uç Nokta için Microsoft Defender API'lerini kullanma.

İzin türü İzin İzin görünen adı
Uygulama Vulnerability.Read.All 'Tehdit ve Güvenlik Açığı Yönetimi güvenlik açığı bilgilerini okuyun'
Temsilci (iş veya okul hesabı) Vulnerability.Read 'Tehdit ve Güvenlik Açığı Yönetimi güvenlik açığı bilgilerini okuyun'

3.3 URL

GET /api/machines/SoftwareVulnerabilityChangesByMachine

3.4 Parametreler

  • sinceTime (gerekli): Veri değişikliklerini görmek istediğiniz başlangıç saati. Güvenlik açığı yönetimi her 6 saatte bir yeni ve güncelleştirilmiş güvenlik açıklarıyla ilgili veriler oluşturur. Döndürülen veriler, belirtilen sinceTime'ın düştüğü 6 saatlik dönemde yakalanan tüm değişiklikleri ve en son oluşturulan verileri içeren sonraki 6 saatlik dönemlerdeki değişiklikleri içerir.
  • pageSize (varsayılan = 50.000): yanıt olarak sonuç sayısı.
  • $top: döndürülecek sonuç sayısı (döndürmez @odata.nextLink ve bu nedenle tüm verileri çekmez).

3.5 Özellikleri

Döndürülen her kayıt, cihaz API'sine göre tam dışarı aktarma yazılımı güvenlik açıkları değerlendirmesinin tüm verilerinin yanı sıra iki alan daha içerir: EventTimestamp ve Status.

  • Yanıtta başka bazı sütunlar döndürülebilir. Bu sütunlar geçicidir ve kaldırılabilir, bu nedenle yalnızca belgelenmiş sütunları kullanın.
  • Aşağıdaki tabloda tanımlanan özellikler, özellik kimliğine göre alfabetik olarak listelenir. Bu API'yi çalıştırırken, sonuçta elde edilen çıktının bu tabloda listelenen sırayla döndürülmesi gerekmez.
Özellik (Kimlik) Veri türü Açıklama Döndürülen değer örneği
CveId Dize Ortak Güvenlik Açıkları ve Etkilenmeler (CVE) sistemi altında güvenlik açığına atanan benzersiz tanımlayıcı. CVE-2020-15992
CvssScore Çift CVE'nin CVSS puanı. 6.2
Deviceıd Dize Hizmetteki cihaz için benzersiz tanımlayıcı. 9eaf3a8b5962e0e6b1af9ec756664a9b823df2d1
DeviceName Dize Cihazın tam etki alanı adı (FQDN). johnlaptop.europe.contoso.com
DiskPath'ler Dizi[dize] Ürünün cihaza yüklendiğini gösteren disk kanıtı. ["C:\Program Files (x86)\Microsoft\Silverlight\Application\silverlight.exe"]
EventTimestamp Dize Bu delta olayının bulunduğu saat. 2020-11-03 10:13:34.8476880
ExploitabilityLevel Dize Bu güvenlik açığının kötüye kullanılabilirlik düzeyi (NoExploit, ExploitIsPublic, ExploitIsVerified, ExploitIsInKit) ExploitIsInKit
IsOnboarded Boole Bir cihazın eklenip eklenmediğini gösterir. Olası değerler true veya false olabilir.
FirstSeenTimestamp Dize Bu ürünün CVE'i cihazda ilk kez görüldü. 2020-11-03 10:13:34.8476880
Kimlik Dize Kayıt için benzersiz tanımlayıcı. 123ABG55_573AG&mnp!
LastSeenTimestamp Dize Yazılımın cihazda son bildirildiği zaman. 2020-11-03 10:13:34.8476880
OSPlatform Dize Cihazda çalışan işletim sisteminin platformu; Windows 10 ve Windows 11 gibi aynı aile içindeki varyasyonlara sahip belirli işletim sistemleri. Ayrıntılar için desteklenen Microsoft Defender Güvenlik Açığı Yönetimi işletim sistemlerine ve platformlara bakın. Windows10 ve Windows 11
RbacGroupName Dize Rol tabanlı erişim denetimi (RBAC) grubu. Bu cihaz herhangi bir RBAC grubuna atanmamışsa, değer "Atanmamış" olur. Sunucular
RecommendationReference dize Bu yazılımla ilgili öneri kimliğine başvuru. va--microsoft--silverlight
RecommendedSecurityUpdate Dize Güvenlik açığını gidermek için yazılım satıcısı tarafından sağlanan güvenlik güncelleştirmesinin adı veya açıklaması. Nisan 2020 Güvenlik Güncelleştirmeler
RecommendedSecurityUpdateId Dize İlgili kılavuz veya bilgi bankası (KB) makaleleri için geçerli güvenlik güncelleştirmelerinin veya tanımlayıcısının tanımlayıcısı 4550961
RegistryPaths Dizi[dize] Ürünün cihaza yüklendiğine dair kayıt defteri kanıtı. ["HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\Google Chrome"]
SoftwareName Dize Yazılım ürününün adı. Chrome
SoftwareVendor Dize Yazılım satıcısının adı. Google
SoftwareVersion Dize Yazılım ürününün sürüm numarası. 81.0.4044.138
Durum Dize Yeni (bir cihazda sunulan yeni bir güvenlik açığı için) (1) Düzeltildi (bu güvenlik açığı cihazda artık yoksa, bu da düzeltildiği anlamına gelir). (2) Güncelleştirildi (cihazdaki bir güvenlik açığı değiştiyse). Olası değişiklikler şunlardır: CVSS puanı, kötüye kullanılabilirlik düzeyi, önem düzeyi, DiskPaths, RegistryPaths, RecommendedSecurityUpdate). Sabit
VulnerabilitySeverityLevel Dize Güvenlik açığına atanan ve CVSS puanını temel alan önem düzeyi. Orta

Açıklamalar

  • Yazılım sürüm 1.0'dan sürüm 2.0'a güncelleştirildiyse ve her iki sürüm de CVE-A'ya açıksa, iki ayrı olay alırsınız:

    1. Düzeltildi: Sürüm 1.0'da CVE-A düzeltildi.
    2. Yeni: Sürüm 2.0'da CVE-A eklendi.

  • Belirli bir güvenlik açığı (örneğin CVE-A) ilk olarak sürüm 1.0'a sahip yazılımlarda belirli bir zamanda (örneğin, 10 Ocak) görülmüşse ve birkaç gün sonra bu yazılım aynı CVE-A'ya da kullanıma sunulan sürüm 2.0'a güncelleştirildiyse, şu iki ayrı olayı alırsınız:

    1. Düzeltildi: CVE-X, FirstSeenTimestamp Ocak 10, sürüm 1.0.
    2. Yeni: CVE-X, FirstSeenTimestamp Ocak 10, sürüm 2.0.

3.6 Örnekler

3.6.1 İstek örneği

GET https://api.security.microsoft.com/api/machines/SoftwareVulnerabilityChangesByMachine?pageSize=5&sinceTime=2021-05-19T18%3A35%3A49.924Z

3.6.2 Yanıt örneği

{
    "@odata.context": "https://api.security.microsoft.com/api/$metadata#Collection(microsoft.windowsDefenderATP.api.DeltaAssetVulnerability)",
    "value": [
        {
            "id": "008198251234544f7dfa715e278d4cec0c16c171_chrome_87.0.4280.88__",
            "deviceId": "008198251234544f7dfa715e278b4cec0c19c171",
            "rbacGroupName": "hhh",
            "deviceName": "ComputerPII_1c8fee370690ca24b6a0d3f34d193b0424943a8b8.DomainPII_0dc1aee0fa366d175e514bd91a9e7a5b2b07ee8e.corp.contoso.com",
            "osPlatform": "Windows10" "Windows11",
            "osVersion": "10.0.19042.685",
            "osArchitecture": "x64",
            "softwareVendor": "google",
            "softwareName": "chrome",
            "softwareVersion": "87.0.4280.88",
            "cveId": null,
            "vulnerabilitySeverityLevel": null,
            "recommendedSecurityUpdate": null,
            "recommendedSecurityUpdateId": null,
            "recommendedSecurityUpdateUrl": null,
            "diskPaths": [
                "C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe"
            ],
            "registryPaths": [
                "HKEY_LOCAL_MACHINE\\SOFTWARE\\WOW6432Node\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\Google Chrome"
            ],
            "lastSeenTimestamp": "2021-01-04 00:29:42",
            "firstSeenTimestamp": "2020-11-06 03:12:44",
            "exploitabilityLevel": "NoExploit",
            "recommendationReference": "va-_-google-_-chrome",
            "status": "Fixed",
            "eventTimestamp": "2020-11-03 10:13:34.8476880"
        },
        {
            "id": "00e59c61234533860738ecf488eec8abf296e41e_onedrive_20.64.329.3__",
            "deviceId": "00e56c91234533860738ecf488eec8abf296e41e",
            "rbacGroupName": "hhh",
            "deviceName": "ComputerPII_82c13a8ad8cf3dbaf7bf34fada9fa3aebc124116.DomainPII_21eeb80d086e79dbfa178eadfa25e8de9acfa346.corp.contoso.com",
            "osPlatform": "Windows10" "Windows11",
            "osVersion": "10.0.18363.1256",
            "osArchitecture": "x64",
            "softwareVendor": "microsoft",
            "softwareName": "onedrive",
            "softwareVersion": "20.64.329.3",
            "cveId": null,
            "vulnerabilitySeverityLevel": null,
            "recommendedSecurityUpdate": null,
            "recommendedSecurityUpdateId": null,
            "recommendedSecurityUpdateUrl": null,
            "diskPaths": [],
            "registryPaths": [
                "HKEY_USERS\\S-1-5-21-2127521184-1604012920-1887927527-24918864\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\OneDriveSetup.exe"
            ],
            "lastSeenTimestamp": "2020-12-11 19:49:48",
            "firstSeenTimestamp": "2020-12-07 18:25:47",
            "exploitabilityLevel": "NoExploit",
            "recommendationReference": "va-_-microsoft-_-onedrive",
            "status": "Fixed",
            "eventTimestamp": "2020-11-03 10:13:34.8476880"
        },
        {
            "id": "01aa8c73095bb12345918663f3f94ce322107d24_firefox_83.0.0.0_CVE-2020-26971_",
            "deviceId": "01aa8c73065bb12345918693f3f94ce322107d24",
            "rbacGroupName": "hhh",
            "deviceName": "ComputerPII_42684eb981bea2d670027e7ad2caafd3f2b381a3.DomainPII_21eed80b086e76dbfa178eabfa25e8de9acfa346.corp.contoso.com",
            "osPlatform": "Windows10" "Windows11",
            "osVersion": "10.0.19042.685",
            "osArchitecture": "x64",
            "softwareVendor": "mozilla",
            "softwareName": "firefox",
            "softwareVersion": "83.0.0.0",
            "cveId": "CVE-2020-26971",
            "vulnerabilitySeverityLevel": "High",
            "recommendedSecurityUpdate": "193220",
            "recommendedSecurityUpdateId": null,
            "recommendedSecurityUpdateUrl": null,
            "diskPaths": [
                "C:\\Program Files (x86)\\Mozilla Firefox\\firefox.exe"
            ],
            "registryPaths": [
                "HKEY_LOCAL_MACHINE\\SOFTWARE\\WOW6432Node\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\Mozilla Firefox 83.0 (x86 en-US)"
            ],
            "lastSeenTimestamp": "2021-01-05 17:04:30",
            "firstSeenTimestamp": "2020-05-06 12:42:19",
            "exploitabilityLevel": "NoExploit",
            "recommendationReference": "va-_-mozilla-_-firefox",
            "status": "Fixed",
            "eventTimestamp": "2020-11-03 10:13:34.8476880"
        },
        {
            "id": "026f0fcb12345fbd2decd1a339702131422d362e_project_16.0.13701.20000__",
            "deviceId": "029f0fcb13245fbd2decd1a336702131422d392e",
            "rbacGroupName": "hhh",
            "deviceName": "ComputerPII_a5706750acba75f15d69cd17f4a7fcd268d6422c.DomainPII_f290e982685f7e8eee168b4332e0ae5d2a069cd6.corp.contoso.com",
            "osPlatform": "Windows10" "Windows11",
            "osVersion": "10.0.19042.685",
            "osArchitecture": "x64",
            "softwareVendor": "microsoft",
            "softwareName": "project",
            "softwareVersion": "16.0.13701.20000",
            "cveId": null,
            "vulnerabilitySeverityLevel": null,
            "recommendedSecurityUpdate": null,
            "recommendedSecurityUpdateId": null,
            "recommendedSecurityUpdateUrl": null,
            "diskPaths": [],
            "registryPaths": [
                "HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\ProjectProRetail - en-us"
            ],
            "lastSeenTimestamp": "2021-01-03 23:38:03",
            "firstSeenTimestamp": "2019-08-01 22:56:12",
            "exploitabilityLevel": "NoExploit",
            "recommendationReference": "va-_-microsoft-_-project",
            "status": "Fixed",
            "eventTimestamp": "2020-11-03 10:13:34.8476880"
        },
        {
            "id": "038df381234510b357ac19d0113ef622e4e212b3_chrome_81.0.4044.138_CVE-2020-16011_",
            "deviceId": "038df381234510d357ac19b0113ef922e4e212b3",
            "rbacGroupName": "hhh",
            "deviceName": "ComputerPII_365f5c0bb7202c163937dad3d017969b2d760eb4.DomainPII_29596a43a2ef2bbfa00f6a16c0cb1d108bc63e32.DomainPII_3c5fefd2e6fda2f36257359404f6c1092aa6d4b8.net",
            "osPlatform": "Windows10" "Windows11",
            "osVersion": "10.0.18363.1256",
            "osArchitecture": "x64",
            "softwareVendor": "google",
            "softwareName": "chrome",
            "softwareVersion": "81.0.4044.138",
            "cveId": "CVE-2020-16011",
            "vulnerabilitySeverityLevel": "High",
            "recommendedSecurityUpdate": "ADV 200002",
            "recommendedSecurityUpdateId": null,
            "recommendedSecurityUpdateUrl": null,
            "diskPaths": [
                "C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe"
            ],
            "registryPaths": [
                "HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\{C4EBFDFD-0C55-3E5F-A919-E3C54949024A}"
            ],
            "lastSeenTimestamp": "2020-12-10 22:45:41",
            "firstSeenTimestamp": "2020-07-26 02:13:43",
            "exploitabilityLevel": "NoExploit",
            "recommendationReference": "va-_-google-_-chrome",
            "status": "Fixed",
            "eventTimestamp": "2020-11-03 10:13:34.8476880"
        }
    ],
    "@odata.nextLink": "https://wpatdadi-eus-stg.cloudapp.net/api/machines/SoftwareVulnerabilitiesTimeline?sincetime=2021-01-11&pagesize=5&$skiptoken=eyJFeHBvcnREZWZpbml0aW9uIjp7IlRpbWVQYXRoIjoiMjAyMS0wMS0xMS8xMTAxLyJ9LCJFeHBvcnRGaWxlSW5kZXgiOjAsIkxpbmVTdG9wcGVkQXQiOjV9"
}
  • Last updated on