Cihaz başına yazılım envanteri değerlendirmeyi dışarı aktarma

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

Bu API, cihaz başına ortak platform numaralandırması (CPE) olan yüklü yazılım için tüm verileri 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 iki yolu vardır:

  • Yazılım envanteri değerlendirmesi JSON yanıtını dışarı aktarma: 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.

  • Dosyalar aracılığıyla yazılım envanteri değerlendirmesini dışarı aktarma: Bu API çözümü, daha fazla miktarda veriyi daha hızlı ve daha güvenilir bir şekilde çekmenizi sağlar ve 100 K'den fazla cihazı olan büyük kuruluşlar için ö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.

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 envanteri değerlendirmeyi dışarı aktarma (JSON yanıtı)

1.1 API yöntemi açıklaması

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

Bu API tarafından döndürülen bilgiler ve CPE'ye sahip olmayan yazılımlar için Ürün kodu olmayan yazılım envanteri değerlendirme API'sinin verdiği bilgiler, kuruluşunuzda yüklü olan yazılım ve yüklü olduğu cihazlar hakkında tam görünürlük sağlar.

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 Software.Read.All 'Tehdit ve Güvenlik Açığı Yönetimi yazılım bilgilerini okuyun'
Temsilci (iş veya okul hesabı) Software.Read 'Tehdit ve Güvenlik Açığı Yönetimi yazılım bilgilerini okuyun'

1.3 URL

GET /api/machines/SoftwareInventoryByMachine

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 0,5 KB veridir. Sizin için doğru pageSize parametresini seçerken bu boyutu dikkate almanız gerekir.
  • 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.
  • 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.

Özellik (Kimlik) Veri türü Açıklama Döndürülen değer örneği
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"]
EndOfSupportDate dize Bu yazılım için desteğin bulunduğu veya desteğin sona erdiği tarih. 2020-12-30
EndOfSupportStatus dize Destek sonu durumu. Şu olası değerleri içerebilir: Yok, EOS Sürümü, Yaklaşan EOS Sürümü, EOS Yazılımı, Yaklaşan EOS Yazılımı. Yaklaşan EOS
NumberOfWeaknesses Int Bu cihazdaki bu yazılımdaki zayıflıkların sayısı 3
OSPlatform dize Cihazda çalışan işletim sisteminin platformu. Bunlar, Windows 10 ve Windows 11 gibi aynı aile içinde varyasyonları olan belirli işletim sistemleridir. 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
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\Microsoft Silverlight"]
SoftwareFirstSeenTimestamp dize Bu yazılım cihazda ilk kez görüldü. 2019-04-07 02:06:47
SoftwareName dize Yazılım ürününün adı. Silverlight
SoftwareVendor dize Yazılım satıcısının adı. Microsoft
SoftwareVersion dize Yazılım ürününün sürüm numarası. 81.0.4044.138

1.6 Örnekler

1.6.1 İstek örneği

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

1.6.2 Yanıt örneği

{
    "@odata.context": "https://api.security.microsoft.com/api/$metadata#Collection(contoso.windowsDefenderATP.api.AssetSoftware)",
    "value": [
        {
            "deviceId": "00044f68765bbaf712342dbe6db733b6a9c59ab4",
            "rbacGroupName": "hhh",
            "deviceName": "ComputerPII_18993b45912eeb224b2be2f5ea3142726e63f16a.DomainPII_21eeb80d086e79dbfa178eadfa25e8de9acfa346.corp.contoso.com",
            "osPlatform": "Windows10" "Windows11",
            "softwareVendor": "microsoft",
            "softwareName": "windows_10" "Windows_11",
            "softwareVersion": "10.0.17763.1637",
            "numberOfWeaknesses": 58,
            "diskPaths": [],
            "registryPaths": [],
            "softwareFirstSeenTimestamp": "2020-12-30 11:07:15",
            "endOfSupportStatus": "Upcoming EOS Version",
            "endOfSupportDate": "2021-05-11T00:00:00+00:00"
        },
        {
            "deviceId": "00044f68765bbaf712342dbe6db733b6a9c59ab4",
            "rbacGroupName": "hhh",
            "deviceName": "ComputerPII_18993b45912eeb224b2be2f5ea3142726e63f16a.DomainPII_21eeb80d086e79dbfa178eadfa25e8de9acfa346.corp.contoso.com",
            "osPlatform": "Windows10" "Windows11",
            "softwareVendor": "microsoft",
            "softwareName": ".net_framework",
            "softwareVersion": "4.0.0.0",
            "numberOfWeaknesses": 0,
            "diskPaths": [],
            "registryPaths": [
                "SOFTWARE\\Microsoft\\NET Framework Setup\\NDP\\v4.0\\Client\\Install"
            ],
            "softwareFirstSeenTimestamp": "2020-12-30 11:07:15",
            "endOfSupportStatus": "None",
            "endOfSupportDate": null
        },
        {
            "deviceId": "00044f68765bbaf712342dbe6db733b6a9c59ab4",
            "rbacGroupName": "hhh",
            "deviceName": "ComputerPII_18993b45912eeb224b2be2f5ea3142726e63f16a.DomainPII_21eed80d086e79bdfa178eadfa25e8de9acfa346.corp.contoso.com",
            "osPlatform": "Windows10" "Windows11",
            "softwareVendor": "microsoft",
            "softwareName": "system_center_2012_endpoint_protection",
            "softwareVersion": "4.7.214.0",
            "numberOfWeaknesses": 0,
            "diskPaths": [],
            "registryPaths": [
                "HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\Microsoft Security Client"
            ],
            "softwareFirstSeenTimestamp": "2020-12-30 11:07:15",
            "endOfSupportStatus": "None",
            "endOfSupportDate": null
        },
        {
            "deviceId": "00044f68765ddaf71234bde6bd733d6a9c59ad4",
            "rbacGroupName": "hhh",
            "deviceName": "ComputerPII_18993b45912eeb224b2be2f5ea3142726e63f16a.DomainPII_21eeb80d086e79dbfa178aedfa25e8be9acfa346.corp.contoso.com",
            "osPlatform": "Windows10" "Windows11",
            "softwareVendor": "microsoft",
            "softwareName": "configuration_manager",
            "softwareVersion": "5.0.8634.1000",
            "numberOfWeaknesses": 0,
            "diskPaths": [],
            "registryPaths": [
                "HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\{B7D3A842-E826-4542-B39B-1D883264B279}"
            ],
            "softwareFirstSeenTimestamp": "2020-12-30 11:07:15",
            "endOfSupportStatus": "None",
            "endOfSupportDate": null
        },
        {
            "deviceId": "00044f38765bbaf712342dbe6db733b6a9c59ab4",
            "rbacGroupName": "hhh",
            "deviceName": "ComputerPII_18993b45912eeb224b2de2f5ea3142726e63f16a.DomainPII_21eeb80d086e79bdfa178eadfa25e8be9acfa346.corp.contoso.com",
            "osPlatform": "Windows10" "Windows11",
            "softwareVendor": "microsoft",
            "softwareName": "system_center_2012_endpoint_protection",
            "softwareVersion": "4.10.209.0",
            "numberOfWeaknesses": 0,
            "diskPaths": [],
            "registryPaths": [
                "HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\Microsoft Security Client"
            ],
            "softwareFirstSeenTimestamp": "2020-12-30 11:07:15",
            "endOfSupportStatus": "None",
            "endOfSupportDate": null
        }
    ],
    "@odata.nextLink": "https://api.security.microsoft.com/api/machines/SoftwareInventoryByMachine?pagesize=5&$skiptoken=eyJFeHBvcnREZWZpbml0aW9uIjp7IlRpbWVQYXRoIjoiMjAyMS0wMS0yNS8wMjAwLyJ9LCJFeHBvcnRGaWxlSW5kZXgiOjAsIkxpbmVTdG9wcGVkQXQiOjV9"
}

2. Yazılım envanteri 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'ın her benzersiz bileşimi için bir giriş içeren bir tablo döndürür.

2.1.1 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 Software.Read.All 'Tehdit ve Güvenlik Açığı Yönetimi yazılım bilgilerini okuyun'
Temsilci (iş veya okul hesabı) Software.Read 'Tehdit ve Güvenlik Açığı Yönetimi yazılım bilgilerini okuyun'

2.3 URL

GET /api/machines/SoftwareInventoryExport

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.
Ö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ü tutan 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/SoftwareInventoryExport

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/SoftwareInventory/json/OrgId=12345678-195f-4223-9c7a-99fb420fd000/part-00393-e423630d-4c69-4490-8769-a4f5468c4f25.c000.json.gz?sv=2019-12-12&st=2021-01-11T11%3A55%3A51Z&se=2021-01-11T14%3A55%3A51Z&sr=b&sp=r&sig=...",
        "https://tvmexportstrstgeus.blob.core.windows.net/tvm-export/2021-01-11/1101/SoftwareInventory/json/OrgId=12345678-195f-4223-9c7a-99fb420fd000/part-00394-e423630d-4c69-4490-8769-a4f5468c4f25.c000.json.gz?sv=2019-12-12&st=2021-01-11T11%3A55%3A51Z&se=2021-01-11T14%3A55%3A51Z&sr=b&sp=r&sig=...",
        "https://tvmexportstrstgeus.blob.core.windows.net/tvm-export/2021-01-11/1101/SoftwareInventory/json/OrgId=12345678-195f-4223-9c7a-99fb420fd000/part-00394-e423630d-4c69-4490-8769-a4f5468c4f25.c001.json.gz?sv=2019-12-12&st=2021-01-11T11%3A55%3A51Z&se=2021-01-11T14%3A55%3A51Z&sr=b&sp=r&sig=..."
    ],
    "generatedTime": "2021-01-11T11:01:00Z"
}
  • Last updated on