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.All e, 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 Include MFA Details o Include Last Sign In Details in Arricchisci utente o Recupera dati di contatto del responsabile

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 .All sono sempre a livello di tenant: le autorizzazioni dell'applicazione Microsoft Graph che terminano con .All (ad esempio User.ReadWrite.All o Group.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:

  1. Concedi solo le autorizzazioni di lettura per l'applicazione: concedi solo Directory.Read.All (e facoltativamente AuditLog.Read.All) alla registrazione dell'applicazione. Rimuovi eventuali autorizzazioni di scrittura .All per le applicazioni (ad esempio User.ReadWrite.All o Group.ReadWrite.All), perché le autorizzazioni per le applicazioni a livello di tenant sostituiscono i limiti delle unità amministrative.
  2. 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.
  3. 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 è 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 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 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 è 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

User account disabled successfully.

Some errors occurred. Please check the logs.

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

User account was enabled successfully.

Some errors occurred. Please check the logs.

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

Host details were fetched successfully: HOSTNAME.

Some errors occurred. Please check log.

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

User details were fetched successfully: USERNAME.

Some errors occurred. Please check the logs.

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

Force password update on the user was successful.

Some errors occurred. Please check the logs.

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

User manager details were fetched successfully.

Some errors occurred. Please check the logs.

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

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

The following user was found in the group: USER_ID.

Some errors occurred. Please check the logs.

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

Groups list was fetched successfully.

Some errors occurred. Please check the logs.

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

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 è 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 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 quando si filtrano 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
  • 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

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 è 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 è 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 applica 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 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

List of users was fetched successfully.

Some errors occurred. Please check the logs.

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

Connection established successfully.

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

User password was reset successfully.

Some errors occurred. Please check the logs.

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:

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