Raccogli i log dei dati di contesto organizzativo di Microsoft Entra ID (in precedenza Azure Active Directory)
Versione parser: 12.0
Questo documento spiega come raccogliere i dati di contesto dell'organizzazione di Microsoft Entra ID (in precedenza Azure Active Directory) configurando un feed di Google Security Operations utilizzando l'API di terze parti.
Il contesto organizzativo di Microsoft Entra ID fornisce informazioni sulla directory, come utenti, gruppi e dispositivi, dal tuo tenant di Microsoft Entra ID. Non si tratta di dati di eventi o log, ma di un'istantanea periodica dello stato della directory che arricchisce altri tipi di log in Google SecOps con il contesto dell'identità.
Prima di iniziare
Assicurati di soddisfare i seguenti prerequisiti:
- Un'istanza Google SecOps
- Accesso con privilegi al portale di Microsoft Azure
- Uno dei seguenti ruoli per concedere il consenso dell'amministratore:
- Amministratore globale: può concedere il consenso per qualsiasi autorizzazione, per qualsiasi API
- Amministratore dei ruoli con privilegi: può concedere il consenso per qualsiasi autorizzazione, per qualsiasi API
Configura la lista consentita IP
Prima di creare il feed, devi aggiungere gli intervalli IP di Google SecOps nelle impostazioni della rete Microsoft Azure o nei criteri di accesso condizionale. Questo è importante se l'origine dati applica limitazioni basate su IP. Se il feed restituisce un errore 403, verifica che la lista consentita sia attiva. Per limitare l'accesso a un intervallo più ristretto, apri un ticket di assistenza.
Per saperne di più, consulta Lista consentita IP.
Ottieni gli intervalli IP di Google SecOps
- Vai a Impostazioni > Gestione dei dati > Feed. Se utilizzi una piattaforma solo SIEM, vai a Impostazioni > Feed.
- Fai clic su Aggiungi nuovo feed di notizie.
- Prendi nota degli intervalli IP visualizzati nell'interfaccia di creazione del feed.
- In alternativa, recupera gli intervalli IP in modo programmatico utilizzando l'API Feed Management.
Configura l'accesso condizionale per le identità dei workload (se necessario)
Se la tua organizzazione utilizza policy di accesso condizionale che limitano l'accesso in base alla località, segui questi passaggi:
- Nella piattaforma di amministrazione Microsoft Entra, vai a Protezione > Accesso condizionale > Località denominate.
- Fai clic su + Nuova località.
- Fornisci i seguenti dettagli di configurazione:
- Nome: inserisci
Google SecOps IP Ranges. - Contrassegna come località attendibile: facoltativo, in base alla policy di sicurezza.
- Intervalli IP: aggiungi ogni intervallo IP di Google SecOps nella notazione CIDR.
- Nome: inserisci
- Fai clic su Crea.
- Vai a Conditional Access (Accesso condizionale) > Policies (Criteri).
- Per tutte le policy che si applicano alle Workload Identity, configura un'esclusione per la località denominata
Google SecOps IP Rangeso per l'entità servizio specifica.
Configura la registrazione dell'app Microsoft Entra
Crea registrazione app
- Accedi all'interfaccia di amministrazione di Microsoft Entra o al portale di Azure.
- Vai a Identity (Identità) > Applications (Applicazioni) > App registrations (Registrazioni app).
- Fai clic su Nuova registrazione.
- Fornisci i seguenti dettagli di configurazione:
- Nome: inserisci un nome descrittivo (ad esempio
Google SecOps Entra ID Context Integration). - Tipi di account supportati: seleziona Solo account in questa directory dell'organizzazione (singolo tenant).
- URI di reindirizzamento: lascia vuoto (non richiesto per l'autenticazione del service principal).
- Nome: inserisci un nome descrittivo (ad esempio
- Fai clic su Register (Registrati).
- Dopo la registrazione, copia e salva i seguenti valori:
- ID applicazione (client)
- ID directory (tenant)
Configura le autorizzazioni API
Il feed legge la directory utente tramite l'endpoint List users di Microsoft Graph, con il manager di ogni utente espanso. Concedi all'applicazione le autorizzazioni corrispondenti alle opzioni del feed che attivi.
- Nella registrazione dell'app, vai ad API permissions (Autorizzazioni API).
- Fai clic su Aggiungi un'autorizzazione.
- Seleziona Microsoft Graph > Application permissions (Autorizzazioni applicazione).
- Cerca e seleziona le seguenti autorizzazioni:
- User.Read.All: obbligatorio. Legge i profili utente e la relazione con il gestore che il feed importa.
- Group.Read.All: solo se imposti Retrieve groups (Recupera gruppi) su True nel feed. Legge i gruppi restituiti per l'appartenenza di ogni utente.
- Device.Read.All: solo se imposti Recupera dispositivi su Vero nel feed. Legge i dispositivi associati a ciascun utente.
- Fai clic su Aggiungi autorizzazioni.
- Fai clic su Concedi il consenso amministratore per la tua organizzazione.
Verifica che la colonna Stato mostri Concesso per la tua organizzazione per tutte le autorizzazioni.
Autorizzazione Tipo Quando richiesto User.Read.All Applicazione Sempre Group.Read.All Applicazione Recupera gruppi è Vero Device.Read.All Applicazione Recupera dispositivi è Vero
Crea un client secret
- Nella registrazione dell'app, vai a Certificates & secrets (Certificati e secret).
- Fai clic su Nuovo client secret.
Fornisci i seguenti dettagli di configurazione:
- Descrizione: inserisci un nome descrittivo (ad esempio
Google SecOps Feed). - Scadenza: seleziona un periodo di scadenza.
- Descrizione: inserisci un nome descrittivo (ad esempio
Fai clic su Aggiungi.
Copia immediatamente il valore del client secret.
Verifica l'accesso all'API prima di creare il feed
Verifica che la registrazione dell'app possa ottenere un token di accesso e leggere gli utenti da Microsoft Graph. Il test utilizza le stesse credenziali e gli stessi endpoint del feed. Eseguilo in una shell che abbia curl e jq, ad esempio Cloud Shell.
Imposta l'ID tenant e l'ID client e inserisci il client secret quando richiesto:
TENANT_ID="TENANT_ID" CLIENT_ID="CLIENT_ID" printf "Client secret: "; read -rs CLIENT_SECRET; echoSostituisci quanto segue:
TENANT_ID: l'ID directory (tenant) della registrazione dell'app.CLIENT_ID: l'ID applicazione (client) della registrazione dell'app.
Al prompt, incolla il valore del client secret. Il secret non viene mostrato e non viene salvato nella cronologia della shell.
Richiedi un token di accesso:
TOKEN_RESPONSE=$(curl -sS "https://login.microsoftonline.com/${TENANT_ID}/oauth2/v2.0/token" \ --data-urlencode "grant_type=client_credentials" \ --data-urlencode "client_id=${CLIENT_ID}" \ --data-urlencode "client_secret=${CLIENT_SECRET}" \ --data-urlencode "scope=https://graph.microsoft.com/.default") echo "${TOKEN_RESPONSE}" | jq 'del(.access_token)' ACCESS_TOKEN=$(echo "${TOKEN_RESPONSE}" | jq -r '.access_token // empty')La richiesta di token deve essere un HTTP POST con un corpo codificato nel modulo.
--data-urlencodelo invia in questo modo e codifica caratteri come+o&nel secret. Se la richiesta ha esito positivo, l'output mostra"token_type": "Bearer". Se l'operazione non riesce, l'output mostraerror_descriptioncon un codice di erroreAADSTS.Leggi un utente con il suo gestore da Microsoft Graph:
curl -sS -w "\nHTTP %{http_code}\n" \ -H "Authorization: Bearer ${ACCESS_TOKEN}" \ "https://graph.microsoft.com/beta/users?\$top=1&\$expand=manager"Se la richiesta ha esito positivo, l'output termina con
HTTP 200e l'arrayvaluecontiene un utente.
Risolvi gli errori di autenticazione
Se la richiesta del token non va a buon fine, individua il codice AADSTS in error_description:
- AADSTS7000215 (client secret non valido): utilizza il valore del client secret, non l'ID secret. Se non hai più il valore, crea un nuovo client secret.
- AADSTS7000222 (client secret scaduto): crea un nuovo client secret e aggiorna il client secret OAuth nel feed.
- AADSTS700016 (applicazione non trovata nella directory): l'ID client è errato o l'ID tenant appartiene a un altro tenant. Confronta entrambi i valori con la pagina Panoramica della registrazione dell'app.
- AADSTS90002 (tenant non trovato): l'ID tenant è errato o l'endpoint di autenticazione appartiene a un altro cloud.
- AADSTS900144 (il corpo della richiesta deve contenere un parametro): la richiesta non è un POST con codifica del modulo o manca un parametro. Esegui il comando come mostrato.
- AADSTS53003 (bloccato dall'accesso condizionale): una policy di accesso condizionale per le Workload Identity blocca l'app. Consulta Configura l'accesso condizionale per le Workload Identity.
Se la richiesta di Microsoft Graph non va a buon fine:
- HTTP 401: la richiesta non aveva un token di accesso valido. Controlla prima l'output della richiesta del token.
- HTTP 403: il consenso dell'amministratore per User.Read.All non è stato concesso. Concedila come descritto in Configura le autorizzazioni API. Le autorizzazioni fanno parte del token, quindi richiedi un nuovo token dopo aver concesso il consenso.
Se il test ha esito positivo, ma l'autenticazione del feed continua a non riuscire, inserisci nuovamente il valore del client secret in Client secret OAuth. Verifica che l'ID tenant e l'ID client OAuth corrispondano ai valori che hai testato. Verifica che l'endpoint di autenticazione API non abbia il prefisso https:// e nessun percorso.
Configura un feed in Google SecOps per importare i dati di contesto organizzativo di Microsoft Entra ID
Per configurare il feed:
- Vai a Impostazioni > Gestione dei dati > Feed. Se utilizzi una piattaforma solo SIEM, vai a Impostazioni > Feed.
- Fai clic su Aggiungi nuovo feed di notizie.
- Nella pagina successiva, fai clic su Configura un singolo feed.
- Nel campo Nome feed, inserisci un nome per il feed (ad es.
Azure AD Organizational Context). - Seleziona API di terze parti come Tipo di origine.
- Seleziona Azure AD Organizational Context (Contesto organizzativo di Azure AD) come Log type (Tipo di log).
- Fai clic su Avanti.
Specifica i valori per i seguenti parametri di input:
- ID client OAuth: inserisci l'ID applicazione (client) della registrazione dell'app.
- OAuth Client Secret (Client secret OAuth): inserisci il valore del client secret che hai copiato in precedenza.
- ID tenant: inserisci l'ID directory (tenant) dalla registrazione dell'app in formato UUID (ad esempio,
0fc279f9-fe30-41be-97d3-abe1d7681418). - Recupera dispositivi: seleziona se recuperare le informazioni sui dispositivi nel contesto utente. Imposta su True per includere i dati del dispositivo.
- Recupera gruppi: seleziona se recuperare le informazioni sull'iscrizione ai gruppi nel contesto utente. Imposta su True per includere i dati del gruppo.
Percorso completo dell'API: URL dell'endpoint API REST di Microsoft Graph:
graph.microsoft.com/beta
Endpoint di autenticazione API: endpoint di autenticazione Microsoft Entra ID:
login.microsoftonline.com
Opzioni avanzate:
- Spazio dei nomi dell'asset: lo spazio dei nomi dell'asset.
- Etichette di importazione: l'etichetta da applicare agli eventi di questo feed.
Fai clic su Avanti.
Controlla la nuova configurazione del feed di notizie nella schermata Finalizza, quindi fai clic su Invia.
Endpoint regionali
Per i deployment di Microsoft Entra ID in Sovereign Cloud, utilizza gli endpoint regionali appropriati:
| Ambiente cloud | Percorso completo dell'API | Endpoint di autenticazione API |
|---|---|---|
| Global | graph.microsoft.com/beta |
login.microsoftonline.com |
| US Government L4 | graph.microsoft.us/beta |
login.microsoftonline.us |
| US Government L5 (DOD) | dod-graph.microsoft.us/beta |
login.microsoftonline.us |
| Cina (21Vianet) | microsoftgraph.chinacloudapi.cn/beta |
login.chinacloudapi.cn |
Tabella di mappatura UDM
| Campo log | Mappatura UDM | Logica |
|---|---|---|
extension_wfc_AccountType |
entity.labels.value |
Mappatura diretta |
extension_wfc_AccountingUnitName |
entity.labels.value |
Mappatura diretta |
extension_wfc_execDescription |
entity.labels.value |
Mappatura diretta |
extension_wfc_groupDescription |
entity.labels.value |
Mappatura diretta |
extension_wfc_orgDescription |
entity.labels.value |
Mappatura diretta |
createdDateTime |
entity.user.attribute.creation_time |
Analizzato come RFC3339 |
sign_in_type |
entity.user.attribute.labels.key |
Mappatura diretta |
assignedLicense.skuId |
entity.user.attribute.labels.value |
Mappatura diretta |
employeeType |
entity.user.attribute.labels.value |
Mappatura diretta |
empmanager-src.usageLocation |
entity.user.attribute.labels.value |
Mappatura diretta |
externalUserState |
entity.user.attribute.labels.value |
Mappatura diretta |
gopher-manager.onPremisesImmutableId |
entity.user.attribute.labels.value |
Mappatura diretta |
mailNickname |
entity.user.attribute.labels.value |
Mappatura diretta |
onPremisesDistinguishedName |
entity.user.attribute.labels.value |
Mappatura diretta |
onPremisesDomainName |
entity.user.attribute.labels.value |
Mappatura diretta |
onPremisesExtensionAttributes.extensionAttribute4 |
entity.user.attribute.labels.value |
Mappatura diretta |
onPremisesImmutableId |
entity.user.attribute.labels.value |
Mappatura diretta |
onPremisesSamAccountName |
entity.user.attribute.labels.value |
Mappatura diretta |
refreshTokensValidFromDateTime |
entity.user.attribute.labels.value |
Mappatura diretta |
token_date_time |
entity.user.attribute.labels.value |
Mappatura diretta |
userPrincipalName |
entity.user.attribute.labels.value |
Mappatura diretta |
user_ou_data |
entity.user.attribute.labels.value |
Mappatura diretta |
userType |
entity.user.attribute.roles.name |
Mappatura diretta |
user_ou_data |
entity.user.attribute.roles.type |
Mappatura: Admin → ADMINISTRATOR, Service Accounts → SERVICE_ACCOUNT |
department |
entity.user.department |
Unita |
mail |
entity.user.email_addresses |
Unita |
proxyAddress |
entity.user.email_addresses |
Mappatura: smtp/SMTP → proxyAddress |
userPrincipalName |
entity.user.email_addresses |
Unita |
employeeId |
entity.user.employee_id |
Rinominato/mappato |
extension_employeeNumber |
entity.user.employee_id |
Rinominato/mappato |
onPremisesDomainName |
entity.user.group_identifiers |
Unita |
proxyAddress |
entity.user.group_identifiers |
Unita |
sign_in_type_manager |
entity.user.managers.attribute.labels.key |
Mappatura diretta |
temp |
entity.user.managers.attribute.labels.key |
Mappatura: true → manager accountEnabled |
empmanager-src.sbuxCompanyCode |
entity.user.managers.attribute.labels.value |
Mappatura diretta |
empmanager-src.sbuxCostCenter |
entity.user.managers.attribute.labels.value |
Mappatura diretta |
empmanager-src.sbuxDirectorySync |
entity.user.managers.attribute.labels.value |
Mappatura diretta |
empmanager-src.sbuxEmployeeStatus |
entity.user.managers.attribute.labels.value |
Mappatura diretta |
empmanager-src.sbuxEmployeeType |
entity.user.managers.attribute.labels.value |
Mappatura diretta |
empmanager-src.sbuxFullName |
entity.user.managers.attribute.labels.value |
Mappatura diretta |
empmanager-src.sbuxFullNameAKA |
entity.user.managers.attribute.labels.value |
Mappatura diretta |
empmanager-src.sbuxFullNameAKAAlt |
entity.user.managers.attribute.labels.value |
Mappatura diretta |
empmanager-src.sbuxFullNameAlt |
entity.user.managers.attribute.labels.value |
Mappatura diretta |
empmanager-src.sbuxGivenNameAlt |
entity.user.managers.attribute.labels.value |
Mappatura diretta |
empmanager-src.sbuxGlobalID |
entity.user.managers.attribute.labels.value |
Mappatura diretta |
empmanager-src.sbuxJobNumber |
entity.user.managers.attribute.labels.value |
Mappatura diretta |
empmanager-src.sbuxKnownAs |
entity.user.managers.attribute.labels.value |
Mappatura diretta |
empmanager-src.sbuxKnownAsAlt |
entity.user.managers.attribute.labels.value |
Mappatura diretta |
empmanager-src.sbuxLocalMarket |
entity.user.managers.attribute.labels.value |
Mappatura diretta |
empmanager-src.sbuxLocalMarketEmployeeID |
entity.user.managers.attribute.labels.value |
Mappatura diretta |
empmanager-src.sbuxManagerImmutableID |
entity.user.managers.attribute.labels.value |
Mappatura diretta |
empmanager-src.sbuxManagerNumber |
entity.user.managers.attribute.labels.value |
Mappatura diretta |
empmanager-src.sbuxOnTLA |
entity.user.managers.attribute.labels.value |
Mappatura diretta |
empmanager-src.sbuxOrgAreaID |
entity.user.managers.attribute.labels.value |
Mappatura diretta |
empmanager-src.sbuxOrgDistrictID |
entity.user.managers.attribute.labels.value |
Mappatura diretta |
empmanager-src.sbuxOrgDivisionID |
entity.user.managers.attribute.labels.value |
Mappatura diretta |
empmanager-src.sbuxOrgRegionID |
entity.user.managers.attribute.labels.value |
Mappatura diretta |
empmanager-src.sbuxOrgShortName |
entity.user.managers.attribute.labels.value |
Mappatura diretta |
empmanager-src.sbuxOrgStoreID |
entity.user.managers.attribute.labels.value |
Mappatura diretta |
empmanager-src.sbuxOrgType |
entity.user.managers.attribute.labels.value |
Mappatura diretta |
empmanager-src.sbuxOrgUnit |
entity.user.managers.attribute.labels.value |
Mappatura diretta |
empmanager-src.sbuxSnAlt |
entity.user.managers.attribute.labels.value |
Mappatura diretta |
empmanager-src.sbuxSourceSystem |
entity.user.managers.attribute.labels.value |
Mappatura diretta |
empmanager-src.userPrincipalName |
entity.user.managers.attribute.labels.value |
Mappatura diretta |
manager_ou_data |
entity.user.managers.attribute.labels.value |
Mappatura diretta |
temp |
entity.user.managers.attribute.labels.value |
Mappatura diretta |
manager_user_type |
entity.user.managers.attribute.roles.name |
Mappatura diretta |
manager_ou_data |
entity.user.managers.attribute.roles.type |
Mappatura: Users → ADMINISTRATOR, Service Accounts → SERVICE_ACCOUNT |
empmanager-src.companyName |
entity.user.managers.company_name |
Rinominato/mappato |
empmanager-src.department |
entity.user.managers.department |
Unita |
empProxyAddress |
entity.user.managers.email_addresses |
Mappatura: smtp/SMTP → empProxyAddress |
empmanager-src.mail |
entity.user.managers.email_addresses |
Unita |
principal_name |
entity.user.managers.email_addresses |
Unita |
empmanager-src.employeeId |
entity.user.managers.employee_id |
Rinominato/mappato |
empmanager-src.extension_employeeNumber |
entity.user.managers.employee_id |
Rinominato/mappato |
empmanager-src.givenName |
entity.user.managers.first_name |
Rinominato/mappato |
empProxyAddress |
entity.user.managers.group_identifiers |
Unita |
empmanager-src.surname |
entity.user.managers.last_name |
Rinominato/mappato |
empmanager-src.city |
entity.user.managers.personal_address.city |
Rinominato/mappato |
country_n_code |
entity.user.managers.personal_address.country_or_region |
Mappatura diretta |
empmanager-src.streetAddress |
entity.user.managers.personal_address.name |
Rinominato/mappato |
empmanager-src.state |
entity.user.managers.personal_address.state |
Rinominato/mappato |
empmanager-src.businessPhones.0 |
entity.user.managers.phone_numbers |
Unita |
empmanager-src.id |
entity.user.managers.product_object_id |
Rinominato/mappato |
empmanager-src.jobTitle |
entity.user.managers.title |
Rinominato/mappato |
empmanager-src.displayName |
entity.user.managers.user_display_name |
Rinominato/mappato |
empmanager-src.sAMAccountName |
entity.user.managers.userid |
Rinominato/mappato |
empmanager-src.onPremisesSecurityIdentifier |
entity.user.managers.windows_sid |
Rinominato/mappato |
country |
entity.user.personal_address.country_or_region |
Mappatura diretta |
usageLocation |
entity.user.personal_address.country_or_region |
Mappatura diretta |
phoneNumber |
entity.user.phone_numbers |
Unita |
onPremisesSamAccountName |
entity.user.userid |
Rinominato/mappato |
sAMAccountName |
entity.user.userid |
Rinominato/mappato |
gopher-device-item.createdDateTime |
metadata.event_timestamp |
Analizzato come RFC3339 |
| N/D | entity.labels.key |
Costante: wfc_AccountType |
| N/D | entity.user.attribute.labels.key |
Costante: gopher-manager onPremisesImmutableId |
| N/D | entity.user.attribute.roles.type |
Costante: SERVICE_ACCOUNT |
| N/D | entity.user.managers.attribute.labels.key |
Costante: manager accountEnabled |
| N/D | entity.user.managers.attribute.roles.type |
Costante: SERVICE_ACCOUNT |
| N/D | entity.user.user_authentication_status |
Costante: ACTIVE |
| N/D | metadata.entity_type |
Costante: USER |
| N/D | metadata.event_metadata.log_type |
Costante: AZURE_AD_CONTEXT |
| N/D | metadata.product_name |
Costante: Azure Active Directory |
| N/D | metadata.vendor_name |
Costante: Microsoft |
Log delle modifiche
Visualizza il log delle modifiche per questo parser
Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.