Integra Microsoft Entra ID con Google SecOps

Questo documento fornisce indicazioni su come integrare Microsoft Entra ID con Google Security Operations (Google SecOps).

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: utilizza le funzionalità di Google SecOps per automatizzare la disattivazione e l'attivazione degli account utente in Microsoft Entra ID in base a eventi di sicurezza, come sospetta compromissione o offboarding dei dipendenti.

  • Reimpostazione password: utilizza le funzionalità di Google SecOps per orchestrare le reimpostazioni password per gli account compromessi o per gli utenti che non riescono ad accedere ai 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: utilizza le funzionalità di Google SecOps per automatizzare la creazione, la modifica e l'eliminazione dei gruppi di 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 che i seguenti requisiti siano soddisfatti nel tuo ambiente Microsoft:

  • Registrazione dell'app Azure: devi registrare un'applicazione nell'interfaccia di amministrazione di Microsoft Entra per ottenere un ID client e un ID tenant.

    Per istruzioni dettagliate, consulta l'articolo Registra un'applicazione in Microsoft Entra ID.

  • Autorizzazioni API: concedi le seguenti autorizzazioni Microsoft Graph > Autorizzazioni applicazione alla tua app e fornisci il consenso dell'amministratore:

    • Directory.Read.All
    • Directory.ReadWrite.All
    • Group.ReadWrite.All
    • User.ReadWrite.All
    • AuditLog.Read.All (obbligatorio per utilizzare il parametro Includi dettagli MFA)

  • Assegnazioni dei ruoli: per eseguire azioni relative alle password, ad esempio Forza aggiornamento password o Reimposta password utente, devi assegnare il ruolo Password Administrator alla tua applicazione in Microsoft Entra ID.

  • Client secret: genera un client secret nella sezione Certificati e secret della tua app Azure. Salva immediatamente il valore del secret (non l'ID secret), poiché viene visualizzato una sola volta ed è necessario per la configurazione.

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 è https://login.microsoftonline.com.
API Root Optional

La radice dell'API dell'istanza di Azure Active Directory.

Il valore predefinito è https://graph.microsoft.com.
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 questa opzione è 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.

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à Google SecOps User.

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 00e40000-1971-439d-80fc-d0e000001dbd.

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

Member USER_ID was added to the group GROUP_ID successfully.

Some errors occurred. Please check the logs.

 L'azione è andata a buon fine.
Member could not be added successfully.

L'azione non è andata a buon fine.

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 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.

Per eseguire l'azione Disattiva account, concedi i privilegi amministrativi all'account Microsoft Entra ID che utilizzi nell'integrazione.

Questa azione viene eseguita sull'entità Google SecOps User.

Configura autorizzazioni aggiuntive

L'azione Disattiva account richiede di configurare anche la seguente autorizzazione API per l'applicazione:

  • User.EnableDisableAccount.All

Per indicazioni su come configurare le autorizzazioni API in Microsoft Entra ID, consulta la sezione Configura le autorizzazioni API di questo documento.

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

User account disabled successfully.

Some errors occurred. Please check the logs.

 L'azione è andata a buon fine.
Disable user account was not successful.

L'azione non è andata a buon fine.

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à Google SecOps User.

Configura autorizzazioni aggiuntive

L'azione Attiva account richiede di configurare anche la seguente autorizzazione API per l'applicazione:

  • User.EnableDisableAccount.All

Per indicazioni su come configurare le autorizzazioni API in Microsoft Entra ID, consulta la sezione Configura le autorizzazioni API di questo documento.

Input azione

Nessuno.

Output azione

L'azione Attiva 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

User account was enabled successfully.

Some errors occurred. Please check the logs.

 L'azione è andata a buon fine.
Enable user account was not successful.

L'azione non è andata a buon fine.

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à Google SecOps Host con le informazioni di Microsoft Entra ID. Questa azione trova una corrispondenza per un'entità Host fornita utilizzando il campo displayName sul dispositivo in Microsoft Entra ID.

Questa azione viene eseguita sull'entità Google SecOps Host.

Input azione

Nessuno.

Output azione

L'azione Arricchisci 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 arricchimento delle entità Disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Tabella di arricchimento 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

Host details were fetched successfully: HOSTNAME.

Some errors occurred. Please check log.

 L'azione è andata a buon fine.
Host details were not found.

L'azione non è andata a buon fine.

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à Google SecOps Host.

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 Enrich User 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 delle entità Disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Tabella di arricchimento delle entità

L'azione Enrich User (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 si utilizza 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

User details were fetched successfully: USERNAME.

Some errors occurred. Please check the logs.

 L'azione è andata a buon fine.
Users list fetch was not successful.

L'azione non è andata a buon fine.

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 aggiornamento password prevede la configurazione dell'entità User nel formato username@domain.

Questa azione viene eseguita sull'entità Google SecOps User.

Configura autorizzazioni aggiuntive

L'azione Forza aggiornamento password richiede di configurare anche la seguente autorizzazione API per l'applicazione:

  • User-PasswordProfile.ReadWrite.All

Per indicazioni su come configurare le autorizzazioni API in Microsoft Entra ID, consulta la sezione Configura le autorizzazioni API di questo documento.

Assegna un ruolo alla tua applicazione

L'azione Forza aggiornamento password richiede l'assegnazione del ruolo Password Administrator alla tua applicazione.

Per assegnare il ruolo Password Administrator alla tua applicazione, completa i seguenti passaggi:

  1. Accedi al portale Azure utilizzando il tuo account Microsoft.
  2. In Microsoft Entra ID, cerca Roles and administrators (Ruoli e amministratori).
  3. Seleziona o cerca il ruolo Password Administrator nell'elenco.
  4. Fai clic su Aggiungi assegnazione.
  5. Seleziona un account (membro) che utilizzi nell'integrazione e fai clic su Avanti.
  6. Inserisci una motivazione per l'assegnazione di un ruolo.
  7. Fai clic su Assegna.

Input azione

Nessuno.

Output azione

L'azione Forza l'aggiornamento della 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

Force password update on the user was successful.

Some errors occurred. Please check the logs.

 L'azione è andata a buon fine.
Attempt to Force user password update was not successful.

L'azione non è andata a buon fine.

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 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 Get Manager Contact Details 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à Google SecOps User.

Input azione

L'azione Recupera i dati di contatto del gestore 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 è accountEnabled,ageGroup,assignedLicenses, businessPhones,city,companyName,consentProvidedForMinor,country, createdDateTime,creationType,department,displayName,mail,employeeId, employeeHireDate,employeeOrgData,employeeType,onPremisesExtensionAttributes, externalUserStateChangeDateTime,faxNumber,givenName,imAddresses,identities, externalUserState,jobTitle,surname,lastPasswordChangeDateTime, legalAgeGroupClassification,mailNickname,mobilePhone,id,officeLocation, onPremisesSamAccountName,onPremisesDistinguishedName,onPremisesDomainName, onPremisesImmutableId,onPremisesLastSyncDateTime, onPremisesProvisioningErrors,onPremisesSecurityIdentifier, onPremisesSyncEnabled,onPremisesUserPrincipalName,otherMails, passwordPolicies,passwordProfile,preferredDataLocation,preferredLanguage, proxyAddresses,signInSessionsValidFromDateTime,sponsors,state,streetAddress, usageLocation,userPrincipalName,userType,postalCode,authorizationInfo, deletedDateTime,showInAddressList,isResourceAccount, refreshTokensValidFromDateTime.
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 i 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 arricchimento 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 arricchimento 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

User manager details were fetched successfully.

Some errors occurred. Please check the logs.

 L'azione è andata a buon fine.
Could not fetch user manager's details successfully.

L'azione non è andata a buon fine.

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à Google SecOps User.

Input azione

L'azione L'utente è nel gruppo richiede i seguenti parametri:

Parametro Descrizione
Group ID Obbligatorio

L'ID del gruppo Microsoft Entra ID a cui aggiungere l'utente, ad esempio 00e40000-1971-439d-80fc-d0e000001dbd.

Output azione

L'azione 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

The following user was found in the group: USER_ID.

Some errors occurred. Please check the logs.

 L'azione è andata a buon fine.
User was not found in the group.

L'azione non è andata a buon fine.

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 è ASC.

I valori possibili sono:

  • DESC
  • ASC
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 è Equal.

I valori possibili sono:

  • Equal
  • Contains
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 Equal, l'azione tenta di trovare la corrispondenza esatta tra i risultati. Se selezioni Contain, l'azione tenta di trovare risultati che contengono la sottostringa fornita.

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 arricchimento 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 della tabella: Groups

Colonne:

  • Nome
  • ID
  • Descrizione
  • Posta
  • Created Time
  • Tipo di gruppo
Tabella di arricchimento 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 di schede può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

Groups list was fetched successfully.

Some errors occurred. Please check the logs.

 L'azione è andata a buon fine.
Groups list fetch was not successful.

L'azione non è andata a buon fine.

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 per elencare i membri.
Group ID Optional

L'ID del gruppo Microsoft Entra ID per elencare i membri. Se configuri sia il parametro Group Name sia il parametro Group ID, l'azione utilizza il valore parametro Group ID.
Filter Key Optional

Il campo in base al quale filtrare i membri del gruppo, ad esempio User Display Name.

I valori possibili sono:

  • Select One
  • User Display Name
  • User Principal Name
  • User Mail Name
Filter Logic Optional

La logica da applicare al filtro.

I valori possibili sono:

  • Not Specified
  • Equal
  • Contains
Filter Value Optional

Il valore da utilizzare per filtrare i membri del gruppo in base ai valori dei parametri Filter Key e Filter Logic selezionati.

Se selezioni Equal, l'azione tenta di trovare la corrispondenza esatta tra i risultati. Se selezioni Contain, l'azione tenta di trovare risultati che contengono la sottostringa fornita.

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
  • Surname
  • 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

Successfully found members for the provided criteria in Azure AD group.

No members were found for the provided criteria in Azure AD group.

The filter was not applied, because parameter "Filter Value" has an empty value.

 L'azione è andata a buon fine.
Error executing action "List Members in the Group". Reason: ERROR_REASON

L'azione non è andata a buon fine.

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 i membri del gruppo:

Nome del risultato dello script Valore
is_success True o False

Elenco dei gruppi di appartenenza dell'utente

Utilizza l'azione Elenca l'appartenenza ai gruppi dell'utente per elencare i gruppi di 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à Google SecOps Username.

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 username@domain. Se non imposti un valore, l'azione utilizza gli identificatori dell'utente dell'entità Username.
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 è Select One.

I valori possibili sono:

  • Select One
  • Group Display Name
  • Group Description
Filter Logic Optional

La logica da applicare per filtrare i gruppi.

Il valore predefinito è Not Specified.

I valori possibili sono:

  • Not Specified
  • Equal
  • Contains
Filter Value Optional

Il valore da utilizzare per filtrare i gruppi.

Se selezioni Equal, l'azione tenta di trovare la corrispondenza esatta tra i risultati. Se selezioni Contain, l'azione tenta di trovare risultati che contengono la sottostringa fornita.

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
  • Created DateTime
  • Classification
  • 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

Successfully found groups for the provided criteria for the following entities: ENTITY_ID

The following entities were not found in the Azure AD: ENTITY_ID

No groups were found in Azure Active Directory for the following entities: ENTITY_ID

The filter was not applied, because parameter "Filter Value" has an empty value.

 L'azione è andata a buon fine.
Error executing action "List User's Groups Membership". Reason: ERROR_REASON

L'azione non è andata a buon fine.

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 è All Fields.

I valori possibili sono:

  • All Fields
  • displayName
  • userPrincipalName
  • id
  • jobTitle
  • mail
  • mobilePhone
  • preferredLanguage
  • surname
  • givenName
Order By Field Optional

Il campo in base al quale ordinare i risultati.

Il valore predefinito è displayName.

I valori possibili sono:

  • displayName
  • userPrincipalName
Order By Optional

L'ordine dei risultati (crescente o decrescente).

Il valore predefinito è ASC.

I valori possibili sono:

  • DESC
  • ASC
Results Limit Optional

Il numero massimo di utenti da restituire.
Advanced Filter Logic Optional

La logica da utilizzare per i filtri avanzati che si applicano al campo Username (userPrincipalName).

Il valore predefinito è Equal.

I valori possibili sono:

  • Equal
  • Contains
Advanced Filter Value Optional

Il valore da utilizzare nel filtro avanzato per il campo Username (userPrincipalName).

Se selezioni Equal, l'azione tenta di trovare la corrispondenza esatta tra i risultati. Se selezioni Contain, l'azione tenta di trovare risultati che contengono la sottostringa fornita.

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 arricchimento 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 arricchimento 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 utilizzi 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

List of users was fetched successfully.

Some errors occurred. Please check the logs.

 L'azione è andata a buon fine.
User list fetch was not successful.

L'azione non è andata a buon fine.

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

Connection established successfully.

 L'azione è andata a buon fine.
Connection could not be established successfully.

L'azione non è andata a buon fine.

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à Google SecOps Username.

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 username@domain.

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 Group Name sia il parametro Group ID, l'azione dà la priorità al valore Group ID.

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

Successfully removed the following entities from the Azure AD group: ENTITY_ID

The following entities were not found in the Azure AD: ENTITY_ID

No usernames were removed from the Azure AD group.

 L'azione è andata a buon fine.
Error executing action "Remove User from the Group". Reason: ERROR_REASON

L'azione non è andata a buon fine.

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à Google SecOps User.

Assegna un ruolo alla tua applicazione

L'azione Reimposta password utente richiede l'assegnazione del ruolo Password Administrator alla tua applicazione.

Per assegnare il ruolo Password Administrator alla tua applicazione, completa i seguenti passaggi:

  1. Accedi al portale Azure utilizzando il tuo account Microsoft.
  2. In Microsoft Entra ID, cerca Roles and administrators (Ruoli e amministratori).
  3. Seleziona o cerca il ruolo Password Administrator nell'elenco.
  4. Fai clic su Aggiungi assegnazione.
  5. Seleziona un account (membro) che utilizzi nell'integrazione e fai clic su Avanti.
  6. Inserisci una motivazione per l'assegnazione di un ruolo.
  7. Fai clic su Assegna.

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

User password was reset successfully.

Some errors occurred. Please check the logs.

 L'azione è andata a buon fine.
User password reset was not successful.

L'azione non è andata a buon fine.

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:

  • Username
  • Email 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

Successfully revoked sessions for the following users in Azure AD: ENTITY_ID

Action wasn't able to find the following users in Azure AD: ENTITY_ID

None of the provided users were found in Azure AD.

 L'azione è andata a buon fine.
Error executing action "Revoke User Session". Reason: ERROR_REASON

L'azione non è andata a buon fine.

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.