Integra Microsoft Entra ID con Google SecOps
Questo documento fornisce indicazioni su come integrare Microsoft Entra ID con Google Security Operations.
Questa integrazione utilizza uno o più componenti open source. Puoi scaricare una copia compressa del codice sorgente completo di questa integrazione dal bucket Cloud Storage.
Casi d'uso
L'integrazione di Microsoft Entra ID con Google SecOps può aiutarti a risolvere i seguenti casi d'uso:
Gestione degli account utente: automatizza la disattivazione e l'attivazione degli account utente in Microsoft Entra ID in base agli eventi di sicurezza, come la sospetta compromissione o l'offboarding dei dipendenti.
Reimpostazione della password: orchestra le reimpostazioni della password per gli account compromessi o per gli utenti bloccati fuori dai propri account. La reimpostazione delle password può aiutarti a semplificare la procedura di recupero delle password e a ridurre i ticket di assistenza.
Gestione dei gruppi: automatizza la creazione, la modifica e l'eliminazione dei gruppi Microsoft Entra ID.
Applicazione delle policy di accesso condizionale: utilizza le policy di accesso condizionale di Microsoft Entra ID all'interno dei playbook di Google SecOps per controllare dinamicamente l'accesso in base al contesto e consentire un controllo granulare sull'accesso alle risorse in base a fattori quali posizione, dispositivo e rischio dell'utente.
Avvisi di sicurezza e risposta agli incidenti: integra gli avvisi di sicurezza di Microsoft Entra ID in Google SecOps per automatizzare i flussi di lavoro di risposta agli incidenti.
Prima di iniziare
Prima di configurare l'integrazione in Google SecOps, verifica di soddisfare i seguenti requisiti nel tuo ambiente Microsoft:
Registrazione dell'app Azure: registra un'applicazione nel centro di amministrazione di Microsoft Entra per ottenere un ID client e un ID tenant. Per istruzioni dettagliate, consulta Registra un'applicazione in Microsoft Entra ID.
Autorizzazioni API e assegnazioni dei ruoli: concedi le autorizzazioni Microsoft Graph o i ruoli Microsoft Entra richiesti in base alle azioni che prevedi di eseguire e se hai bisogno di limiti di accesso a livello di tenant o con ambito.
Client secret: genera un client secret nella sezione Certificati e secret dell'applicazione registrata. Copia immediatamente il valore del secret (non l'ID secret), poiché Microsoft Entra ID lo visualizza una sola volta.
Configura le autorizzazioni API
Concedi solo le autorizzazioni dell'applicazione Microsoft Graph richieste per il tuo modello di deployment e concedi il consenso dell'amministratore. Per le istruzioni, consulta la documentazione di Microsoft per configurare le autorizzazioni dell'applicazione.
- Azioni di sola lettura (tutti i deployment): concedi
Directory.Read.All. - Azioni di scrittura a livello di tenant (predefinita): concedi le autorizzazioni dell'applicazione Microsoft Graph per l'accesso a livello di tenant dalla tabella seguente per le azioni di scrittura che prevedi di eseguire.
- Azioni di scrittura con ambito (limitate a utenti o gruppi specifici): concedi
solo le autorizzazioni in lettura (
Directory.Read.Alle, facoltativamente,AuditLog.Read.All). Non concedere autorizzazioni di scrittura per l'applicazione. Assegna invece i ruoli della directory Accesso limitato della tabella seguente utilizzando un'unità amministrativa.
| Funzionalità e azioni | Accesso a livello di tenant (autorizzazione dell'applicazione Microsoft Graph) | Accesso limitato (ruolo della directory Microsoft Entra) |
|---|---|---|
Lettura e arricchimento della directory di base (obbligatorio per tutte le azioni) Ping, Enrich User, Enrich Host, Get Manager Contact Details, Is User in Group, List Groups, List Members in the Group, List User's Groups Membership e List Users |
Directory.Read.All (o User.Read.All,
GroupMember.Read.All e Device.Read.All) |
Richiede Directory.Read.All (o il ruolo Directory Readers) nell'ambito del tenant per risolvere gli oggetti della directory. |
MFA and sign-in enrichment (Optional) Obbligatorio solo quando attivi |
AuditLog.Read.All |
Richiede AuditLog.Read.All nell'ambito tenant. |
Gestione dello stato dell'account Disabilita account e Abilita account |
User.EnableDisableAccount.All (o User.ReadWrite.All) |
Helpdesk Administrator o User Administrator. |
Gestione delle password Forza aggiornamento password e Reimposta password utente |
User-PasswordProfile.ReadWrite.All e il ruolo Directory Password Administrator |
Password Administrator, Helpdesk Administrator o User Administrator. |
Revoca della sessione Revoca sessione utente |
User.RevokeSessions.All (o User.ReadWrite.All) |
Authentication Administrator o
User Administrator. |
Gestione dell'iscrizione ai gruppi Aggiungi utente a un gruppo e Rimuovi utente dal gruppo |
GroupMember.ReadWrite.All (o Group.ReadWrite.All) |
Groups Administrator o User Administrator
(l'unità amministrativa deve contenere i gruppi di destinazione). |
Assegna un ruolo a livello di tenant per le azioni relative alle password
Se utilizzi le autorizzazioni di Microsoft Graph a livello di tenant e prevedi di eseguire Forza l'aggiornamento della password o Reimposta la password utente, devi anche assegnare il ruolo di directory Password Administrator alla tua applicazione registrata nell'ambito del tenant. Per istruzioni, consulta la documentazione di Microsoft per
assegnare i ruoli di Microsoft Entra.
Ambito delle autorizzazioni e limiti di accesso
Google SecOps si autentica in Microsoft Graph utilizzando il flusso delle credenziali client OAuth 2.0 e non filtra le azioni per gruppo o unità organizzativa dopo l'autenticazione. Microsoft Entra ID applica tutti i limiti di accesso direttamente:
- Le autorizzazioni dell'applicazione
.Allsono sempre a livello di tenant: le autorizzazioni dell'applicazione Microsoft Graph che terminano con.All(ad esempioUser.ReadWrite.AlloGroup.ReadWrite.All) concedono l'accesso all'intero tenant e non possono essere limitate a un gruppo o a un'unità amministrativa specifici. - L'assegnazione degli utenti alle applicazioni Enterprise non limita l'ambito dell'API: l'attivazione di Assegnazione obbligatoria o l'assegnazione di utenti e gruppi a un'applicazione Enterprise controlla solo gli accessi degli utenti interattivi. Non limita gli oggetti della directory che l'entità servizio dell'applicazione può modificare tramite Microsoft Graph.
Limita le azioni di scrittura utilizzando un'unità amministrativa
Completa questi passaggi solo se vuoi limitare le azioni di scrittura a un sottoinsieme specifico di utenti o gruppi anziché all'intero tenant:
- Concedi solo le autorizzazioni di lettura per l'applicazione: concedi solo
Directory.Read.All(e facoltativamenteAuditLog.Read.All) alla registrazione dell'applicazione. Rimuovi eventuali autorizzazioni di scrittura.Allper le applicazioni (ad esempioUser.ReadWrite.AlloGroup.ReadWrite.All), perché le autorizzazioni per le applicazioni a livello di tenant sostituiscono i limiti delle unità amministrative. - Crea e compila un'unità amministrativa: crea un'unità amministrativa in Microsoft Entra ID e aggiungi gli oggetti della directory di destinazione che Google SecOps è autorizzato a modificare:
- Aggiungi utenti target per limitare le azioni utente (Disabilita account, Abilita account, Forza aggiornamento password, Reimposta password utente e Revoca sessione utente).
- Aggiungi gruppi di destinazione per limitare le azioni di iscrizione ai gruppi (Aggiungi utente a un gruppo e Rimuovi utente dal gruppo). L'aggiunta di un gruppo consente all'integrazione di modificare solo l'appartenenza a quel gruppo. Non concede l'autorizzazione per gestire gli account utente all'interno del gruppo, a meno che questi utenti non vengano aggiunti direttamente anche all'unità amministrativa.
- Assegna ruoli della directory con ambito: assegna i ruoli richiesti dalla colonna Accesso con ambito della tabella delle autorizzazioni API alla tua applicazione registrata con l'ambito limitato alla tua unità amministrativa. Per istruzioni, consulta la documentazione di Microsoft per assegnare i ruoli di Microsoft Entra.
Parametri di integrazione
L'integrazione di Microsoft Entra ID richiede i seguenti parametri:
| Parametro | Descrizione |
|---|---|
Login API Root |
Optional
La radice dell'API utilizzata per l'autenticazione con Microsoft Identity Platform. Il valore predefinito è |
API Root |
Optional
La radice dell'API dell'istanza di Azure Active Directory. Il valore predefinito è |
Client ID |
Obbligatorio
Il valore dell'ID applicazione (client) del tuo account Microsoft Entra ID. |
Client Secret |
Obbligatorio
Il valore del client secret del tuo account Microsoft Entra ID. |
Directory ID |
Obbligatorio
Il valore dell'ID directory (tenant) del tuo account Microsoft Entra ID. |
Verify SSL |
Optional
Se selezionata, l'integrazione verifica che il certificato SSL utilizzato per connettersi al server Microsoft Entra ID sia valido. Questo tipo di annuncio sarà selezionato per impostazione predefinita. |
Per istruzioni su come configurare un'integrazione in Google SecOps, consulta Configura le integrazioni.
Se necessario, puoi apportare modifiche in un secondo momento. Dopo aver configurato un'istanza di integrazione, puoi utilizzarla nei playbook. Per saperne di più su come configurare e supportare più istanze, consulta Supporto di più istanze.
Azioni
Per saperne di più sulle azioni, consulta Rispondi alle azioni in attesa dalla scrivania di lavoro ed Esegui un'azione manuale nel tuo caso.
Prima di eseguire le azioni, assicurati di aver configurato le autorizzazioni o i ruoli della directory richiesti per ogni funzionalità. Per saperne di più, consulta Configura le autorizzazioni API e Ambito delle autorizzazioni e limiti di accesso.
Aggiungi un utente a un gruppo
Utilizza l'azione Aggiungi utente a un gruppo per aggiungere un utente al gruppo Microsoft Entra ID specifico. Questa azione prevede la configurazione dell'entità User nel formato username@domain.
Questa azione viene eseguita sull'entità User di Google SecOps.
Input azione
L'azione Aggiungi utente a un gruppo richiede i seguenti parametri:
| Parametro | Descrizione |
|---|---|
Group ID |
Obbligatorio
L'ID del gruppo Microsoft Entra ID a cui aggiungere l'utente, ad esempio |
Output azione
L'azione Aggiungi utente a un gruppo fornisce i seguenti output:
| Tipo di output dell'azione | Disponibilità |
|---|---|
| Allegato della bacheca richieste | Non disponibile |
| Link alla bacheca casi | Non disponibile |
| Tabella della bacheca casi | Non disponibile |
| Tabella di arricchimento | Non disponibile |
| Risultato JSON | Non disponibile |
| Messaggi di output | Disponibile |
| Risultato dello script | Disponibile |
Messaggi di output
L'azione Aggiungi utente a un gruppo può restituire i seguenti messaggi di output:
| Messaggio di output | Descrizione del messaggio |
|---|---|
|
L'azione è riuscita. |
Member could not be added successfully. |
L'azione non è riuscita. Controlla la connessione al server, i parametri di input o le credenziali. |
Risultato dello script
La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Aggiungi utente a un gruppo:
| Nome del risultato dello script | Valore |
|---|---|
is_success |
True o False |
Disabilita account
Utilizza l'azione Disattiva account per disattivare un account in Microsoft Entra ID.
Questa azione prevede la configurazione dell'entità User nel formato username@domain.
Questa azione viene eseguita sull'entità User di Google SecOps.
Input azione
Nessuno.
Output azione
L'azione Disattiva account fornisce i seguenti output:
| Tipo di output dell'azione | Disponibilità |
|---|---|
| Allegato della bacheca richieste | Non disponibile |
| Link alla bacheca casi | Non disponibile |
| Tabella della bacheca casi | Non disponibile |
| Tabella di arricchimento | Non disponibile |
| Risultato JSON | Non disponibile |
| Messaggi di output | Disponibile |
| Risultato dello script | Disponibile |
Messaggi di output
L'azione Disattiva account può restituire i seguenti messaggi di output:
| Messaggio di output | Descrizione del messaggio |
|---|---|
|
L'azione è riuscita. |
Disable user account was not successful. |
L'azione non è riuscita. Controlla la connessione al server, i parametri di input o le credenziali. |
Risultato dello script
La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Disattiva account:
| Nome del risultato dello script | Valore |
|---|---|
is_success |
True o False |
Abilita account
Utilizza l'azione Attiva account per attivare un account in Microsoft Entra ID.
Questa azione prevede la configurazione dell'entità User nel formato username@domain.
Questa azione viene eseguita sull'entità User di Google SecOps.
Input azione
Nessuno.
Output azione
L'azione Abilita account fornisce i seguenti output:
| Tipo di output dell'azione | Disponibilità |
|---|---|
| Allegato della bacheca richieste | Non disponibile |
| Link alla bacheca casi | Non disponibile |
| Tabella della bacheca casi | Non disponibile |
| Tabella di arricchimento | Non disponibile |
| Risultato JSON | Non disponibile |
| Messaggi di output | Disponibile |
| Risultato dello script | Disponibile |
Messaggi di output
L'azione Attiva account può restituire i seguenti messaggi di output:
| Messaggio di output | Descrizione del messaggio |
|---|---|
|
L'azione è riuscita. |
Enable user account was not successful. |
L'azione non è riuscita. Controlla la connessione al server, i parametri di input o le credenziali. |
Risultato dello script
La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Attiva account:
| Nome del risultato dello script | Valore |
|---|---|
is_success |
True o False |
Host di arricchimento
Utilizza l'azione Arricchisci host per arricchire l'entità Host di Google SecOps con le informazioni di Microsoft Entra ID. Questa azione trova una corrispondenza per un'entità Host fornita utilizzando il campo displayName del dispositivo in Microsoft Entra ID.
Questa azione viene eseguita sull'entità Host di Google SecOps.
Input azione
Nessuno.
Output azione
L'azione Enrich Host fornisce i seguenti output:
| Tipo di output dell'azione | Disponibilità |
|---|---|
| Allegato della bacheca richieste | Non disponibile |
| Link alla bacheca casi | Non disponibile |
| Tabella della bacheca casi | Non disponibile |
| Tabella di enrichment delle entità | Disponibile |
| Risultato JSON | Disponibile |
| Messaggi di output | Disponibile |
| Risultato dello script | Disponibile |
Tabella di enrichment delle entità
L'azione Enrich Host supporta il seguente arricchimento delle entità:
| Campo di arricchimento | Logica |
|---|---|
AAD_Name |
Restituisce se esiste nel risultato JSON. |
AAD_Enabled |
Restituisce se esiste nel risultato JSON. |
AAD_Property Device ID |
Restituisce se esiste nel risultato JSON. |
AAD_OS |
Restituisce se esiste nel risultato JSON. |
AAD_Version |
Restituisce se esiste nel risultato JSON. |
AAD_Profile Type |
Restituisce se esiste nel risultato JSON. |
AAD_Compliant |
Restituisce se esiste nel risultato JSON. |
AAD_Last Sign In |
Restituisce se esiste nel risultato JSON. |
Risultato JSON
L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Arricchisci host:
[
{
"EntityResult": {
"deletedDateTime": "1234569",
"complianceExpirationDateTime": "1234567",
"profileType": "RegisteredDevice",
"key": "007",
"if":"889922-aaaa-123123"
},
"Entity": "us-lt-v13001"
}
]
Messaggi di output
L'azione Arricchisci host può restituire i seguenti messaggi di output:
| Messaggio di output | Descrizione del messaggio |
|---|---|
|
L'azione è riuscita. |
Host details were not found. |
L'azione non è riuscita. Controlla la connessione al server, i parametri di input o le credenziali. |
Risultato dello script
La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Arricchisci host:
| Nome del risultato dello script | Valore |
|---|---|
is_success |
True o False |
Arricchisci utente
Utilizza l'azione Arricchisci utente per arricchire l'entità User di Google SecOps con le informazioni di Microsoft Entra ID. Questa azione prevede la configurazione dell'entità User nel formato username@domain.
Questa azione viene eseguita sull'entità Host di Google SecOps.
Input azione
L'azione Arricchisci utente richiede i seguenti parametri:
| Parametro | Descrizione |
|---|---|
Include MFA Details |
Facoltativo. Se selezionata, l'azione restituisce i dettagli MFA relativi all'utente. |
Include Last Sign In Details |
Facoltativo. Se selezionata, l'azione recupera l'attività di accesso dell'utente (inclusi i timestamp di accesso interattivo e non interattivo). |
Output azione
L'azione Arricchisci utente fornisce i seguenti output:
| Tipo di output dell'azione | Disponibilità |
|---|---|
| Allegato della bacheca richieste | Non disponibile |
| Link alla bacheca casi | Non disponibile |
| Tabella della bacheca casi | Non disponibile |
| Tabella di enrichment delle entità | Disponibile |
| Risultato JSON | Disponibile |
| Messaggi di output | Disponibile |
| Risultato dello script | Disponibile |
Tabella di enrichment delle entità
L'azione Arricchisci utente supporta il seguente arricchimento delle entità:
| Campo di arricchimento | Logica |
|---|---|
AAD_Name |
Restituisce se esiste nel risultato JSON. |
AAD_Mobile Phone |
Restituisce se esiste nel risultato JSON. |
AAD_Preferred Language |
Restituisce se esiste nel risultato JSON. |
AAD_Job Title |
Restituisce se esiste nel risultato JSON. |
AAD_Username |
Restituisce se esiste nel risultato JSON. |
Risultato JSON
L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Arricchisci utente:
[
{
"Entity": "user@domain.com",
"EntityResult": {
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users/$entity",
"accountEnabled": true,
"ageGroup": null,
"businessPhones": [],
"city": "New York",
"companyName": "ExampleCorp",
"consentProvidedForMinor": null,
"country": "US",
"createdDateTime": "2025-01-01T00:00:00Z",
"creationType": null,
"department": "Security",
"displayName": "User Name",
"mail": "user@domain.com",
"employeeId": "12345",
"employeeHireDate": null,
"employeeType": null,
"externalUserStateChangeDateTime": null,
"faxNumber": null,
"givenName": "User",
"imAddresses": [],
"externalUserState": null,
"jobTitle": "Security Analyst",
"surname": "Surname",
"lastPasswordChangeDateTime": "2025-01-01T00:00:00Z",
"legalAgeGroupClassification": null,
"mailNickname": "usernickname",
"mobilePhone": "+11234567890",
"id": "user-id-12345",
"officeLocation": null,
"onPremisesSamAccountName": null,
"onPremisesDistinguishedName": null,
"onPremisesDomainName": null,
"onPremisesImmutableId": null,
"onPremisesLastSyncDateTime": null,
"onPremisesProvisioningErrors": [],
"onPremisesSecurityIdentifier": null,
"onPremisesSyncEnabled": null,
"onPremisesUserPrincipalName": null,
"otherMails": [],
"passwordPolicies": "None",
"preferredDataLocation": null,
"preferredLanguage": "en-US",
"proxyAddresses": [],
"signInSessionsValidFromDateTime": "2025-01-01T00:00:00Z",
"state": "NY",
"streetAddress": "123 Main St",
"usageLocation": "US",
"userPrincipalName": "user@domain.com",
"userType": "Member",
"postalCode": "10001",
"deletedDateTime": null,
"showInAddressList": null,
"isResourceAccount": null,
"refreshTokensValidFromDateTime": "2025-01-01T00:00:00Z",
"employeeOrgData": null,
"passwordProfile": null,
"authorizationInfo": {
"certificateUserIds": []
},
"mfa_details": {
"id": "user-id-12345",
"userPrincipalName": "user@domain.com",
"userDisplayName": "User Name",
"userType": "member",
"isAdmin": false,
"isSsprRegistered": true,
"isSsprEnabled": true,
"isSsprCapable": true
"isMfaRegistered": true,
"isMfaCapable": true,
"isPasswordlessCapable": false,
"methodsRegistered": [
"email",
"mobilePhone"
],
"defaultMfaMethod": "mobilePhone",
"isSystemPreferredAuthenticationMethodEnabled": false,
"systemPreferredAuthenticationMethods": [],
"userPreferredMethodForSecondaryAuthentication": "oath",
"lastUpdatedDateTime": "2026-01-01T00:00:00Z"
}
}
}
]
Messaggi di output
L'azione Arricchisci utente può restituire i seguenti messaggi di output:
| Messaggio di output | Descrizione del messaggio |
|---|---|
|
L'azione è riuscita. |
Users list fetch was not successful. |
L'azione non è riuscita. Controlla la connessione al server, i parametri di input o le credenziali. |
Risultato dello script
La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Arricchisci utente:
| Nome del risultato dello script | Valore |
|---|---|
is_success |
True o False |
Forza aggiornamento password
Utilizza l'azione Forza aggiornamento password per forzare l'aggiornamento della password per l'utente. Questa azione richiede all'utente di cambiare la password al successivo tentativo di accesso.
L'azione Forza l'aggiornamento della password prevede la configurazione dell'entità User nel formato username@domain.
Questa azione viene eseguita sull'entità User di Google SecOps.
Input azione
Nessuno.
Output azione
L'azione Forza aggiornamento password fornisce i seguenti output:
| Tipo di output dell'azione | Disponibilità |
|---|---|
| Allegato della bacheca richieste | Non disponibile |
| Link alla bacheca casi | Non disponibile |
| Tabella della bacheca casi | Non disponibile |
| Tabella di arricchimento | Non disponibile |
| Risultato JSON | Non disponibile |
| Messaggi di output | Disponibile |
| Risultato dello script | Disponibile |
Messaggi di output
L'azione Forza aggiornamento password può restituire i seguenti messaggi di output:
| Messaggio di output | Descrizione del messaggio |
|---|---|
|
L'azione è riuscita. |
Attempt to Force user password update was not successful.
|
L'azione non è riuscita. Controlla la connessione al server, i parametri di input o le credenziali. |
Risultato dello script
La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Forza l'aggiornamento della password:
| Nome del risultato dello script | Valore |
|---|---|
is_success |
True o False |
Ottieni i dati di contatto del gestore
Utilizza l'azione Recupera i dati di contatto del responsabile per ottenere i dati di contatto del responsabile dell'utente.
L'azione Recupera i dati di contatto del gestore prevede la configurazione dell'entità User nel formato username@domain.
Questa azione viene eseguita sull'entità User di Google SecOps.
Input azione
L'azione Recupera i dati di contatto del responsabile richiede il seguente parametro:
| Parametro | Descrizione |
|---|---|
Fields To Return |
Facoltativo. Un elenco separato da virgole di attributi specifici del profilo amministratore da recuperare. Se non viene fornito alcun valore, l'azione restituisce l'insieme predefinito di attributi definiti dall'API. Il valore predefinito è |
Include MFA Details |
Facoltativo. Se selezionata, l'azione restituisce i dettagli MFA relativi all'utente. |
Include Last Sign In Details |
Facoltativo. Se selezionata, l'azione recupera l'attività di accesso dell'utente (inclusi i timestamp di accesso interattivo e non interattivo). |
Output azione
L'azione Recupera dati di contatto del responsabile fornisce i seguenti output:
| Tipo di output dell'azione | Disponibilità |
|---|---|
| Allegato della bacheca richieste | Non disponibile |
| Link alla bacheca casi | Non disponibile |
| Tabella della bacheca casi | Disponibile |
| Tabella di enrichment delle entità | Disponibile |
| Risultato JSON | Disponibile |
| Messaggi di output | Disponibile |
| Risultato dello script | Disponibile |
Tabella della bacheca casi
L'azione Get Manager Contact Details può restituire la seguente tabella in Google SecOps:
Nome tabella: Manager contact
Colonne:
- Nome
- Numero di telefono
Tabella di enrichment delle entità
L'azione Recupera i dati di contatto del gestore supporta il seguente arricchimento delle entità:
| Campo di arricchimento | Logica |
|---|---|
Display Name |
Restituisce se esiste nel risultato JSON. |
Mobile Phone |
Restituisce se esiste nel risultato JSON. |
@odata.context |
Restituisce se esiste nel risultato JSON. |
AAD_Job Title |
Restituisce se esiste nel risultato JSON. |
AAD_Username |
Restituisce se esiste nel risultato JSON. |
Risultato JSON
L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Recupera i dati di contatto del gestore:
[
{
"Entity": "user@example.com",
"EntityResult": {
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users/$entity",
"accountEnabled": true,
"ageGroup": null,
"businessPhones": [],
"city": "Anytown",
"companyName": "Example Corporation",
"consentProvidedForMinor": null,
"country": "US",
"createdDateTime": "2025-01-01T00:00:00Z",
"creationType": null,
"department": "Security Operations",
"displayName": "Internal User",
"mail": "user@example.com",
"employeeId": "ID-00001",
"employeeHireDate": null,
"employeeType": "Full-time",
"externalUserStateChangeDateTime": null,
"faxNumber": null,
"givenName": "Alex",
"imAddresses": [],
"externalUserState": null,
"jobTitle": "Security Lead",
"surname": "Doe",
"lastPasswordChangeDateTime": "2025-01-01T00:00:00Z",
"legalAgeGroupClassification": null,
"mailNickname": "alexdoe",
"mobilePhone": "+1 555-0100",
"id": "00000000-0000-0000-0000-000000000000",
"officeLocation": null,
"usageLocation": "US",
"userPrincipalName": "user@example.com",
"userType": "Member",
"postalCode": "00000",
"deletedDateTime": null,
"showInAddressList": null,
"isResourceAccount": null,
"refreshTokensValidFromDateTime": "2025-01-01T00:00:00Z",
"employeeOrgData": null,
"authorizationInfo": {
"certificateUserIds": []
},
"sponsors": [],
"mfa_details": {
"id": "00000000-0000-0000-0000-000000000000",
"userPrincipalName": "user@example.com",
"userDisplayName": "Internal User",
"userType": "member",
"isAdmin": true,
"isSsprRegistered": false,
"isSsprEnabled": true,
"isSsprCapable": false,
"isMfaRegistered": true,
"isMfaCapable": true,
"isPasswordlessCapable": false,
"methodsRegistered": [
"mobilePhone",
"softwareOneTimePasscode"
],
"defaultMfaMethod": "softwareOneTimePasscode",
"isSystemPreferredAuthenticationMethodEnabled": true,
"systemPreferredAuthenticationMethods": [
"SoftwareOTP"
],
"userPreferredMethodForSecondaryAuthentication": "oath",
"lastUpdatedDateTime": "2026-01-01T00:00:00Z"
}
}
}
]
Messaggi di output
L'azione Get Manager Contact Details può restituire i seguenti messaggi di output:
| Messaggio di output | Descrizione del messaggio |
|---|---|
|
L'azione è riuscita. |
Could not fetch user manager's details successfully. |
L'azione non è riuscita. Controlla la connessione al server, i parametri di input o le credenziali. |
Risultato dello script
La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Recupera i dati di contatto del gestore:
| Nome del risultato dello script | Valore |
|---|---|
is_success |
True o False |
Is User in Group
Utilizza l'azione Is User in Group per verificare se l'utente è membro di un gruppo Microsoft Entra ID specifico. Questa azione prevede la configurazione dell'entità User nel formato username@domain.
Questa azione viene eseguita sull'entità User di Google SecOps.
Input azione
L'azione Is User in Group richiede i seguenti parametri:
| Parametro | Descrizione |
|---|---|
Group ID |
Obbligatorio
L'ID del gruppo Microsoft Entra ID a cui aggiungere l'utente, ad esempio |
Output azione
L'azione Is User in Group (L'utente è nel gruppo) fornisce i seguenti output:
| Tipo di output dell'azione | Disponibilità |
|---|---|
| Allegato della bacheca richieste | Non disponibile |
| Link alla bacheca casi | Non disponibile |
| Tabella della bacheca casi | Non disponibile |
| Tabella di arricchimento | Non disponibile |
| Risultato JSON | Disponibile |
| Messaggi di output | Disponibile |
| Risultato dello script | Disponibile |
Risultato JSON
L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Is User in Group:
[
{
"EntityResult": "true",
"Entity": "user@example.com"
}
]
Messaggi di output
L'azione Is User in Group può restituire i seguenti messaggi di output:
| Messaggio di output | Descrizione del messaggio |
|---|---|
|
L'azione è riuscita. |
User was not found in the group. |
L'azione non è riuscita. Controlla la connessione al server, i parametri di input o le credenziali. |
Risultato dello script
La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione L'utente è nel gruppo:
| Nome del risultato dello script | Valore |
|---|---|
is_success |
True o False |
Elenco gruppi
Utilizza l'azione Elenca gruppi per elencare i gruppi Microsoft Entra ID utilizzando i criteri di ricerca specificati.
Per l'azione Elenca gruppi di schede, il filtro funziona con il campo Name.
Questa azione non viene eseguita sulle entità Google SecOps.
Input azione
L'azione Elenca gruppi richiede i seguenti parametri:
| Parametro | Descrizione |
|---|---|
Order By |
Optional
L'ordine in base al quale ordinare i gruppi restituiti in base al nome. Il valore predefinito è I valori possibili sono:
|
Results Limit |
Optional
Il numero massimo di gruppi da restituire. |
Filter Logic |
Optional
La logica per filtrare i gruppi in base al nome. Il valore predefinito è I valori possibili sono:
|
Filter Value |
Optional
Il valore per filtrare i gruppi utilizzando la logica di filtro selezionata. Questo valore si applica al nome del gruppo. Se selezioni Se non imposti un valore, il filtro non viene applicato. |
Output azione
L'azione Elenca gruppi di schede fornisce i seguenti output:
| Tipo di output dell'azione | Disponibilità |
|---|---|
| Allegato della bacheca richieste | Non disponibile |
| Link alla bacheca casi | Non disponibile |
| Tabella della bacheca casi | Disponibile |
| Tabella di enrichment delle entità | Disponibile |
| Risultato JSON | Disponibile |
| Messaggi di output | Disponibile |
| Risultato dello script | Disponibile |
Tabella della bacheca casi
L'azione Elenca gruppi può restituire la seguente tabella in Google SecOps:
Nome tabella: Groups
Colonne:
- Nome
- ID
- Descrizione
- Posta
- Data/ora creazione
- Tipo di gruppo
Tabella di enrichment delle entità
L'azione Elenca gruppi supporta il seguente arricchimento delle entità:
| Campo di arricchimento | Logica |
|---|---|
Group Type |
Restituisce se esiste nel risultato JSON. |
ID |
Restituisce se esiste nel risultato JSON. |
Name |
Restituisce se esiste nel risultato JSON. |
Description |
Restituisce se esiste nel risultato JSON. |
Created Time |
Restituisce se esiste nel risultato JSON. |
Risultato JSON
L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Elenca gruppi:
[
{
"Group_Type": "managed",
"Id": "1212-12312-123",
"Name": "Group Name",
"Description": "This group is ...",
"Created_Time": "2019-10-24T19:10:18Z",
"onPremisesSamAccountName": "alext"
}
]
Messaggi di output
L'azione Elenca gruppi può restituire i seguenti messaggi di output:
| Messaggio di output | Descrizione del messaggio |
|---|---|
|
L'azione è riuscita. |
Groups list fetch was not successful. |
L'azione non è riuscita. Controlla la connessione al server, i parametri di input o le credenziali. |
Risultato dello script
La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Elenca gruppi:
| Nome del risultato dello script | Valore |
|---|---|
is_success |
True o False |
Elenco dei membri del gruppo
Utilizza l'azione Elenca i membri del gruppo per elencare i membri del gruppo Microsoft Entra ID specificato.
La logica di filtro funziona in base al valore parametro Filter Key.
Questa azione non viene eseguita sulle entità Google SecOps.
Input azione
L'azione Elenca i membri del gruppo richiede i seguenti parametri:
| Parametro | Descrizione |
|---|---|
Max Records To Return |
Optional
Il numero massimo di record da restituire. Il valore predefinito è 50. |
Group Name |
Optional
Il nome del gruppo Microsoft Entra ID di cui elencare i membri. |
Group ID |
Optional
L'ID del gruppo Microsoft Entra ID per elencare i membri. Se configuri sia il parametro |
Filter Key |
Optional
Il campo in base al quale filtrare i membri del gruppo, ad esempio I valori possibili sono:
|
Filter Logic |
Optional
La logica da applicare al filtro. I valori possibili sono:
|
Filter Value |
Optional
Il valore da utilizzare per filtrare i membri del gruppo in base ai valori dei parametri Se selezioni Se non imposti un valore, il filtro non viene applicato. |
Output azione
L'azione Elenca i membri del gruppo fornisce i seguenti output:
| Tipo di output dell'azione | Disponibilità |
|---|---|
| Allegato della bacheca richieste | Non disponibile |
| Link alla bacheca casi | Non disponibile |
| Tabella della bacheca casi | Disponibile |
| Tabella di arricchimento | Non disponibile |
| Risultato JSON | Disponibile |
| Messaggi di output | Disponibile |
| Risultato dello script | Disponibile |
Tabella della bacheca casi
L'azione Elenca i membri del gruppo può restituire la seguente tabella in Google SecOps:
Nome tabella: Membri disponibili del gruppo
Colonne:
- ID
- Nome dell'entità utente
- Nome visualizzato
- Cognome
- Given Name
- Posta
- Qualifica
- Telefoni aziendali
- Cellulare
- Sede dell'ufficio
- Lingua preferita
Risultato JSON
L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Elenca i membri del gruppo:
[
{
"@odata.type": "#microsoft.graph.user",
"id": "b786d3cf-e97d-4511-b61c-0559e9f4da75",
"businessPhones": [],
"displayName": "Alex T",
"givenName": "Alex",
"jobTitle": "Software Engineer",
"mail": "alex.t@example.com",
"mobilePhone": null,
"officeLocation": "Building A",
"preferredLanguage": "en-US",
"surname": "T",
"userPrincipalName": "alex.t@example.com"
}
]
Messaggi di output
L'azione Elenca i membri del gruppo può restituire i seguenti messaggi di output:
| Messaggio di output | Descrizione del messaggio |
|---|---|
|
L'azione è riuscita. |
Error executing action "List Members in the Group". Reason:
ERROR_REASON |
L'azione non è riuscita. Controlla la connessione al server, i parametri di input o le credenziali. |
Risultato dello script
La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Elenca i membri del gruppo:
| Nome del risultato dello script | Valore |
|---|---|
is_success |
True o False |
Elenca l'appartenenza ai gruppi dell'utente
Utilizza l'azione Elenca l'appartenenza ai gruppi dell'utente per elencare i gruppi Microsoft Entra ID di cui l'utente è membro.
Puoi fornire il nome utente come entità o come parametro di input dell'azione. Se configuri il nome utente sia come entità sia come parametro di input, l'azione utilizza il parametro di input.
Per configurare il nome utente, segui il formato username@domain.
Questa azione viene eseguita sull'entità Username di Google SecOps.
Input azione
L'azione Elenca l'appartenenza ai gruppi dell'utente richiede i seguenti parametri:
| Parametro | Descrizione |
|---|---|
User Name |
Optional
Un elenco separato da virgole di nomi utente per cui recuperare le iscrizioni ai gruppi, ad esempio |
Return Only Security Enabled Groups |
Optional
Se selezionata, l'azione restituisce solo i gruppi abilitati per la sicurezza a cui appartiene l'utente. Non selezionato per impostazione predefinita. |
Return Detailed Groups Information |
Optional
Se selezionata, l'azione restituisce informazioni dettagliate sui gruppi Microsoft Entra ID. Non selezionato per impostazione predefinita. |
Filter Key |
Optional
La chiave da utilizzare per filtrare i gruppi. Il valore predefinito è I valori possibili sono:
|
Filter Logic |
Optional
La logica da applicare quando si filtrano i gruppi. Il valore predefinito è I valori possibili sono:
|
Filter Value |
Optional
Il valore da utilizzare per filtrare i gruppi. Se selezioni Se non imposti un valore, il filtro non viene applicato. |
Max Records To Return |
Optional
Il numero massimo di record da restituire. Se non imposti un valore, l'azione restituisce 50 record per impostazione predefinita. |
Output azione
L'azione Elenca l'appartenenza ai gruppi dell'utente fornisce i seguenti output:
| Tipo di output dell'azione | Disponibilità |
|---|---|
| Allegato della bacheca richieste | Non disponibile |
| Link alla bacheca casi | Non disponibile |
| Tabella della bacheca casi | Disponibile |
| Tabella di arricchimento | Non disponibile |
| Risultato JSON | Disponibile |
| Messaggi di output | Disponibile |
| Risultato dello script | Disponibile |
Tabella della bacheca casi
L'azione Elenca l'appartenenza ai gruppi dell'utente può restituire la seguente tabella in Google SecOps:
Nome tabella: Group Memberships
Colonne:
- ID
- Nome visualizzato
- Descrizione
- Sicurezza abilitata
- Identificatore di sicurezza
- Data/ora di creazione
- Classificazione
- Visibilità
- Posta
- Mail Enabled
- Mail Nickname
Risultato JSON
L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Elenca l'appartenenza ai gruppi dell'utente:
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(Edm.String)",
"value": [
"ID",
"ID",
"ID",
]
}
Messaggi di output
L'azione Elenca l'appartenenza ai gruppi dell'utente può restituire i seguenti messaggi di output:
| Messaggio di output | Descrizione del messaggio |
|---|---|
|
L'azione è riuscita. |
Error executing action "List User's Groups Membership". Reason:
ERROR_REASON |
L'azione non è riuscita. Controlla la connessione al server, i parametri di input o le credenziali. |
Risultato dello script
La tabella seguente elenca il valore dell'output del risultato dello script quando utilizzi l'azione Elenca l'appartenenza ai gruppi dell'utente:
| Nome del risultato dello script | Valore |
|---|---|
is_success |
True o False |
Elenco utenti
Utilizza l'azione Elenca utenti per elencare gli utenti di Microsoft Entra ID utilizzando i criteri di ricerca specificati.
Per l'azione Elenca utenti, il filtro funziona con il campo Username
(userPrincipalName).
Questa azione non viene eseguita sulle entità Google SecOps.
Input azione
L'azione Elenca utenti richiede i seguenti parametri:
| Parametro | Descrizione |
|---|---|
Filter |
Optional
I campi da includere nei risultati. Il valore predefinito è I valori possibili sono:
|
Order By Field |
Optional
Il campo in base al quale ordinare i risultati. Il valore predefinito è I valori possibili sono:
|
Order By |
Optional
L'ordine dei risultati (crescente o decrescente). Il valore predefinito è I valori possibili sono:
|
Results Limit |
Optional
Il numero massimo di utenti da restituire. |
Advanced Filter Logic |
Optional
La logica da utilizzare per i filtri avanzati che si applica al campo Il valore predefinito è I valori possibili sono:
|
Advanced Filter Value |
Optional
Il valore da utilizzare nel filtro avanzato per il campo Se selezioni Se non imposti un valore, il filtro non viene applicato. |
Output azione
L'azione Elenca utenti fornisce i seguenti output:
| Tipo di output dell'azione | Disponibilità |
|---|---|
| Allegato della bacheca richieste | Non disponibile |
| Link alla bacheca casi | Non disponibile |
| Tabella della bacheca casi | Disponibile |
| Tabella di enrichment delle entità | Disponibile |
| Risultato JSON | Disponibile |
| Messaggi di output | Disponibile |
| Risultato dello script | Disponibile |
Tabella della bacheca casi
L'azione Elenca utenti può restituire la seguente tabella in Google SecOps:
Nome tabella: Users
Colonne:
- Nome
- Nome utente
- ID
- Nome
- Lingua preferita
- Posta
- Cellulare
- Cognome
- Qualifica
Tabella di enrichment delle entità
L'azione Elenca utenti supporta il seguente arricchimento delle entità:
| Campo di arricchimento | Logica |
|---|---|
Username |
Restituisce se esiste nel risultato JSON. |
Surname |
Restituisce se esiste nel risultato JSON. |
Name |
Restituisce se esiste nel risultato JSON. |
Job Title |
Restituisce se esiste nel risultato JSON. |
Mail |
Restituisce se esiste nel risultato JSON. |
Risultato JSON
L'esempio seguente mostra l'output del risultato JSON ricevuto quando si utilizza l'azione Elenca utenti:
[
{
"Group Type": "managed",
"Id": "ID",
"Name": "Example",
"Description": "Example",
"Created Time":"2019-10-24T19:10:18Z"
}
]
Messaggi di output
L'azione Elenca utenti può restituire i seguenti messaggi di output:
| Messaggio di output | Descrizione del messaggio |
|---|---|
|
L'azione è riuscita. |
User list fetch was not successful. |
L'azione non è riuscita. Controlla la connessione al server, i parametri di input o le credenziali. |
Risultato dello script
La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Elenca utenti:
| Nome del risultato dello script | Valore |
|---|---|
is_success |
True o False |
Dindin
Utilizza l'azione Ping per testare la connettività a Microsoft Entra ID.
Questa azione viene eseguita su tutte le entità Google SecOps.
Input azione
Nessuno.
Output azione
L'azione Ping fornisce i seguenti output:
| Tipo di output dell'azione | Disponibilità |
|---|---|
| Allegato della bacheca richieste | Non disponibile |
| Link alla bacheca casi | Non disponibile |
| Tabella della bacheca casi | Non disponibile |
| Tabella di arricchimento | Non disponibile |
| Risultato JSON | Non disponibile |
| Messaggi di output | Disponibile |
| Risultato dello script | Disponibile |
Messaggi di output
L'azione Ping può restituire i seguenti messaggi di output:
| Messaggio di output | Descrizione del messaggio |
|---|---|
|
L'azione è riuscita. |
Connection could not be established successfully. |
L'azione non è riuscita. Controlla la connessione al server, i parametri di input o le credenziali. |
Risultato dello script
La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Ping:
| Nome del risultato dello script | Valore |
|---|---|
is_success |
True o False |
Rimuovi l'utente dal gruppo
Utilizza l'azione Rimuovi utente dal gruppo per rimuovere un utente dal gruppo specificato in Microsoft Entra ID.
Puoi fornire il nome utente come entità o come parametro di input dell'azione. Se configuri il nome utente sia come entità sia come parametro di input, l'azione utilizza il parametro di input.
Per configurare il nome utente, segui il formato username@domain.
Questa azione viene eseguita sull'entità Username di Google SecOps.
Input azione
L'azione Rimuovi utente dal gruppo richiede i seguenti parametri:
| Parametro | Descrizione |
|---|---|
User Name |
Optional
Una stringa di nomi utente separati da virgole da rimuovere dal gruppo specificato.
Per configurare questo valore parametro, utilizza il formato Se non imposti un valore, l'azione viene eseguita sui nomi utente delle entità utente di un incidente dell'azione. |
Group Name |
Optional
Il nome del gruppo da cui rimuovere l'utente. |
Group ID |
Optional
L'ID del gruppo da cui rimuovere l'utente. Se imposti sia il parametro |
Output azione
L'azione Rimuovi utente dal gruppo fornisce i seguenti output:
| Tipo di output dell'azione | Disponibilità |
|---|---|
| Allegato della bacheca richieste | Non disponibile |
| Link alla bacheca casi | Non disponibile |
| Tabella della bacheca casi | Non disponibile |
| Tabella di arricchimento | Non disponibile |
| Risultato JSON | Non disponibile |
| Messaggi di output | Disponibile |
| Risultato dello script | Disponibile |
Messaggi di output
L'azione Rimuovi utente dal gruppo può restituire i seguenti messaggi di output:
| Messaggio di output | Descrizione del messaggio |
|---|---|
|
L'azione è riuscita. |
Error executing action "Remove User from the Group". Reason:
ERROR_REASON |
L'azione non è riuscita. Controlla la connessione al server, i parametri di input o le credenziali. |
Risultato dello script
La tabella seguente elenca il valore dell'output del risultato dello script quando utilizzi l'azione Rimuovi utente dal gruppo:
| Nome del risultato dello script | Valore |
|---|---|
is_success |
True o False |
Reimposta password utente
Utilizza l'azione Reimposta password utente per reimpostare la password utente su quella specificata nell'azione. Questa azione richiede all'utente di cambiare la password al successivo tentativo di accesso.
L'azione Reimposta password utente prevede la configurazione dell'entità User nel formato username@domain.
Questa azione viene eseguita sull'entità User di Google SecOps.
Input azione
L'azione Reimposta password utente richiede i seguenti parametri:
| Parametro | Descrizione |
|---|---|
Password |
Obbligatorio
La nuova password da impostare per l'utente. |
Output azione
L'azione Reimposta password utente fornisce i seguenti output:
| Tipo di output dell'azione | Disponibilità |
|---|---|
| Allegato della bacheca richieste | Non disponibile |
| Link alla bacheca casi | Non disponibile |
| Tabella della bacheca casi | Non disponibile |
| Tabella di arricchimento | Non disponibile |
| Risultato JSON | Non disponibile |
| Messaggi di output | Disponibile |
| Risultato dello script | Disponibile |
Messaggi di output
L'azione Reimposta password utente può restituire i seguenti messaggi di output:
| Messaggio di output | Descrizione del messaggio |
|---|---|
|
L'azione è riuscita. |
User password reset was not successful. |
L'azione non è riuscita. Controlla la connessione al server, i parametri di input o le credenziali. |
Risultato dello script
La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Reimposta password utente:
| Nome del risultato dello script | Valore |
|---|---|
is_success |
True o False |
Revoca sessione utente
Utilizza l'azione Revoca sessione utente per revocare una sessione utente.
Questa azione viene eseguita sulle seguenti entità Google SecOps:
UsernameEmail Address
Input azione
Nessuno.
Output azione
L'azione Revoca sessione utente fornisce i seguenti output:
| Tipo di output dell'azione | Disponibilità |
|---|---|
| Allegato della bacheca richieste | Non disponibile |
| Link alla bacheca casi | Non disponibile |
| Tabella della bacheca casi | Non disponibile |
| Tabella di arricchimento | Non disponibile |
| Risultato JSON | Disponibile |
| Messaggi di output | Disponibile |
| Risultato dello script | Disponibile |
Risultato JSON
I seguenti esempi mostrano gli output dei risultati JSON ricevuti quando si utilizza l'azione Revoca sessione utente:
Se l'utente esiste:
{ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Edm.Boolean", "value": true }Se l'utente non viene trovato:
{ "error": "User not found." }
Messaggi di output
L'azione Revoca sessione utente può restituire i seguenti messaggi di output:
| Messaggio di output | Descrizione del messaggio |
|---|---|
|
L'azione è riuscita. |
Error executing action "Revoke User Session". Reason:
ERROR_REASON |
L'azione non è riuscita. Controlla la connessione al server, i parametri di input o le credenziali. |
Risultato dello script
La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Revoca sessione utente:
| Nome del risultato dello script | Valore |
|---|---|
is_success |
True o False |
Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.