Ottieni il contesto dell'applicazione e dell'utente finale per gli avvisi di IA

Microsoft Defender per il cloud la protezione dalle minacce per i servizi di intelligenza artificiale consente di migliorare l'utilità e il valore di sicurezza degli avvisi di intelligenza artificiale generati fornendo sia l'utente finale che il contesto dell'applicazione.

La maggior parte degli scenari di servizio di intelligenza artificiale viene compilata come parte di un'applicazione, quindi le chiamate API al servizio di intelligenza artificiale provengono da un'applicazione Web, un'istanza di calcolo o un gateway di intelligenza artificiale. Questa architettura mediata dalle applicazioni introduce complessità perché gli investigatori mancano di contesto quando esaminano le richieste di IA per determinare l'applicazione aziendale o l'utente finale coinvolto.

Insieme, Microsoft Defender per il cloud e Azure'intelligenza artificiale consentono di aggiungere parametri alle chiamate API di intelligenza artificiale Azure in modo che Defender per il cloud sia in grado di acquisire il contesto critico dell'utente finale o dell'applicazione negli avvisi di intelligenza artificiale. Catturare il contesto dell'utente finale e dell'applicazione negli avvisi AI porta a un trio e risultati più efficaci. Ad esempio, quando si aggiunge l'indirizzo IP o l'identità dell'utente finale, è possibile bloccare l'utente o correlare eventi imprevisti e avvisi da parte dell'utente. Quando si aggiunge il contesto dell'applicazione, è possibile definire la priorità o determinare se il comportamento sospetto è standard per tale applicazione nell'organizzazione.

Screenshot del portale di Defender XDR che mostra i vantaggi derivanti dall'aggiunta di code.

Prerequisiti

Aggiungere parametri di sicurezza alla chiamata di Azure OpenAI

Per ricevere avvisi di sicurezza IA con più contesto, è possibile aggiungere uno o tutti i parametri UserSecurityContext di esempio seguenti alle chiamate dell'API Azure OpenAI.

Tutti i campi in UserSecurityContext sono facoltativi.

Per il contesto dell’utente finale, consigliamo di passare come minimo i campi EndUserId e SourceIP. I campi EndUserId e SourceIP forniscono agli analisti del Centro operazioni per la sicurezza (SOC) la possibilità di analizzare incidenti di sicurezza che coinvolgono risorse IA e applicazioni IA generative.

Per il contesto dell'applicazione, passare il applicationName campo come stringa semplice.

Se il nome di un campo UserSecurityContext è scritto erroneamente, la chiamata API di Azure OpenAI ha comunque successo.

Note

EndUserId è l'ID oggetto utente di Microsoft Entra (in precedenza Azure Active Directory) usato per autenticare gli utenti finali all'interno dell'applicazione di intelligenza artificiale generativa. Informazioni personali sensibili non dovrebbero essere incluse in questo campo.

Schema di UserSecurityContext

Lo schema esatto è disponibile nella documentazione di riferimento dell'API REST OpenAI di Azure.

L'oggetto contesto di sicurezza dell'utente fa parte del corpo della richiesta dell'API di completamento della chat.

Attualmente non è supportata l'aggiunta UserSecurityContext di parametri per l'arricchimento di Defender per il cloud Alert quando si applicano modelli distribuiti tramite l'API di inferenza dei modelli AI di Azure.

API supportate e versioni SDK

La tabella seguente elenca le API supportate e le versioni SDK per UserSecurityContext.

Source Supporto delle versioni Esempio di codice Comments
API REST di Azure OpenAI Versione 2025-01-01 - -
AZURE .NET SDK v2.2.0-beta.1 (2025-02-07) o versione successiva Esempio di codice GitHub -
AZURE PYTHON SDK v1.61.1 o versione successiva Esempio di codice GitHub Il supporto viene fornito mediante aggiunta all'oggetto extra_body.
Azure JS/Node SDK v4.83.0 o versione successiva Esempio di codice GitHub Il supporto viene fornito mediante aggiunta all'oggetto extra_body.
Azure Go SDK v0.7.2 o versione successiva - -

Passo successivo