Integra Active Directory con Google SecOps

Questo documento spiega come integrare Active Directory con Google Security Operations.

Casi d'uso

L'integrazione di Active Directory utilizza le funzionalità di Google SecOps per supportare i seguenti casi d'uso:

  • Attiva e disattiva utenti:disattiva un account utente potenzialmente compromesso e impedisci ulteriori accessi non autorizzati.

  • Reimposta password:reimposta automaticamente la password utente in Active Directory e invia una notifica all'utente della modifica.

  • Gestisci gruppi:aggiungi nuovi utenti ai gruppi di sicurezza appropriati in base al loro ruolo e assicurati che dispongano delle autorizzazioni di accesso corrette.

  • Recuperare le informazioni utente:recupera i dettagli dell'utente, ad esempio le iscrizioni ai gruppi, l'ultimo accesso e le informazioni di contatto di un account utente specifico.

  • Automatizza l'offboarding: disattiva gli account, rimuovili dai gruppi e trasferisci la proprietà dei file nel caso in cui un dipendente esca dall'organizzazione.

Prima di iniziare

Prima di configurare l'integrazione di Active Directory in Google SecOps, verifica che l'ambiente di rete, Active Directory Domain Services (AD DS) e le credenziali dell'account di servizio soddisfino tutti i prerequisiti operativi.

Per preparare l'ambiente per l'integrazione, completa i seguenti prerequisiti:

  1. Verifica la connettività di rete e la risoluzione DNS tra l'istanza Google SecOps (o l'agente remoto) e i domain controller Active Directory.

  2. Se la connessione avviene tramite LDAPS (porta 636) (necessario per i reimpostazioni delle password), assicurati che i certificati di directory siano configurati. Se utilizzi un'autorità di certificazione (CA) interna, tieni a portata di mano il certificato CA radice o intermedio CA pronto per la codifica base64.

  3. Crea un service account Active Directory dedicato che rispetti il principio del privilegio minimo (PoLP).

  4. Esamina le autorizzazioni per le azioni richieste per determinare gli attributi e i diritti di accesso necessari per i playbook specifici che prevedi di eseguire.

  5. Delega le autorizzazioni alle unità organizzative (UO) di destinazione utilizzando Utenti e computer di Active Directory (ADUC) o PowerShell (dsacls), assicurandoti che il account di servizio abbia accesso in lettura e scrittura esplicito all'attributo userAccountControl.

Requisiti di rete e DNS

Google SecOps comunica direttamente con i controller di dominio Active Directory utilizzando il protocollo LDAP (Lightweight Directory Access Protocol) o LDAPS su TCP.

Assicurati che il tuo ambiente di rete soddisfi le seguenti regole di connettività:

  • Connettività delle porte: assicurati che i firewall e il routing di rete consentano la comunicazione in uscita da Google SecOps (o dall'agente remoto) ai controller di dominio Active Directory sulle seguenti porte:

    • LDAP (standard): apri la porta 389/TCP per la comunicazione LDAP non criptata.
    • LDAPS (consigliato, obbligatorio per le password): apri la porta 636/TCP (o la porta SSL/TLS personalizzata). LDAPS è necessario per il traffico di directory criptato ed è obbligatorio per le azioni di modifica della password, ad esempio Imposta password utente.

  • Risoluzione DNS e nome host: Active Directory richiede una risoluzione accurata del nome host per corrispondere ai certificati SSL/TLS e ai binding dei servizi di directory. Se il tuo dominio viene risolto da un nome DNS completo tramite la configurazione DNS interna, non è necessaria alcuna configurazione host aggiuntiva. Se la risoluzione DNS non è disponibile nell'immagine container dell'agente remoto, configura il file /etc/hosts.

Configura il file /etc/hosts

Active Directory richiede una risoluzione accurata del nome host per corrispondere ai certificati SSL/TLS e alle associazioni di servizi di directory. Se l'agente remoto non riesce a risolvere il domain controller Active Directory utilizzando DNS, mappa l'host manualmente.

Per configurare il file /etc/hosts, completa i seguenti passaggi:

  1. Apri /etc/hosts in un editor di testo con privilegi amministrativi:

    sudo vi /etc/hosts

  2. Aggiungi una voce che mappa l'indirizzo IP del controller di dominio al suo nome di dominio completo (FQDN):

    192.0.2.195 dc01.example.local

  3. Salva e chiudi il file.

Se non hai bisogno di un certificato CA per l'integrazione, procedi alla configurazione dei requisiti di autenticazione e service account. In caso contrario, configura il certificato CA.

(Facoltativo) Configura il certificato CA

Quando ti connetti tramite LDAPS (porta 636) utilizzando certificati emessi da una CA privata o interna, fornisci la stringa del certificato con codifica Base64 durante la configurazione per stabilire una connessione TLS attendibile.

Per configurare e caricare il certificato CA, completa i seguenti passaggi:

  1. Codifica il file del certificato in formato PEM:

    • Linux: bash base64 -w 0 mycert.crt

    • macOS: bash base64 -i mycert.crt

  2. Copia la stringa di output completa (incluse le intestazioni codificate) e incollala nel campo CA Certificate File - parsed into Base64 String (File del certificato CA - analizzato in stringa Base64) nella configurazione dell'integrazione di Google SecOps.

  3. Imposta il parametro Server sul nome di dominio completo del domain controller (non sul suo indirizzo IP) in modo che il nome host corrisponda al nome comune (CN) o al nome alternativo del soggetto (SAN) del certificato.

  4. Fai clic su Testa per convalidare l'handshake TLS.

Requisiti di autenticazione e del account di servizio

L'integrazione di Active Directory esegue l'autenticazione utilizzando le credenziali AD DS standard.

Assicurati che la configurazione dell'autenticazione sia conforme alle seguenti pratiche di sicurezza:

  • Service account dedicato: crea un account di servizio dedicato (ad esempio svc_secops_ad) specificamente per i playbook automatici di Google SecOps. Evita di utilizzare account utente interattivi o account amministratore di dominio integrati.

  • Formato del nome utente: il nome utente può essere fornito come User Principal Name (UPN) (ad esempio svc_secops@example.local) o come nome di accesso di livello inferiore (EXAMPLE\svc_secops).

  • PoLP: non aggiungere il account di servizio a gruppi integrati con privilegi come Amministratori di dominio, Amministratori aziendali o Operatori account. Concedi invece autorizzazioni granulari per unità organizzative specifiche in cui risiedono oggetti utente, computer o gruppo.

Configurare le autorizzazioni di azione (privilegio minimo)

Concedi al account di servizio di autenticazione le autorizzazioni Active Directory specifiche e l'accesso agli attributi LDAP richiesti per le azioni eseguite dai playbook.

Consulta le autorizzazioni minime per le azioni di Active Directory nella tabella seguente:

Nome azione Autorizzazione / diritto esteso AD DS obbligatorio Classe oggetto di destinazione Descrizione / Ambito dell'attributo
Ping Read Property Utente, radice dominio Esegue query sull'oggetto account di servizio configurato (sAMAccountName, userPrincipalName, mail) per convalidare la connettività e le credenziali della directory.
Arricchire le entità
  • List Contents
  • Read Property (attributi target: userAccountControl, sAMAccountName, mail, memberOf, lockoutTime, pwdLastSet)
 Utente, Computer, Gruppo Esegue query sugli attributi di utenti e computer e risolve le appartenenze ai gruppi nidificati. Richiede Read Property su userAccountControl per evitare errori di indice nullo.
Disattivare l'account
  • Read Property: userAccountControl
  • Write Property: userAccountControl
 Utente Legge e imposta il flag ACCOUNTDISABLE (0x0002) sull'oggetto utente di destinazione.
Abilita account
  • Read Property: userAccountControl
  • Write Property: userAccountControl
 Utente Legge e cancella il flag ACCOUNTDISABLE (0x0002) nell'oggetto utente di destinazione.
Disabilita computer
  • Read Property: userAccountControl
  • Write Property: userAccountControl
 Computer Legge e imposta il flag ACCOUNTDISABLE sull'oggetto computer di destinazione.
Attiva computer
  • Read Property: userAccountControl
  • Write Property: userAccountControl
 Computer Legge e cancella il flag ACCOUNTDISABLE sull'oggetto computer di destinazione.
Sblocca account Write Property: lockoutTime Utente Imposta l'attributo lockoutTime su 0 per sbloccare un account utente bloccato.
Forzare l'aggiornamento della password Write Property: pwdLastSet Utente Imposta l'attributo pwdLastSet su 0 per richiedere all'utente di cambiare la password al prossimo accesso.
Imposta password utente
  • Diritto esteso: Reset Password (User-Force-Change-Password)
  • (Facoltativo) Write Property: unicodePwd
 Utente Reimposta la password dell'utente di destinazione. Richiede LDAPS (porta 636) o StartTLS.
Aggiungi utente al gruppo
  • Read Property: member
  • Write Property: member
 Gruppo Aggiunge il nome distinto dell'utente target (distinguishedName) all'attributo member del gruppo.
Rimuovere l'utente dal gruppo
  • Read Property: member
  • Write Property: member
 Gruppo Rimuove il nome distinto (distinguishedName) dell'utente di destinazione dall'attributo member del gruppo.
Cambia OU utente
  • Delete Child Object (Utente) nell'UO di origine
  • Create Child Object (utente) nell'UO di destinazione
  • Write Property: name, distinguishedName
 Unità organizzativa (UO), Utente Sposta gli oggetti utente tra le OU utilizzando LDAP modify_dn.
Cambia UO host
  • Delete Child Object (Computer) nell'unità organizzativa di origine
  • Create Child Object (computer) nell'UO di destinazione
  • Write Property: name, distinguishedName
 Unità organizzativa (UO), Computer Sposta gli oggetti computer tra le OU utilizzando LDAP modify_dn.
Aggiornare gli attributi di un utente AD Write Property sugli attributi di targeting (ad esempio mail, title, department, telephoneNumber, description o manager) Utente Modifica i valori degli attributi specificati nell'oggetto utente di destinazione.
Aggiornare gli attributi di un host AD Write Property sugli attributi target (ad esempio description o location) Computer Modifica i valori degli attributi specificati nell'oggetto computer di destinazione.
Get Group Members
  • List Contents
  • Read Property: member, sAMAccountName, distinguishedName
 Gruppo, Utente, Computer Esegue query sull'appartenenza ai gruppi e sugli attributi degli account membri.
Recuperare i dati di contatto del manager
  • Read Property: manager
  • Read Property: mail, displayName, telephoneNumber, title
 Utente Legge l'attributo manager dall'oggetto utente di destinazione e recupera i dettagli di contatto del gestore.
Is User In Group
  • Read Property: memberOf, sAMAccountName
 Utente, gruppo Valuta se un account utente appartiene al gruppo di sicurezza o di distribuzione specificato.
Elenca gruppi di utenti
  • Read Property: memberOf, sAMAccountName
 Utente, gruppo Restituisce l'elenco di tutti i gruppi assegnati all'account utente specificato.
Cercare in Active Directory
  • List Contents
  • Read Property sugli attributi interrogati
 Utente, Computer, Gruppo, UO Esegue query di filtro LDAP personalizzate sull'albero secondario della directory.

Delega delle autorizzazioni in Active Directory

Per applicare il principio del privilegio minimo senza concedere ampi diritti amministrativi, utilizza ADUC o PowerShell e dsacls per delegare le autorizzazioni sulle unità organizzative di destinazione utilizzando strumenti di gestione standard di Active Directory.

Delegare il controllo utilizzando ADUC

Se preferisci utilizzare un'interfaccia grafica, delega le autorizzazioni specifiche per oggetti e proprietà utilizzando la procedura guidata Delega controllo in ADUC.

Esegui la procedura guidata nell'unità organizzativa di destinazione per concedere le autorizzazioni specifiche per oggetti e proprietà necessarie per la gestione degli account (ad esempio lettura e scrittura dei flag di controllo dell'account, reimpostazione delle password e sblocco degli account).

Per istruzioni passo passo sull'esecuzione della procedura guidata, consulta la documentazione di Microsoft su Delega del controllo in AD DS su Windows Server.

Delegare il controllo utilizzando PowerShell e dsacls

Se preferisci un approccio da riga di comando o devi automatizzare e creare script per l'assegnazione delle autorizzazioni, utilizza PowerShell insieme all'utilità da riga di comando dsacls.exe integrata.

Esegui i seguenti esempi di comando su una workstation amministrativa o su un controller di dominio, sostituendo l'unità organizzativa di destinazione e il nome account di servizio:

  • Concedi l'accesso in lettura e scrittura a userAccountControl (disattiva/attiva gli account utente e impedisci errori di arricchimento): powershell dsacls.exe "OU=Users,DC=example,DC=local" /I:S /G "EXAMPLE\svc_secops_ad:RPWP;userAccountControl;user"
  • Concedi l'accesso in lettura e scrittura a userAccountControl per gli oggetti computer (disattiva/attiva computer): powershell dsacls.exe "OU=Computers,DC=example,DC=local" /I:S /G "EXAMPLE\svc_secops_ad:RPWP;userAccountControl;computer"
  • Concedi autorizzazioni per sbloccare l'account (lockoutTime): powershell dsacls.exe "OU=Users,DC=example,DC=local" /I:S /G "EXAMPLE\svc_secops_ad:WP;lockoutTime;user"
  • Concedere le autorizzazioni per forzare la modifica della password (pwdLastSet): powershell dsacls.exe "OU=Users,DC=example,DC=local" /I:S /G "EXAMPLE\svc_secops_ad:WP;pwdLastSet;user"
  • Concedere i diritti di reimpostazione della password (diritto esteso Reset Password): powershell dsacls.exe "OU=Users,DC=example,DC=local" /I:S /G "EXAMPLE\svc_secops_ad:CA;Reset Password;user"
  • Concedere i diritti di modifica dell'iscrizione a un gruppo di sicurezza: powershell dsacls.exe "CN=SecOps-Quarantine,OU=Groups,DC=example,DC=local" /G "EXAMPLE\svc_secops_ad:RPWP;member;group"

Per ulteriori dettagli sulla sintassi e sugli switch dei parametri, consulta la documentazione Microsoft su dsacls.

Parametri di integrazione

L'integrazione di Active Directory richiede i seguenti parametri:

Parametro Descrizione
Server

Obbligatorio.

Il nome host, il nome DNS o l'indirizzo IP del server Active Directory. L'integrazione comunica utilizzando il protocollo LDAP.

Per utilizzare una porta personalizzata, aggiungila all'indirizzo (ad es. mydomain.com:636).

Per impostazione predefinita, l'integrazione utilizza la porta 636 quando SSL/TLS è abilitato e la porta 389 quando è disabilitato.
Username

Obbligatorio.

L'indirizzo email dell'utente da connettere ad Active Directory, ad esempio user@example.com.

Questo parametro accetta anche l'attributo userPrincipalName.
Domain

Obbligatorio.

Il percorso DNS completo del tuo dominio all'interno dello spazio dei nomi di rete.

Per configurare questo parametro, inserisci il nome di dominio completo (FQDN) del tuo dominio nel seguente formato: SUBDOMAIN.ROOT_DOMAIN.

Ad esempio, se il tuo dominio Active Directory interno è example.local, il nome di dominio completo da inserire è example.local. Se il tuo dominio Active Directory interno è corp.example.com, il nome di dominio completo da inserire è corp.example.com.
Password

Obbligatorio.

La password dell'account utente.
Custom Query Fields

Facoltativo.

Campi personalizzati dell'integrazione di Active Directory, come customField1, customField2.
CA Certificate File - parsed into Base64 String

Facoltativo.

La stringa del file del certificato CA codificata nel formato base64 che hai ottenuto durante la configurazione del certificato CA. Per configurare questo parametro, inserisci il valore BASE64_ENCODED_CERTIFICATE_STRING completo.
Use SSL

Facoltativo.

Se selezionata, l'integrazione convalida il certificato SSL quando si connette al server Active Directory.

Se selezionata, l'integrazione utilizza LDAPS sicuro (porta 636). Se non selezionata, utilizza LDAP standard (porta 389).

Non selezionato per impostazione predefinita.

Per istruzioni su come configurare un'integrazione in Google SecOps, consulta Configurare le integrazioni.

Se necessario, potrai 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 ulteriori informazioni sulle azioni, vedi Rispondere alle azioni in attesa dalla tua scrivania e Eseguire un'azione manuale.

Aggiungi utente al gruppo

Utilizza l'azione Aggiungi utente al gruppo per aggiungere l'utente ai gruppi.

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

Input azione

L'azione Aggiungi utente al gruppo richiede i seguenti parametri:

Parametro Descrizione
Group Name

Obbligatorio.

Un elenco separato da virgole di gruppi a cui aggiungere utenti.

Output azione

L'azione Aggiungi utente al gruppo fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca casi 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 al gruppo può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

Successfully added the following users to the group "GROUP_NAME" in Active Directory: ENTITY_ID

The following users were already a part of the group "GROUP_NAME" in Active Directory: ENTITY_ID

Action wasn't able to add the following users to the group "GROUP_NAME" in Active Directory: ENTITY_ID

No users were added to the group "GROUP_NAME" in Active Directory.

No users were added to the provided groups in Active Directory.

 L'azione è riuscita.
Error executing action "Add User to Group". Reason: ERROR_REASON

L'azione non è riuscita.

Controlla la connessione al server, i parametri di input o le credenziali.
Risultato dello script

La seguente tabella elenca il valore dell'output del risultato dello script quando si utilizza l'azione Aggiungi utente al gruppo:

Nome del risultato dello script Valore
is_success True o False

Modifica UO host

Utilizza l'azione Cambia UO host per modificare l'UO di un host.

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

Input azione

L'azione Cambia UO host richiede i seguenti parametri:

Parametro Descrizione
OU Name

Obbligatorio.

Il nome della nuova unità organizzativa utente.

Output azione

L'azione Cambia UO host fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca casi Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Non disponibile
Risultato dello script Disponibile
Risultato dello script

La seguente tabella elenca il valore dell'output del risultato dello script quando utilizzi l'azione Cambia OU host:

Nome del risultato dello script Valore
is_success True o False

Modifica UO utente

Utilizza l'azione Modifica UO utente per modificare l'UO di un utente.

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

Input azione

L'azione Cambia UO utente richiede i seguenti parametri:

Parametro Descrizione
OU Name

Obbligatorio.

Il nome della nuova unità organizzativa utente.

Output azione

L'azione Cambia UO utente fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca casi Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Non disponibile
Risultato dello script Disponibile
Risultato dello script

La tabella seguente elenca il valore dell'output del risultato dello script quando si utilizza l'azione Cambia unità organizzativa utente:

Nome del risultato dello script Valore
is_success True o False

Disabilita account

Utilizza l'azione Disattiva account per disattivare un account utente.

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

Input azione

Nessuno.

Output azione

L'azione Disattiva account fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca casi Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Non disponibile
Risultato dello script Disponibile
Risultato dello script

La tabella seguente elenca il valore dell'output del risultato dello script quando utilizzi l'azione Disattiva account:

Nome del risultato dello script Valore
is_success True o False

Disattiva computer

Utilizza l'azione Disattiva computer per disattivare un account computer.

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

Input azione

Nessuno.

Output azione

L'azione Disattiva computer fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca casi Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Non disponibile
Risultato dello script Disponibile
Risultato dello script

La tabella seguente elenca il valore dell'output del risultato dello script quando utilizzi l'azione Disattiva computer:

Nome del risultato dello script Valore
is_success True o False

Abilita account

Utilizza l'azione Attiva account per attivare un account utente.

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

Input azione

Nessuno.

Output azione

L'azione Abilita account fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca casi Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Non disponibile
Risultato dello script Disponibile
Risultato dello script

La tabella seguente elenca il valore dell'output del risultato dello script quando utilizzi l'azione Attiva account:

Nome del risultato dello script Valore
is_success True o False

Attiva computer

Utilizza l'azione Abilita computer per abilitare un account computer.

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

Input azione

Nessuno.

Output azione

L'azione Abilita computer fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca casi Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Non disponibile
Risultato dello script Disponibile
Risultato dello script

La tabella seguente elenca il valore dell'output del risultato dello script quando utilizzi l'azione Attiva computer:

Nome del risultato dello script Valore
is_success True o False

Arricchisci entità

Utilizza l'azione Arricchisci entità per arricchire le entità Hostname o Username con le proprietà di Active Directory.

Questa azione è asincrona. Se necessario, modifica il valore di timeout dello script nell'IDE Google SecOps per l'azione.

L'azione Arricchisci entità viene eseguita sulle seguenti entità Google SecOps:

  • User
  • Hostname

Input azione

L'azione Arricchisci entità richiede i seguenti parametri:

Parametro Descrizione
Mark entities as internal

Obbligatorio.

Se selezionata, l'azione contrassegna automaticamente le entità arricchite correttamente come entità interne.
Specific Attribute Names To Enrich With

Facoltativo.

Un elenco separato da virgole di nomi di attributi con cui arricchire le entità.

Se non imposti alcun valore, l'azione arricchisce le entità con tutti gli attributi disponibili. Se un attributo contiene più valori, l'azione arricchisce l'attributo con tutti i valori disponibili.

Questo parametro è sensibile alle maiuscole.
Should Case Wall table be filtered by the specified attributes?

Facoltativo.

Se selezionata, l'azione compila la tabella della bacheca casi solo con gli attributi specificati nel valore parametro Specific Attribute Names To Enrich With.

Non selezionato per impostazione predefinita.
Should JSON result be filtered by the specified attributes?

Facoltativo.

Se selezionato, il risultato JSON restituisce solo gli attributi specificati nel valore parametro Specific Attribute Names To Enrich With.

Non selezionato per impostazione predefinita.
Connection Timeout

Facoltativo.

Limite di timeout della connessione di rete in secondi.

Il valore predefinito è 10.
Receive Timeout

Facoltativo.

Limite di timeout di ricezione della rete in secondi.

Il valore predefinito è 60.

Output azione

L'azione Arricchisci entità fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca casi Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento delle entità Disponibile
Risultato JSON Disponibile
Risultato dello script Disponibile
Arricchimento delle entità

L'azione Arricchisci entità supporta il seguente arricchimento delle entità:

Nome del campo di arricchimento Logica
AD_primaryGroupID L'azione restituisce il valore se esiste nel risultato JSON.
AD_logonCount L'azione restituisce il valore se esiste nel risultato JSON.
AD_cn L'azione restituisce il valore se esiste nel risultato JSON.
AD_countryCode L'azione restituisce il valore se esiste nel risultato JSON.
AD_objectClass L'azione restituisce il valore se esiste nel risultato JSON.
AD_userPrincipalName L'azione restituisce il valore se esiste nel risultato JSON.
AD_adminCount L'azione restituisce il valore se esiste nel risultato JSON.
AD_lastLogonTimestamp L'azione restituisce il valore se esiste nel risultato JSON.
AD_manager L'azione restituisce il valore se esiste nel risultato JSON.
AD_instanceType L'azione restituisce il valore se esiste nel risultato JSON.
AD_distinguishedName L'azione restituisce il valore se esiste nel risultato JSON.
AD_dSCorePropagationData L'azione restituisce il valore se esiste nel risultato JSON.
AD_msDS-SupportedEncryptionTypes L'azione restituisce il valore se esiste nel risultato JSON.
AD_objectSid L'azione restituisce il valore se esiste nel risultato JSON.
AD_whenCreated L'azione restituisce il valore se esiste nel risultato JSON.
AD_uSNCreated L'azione restituisce il valore se esiste nel risultato JSON.
AD_lockoutTime L'azione restituisce il valore se esiste nel risultato JSON.
AD_badPasswordTime L'azione restituisce il valore se esiste nel risultato JSON.
AD_pwdLastSet L'azione restituisce il valore se esiste nel risultato JSON.
AD_sAMAccountName L'azione restituisce il valore se esiste nel risultato JSON.
AD_objectCategory L'azione restituisce il valore se esiste nel risultato JSON.
AD_lastLogon L'azione restituisce il valore se esiste nel risultato JSON.
AD_objectGUID L'azione restituisce il valore se esiste nel risultato JSON.
AD_whenChanged L'azione restituisce il valore se esiste nel risultato JSON.
AD_badPwdCount L'azione restituisce il valore se esiste nel risultato JSON.
AD_accountExpires L'azione restituisce il valore se esiste nel risultato JSON.
AD_displayName L'azione restituisce il valore se esiste nel risultato JSON.
AD_name L'azione restituisce il valore se esiste nel risultato JSON.
AD_memberOf L'azione restituisce il valore se esiste nel risultato JSON.
AD_codePage L'azione restituisce il valore se esiste nel risultato JSON.
AD_userAccountControl L'azione restituisce il valore se esiste nel risultato JSON.
AD_sAMAccountType L'azione restituisce il valore se esiste nel risultato JSON.
AD_uSNChanged L'azione restituisce il valore se esiste nel risultato JSON.
AD_sn L'azione restituisce il valore se esiste nel risultato JSON.
AD_givenName L'azione restituisce il valore se esiste nel risultato JSON.
AD_lastLogoff L'azione restituisce il valore se esiste nel risultato JSON.
Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Arricchisci entità:

[
    {
        "EntityResult": {
            "primaryGroupID": [513],
            "logonCount": [6505],
            "cn": ["user name"],
            "countryCode": [0],
            "objectClass": ["top", "person", "organizationalPerson"],
            "userPrincipalName": ["user@example.com"],
            "adminCount": [1],
            "lastLogonTimestamp": ["2019-01-09 08:42:03.540783+00:00"],
            "manager": ["CN=user name,OU=R&D,OU=TLV,OU=host name,DC=domain,DC=LOCAL"],
            "instanceType": [4],
            "distinguishedName": ["CN=user name,OU=R&D,OU=TLV,OU=host,DC=domain,DC=LOCAL"],
            "dSCorePropagationData": ["2019-01-14 14:39:16+00:00"],
            "msDS-SupportedEncryptionTypes": [0],
            "objectSid": ["ID"],
            "whenCreated": ["2011-11-07 08:00:44+00:00"],
            "uSNCreated": [7288202],
            "lockoutTime": ["1601-01-01 00:00:00+00:00"],
            "badPasswordTime": ["date"],
            "pwdLastSet": ["date"],
            "sAMAccountName": ["example"],
            "objectCategory": ["CN=Person,CN=Schema,CN=Configuration,DC=host,DC=LOCAL"],
            "lastLogon": ["2019-01-14 17:13:54.463070+00:00"],
            "objectGUID": ["GUID"],
            "whenChanged": ["2019-01-14 16:49:01+00:00"],
            "badPwdCount": [1],
            "accountExpires": ["9999-12-31 23:59:59.999999"],
            "displayName": ["example user"],
            "name": ["user"],
            "memberOf": ["CN=\\\\u05e7\\\\u05d1\\\\u05d5\\\\u05e6\\\\u05d4 \\\\u05d1\\\\u05e2\\\\u05d1\\\\u05e8\\\\u05d9\\\\u05ea,OU=TEST,OU=QA,OU=IT,OU=TLV,OU=host,DC=domain,DC=LOCAL", "CN=Organization Management,OU=Microsoft Exchange Security Groups,DC=domain,DC=LOCAL", "CN=Local Admin,OU=Groups,OU=IT,OU=TLV,OU=host,DC=domain,DC=LOCAL"],
            "codePage": [0],
            "userAccountControl": [111],
            "sAMAccountType": [805306368],
            "uSNChanged": [15301168],
            "sn": ["example"],
            "givenName": ["user"],
            "lastLogoff": ["1601-01-01 00:00:00+00:00"
                          ]},
        "Entity": "user@example.com"
    }
]
Risultato dello script

La tabella seguente elenca il valore dell'output del risultato dello script quando utilizzi l'azione Arricchisci entità:

Nome del risultato dello script Valore
is_success True o False

Forza aggiornamento password

Utilizza l'azione Forza aggiornamento password per richiedere a un utente di cambiare la password al successivo accesso.

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

Input azione

Nessuno.

Output azione

L'azione Forza aggiornamento password fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca casi Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Non disponibile
Risultato dello script Disponibile
Risultato dello script

La tabella seguente elenca il valore dell'output del risultato dello script quando si utilizza l'azione Forza aggiornamento password:

Nome del risultato dello script Valore
is_success True o False

Ottieni membri del gruppo

Utilizza l'azione Recupera membri del gruppo per recuperare i membri di un gruppo Active Directory specificato.

Questa azione supporta il recupero dei membri utente e nome host e la ricerca all'interno di gruppi nidificati.

Input azione

L'azione Ottieni membri del gruppo richiede i seguenti parametri:

Parametro Descrizione
Group Name

Obbligatorio.

Il nome del gruppo che contiene i membri elencati.
Members Type

Obbligatorio.

Il tipo di membro del gruppo.

Il valore predefinito è User.
Perform Nested Search

Facoltativo.

Se selezionata, l'azione recupera ulteriori dettagli sui gruppi che fanno parte del gruppo principale.

Non selezionato per impostazione predefinita.
Limit

Obbligatorio.

Il numero massimo di schede da recuperare da Active Directory.

Il valore predefinito è 100.

Output azione

L'azione Recupera membri del gruppo fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca casi Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Risultato dello script Disponibile
Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando si utilizza l'azione Recupera membri gruppo:

[
  {
    "cn":"Example User1",
    "displayName":"Example User1",
    "distinguishedName":"CN=Example User1,OU=User Accounts,DC=example,DC=local"
  },
  {
    "cn":"Example User2",
    "displayName":"Example User2",
    "distinguishedName":"CN=Example User2,CN=Users,DC=example,DC=local"
  },
  {
    "cn":"Example User3",
    "displayName":"Example User3",
    "distinguishedName":"CN=Example User3,CN=Users,DC=example,DC=local"
  }
]
Risultato dello script

La tabella seguente elenca il valore dell'output del risultato dello script quando si utilizza l'azione Recupera membri del gruppo:

Nome del risultato dello script Valore
is_success True o False

Recuperare i dati di contatto del manager

Utilizza l'azione Ottieni dettagli di contatto del responsabile per ottenere i dettagli di contatto del responsabile da Active Directory.

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

Input azione

Nessuno.

Output azione

L'azione Recupera i dettagli di contatto del gestore fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca casi 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
Arricchimento delle entità

L'azione Recupera i dettagli di contatto del gestore supporta il seguente arricchimento dell'entità:

Nome del campo di arricchimento Logica
AD_Manager_Name L'azione restituisce il valore se esiste nel risultato JSON.
AD_Manager_phone L'azione restituisce il valore se esiste nel risultato JSON.
AD_primaryGroupID L'azione restituisce il valore se esiste nel risultato JSON.
AD_logonCount L'azione restituisce il valore se esiste nel risultato JSON.
AD_cn L'azione restituisce il valore se esiste nel risultato JSON.
AD_countryCode L'azione restituisce il valore se esiste nel risultato JSON.
AD_objectClass L'azione restituisce il valore se esiste nel risultato JSON.
AD_userPrincipalName L'azione restituisce il valore se esiste nel risultato JSON.
AD_adminCount L'azione restituisce il valore se esiste nel risultato JSON.
AD_lastLogonTimestamp L'azione restituisce il valore se esiste nel risultato JSON.
AD_manager L'azione restituisce il valore se esiste nel risultato JSON.
AD_instanceType L'azione restituisce il valore se esiste nel risultato JSON.
AD_distinguishedName L'azione restituisce il valore se esiste nel risultato JSON.
AD_dSCorePropagationData L'azione restituisce il valore se esiste nel risultato JSON.
AD_msDS-SupportedEncryptionTypes L'azione restituisce il valore se esiste nel risultato JSON.
AD_objectSid L'azione restituisce il valore se esiste nel risultato JSON.
AD_whenCreated L'azione restituisce il valore se esiste nel risultato JSON.
AD_uSNCreated L'azione restituisce il valore se esiste nel risultato JSON.
AD_lockoutTime L'azione restituisce il valore se esiste nel risultato JSON.
AD_badPasswordTime L'azione restituisce il valore se esiste nel risultato JSON.
AD_pwdLastSet L'azione restituisce il valore se esiste nel risultato JSON.
AD_sAMAccountName L'azione restituisce il valore se esiste nel risultato JSON.
AD_objectCategory L'azione restituisce il valore se esiste nel risultato JSON.
AD_lastLogon L'azione restituisce il valore se esiste nel risultato JSON.
AD_objectGUID L'azione restituisce il valore se esiste nel risultato JSON.
AD_whenChanged L'azione restituisce il valore se esiste nel risultato JSON.
AD_badPwdCount L'azione restituisce il valore se esiste nel risultato JSON.
AD_accountExpires L'azione restituisce il valore se esiste nel risultato JSON.
AD_displayName L'azione restituisce il valore se esiste nel risultato JSON.
AD_name L'azione restituisce il valore se esiste nel risultato JSON.
AD_memberOf L'azione restituisce il valore se esiste nel risultato JSON.
AD_codePage L'azione restituisce il valore se esiste nel risultato JSON.
AD_userAccountControl L'azione restituisce il valore se esiste nel risultato JSON.
AD_sAMAccountType L'azione restituisce il valore se esiste nel risultato JSON.
AD_uSNChanged L'azione restituisce il valore se esiste nel risultato JSON.
AD_sn L'azione restituisce il valore se esiste nel risultato JSON.
AD_givenName L'azione restituisce il valore se esiste nel risultato JSON.
AD_lastLogoff L'azione restituisce il valore se esiste nel risultato JSON.
Risultato JSON

Il seguente esempio mostra l'output del risultato JSON ricevuto quando si utilizza l'azione Ottieni dettagli contatto del gestore:

[
   {
        "EntityResult":
        {
            "primaryGroupID": [513],
            "logonCount": [6505],
            "cn": ["user name"],
            "countryCode": [0],
            "objectClass": ["top", "person", "organizationalPerson"],
            "userPrincipalName": ["user@example.com"],
            "adminCount": [1],
            "lastLogonTimestamp": ["2019-01-09 08:42:03.540783+00:00"],
            "manager": ["CN=user name,OU=R&D,OU=TLV,OU=host name,DC=domain,DC=LOCAL"],
            "instanceType": [4],
            "distinguishedName": ["CN=user name,OU=R&D,OU=TLV,OU=host,DC=domain,DC=LOCAL"],
            "dSCorePropagationData": ["2019-01-14 14:39:16+00:00"],
            "msDS-SupportedEncryptionTypes": [0],
            "objectSid": ["ID"],
            "whenCreated": ["2011-11-07 08:00:44+00:00"],
            "uSNCreated": [7288202],
            "lockoutTime": ["1601-01-01 00:00:00+00:00"],
            "badPasswordTime": ["date"],
            "pwdLastSet": ["date"],
            "sAMAccountName": ["example"],
            "objectCategory": ["CN=Person,CN=Schema,CN=Configuration,DC=host,DC=LOCAL"],
            "lastLogon": ["2019-01-14 17:13:54.463070+00:00"],
            "objectGUID": ["{id}"],
            "whenChanged": ["2019-01-14 16:49:01+00:00"],
            "badPwdCount": [1],
            "accountExpires": ["9999-12-31 23:59:59.999999"],
            "displayName": ["example"],
            "name": ["user"],
            "memberOf": ["CN= u05e7 u05d1 u05d5 u05e6 u05d4  u05d1 u05e2 u05d1 u05e8 u05d9 u05ea,OU=TEST,OU=QA,OU=IT,OU=TLV,OU=host,DC=domain,DC=LOCAL", "CN=Organization Management,OU=Microsoft Exchange Security Groups,DC=domain,DC=LOCAL", "CN=Local Admin,OU=Groups,OU=IT,OU=TLV,OU=host,DC=domain,DC=LOCAL"],
            "codePage": [0],
            "userAccountControl": [111],
            "sAMAccountType": [805306368],
            "uSNChanged": [15301168],
            "sn": ["example"],
            "givenName": ["user"],
            "lastLogoff": ["1601-01-01 00:00:00+00:00"]
        },
        "Entity": "user@example.com"
    }
]
Messaggi di output

L'azione Ping può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

All entities were processed successfully.

Some entities were processed successfully and some weren't. Please check the action log for further information.

No entities were processed.

 L'azione è riuscita.
Error executing action "Get Manager Contact Details". 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 Ottieni dettagli contatto del gestore:

Nome del risultato dello script Valore
is_success True o False

L'utente è nel gruppo

Utilizza l'azione L'utente fa parte del gruppo per verificare se l'utente è membro di un gruppo specifico.

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

Input azione

L'azione L'utente fa parte del gruppo richiede i seguenti parametri:

Parametro Descrizione
Group Name

Obbligatorio.

Il nome del gruppo da controllare, ad esempio administrators.

Output azione

L'azione L'utente fa parte del gruppo fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca casi Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Risultato dello script Disponibile
Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando si utilizza l'azione L'utente fa parte del gruppo:

[
    {
        "EntityResult": true,
        "Entity": "USER1@EXAMPLE.COM"
    }, {
        "EntityResult": false,
        "Entity": "USER2@EXAMPLE.COM"
    }, {
        "EntityResult": true,
        "Entity": "USER3@EXAMPLE.COM"
    }
]
Risultato dello script

La seguente tabella elenca il valore dell'output del risultato dello script quando utilizzi l'azione L'utente fa parte del gruppo:

Nome del risultato dello script Valore
is_success True o False

Elenca gruppi di utenti

Utilizza l'azione Elenca gruppi di utenti per ottenere un elenco di tutti i gruppi di utenti disponibili in Active Directory.

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

Input azione

Nessuno.

Output azione

L'azione Elenca gruppi di utenti fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca casi Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Risultato dello script Disponibile
Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando si utilizza l'azione Elenca gruppi di utenti:

[
    {
        "EntityResult": ["Domain Users"],
        "Entity": "user@example.com"
    }
]
Risultato dello script

La seguente tabella elenca il valore dell'output del risultato dello script quando utilizzi l'azione Elenca gruppi di utenti:

Nome del risultato dello script Valore
is_success True o False

Dindin

Utilizza l'azione Ping per testare la connettività ad Active Directory.

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 casi Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Non disponibile
Risultato dello script Disponibile
Risultato dello script

La tabella seguente elenca il valore dell'output del risultato dello script quando utilizzi l'azione Ping:

Nome del risultato dello script Valore
is_success True o False

Sblocca account

Utilizza l'azione Sblocca account per sbloccare un account bloccato.

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

Input azione

Nessuno.

Output azione

L'azione Sblocca account fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca casi Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Non disponibile
Risultato dello script Disponibile
Risultato dello script

La tabella seguente elenca il valore dell'output del risultato dello script quando utilizzi l'azione Sblocca account:

Nome del risultato dello script Valore
is_success True o False

Rimuovi utente dal gruppo

Utilizza l'azione Rimuovi utente dal gruppo per rimuovere l'utente dai gruppi.

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

Input azione

L'azione Rimuovi utente dal gruppo richiede i seguenti parametri:

Parametro Descrizione
Group Name

Obbligatorio.

Un elenco separato da virgole di gruppi da cui rimuovere gli utenti.

Output azione

L'azione Rimuovi utente dal gruppo fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca casi 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 users from the group "GROUP_NAME" in Active Directory: ENTITY_ID

The following users were not a part of the group "GROUP_NAME" in Active Directory: ENTITY_ID

Action wasn't able to remove the following users from the group "GROUP_NAME" in Active Directory: ENTITY_ID

No users were removed from the group "GROUP_NAME" in Active Directory.

No users were removed from the provided groups in Active Directory.

 L'azione è riuscita.
Error executing action "Remove User From 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

Cerca in Active Directory

Utilizza l'azione Cerca in Active Directory per cercare in Active Directory utilizzando una query specificata.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Cerca in Active Directory richiede i seguenti parametri:

Parametro Descrizione
Query String

Obbligatorio.

La stringa di query da eseguire in Active Directory.
Limit

Facoltativo.

Il numero massimo di schede da recuperare da Active Directory.

Output azione

L'azione Cerca in Active Directory fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca casi 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 si utilizza l'azione Cerca Active Directory:

[
      {
        "primaryGroupID": [
          513
        ],
        "logonCount": [
          6505
        ],
        "cn": [
          "user name"
        ],
        "countryCode": [
          0
        ],
        "objectClass": [
          "top",
          "person",
          "organizationalPerson"
        ],
        "userPrincipalName": [
          "user@example.com"
        ],
        "adminCount": [
          1
        ],
        "lastLogonTimestamp": [
          "2019-01-09 08:42:03.540783+00:00"
        ],
        "manager": [
          "CN=user name,OU=R&D,OU=TLV,OU=host name,DC=domain,DC=LOCAL"
        ],
        "instanceType": [
          4
        ],
        "distinguishedName": [
          "CN=user name,OU=R&D,OU=TLV,OU=host,DC=domain,DC=LOCAL"
        ],
        "dSCorePropagationData": [
          "2019-01-14 14:39:16+00:00"
        ],
        "msDS-SupportedEncryptionTypes": [
          0
        ],
        "objectSid": [
          "ID"
        ],
        "whenCreated": [
          "2011-11-07 08:00:44+00:00"
        ],
        "uSNCreated": [
          7288202
        ],
        "lockoutTime": [
          "1601-01-01 00:00:00+00:00"
        ],
        "badPasswordTime": [
          "date"
        ],
        "pwdLastSet": [
          "date"
        ],
        "sAMAccountName": [
          "example"
        ],
        "objectCategory": [
          "CN=Person,CN=Schema,CN=Configuration,DC=host,DC=LOCAL"
        ],
        "lastLogon": [
          "2019-01-14 17:13:54.463070+00:00"
        ],
        "objectGUID": [
          "GUID"
        ],
        "whenChanged": [
          "2019-01-14 16:49:01+00:00"
        ],
        "badPwdCount": [
          1
        ],
        "accountExpires": [
          "9999-12-31 23:59:59.999999"
        ],
        "displayName": [
          "example"
        ],
        "name": [
          "user"
        ],
        "memberOf": [
          "CN=\\\\u05e7\\\\u05d1\\\\u05d5\\\\u05e6\\\\u05d4 \\\\u05d1\\\\u05e2\\\\u05d1\\\\u05e8\\\\u05d9\\\\u05ea,OU=TEST,OU=QA,OU=IT,OU=TLV,OU=host,DC=domain,DC=LOCAL",
          "CN=Organization Management,OU=Microsoft Exchange Security Groups,DC=domain,DC=LOCAL",
          "CN=Local Admin,OU=Groups,OU=IT,OU=TLV,OU=host,DC=domain,DC=LOCAL"
        ],
        "codePage": [
          0
        ],
        "userAccountControl": [
          111
        ],
        "sAMAccountType": [
          805306368
        ],
        "uSNChanged": [
          15301168
        ],
        "sn": [
          "example"
        ],
        "givenName": [
          "user"
        ],
        "lastLogoff": [
          "1601-01-01 00:00:00+00:00"
        ]
      }
    ]
Messaggi di output

L'azione Cerca in Active Directory può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

Successfully performed the query "QUERY_STRING" in Active Directory.

No results to show following the query: "QUERY_STRING".

 L'azione è riuscita.
Error executing action "Search Active Directory". 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 si utilizza l'azione Cerca Active Directory:

Nome del risultato dello script Valore
is_success True o False

Imposta password utente

Utilizza l'azione Imposta password utente per configurare la password utente.

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

Input azione

L'azione Imposta password utente richiede i seguenti parametri:

Parametro Descrizione
New Password

Obbligatorio.

Un nuovo valore della password.

Output azione

L'azione Imposta password utente fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca casi Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Non disponibile
Risultato dello script Disponibile
Risultato dello script

La tabella seguente elenca il valore dell'output del risultato dello script quando utilizzi l'azione Imposta password utente:

Nome del risultato dello script Valore
is_success True o False

Aggiorna gli attributi di un host AD

Utilizza l'azione Aggiorna gli attributi di un host AD per aggiornare gli attributi degli host attuali in Active Directory.

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

Input azione

L'azione Aggiorna gli attributi di un host AD richiede i seguenti parametri:

Parametro Descrizione
Attribute Name

Obbligatorio.

Il nome dell'attributo da aggiornare, ad esempio Description.
Attribute Value

Obbligatorio.

Un nuovo valore per l'attributo.

Output azione

L'azione Aggiorna gli attributi di un host AD fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca casi 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 Aggiorna gli attributi di un host AD può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

Active Directory - Following entities were updated successfully: ENTITY_ID_LIST.

No suitable entities were found.

 L'azione è riuscita.
Failed to update the ATTRIBUTE_NAME for the following entities: ENTITY_ID_LIST.

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 Aggiorna gli attributi di un host AD:

Nome del risultato dello script Valore
is_success True o False

Aggiornare gli attributi di un utente AD

Utilizza l'azione Aggiorna attributi di un utente AD per aggiornare gli attributi degli utenti correnti in Active Directory.

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

Input azione

L'azione Aggiorna attributi di un utente AD richiede i seguenti parametri:

Parametro Descrizione
Attribute Name

Obbligatorio.

Il nome dell'attributo da aggiornare, ad esempio Description.
Attribute Value

Obbligatorio.

Un nuovo valore per l'attributo.

Output azione

L'azione Aggiorna attributi di un utente AD fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca casi 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 Aggiorna attributi di un utente AD può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

Active Directory - Following entities were updated successfully: ENTITY_ID_LIST.

No suitable entities were found.

 L'azione è riuscita.
Failed to update the ATTRIBUTE_NAME for the following entities: ENTITY_ID_LIST.

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 Aggiorna gli attributi di un utente AD:

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.