Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Descrizione DELL'API
Dispositivo offboard da Defender per endpoint.
Prerequisiti
Sistemi operativi supportati
| Sistema operativo | Versioni supportate |
|---|---|
| Client Windows | Windows 11 e Windows 10, versione 1703 e successive |
| Windows Server | Windows Server 2019 e successivi; Windows Server 2012 R2 e Windows Server 2016 quando si utilizza il nuovo agente unificato per Defender for Endpoint |
| macOS | macOS 14 e successivi |
| Linux | Distribuzioni Linux supportate |
Limitazioni
- Le limitazioni di frequenza per questa API sono 100 chiamate al minuto e 1.500 chiamate all'ora.
- Sui dispositivi Windows, eseguire l'API di offboarding interrompe solo il servizio sensore. Non rimuove le informazioni di onboarding dal registro come fa uno script di offboarding.
Autorizzazioni
Microsoft consiglia di usare i ruoli con il minor numero di autorizzazioni. Ciò consente di migliorare la sicurezza per l'organizzazione. Amministratore globale è un ruolo con privilegi elevati che deve essere limitato agli scenari di emergenza quando non è possibile usare un ruolo esistente.
Quando si ottiene un token usando le credenziali utente:
All'utente deve essere assegnato un ruolo appropriato. Per altre informazioni, vedere: Opzioni di autorizzazione.
L'utente deve avere accesso al dispositivo, in base alle impostazioni del gruppo di dispositivi. Per altre informazioni, vedere : Creare e gestire gruppi di dispositivi.
Per chiamare questa API è necessaria una delle autorizzazioni seguenti. Per altre informazioni, incluso come scegliere le autorizzazioni, vedere Usare le API di Defender per endpoint
| Tipo di autorizzazione | Autorizzazione | Nome visualizzato autorizzazioni |
|---|---|---|
| Applicazione | Machine.Offboard |
Offboard machine |
| Delegato (account aziendale o dell'istituto di istruzione) | Machine.Offboard |
Offboard machine |
Richiesta HTTP
POST https://api.security.microsoft.com/api/machines/{id}/offboard
L'ID computer è disponibile nell'URL quando si seleziona il dispositivo. In genere, è un numero alfanumerico a 40 cifre che si trova nell'URL.
Intestazioni di richiesta
| Nome | Tipo | Descrizione |
|---|---|---|
| Autorizzazione | Stringa | Connessione {token}. Obbligatorio. |
| Content-Type | stringa | application/json. Obbligatorio. |
Corpo della richiesta
Nel corpo della richiesta specificare un oggetto JSON con i parametri seguenti:
| Parametro | Tipo | Descrizione |
|---|---|---|
| Comment | Stringa | Commento da associare all'azione. Obbligatorio. |
Risposta
Se ha esito positivo, questo metodo restituisce 200 - Created response codice e Machine Action nel corpo della risposta.
Esempio
Richiesta
Ecco un esempio della richiesta. Se non è stato aggiunto alcun commento JSON, viene eseguito un errore con il codice 400.
POST https://api.security.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/offboard
{
"Comment": "Offboard machine by automation"
}