Gépi bejelentkezési felhasználói API lekérése

API-leírás

Egy adott eszközön bejelentkezett felhasználók gyűjteményét kéri le.

Korlátozások

• A riasztásokat a konfigurált megőrzési időszaknak megfelelően frissítheti.
• Az API sebességkorlátozásai percenként 100 hívás és óránként 1500 hívás.

Engedélyek

Jogkivonat felhasználói hitelesítő adatokkal történő beszerzésekor:

• A felhasználónak legalább a következő szerepköri engedéllyel kell rendelkeznie: "Adatok megtekintése". További információ: Szerepkörök létrehozása és kezelése.
• A válasz csak akkor tartalmazza a felhasználókat, ha az eszköz látható a felhasználó számára az eszközcsoport beállításai alapján. További információ: Eszközcsoportok létrehozása és kezelése.

Az API meghívásához az alábbi engedélyek egyikére van szükség. További információ, többek között az engedélyek kiválasztása: Végponthoz készült Microsoft Defender API-k használata

Engedély típusa	Engedély	Engedély megjelenítendő neve
Alkalmazás	User.Read.All	"Felhasználói profilok olvasása"
Delegált (munkahelyi vagy iskolai fiók)	User.Read.All	"Felhasználói profilok olvasása"

HTTP-kérés

GET /api/machines/{id}/logonusers

Kérelemfejlécek

Name (Név)	Típus	Leírás
Felhatalmazás	Karakterlánc	Tulajdonos : {token}. Kötelező megadni.

Kérelem törzse

Üres

Válasz

Ha sikeres, és az eszköz létezik – 200 OK a törzsben lévő felhasználói entitások listájával. Ha az eszköz nem található – 404 Nem található.

Példa

Kérés

Íme egy példa a kérésre.

GET https://api.security.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/logonusers

Válasz

Íme egy példa a válaszra.

HTTP/1.1 200 OK
Content-type: application/json
{
    "@odata.context": "https://api.security.microsoft.com/api/$metadata#Users",
    "value": [
        {
            "id": "contoso\\user1",
            "accountName": "user1",
            "accountDomain": "contoso",
            "firstSeen": "2019-12-18T08:02:54Z",
            "lastSeen": "2020-01-06T08:01:48Z",
            "logonTypes": "Interactive",
            "isDomainAdmin": true,
            "isOnlyNetworkUser": false
        },
        ...
    ]
}