Integra Active Directory con Google SecOps

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

Nota: 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 Active Directory utilizza le funzionalità di Google SecOps per supportare i seguenti casi d'uso:

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

• Reimposta le password: reimposta automaticamente la password utente in Active Directory e comunica la modifica all'utente.

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

• Recupera le informazioni dell'utente: recupera i dettagli dell'utente, come le iscrizioni ai gruppi, l'ora dell'ultimo accesso e i dati di contatto di un account utente specifico.

• Automatizza l'offboarding: disattiva gli account, rimuovili dai gruppi e trasferisci la proprietà dei file quando un dipendente lascia l'azienda.

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 la tua istanza Google SecOps (o l'agente remoto) e i domain controller Active Directory.

2. (Facoltativo) Se ti connetti tramite LDAPS (porta 636, richiesta per le reimpostazioni della password) utilizzando un'autorità di certificazione interna, configura il certificato CA codificando il certificato radice o intermedio in una stringa base64.

3. Crea un service account Active Directory dedicato rispettando il principio del privilegio minimo.

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

5. Delega le autorizzazioni sulle unità organizzative di destinazione per le azioni che prevedi di utilizzare (utilizzando Utenti e computer di Active Directory o PowerShell e dsacls), assicurandoti che l'account di servizio abbia accesso esplicito in lettura e scrittura all'attributo userAccountControl.

Requisiti di rete e DNS

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

Assicurati che l'ambiente di rete soddisfi le seguenti regole di connettività:

• Connettività delle porte: assicurati che i firewall e il routing della rete consentano la comunicazione in uscita da Google SecOps (o dall'agente remoto) ai domain controller 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 della directory criptato ed è obbligatorio per le azioni di modifica della password.

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

Configura il file /etc/hosts

Questa configurazione è facoltativa. Se il tuo domain controller è già risolto tramite la configurazione del DNS interno, salta questa sezione. Se l'agente remoto non riesce a risolvere il domain controller Active Directory utilizzando il DNS, mappa manualmente l'host nel file /etc/hosts in modo che corrisponda ai certificati SSL/TLS e alle associazioni del servizio di directory.

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 domain controller al relativo 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.

Configura il certificato CA

Questo passaggio è facoltativo. Se ti connetti utilizzando LDAP standard (porta 389) o utilizzi un certificato pubblicamente attendibile, salta questa sezione e vai a Requisiti di autenticazione e del service account. Se ti connetti tramite LDAPS (porta 636, richiesta per le reimpostazioni della password) utilizzando un certificato emesso 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 l'intera stringa di output (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) sul certificato.

4. Fai clic su Test per convalidare il TLS handshake.

Requisiti di autenticazione e 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) specifico 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 nome dell'entità utente (UPN) (ad esempio [e-mail]) o come nome di accesso di livello precedente (EXAMPLE\svc_secops).

• PoLP: non aggiungere il account di servizio a gruppi integrati con privilegi come Domain Admins, Enterprise Admins o Account Operators. Concedi invece autorizzazioni granulari a UO specifiche in cui risiedono gli oggetti utente, computer o gruppo.

Configura le autorizzazioni per le azioni (privilegio minimo)

Concedi al account di servizio di autenticazione solo le autorizzazioni Active Directory e l'accesso agli attributi LDAP necessari per le azioni specifiche che prevedi di eseguire.

Importante: le azioni di controllo dello stato e del ciclo di vita (tra cui Attiva account, Disattiva account, Attiva computer, Disattiva computer e Arricchisci entità) richiedono diritti espliciti di lettura e scrittura della proprietà sull'attributo userAccountControl.

Se l'account di servizio non può leggere userAccountControl, Active Directory omette completamente l'attributo dalle risposte LDAP. In Google SecOps, questo genera eccezioni null non gestite (come TypeError: 'NoneType' object is not subscriptable). Assicurati che questo attributo sia delegato esplicitamente a tutte le UO di destinazione.

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

Nome azione	Autorizzazione AD DS/diritto esteso richiesto	Classe oggetto target	Descrizione/Ambito di attribuzione
Ping	Read Property	Utente, radice dominio	Esegue una query sull'oggetto account di servizio configurato (sAMAccountName, userPrincipalName, mail) per convalidare la connettività e le credenziali della directory.
Arricchisci 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 iscrizioni ai gruppi nidificati. Richiede Read Property su userAccountControl per evitare errori di indice nullo.
Disattiva account	Read Property: userAccountControl Write Property: userAccountControl	Utente	Legge e imposta il flag ACCOUNTDISABLE (0x0002) sull'oggetto utente di destinazione.
Attiva account	Read Property: userAccountControl Write Property: userAccountControl	Utente	Legge e cancella il flag ACCOUNTDISABLE (0x0002) sull'oggetto utente di destinazione.
Disattiva 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 bloccato	Read Property: lockoutTime Write Property: lockoutTime	Utente	Legge e imposta l'attributo lockoutTime su 0 per sbloccare un account utente bloccato.
Forza l'aggiornamento della password	Read Property: pwdLastSet Write Property: pwdLastSet	Utente	Legge e imposta l'attributo pwdLastSet su 0 per richiedere all'utente di cambiare la password al prossimo accesso.
Imposta password utente	Esteso a destra: 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 (distinguishedName) dell'utente di destinazione all'attributo member del gruppo.
Rimuovi utente dal gruppo	Read Property: member Write Property: member	Gruppo	Rimuove il nome distinto dell'utente di destinazione (distinguishedName) dall'attributo member del gruppo.
Cambia UO utente	Delete Child Object (utente) nell'UO di origine Create Child Object (utente) nell'UO di destinazione Write Property: name, distinguishedName	Unità organizzativa, utente	Sposta gli oggetti utente tra le UO utilizzando LDAP modify_dn.
Cambia l'UO host	Delete Child Object (computer) nell'UO di origine Create Child Object (Computer) nell'UO di destinazione Write Property: name, distinguishedName	Unità organizzativa, computer	Sposta gli oggetti computer tra le UO utilizzando LDAP modify_dn.
Aggiorna gli attributi di un utente AD	Write Property sugli attributi target (come mail, title, department, telephoneNumber, description o manager)	Utente	Modifica i valori degli attributi specificati nell'oggetto utente di destinazione.
Aggiorna gli attributi di un host AD	Write Property sugli attributi target (come description o location)	Computer	Modifica i valori degli attributi specificati nell'oggetto computer di destinazione.
Recupera i membri del gruppo	List Contents Read Property: member, sAMAccountName, distinguishedName	Gruppo, Utente, Computer	Esegue query sull'appartenenza ai gruppi e sugli attributi degli account dei membri.
Get Manager Contact Details	Read Property: manager Read Property: cn, telephoneNumber, mail, displayName, title	Utente	Legge l'attributo manager dall'oggetto utente di destinazione e recupera i dati di contatto del responsabile.
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.
Cerca in Active Directory	List Contents Read Property sugli attributi interrogati	Utente, computer, gruppo, unità organizzativa	Esegue query di filtro LDAP personalizzate sulla sottostruttura della directory.

Delega delle autorizzazioni in Active Directory

Per applicare il PoLP senza concedere diritti amministrativi ampi, delega le autorizzazioni alle UO di destinazione utilizzando la console ADUC grafica o gli strumenti a riga di comando PowerShell e dsacls. Devi utilizzare solo uno di questi metodi e delegare solo le autorizzazioni necessarie per le azioni specifiche che prevedi di eseguire.

Delega il controllo utilizzando ADUC

Se preferisci utilizzare un'interfaccia grafica, utilizza la Delega guidata del controllo in ADUC per delegare le autorizzazioni specifiche per oggetti e proprietà.

Esegui la procedura guidata nell'UO di destinazione per concedere le autorizzazioni per oggetti e proprietà necessarie per le azioni che intendi utilizzare (ad esempio la lettura e la scrittura dei flag di controllo dell'account, la reimpostazione delle password o lo sblocco degli account).

Per istruzioni passo passo sull'esecuzione della procedura guidata, consulta la documentazione di Microsoft sulla delega del controllo in AD DS.

Delega il controllo utilizzando PowerShell e dsacls

Se preferisci un approccio da riga di comando o vuoi automatizzare le assegnazioni delle autorizzazioni, utilizza PowerShell con l'utilità dsacls.exe integrata anziché ADUC.

Esegui solo gli esempi di comandi che si applicano alle azioni che prevedi di utilizzare su una workstation amministrativa o un domain controller, sostituendo l'UO di destinazione e il nome del account di servizio:

• Concedi le autorizzazioni di lettura e scrittura su userAccountControl per gli oggetti utente (per attivare o disattivare gli account utente ed evitare errori di arricchimento): powershell dsacls.exe "OU=Users,DC=example,DC=local" /I:S /G "EXAMPLE\svc_secops_ad:RPWP;userAccountControl;user"
• Concedi le autorizzazioni di lettura e scrittura su userAccountControl per gli oggetti computer (per attivare o disattivare i computer): powershell dsacls.exe "OU=Computers,DC=example,DC=local" /I:S /G "EXAMPLE\svc_secops_ad:RPWP;userAccountControl;computer"
• Concedi le autorizzazioni per sbloccare l'account (lockoutTime): powershell dsacls.exe "OU=Users,DC=example,DC=local" /I:S /G "EXAMPLE\svc_secops_ad:RPWP;lockoutTime;user"
• Concedi 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:RPWP;pwdLastSet;user"
• Concedi 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"
• Concedi i diritti di modifica dell'appartenenza 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 maggiori dettagli sulla sintassi e sugli switch dei parametri, consulta la documentazione di Microsoft su dsacls.

Nota: in Active Directory, l'ereditarietà è disattivata per i membri dei gruppi amministrativi protetti dal processo interno AdminSDHolder. Le autorizzazioni delegate assegnate a livello di UO non verranno applicate agli account amministratore protetti.

Per ulteriori informazioni sulla gestione degli oggetti protetti, consulta la documentazione di Microsoft su AdminSDHolder e account protetti.

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 esempio mydomain.com:636). Per impostazione predefinita, l'integrazione utilizza la porta 636 quando SSL/TLS è abilitato e la porta 389 quando è disabilitato.
Username	Obbligatorio. Il nome utente o l'indirizzo email dell'utente per la connessione ad Active Directory, ad esempio DOMAIN\username o [e-mail]. Questo parametro accetta anche l'attributo userPrincipalName.
Password	Obbligatorio. La password dell'account utente.
Domain	Obbligatorio. Il percorso DNS completo del tuo dominio all'interno dello spazio dei nomi di rete. Fornisci 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, l'FQDN da inserire è corp.example.com.
Custom Query Fields	Facoltativo. Un elenco separato da virgole di campi Active Directory personalizzati da includere nelle query, ad esempio customField1, customField2.
CA Certificate File - parsed into Base64 String	Facoltativo. La stringa del file del certificato CA codificata nel formato base64 ottenuto durante la configurazione del certificato CA. Fornisci il valore completo.
Use SSL	Facoltativo. Se selezionata, l'integrazione convalida il certificato SSL durante la connessione al server di directory Active Directory e utilizza LDAPS sicuro (porta 636). Se non viene selezionata, viene utilizzato l'LDAP standard (porta 389).
Debug Logging	Facoltativo. Se selezionata, l'integrazione registra informazioni di debug dettagliate per le operazioni di Active Directory.

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

Se necessario, puoi apportare modifiche in un secondo momento. Dopo aver configurato un'istanza di integrazione, puoi utilizzarla nei playbook. Per saperne di più su come configurare e supportare più istanze, consulta Supporto di più istanze.

Azioni

Per saperne di più sulle azioni, consulta Rispondi alle azioni in attesa dalla scrivania di lavoro ed Esegui un'azione manuale nel tuo caso.

Aggiungi utente al gruppo

Utilizza l'azione Aggiungi utente al gruppo per aggiungere utenti della richiesta a uno o più gruppi di Active Directory, ad esempio per aggiungere un account a un gruppo con accesso limitato durante un'indagine. L'azione identifica automaticamente gli utenti target dalla richiesta e li aggiunge ai gruppi specificati.

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

Output azione

L'azione Aggiungi utente al 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 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	L'azione è andata a buon fine.
Action wasn't able to add the following users to the group "GROUP_NAME" in Active Directory: ENTITY_ID	L'azione non è riuscita per gli utenti specificati. Verifica che il account di servizio disponga dell'autorizzazione per modificare l'attributo member nel gruppo di destinazione.
The following users were not found in Active Directory: ENTITY_ID	L'azione non è riuscita per gli utenti specificati. Verifica che gli account utente esistano in Active Directory e che gli identificatori delle entità corrispondano a nomi utente o indirizzi email validi.
The following groups were not found in Active Directory: GROUP_NAME	L'azione non è riuscita per i gruppi specificati. Controlla l'ortografia dei nomi dei gruppi nel parametro Group Name e verifica che i gruppi esistano nel dominio configurato.
No users were added to the group "GROUP_NAME" in Active Directory.	L'azione non è riuscita per il gruppo specificato. Verifica che gli utenti di destinazione esistano in Active Directory e che il account di servizio disponga dell'accesso in scrittura al gruppo specificato.
No users were added to the provided groups in Active Directory.	L'azione non è andata a buon fine. Verifica che la richiesta contenga entità User valide e che i gruppi specificati esistano in Active Directory.
Error executing action "Add User To Group". Reason: ERROR_REASON	L'azione non è andata a buon fine. Controlla la connessione al server Active Directory, i parametri di input o le credenziali del account di servizio.

Risultato dello script

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

Nome del risultato dello script	Valore
is_success	true o false

Cambia UO host

Utilizza l'azione Cambia UO host per spostare i computer nel caso in un'altra unità organizzativa in Active Directory, ad esempio per spostare una macchina compromessa in un'UO di quarantena con policy limitate. L'azione identifica automaticamente i computer di destinazione dalla richiesta e li sposta nell'UO di destinazione specificata.

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

Output azione

L'azione Cambia UO host fornisce i seguenti output:

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

Messaggi di output

L'azione Cambia UO host può restituire i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Changed OU for the following hosts: ENTITY_ID	L'azione è andata a buon fine.
Failed to change OU for the following hosts : ENTITY_ID	L'azione non è riuscita per gli host specificati. Verifica che la UO di destinazione esista e che l'account di servizio disponga dell'autorizzazione per spostare gli oggetti computer tra le UO di origine e di destinazione.
The following hosts were not found in Active Directory: ENTITY_ID	L'azione non è riuscita per gli host specificati. Verifica che gli account computer esistano in Active Directory e corrispondano alle entità Hostname nel caso.
The action didn't change OU on any hosts.	L'azione non è andata a buon fine. Verifica che i computer di destinazione e l'UO di destinazione esistano in Active Directory e che il account di servizio disponga delle autorizzazioni per spostare gli account computer.
Error executing action "Change Host OU". Reason: ERROR_REASON	L'azione non è andata a buon fine. Controlla la connessione al server Active Directory, il parametro OU Name o le credenziali del account di servizio.

Risultato dello script

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

Nome del risultato dello script	Valore
is_success	true o false

Cambia UO utente

Utilizza l'azione Cambia UO utente per spostare gli utenti della richiesta in un'altra unità organizzativa in Active Directory, ad esempio per spostare un account in un'UO con restrizioni durante un incidente o un workflow di offboarding. L'azione identifica automaticamente gli utenti target della richiesta e li sposta nell'UO di destinazione specificata.

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

Output azione

L'azione Cambia UO 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 Cambia UO utente può restituire i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Changed OU for the following users: ENTITY_ID	L'azione è andata a buon fine.
Failed to change OU for the following users : ENTITY_ID	L'azione non è riuscita per gli utenti specificati. Verifica che la UO di destinazione esista e che il account di servizio disponga dell'autorizzazione per spostare gli oggetti utente tra le UO di origine e di destinazione.
The following users were not found in Active Directory: ENTITY_ID	L'azione non è riuscita per gli utenti specificati. Verifica che gli account utente esistano in Active Directory e corrispondano alle entità User nella richiesta.
The action didn't change OU on any users.	L'azione non è andata a buon fine. Verifica che gli utenti di destinazione e l'UO di destinazione esistano in Active Directory e che il account di servizio disponga delle autorizzazioni per spostare gli account utente.
Error executing action "Change User OU". Reason: ERROR_REASON	L'azione non è andata a buon fine. Controlla la connessione al server Active Directory, il parametro OU Name o le credenziali del account di servizio.

Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Cambia UO utente:

Nome del risultato dello script	Valore
is_success	true o false

Disabilita account

Utilizza l'azione Disattiva account per disattivare gli account utente in Active Directory. Questa azione ha come target automatico gli utenti collegati alla richiesta.

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 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
Disabled account for the following users: ENTITY_ID	L'azione è andata a buon fine.
Failed to disable account for the following users: ENTITY_ID	L'azione non è riuscita per gli utenti specificati. Verifica che il account di servizio disponga delle autorizzazioni di lettura e scrittura per l'attributo userAccountControl negli account utente di destinazione e che gli utenti non siano account amministrativi protetti.
The following users were not found in Active Directory: ENTITY_ID	L'azione non è riuscita per gli utenti specificati. Verifica che gli account utente esistano in Active Directory e corrispondano alle entità User nella richiesta.
No users were disabled in Active Directory.	L'azione non è andata a buon fine. Verifica che la richiesta contenga entità User valide e che il account di servizio disponga dell'autorizzazione per disattivare gli account di destinazione.
Error executing action "Disable Account". Reason: ERROR_REASON	L'azione non è andata a buon fine. Controlla la connessione al server Active Directory o le credenziali del account di servizio.

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

Disattiva computer

Utilizza l'azione Disattiva computer per disattivare gli account computer in Active Directory e impedire l'autenticazione nel dominio di macchine compromesse o non autorizzate. L'azione ha come target automatico i nomi host allegati alla richiesta.

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 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 computer può restituire i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Successfully disabled the following computers in Active Directory: ENTITY_ID The following computers were already disabled in Active Directory: ENTITY_ID	L'azione è andata a buon fine.
Action wasn't able to disable the following computers in Active Directory: ENTITY_ID	L'azione non è riuscita per i computer specificati. Verifica che il account di servizio disponga delle autorizzazioni di lettura e autorizzazione in scrittura per l'attributo userAccountControl sugli oggetti computer di destinazione.
The following computers were not found in Active Directory: ENTITY_ID	L'azione non è riuscita per i computer specificati. Verifica che gli account computer esistano in Active Directory e corrispondano alle entità Hostname nel caso.
No computers were disabled in Active Directory.	L'azione non è andata a buon fine. Verifica che la richiesta contenga entità Hostname valide e che il account di servizio disponga dell'autorizzazione per disattivare gli account dei computer di destinazione.
Error executing action "Disable Computer". Reason: ERROR_REASON	L'azione non è andata a buon fine. Controlla la connessione al server Active Directory o le credenziali del account di servizio.

Risultato dello script

La tabella seguente elenca il valore per l'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 riattivare gli account utente disattivati in Active Directory. L'azione ha come target automatico gli utenti collegati alla richiesta.

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

Input azione

Nessuno.

Output azione

L'azione Attiva account fornisce i seguenti output:

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

Messaggi di output

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

Messaggio di output	Descrizione del messaggio
Successfully enabled the following users in Active Directory: ENTITY_ID The following users were already enabled in Active Directory: ENTITY_ID	L'azione è andata a buon fine.
Action wasn't able to enable the following users in Active Directory: ENTITY_ID	L'azione non è riuscita per gli utenti specificati. Verifica che il account di servizio disponga delle autorizzazioni di lettura e autorizzazione in scrittura per l'attributo userAccountControl negli account utente di destinazione.
The following users were not found in Active Directory: ENTITY_ID	L'azione non è riuscita per gli utenti specificati. Verifica che gli account utente esistano in Active Directory e corrispondano alle entità User nella richiesta.
No users were enabled in Active Directory.	L'azione non è andata a buon fine. Verifica che la richiesta contenga entità User valide e che il account di servizio disponga dell'autorizzazione per attivare gli account di destinazione.
Error executing action "Enable Account". Reason: ERROR_REASON	L'azione non è andata a buon fine. Controlla la connessione al server Active Directory o le credenziali del account di servizio.

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

Attiva computer

Utilizza l'azione Attiva computer per riattivare gli account computer disattivati in Active Directory in modo che le macchine possano autenticarsi nuovamente nel dominio. L'azione sceglie automaticamente come target i nomi host associati alla richiesta.

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

Input azione

Nessuno.

Output azione

L'azione Attiva computer 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 computer può restituire i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Successfully enabled the following computers in Active Directory: ENTITY_ID The following computers were already enabled in Active Directory: ENTITY_ID	L'azione è andata a buon fine.
Action wasn't able to enable the following computers in Active Directory: ENTITY_ID	L'azione non è riuscita per i computer specificati. Verifica che il account di servizio disponga delle autorizzazioni di lettura e autorizzazione in scrittura per l'attributo userAccountControl sugli oggetti computer di destinazione.
The following computers were not found in Active Directory: ENTITY_ID	L'azione non è riuscita per i computer specificati. Verifica che gli account computer esistano in Active Directory e corrispondano alle entità Hostname nel caso.
No computers were enabled in Active Directory.	L'azione non è andata a buon fine. Verifica che la richiesta contenga entità Hostname valide e che l'account di servizio disponga dell'autorizzazione per abilitare gli account dei computer di destinazione.
Error executing action "Enable Computer". Reason: ERROR_REASON	L'azione non è andata a buon fine. Controlla la connessione al server Active Directory o le credenziali del account di servizio.

Risultato dello script

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

Nome del risultato dello script	Valore
is_success	true o false

Arricchisci le entità

Utilizza l'azione Arricchisci entità per recuperare i dettagli del profilo Active Directory, lo stato dell'account e le iscrizioni ai gruppi per gli utenti e i computer nel caso. Puoi arricchire le entità con tutte le informazioni della directory disponibili o limitare i risultati e la tabella della bacheca delle richieste ad attributi specifici.

Questa azione è asincrona. Se necessario, modifica il valore di timeout dello script nell'IDE di 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	Facoltativo. Se selezionata, l'azione contrassegna automaticamente le entità arricchite correttamente come entità interne. Abilitato per impostazione predefinita.
Create Case Wall Table	Facoltativo. Se selezionata, l'azione genera una tabella della bacheca del caso contenente gli attributi di Active Directory recuperati per ogni entità arricchita. Abilitato per impostazione predefinita.
Specific Attribute Names To Enrich With	Facoltativo. Un elenco separato da virgole di nomi di attributi con cui arricchire le entità. Se non fornisci 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 in Specific Attribute Names To Enrich With.
Should JSON result be filtered by the specified Attributes?	Facoltativo. Se selezionata, il risultato JSON restituisce solo gli attributi specificati in Specific Attribute Names To Enrich With.

Output azione

L'azione Arricchisci entità fornisce i seguenti output:

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

Tabella della bacheca casi

L'azione Arricchisci entità fornisce la seguente tabella nella bacheca delle richieste quando è selezionato Create Case Wall Table:

• Nome tabella: Report for: <var class="readonly">ENTITY_ID</var>
• Colonne: nomi e valori degli attributi Active Directory recuperati per l'entità (o filtrati in base al parametro Specific Attribute Names To Enrich With se è selezionato Should Case Wall Table be filtered by the specified Attributes?).

Enrichment delle entità

L'azione Enrich Entities 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": ["[e-mail]"],
            "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": "[e-mail]"
    }
]

Messaggi di output

L'azione Arricchisci entità può restituire i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Active Directory Permalink: SERVER Enriched the following Users ENTITY_ID Enriched the following Hosts ENTITY_ID All entities were enriched.	L'azione è andata a buon fine.
The following entities were not found in Active Directory: ENTITY_ID	L'azione non è riuscita per le entità specificate. Verifica che gli account utente o host esistano in Active Directory e corrispondano agli identificatori delle entità nel caso.
Failed to enrich the following Users ENTITY_ID	L'azione non è riuscita per gli utenti specificati. Verifica che l'account di servizio disponga dell'autorizzazione per leggere gli attributi (incluso userAccountControl) negli account utente di destinazione e controlla che gli attributi personalizzati esistano in Active Directory.
Failed to enrich the following Hosts ENTITY_ID	L'azione non è riuscita per gli host specificati. Verifica che l'account di servizio disponga dell'autorizzazione per leggere gli attributi (incluso userAccountControl) negli account dei computer di destinazione e controlla che in Active Directory siano presenti attributi personalizzati.
No entities were enriched.	L'azione non è andata a buon fine. Verifica che la richiesta contenga entità User o Hostname valide che esistono in Active Directory.
Error executing action "Enrich Entities". Reason: ERROR_REASON	L'azione non è andata a buon fine. Controlla la connessione al server di directory Active Directory, i campi delle query personalizzate o le credenziali del account di servizio.

Risultato dello script

La tabella seguente elenca il valore per l'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 l'aggiornamento della password per richiedere agli utenti di cambiare la password al successivo accesso. L'azione ha come target automatico gli utenti collegati alla richiesta.

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

Input azione

Nessuno.

Output azione

L'azione Forza l'aggiornamento della password fornisce i seguenti output:

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

Messaggi di output

L'azione Forza aggiornamento password può restituire i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Forced password update on next logon for the following users: ENTITY_ID	L'azione è andata a buon fine.
Failed to force password update on next logon for the following users: ENTITY_ID	L'azione non è riuscita per gli utenti specificati. Verifica che il account di servizio disponga delle autorizzazioni di lettura e scrittura per l'attributo pwdLastSet negli account utente di destinazione.
The following users were not found in Active Directory: ENTITY_ID	L'azione non è riuscita per gli utenti specificati. Verifica che gli account utente esistano in Active Directory e corrispondano alle entità User nella richiesta.
Password update wasn't forced on any users.	L'azione non è andata a buon fine. Verifica che la richiesta contenga entità User valide e che il account di servizio disponga dell'autorizzazione per aggiornare le impostazioni di scadenza della password.
Error executing action "Force Password Update". Reason: ERROR_REASON	L'azione non è andata a buon fine. Controlla la connessione al server Active Directory o le credenziali del account di servizio.

Risultato dello script

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

Nome del risultato dello script	Valore
is_success	true o false

Ottieni membri del gruppo

Utilizza l'azione Get Group Members (Recupera membri del gruppo) per elencare gli utenti, i computer o entrambi che appartengono a un gruppo Active Directory specifico. Se vuoi, puoi restringere la ricerca a un'unità organizzativa o a un gruppo principale specifico e includere i membri dei sottogruppi nidificati.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Recupera 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 da recuperare dal gruppo. I valori possibili sono: Only Users Only Hosts Both Il valore predefinito è Only Users.
Where To Search	Obbligatorio. Un Organizational Unit o Group specifico per limitare l'ambito della ricerca. I valori possibili sono: Select Option Organizational Unit Group Il valore predefinito è Select Option.
Filter Object Value	Facoltativo. Il nome di Organizational Unit o Group in cui l'azione cerca il gruppo di destinazione. Questo parametro è obbligatorio se Where To Search è impostato su Organizational Unit o Group.
Perform Nested Search	Facoltativo. Se selezionata, l'azione recupera i membri dai sottogruppi nidificati che appartengono al gruppo di destinazione.
Limit	Facoltativo. 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 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 Recupera membri del gruppo fornisce la seguente tabella nella bacheca della richiesta:

• Nome tabella: Members of Active Directory group: <var class="readonly">GROUP_NAME</var>
• Colonne:
  • Distinguished Name
  • SAM Account Name
  • User Principal Name
  • Type

Risultato JSON

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

[
  {
    "dn": "CN=Example User1,OU=User Accounts,DC=example,DC=local",
    "sAMAccountName": "ExampleUser1",
    "userPrincipalName": "[e-mail]",
    "type": "CN=Person,CN=Schema,CN=Configuration,DC=example,DC=local"
  },
  {
    "dn": "CN=Example User2,CN=Users,DC=example,DC=local",
    "sAMAccountName": "ExampleUser2",
    "userPrincipalName": "[e-mail]",
    "type": "CN=Person,CN=Schema,CN=Configuration,DC=example,DC=local"
  }
]

Messaggi di output

L'azione Get Group Members può restituire i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Successfully retrieved members of the group "GROUP_NAME" from Active Directory. Group "GROUP_NAME" doesn't contain any members matching search criteria in Active Directory.	L'azione è andata a buon fine.
Error executing action "Get Group Members". Reason: Filter Object Value should be provided	L'azione non è andata a buon fine. Fornisci un nome UO o gruppo valido nel parametro Filter Object Value quando Where To Search è impostato su Organizational Unit o Group.
Error executing action "Get Group Members". Reason: Given value for Limit should be a positive number.	L'azione non è andata a buon fine. Inserisci un numero intero maggiore di 0 nel parametro Limit.
Error executing action "Get Group Members". Reason: Given group doesn't exist in Active Directory.	L'azione non è andata a buon fine. Controlla il nome del gruppo nel parametro Group Name e verifica che il gruppo esista nell'ambito di ricerca configurato.
Error executing action "Get Group Members". Reason: Specified Organizational Unit doesn't exist in Active Directory.	L'azione non è andata a buon fine. Verifica che l'unità organizzativa specificata in Filter Object Value esista in Active Directory.
Error executing action "Get Group Members". Reason: Specified Group in "Filter Object Value" doesn't exist in Active Directory.	L'azione non è andata a buon fine. Verifica che il gruppo principale specificato in Filter Object Value esista in Active Directory.
Error executing action "Get Group Members". Reason: ERROR_REASON	L'azione non è andata a buon fine. Controlla la connessione al server Active Directory, i parametri di input o le credenziali del account di servizio.

Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Recupera i membri del gruppo:

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 gestore per cercare il gestore di un utente in Active Directory e recuperare i suoi dati di contatto. L'azione ha come target automatico gli utenti collegati alla richiesta.

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

Input azione

Nessuno.

Output azione

L'azione Recupera i dati di contatto del responsabile fornisce i seguenti output:

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

Tabella della bacheca casi

L'azione Recupera i dati di contatto del gestore fornisce la seguente tabella nella bacheca della richiesta:

• Nome tabella: Manager Contact: <var class="readonly">ENTITY_ID</var>
• Colonne:
  • Manager Name
  • Manager Phone

Enrichment delle entità

L'azione Recupera i dati di contatto del gestore supporta il seguente arricchimento delle 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

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Recupera i dati di contatto del gestore:

[
   {
        "EntityResult":
        {
            "primaryGroupID": [513],
            "logonCount": [6505],
            "cn": ["user name"],
            "countryCode": [0],
            "objectClass": ["top", "person", "organizationalPerson"],
            "userPrincipalName": ["[e-mail]"],
            "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"]
        },
        "Entity": "[e-mail]"
    }
]

Messaggi di output

L'azione Get Manager Contact Details può restituire i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Retrieved manager details for the following users: ENTITY_ID	L'azione è andata a buon fine.
The following users don't have managers specified in Active Directory: ENTITY_ID	L'azione non è riuscita per gli utenti specificati. Verifica che l'attributo manager sia compilato negli account utente di destinazione in Active Directory.
Failed to retrieve manager details for the following users: ENTITY_ID	L'azione non è riuscita per gli utenti specificati. Verifica che il account di servizio disponga dell'autorizzazione per leggere l'attributo manager e il profilo utente del responsabile in Active Directory.
The following users were not found in Active Directory: ENTITY_ID	L'azione non è riuscita per gli utenti specificati. Verifica che gli account utente esistano in Active Directory e corrispondano alle entità User nella richiesta.
No manager details were retrieved for the provided users.	L'azione non è andata a buon fine. Verifica che la richiesta contenga entità User valide a cui è assegnato un gestore in Active Directory.
Error executing action "Get Manager Contact Details". Reason: ERROR_REASON	L'azione non è andata a buon fine. Controlla la connessione al server Active Directory o le credenziali del account di servizio.

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 (L'utente è nel gruppo) per verificare se utenti specifici appartengono a un determinato gruppo di Active Directory. Per impostazione predefinita, l'azione controlla le entità User nella richiesta, oppure puoi inserire un elenco di nomi utente separati da virgole nel parametro User Name per controllare direttamente account specifici.

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

Input azione

L'azione Is User In Group richiede i seguenti parametri:

Parametro	Descrizione
Group Name	Obbligatorio. Il nome del gruppo da controllare, ad esempio administrators.
User Name	Facoltativo. Un elenco separato da virgole di nomi utente da controllare. Se non fornisci un valore, l'azione controlla le entità User nella richiesta.
Where To Search	Obbligatorio. Un Organizational Unit o Group specifico per limitare l'ambito della ricerca. I valori possibili sono: Select Option Organizational Unit Group Il valore predefinito è Select Option.
Filter Object Value	Facoltativo. Il nome di Organizational Unit o Group in cui l'azione cerca il gruppo di destinazione. Questo parametro è obbligatorio se Where To Search è impostato su Organizational Unit o Group.
Search In Subgroups	Facoltativo. Se selezionata, l'azione esegue la ricerca in modo ricorsivo all'interno dei sottogruppi nidificati.

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": "[e-mail]"
    }, {
        "EntityResult": false,
        "Entity": "[e-mail]"
    }, {
        "EntityResult": true,
        "Entity": "[e-mail]"
    }
]

Messaggi di output

L'azione Is User In Group può restituire i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
USER_NAME IN GROUP_NAME; USER_NAME NOT in GROUP_NAME;	L'azione è andata a buon fine.
The following users were not found in Active Directory: USER_NAME	L'azione non è riuscita per gli utenti specificati. Verifica che i nomi utente o le entità User esistano in Active Directory.
None of the provided users were found in Active Directory.	L'azione non è andata a buon fine. Verifica che la richiesta contenga entità User valide o che i nomi utente specificati nel parametro User Name esistano in Active Directory.
Error executing action "Is User In Group". Reason: Filter Object Value should be provided	L'azione non è andata a buon fine. Fornisci un nome UO o gruppo valido nel parametro Filter Object Value quando Where To Search è impostato su Organizational Unit o Group.
Error executing action "Is User In Group". Reason: Given group doesn't exist in Active Directory.	L'azione non è andata a buon fine. Controlla il nome del gruppo nel parametro Group Name e verifica che il gruppo esista nell'ambito di ricerca configurato.
Error executing action "Is User In Group". Reason: Specified Organizational Unit doesn't exist in Active Directory.	L'azione non è andata a buon fine. Verifica che l'unità organizzativa specificata in Filter Object Value esista in Active Directory.
Error executing action "Is User In Group". Reason: Specified Group in "Filter Object Value" doesn't exist in Active Directory.	L'azione non è andata a buon fine. Verifica che il gruppo principale specificato in Filter Object Value esista in Active Directory.
Error executing action "Is User In Group". Reason: ERROR_REASON	L'azione non è andata a buon fine. Controlla la connessione al server Active Directory, i parametri di input o le credenziali del account di servizio.

Risultato dello script

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

Nome del risultato dello script	Valore
is_success	true o false

Elenca gruppi di utenti

Utilizza l'azione Elenca gruppi di utenti per recuperare un elenco di tutti i gruppi Active Directory a cui appartiene un utente. L'azione ha come target automatico gli utenti collegati alla richiesta.

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 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 Elenca gruppi di utenti:

[
    {
        "EntityResult": ["Domain Users"],
        "Entity": "[e-mail]"
    }
]

Messaggi di output

L'azione Elenca gruppi di utenti può restituire i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Groups were listed for the following users: ENTITY_ID	L'azione è andata a buon fine.
No groups were found for the following users: ENTITY_ID	L'azione non è riuscita per gli utenti specificati. Verifica che gli account utente siano assegnati ad almeno un gruppo esplicito nell'attributo memberOf in Active Directory.
Failed to list groups for the following users: ENTITY_ID	L'azione non è riuscita per gli utenti specificati. Verifica che il account di servizio disponga dell'autorizzazione per leggere l'attributo memberOf negli account utente di destinazione.
The following users were not found in Active Directory: ENTITY_ID	L'azione non è riuscita per gli utenti specificati. Verifica che gli account utente esistano in Active Directory e corrispondano alle entità User nella richiesta.
No groups were listed.	L'azione non è andata a buon fine. Verifica che la richiesta contenga entità User valide che appartengono a gruppi in Active Directory.
Error executing action "List User Groups". Reason: ERROR_REASON	L'azione non è andata a buon fine. Controlla la connessione al server Active Directory o le credenziali del account di servizio.

Risultato dello script

La tabella seguente elenca il valore per l'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 verificare che Google SecOps possa connettersi e autenticarsi al tuo server Active Directory utilizzando le impostazioni di integrazione configurate.

Questa azione non viene eseguita sulle 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
Connected successfully.	L'azione è andata a buon fine.
Error executing action "Ping". Reason: ERROR_REASON	L'azione non è andata a buon fine. Controlla l'indirizzo del server, la porta, le impostazioni SSL o le credenziali dell'account di servizio nella configurazione dell'integrazione.

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

Sblocca l'account bloccato

Utilizza l'azione Sblocca account bloccato per sbloccare gli account utente in Active Directory che sono stati bloccati dopo troppi tentativi di accesso non riusciti. L'azione ha come target automatico gli utenti collegati alla richiesta.

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

Input azione

Nessuno.

Output azione

L'azione Sblocca account bloccato 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 Sblocca account bloccato può restituire i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Unlocked account for the following users: ENTITY_ID	L'azione è andata a buon fine.
Failed to unlock account for the following users: ENTITY_ID	L'azione non è riuscita per gli utenti specificati. Verifica che il account di servizio disponga delle autorizzazioni di lettura e scrittura per l'attributo lockoutTime negli account utente di destinazione.
The following users were not found in Active Directory: ENTITY_ID	L'azione non è riuscita per gli utenti specificati. Verifica che gli account utente esistano in Active Directory e corrispondano alle entità User nella richiesta.
No accounts were unlocked.	L'azione non è andata a buon fine. Verifica che la richiesta contenga entità User valide e che il account di servizio disponga dell'autorizzazione per sbloccare gli account di destinazione.
Error executing action "Release Locked Account". Reason: ERROR_REASON	L'azione non è andata a buon fine. Controlla la connessione al server Active Directory o le credenziali del account di servizio.

Risultato dello script

La tabella seguente elenca il valore per l'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 gli utenti nel caso da uno o più gruppi Active Directory, ad esempio per revocare l'accesso elevato al gruppo durante un incidente. L'azione identifica automaticamente gli utenti target dalla richiesta e li rimuove dai gruppi specificati.

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 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 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	L'azione è andata a buon fine.
Action wasn't able to remove the following users from the group "GROUP_NAME" in Active Directory: ENTITY_ID	L'azione non è riuscita per gli utenti specificati. Verifica che il account di servizio disponga dell'autorizzazione per modificare l'attributo member nel gruppo di destinazione.
The following users were not found in Active Directory: ENTITY_ID	L'azione non è riuscita per gli utenti specificati. Verifica che gli account utente esistano in Active Directory e corrispondano alle entità User nella richiesta.
The following groups were not found in Active Directory: GROUP_NAME	L'azione non è riuscita per i gruppi specificati. Controlla l'ortografia dei nomi dei gruppi nel parametro Group Name e verifica che i gruppi esistano nel dominio configurato.
No users were removed from the group "GROUP_NAME" in Active Directory.	L'azione non è riuscita per il gruppo specificato. Verifica che gli utenti di destinazione esistano in Active Directory e che il account di servizio disponga dell'accesso in scrittura al gruppo specificato.
No users were removed from the provided groups in Active Directory.	L'azione non è andata a buon fine. Verifica che la richiesta contenga entità User valide e che i gruppi specificati esistano in Active Directory.
Error executing action "Remove User From Group". Reason: ERROR_REASON	L'azione non è andata a buon fine. Controlla la connessione al server Active Directory, i parametri di input o le credenziali del account di servizio.

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 nella directory utenti, computer, gruppi o unità organizzative utilizzando condizioni di ricerca integrate o una query personalizzata. Puoi anche filtrare la ricerca in base a unità organizzative specifiche e scegliere quali campi della directory includere nei risultati.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

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

Parametro	Descrizione
Search Condition	Obbligatorio. La condizione da applicare alla ricerca. I valori possibili sono: Contains Exact Match Starts With Custom LDAP Query Il valore predefinito è Contains.
Include Domain	Facoltativo. Se selezionata, l'azione include il componente del dominio durante la ricerca con le condizioni Contains, Exact Match o Starts With.
Search Object	Obbligatorio. Un tipo di oggetto da cercare quando non utilizzi Custom LDAP Query. I valori possibili sono: Select Option User Host Group Organizational Unit Il valore predefinito è Select Option.
Filter Object Value	Obbligatorio. Un valore dell'oggetto in base al quale filtrare o la stringa di query LDAP completa quando Search Condition è impostato su Custom LDAP Query.
Custom Fields	Facoltativo. Un elenco separato da virgole di attributi LDAP da restituire nei risultati di ricerca.
Specific OUs to Search	Facoltativo. Un elenco separato da virgole di nomi di unità organizzative per limitare l'ambito di ricerca.
Include Default Search Fields	Facoltativo. Se selezionata, l'azione include i campi predefiniti di Active Directory nei risultati restituiti, oltre a qualsiasi Custom Fields specificato. Abilitato per impostazione predefinita.
Max Records To Return	Facoltativo. Un numero massimo di record da recuperare da Active Directory. Il valore predefinito è 100.
Sort Field	Facoltativo. Un nome di attributo LDAP utilizzato per ordinare le voci restituite.

Output azione

L'azione Cerca in Active Directory 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 Cerca in Active Directory fornisce la seguente tabella nella bacheca del caso:

• Nome tabella: Active Directory Search Results
• Colonne: attributi di Active Directory restituiti per le voci della directory corrispondenti (in base a Include Default Search Fields e Custom Fields).

Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Cerca in Active Directory:

[
      {
        "primaryGroupID": [
          513
        ],
        "logonCount": [
          6505
        ],
        "cn": [
          "user name"
        ],
        "countryCode": [
          0
        ],
        "objectClass": [
          "top",
          "person",
          "organizationalPerson"
        ],
        "userPrincipalName": [
          "[e-mail]"
        ],
        "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 è andata a buon fine.
Error executing action "Search Active Directory". Reason: you need to select "Search Object" or choose "Custom LDAP Query" as a "Search Condition"	L'azione non è andata a buon fine. Seleziona un tipo di oggetto valido nel parametro Search Object o modifica Search Condition in Custom LDAP Query.
Error executing action "Search Active Directory". Reason: Value for the parameter "Max Records To Return" should be a positive number.	L'azione non è andata a buon fine. Inserisci un numero intero maggiore di 0 nel parametro Max Records To Return.
Error executing action "Search Active Directory". Reason: The following OUs were not found in Active Directory: OU_NAMES	L'azione non è andata a buon fine. Controlla l'ortografia delle unità organizzative nel parametro Specific OUs to Search e verifica che esistano in Active Directory.
Error executing action "Search Active Directory". Reason: Knowingly invalid query was executed: "QUERY_STRING". Please verify the inputs and try again.	L'azione non è andata a buon fine. Controlla la sintassi della query personalizzata o del valore del filtro nel parametro Filter Object Value e verifica che i nomi Custom Fields o Sort Field specificati siano attributi LDAP validi.
Error executing action "Search Active Directory". Reason: ERROR_REASON	L'azione non è andata a buon fine. Controlla la connessione al server Active Directory, i parametri di input o le credenziali del account di servizio.

Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Cerca in Active Directory:

Nome del risultato dello script	Valore
is_success	true o false

Imposta password utente

Utilizza l'azione Imposta password utente per reimpostare la password degli utenti della richiesta con una nuova password. Assicurati che l'integrazione sia connessa tramite SSL (LDAPS) e che la nuova password soddisfi le regole di complessità delle password del tuo dominio.

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. Il valore della nuova password.

Output azione

L'azione Imposta 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 Imposta password utente può restituire i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Reset password for the following users: ENTITY_ID	L'azione è andata a buon fine.
Failed to reset password for the following users: ENTITY_ID	L'azione non è riuscita per gli utenti specificati. Verifica che la nuova password soddisfi i requisiti di complessità e cronologia delle password del dominio e che gli utenti di destinazione non siano account amministrativi protetti.
The following users were not found in Active Directory: ENTITY_ID	L'azione non è riuscita per gli utenti specificati. Verifica che gli account utente esistano in Active Directory e corrispondano alle entità User nella richiesta.
No passwords were changed.	L'azione non è andata a buon fine. Verifica che la richiesta contenga entità User valide e che il account di servizio disponga dell'autorizzazione per reimpostare le password negli account di destinazione.
Failed to execute "Set User Password" action! Watch Over Extended Rights permission or SSL connection.	L'azione non è andata a buon fine. Assicurati che Use SSL sia selezionato nella configurazione dell'integrazione (LDAPS sulla porta 636) e che il account di servizio disponga del diritto esteso Reimposta password.
Error executing action "Set User Password". Reason: ERROR_REASON	L'azione non è andata a buon fine. Controlla la connessione al server Active Directory, i parametri di input o le credenziali del account di servizio.

Risultato dello script

La tabella seguente elenca il valore per l'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 una proprietà della directory specifica negli account computer nel caso, ad esempio aggiornando il campo Description di un computer con note sull'incidente. L'azione identifica automaticamente i computer di destinazione dalla richiesta e applica il nuovo valore.

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. Il nuovo valore dell'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 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 Aggiorna gli attributi di un host AD può restituire i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Successfully updated attribute "ATTRIBUTE_NAME" on the following hosts in Active Directory: ENTITY_ID_LIST	L'azione è andata a buon fine.
Action wasn't able to update attribute "ATTRIBUTE_NAME" on the following hosts in Active Directory: ENTITY_ID_LIST	L'azione non è riuscita per gli host specificati. Verifica che il account di servizio disponga dell'autorizzazione in scrittura per l'attributo specificato negli account computer di destinazione e che il formato del valore sia valido per l'attributo.
The following hosts were not found in Active Directory: ENTITY_ID_LIST	L'azione non è riuscita per gli host specificati. Verifica che gli account computer esistano in Active Directory e corrispondano alle entità Hostname nel caso.
No hosts were updated in Active Directory.	L'azione non è andata a buon fine. Verifica che la richiesta contenga entità Hostname valide e che il account di servizio disponga dell'autorizzazione per aggiornare l'attributo specificato.
Error executing action "Update attributes of an AD Host". Reason: Provided attribute doesn't exist in Active Directory.	L'azione non è andata a buon fine. Controlla l'ortografia dell'attributo nel parametro Attribute Name e verifica che sia un attributo computer Active Directory valido.
Error executing action "Update attributes of an AD Host". Reason: ERROR_REASON	L'azione non è andata a buon fine. Controlla la connessione al server Active Directory, i parametri di input o le credenziali del account di servizio.

Risultato dello script

La tabella seguente elenca il valore per l'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

Aggiorna gli attributi di un utente AD

Utilizza l'azione Aggiorna gli attributi di un utente AD per aggiornare una proprietà della directory specifica negli account utente nel caso, ad esempio aggiornando il campo Description, title o department di un utente. L'azione identifica automaticamente gli utenti target dalla richiesta e applica il nuovo valore.

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

Input azione

L'azione Aggiorna gli 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. Il nuovo valore dell'attributo.

Output azione

L'azione Aggiorna gli attributi di un utente AD 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 Aggiorna gli attributi di un utente AD può restituire i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Successfully updated attribute "ATTRIBUTE_NAME" for the following users in Active Directory: ENTITY_ID_LIST	L'azione è andata a buon fine.
Action wasn't able to update attribute "ATTRIBUTE_NAME" for the following users in Active Directory: ENTITY_ID_LIST	L'azione non è riuscita per gli utenti specificati. Verifica che il account di servizio disponga dell'autorizzazione in scrittura per l'attributo specificato negli account utente di destinazione e che il formato del valore sia valido per l'attributo.
The following users were not found in Active Directory: ENTITY_ID_LIST	L'azione non è riuscita per gli utenti specificati. Verifica che gli account utente esistano in Active Directory e corrispondano alle entità User nella richiesta.
No users were updated in Active Directory.	L'azione non è andata a buon fine. Verifica che la richiesta contenga entità User valide e che il account di servizio disponga dell'autorizzazione per aggiornare l'attributo specificato.
Error executing action "Update attributes of an AD User". Reason: Provided attribute doesn't exist in Active Directory.	L'azione non è andata a buon fine. Controlla l'ortografia dell'attributo nel parametro Attribute Name e verifica che sia un attributo utente Active Directory valido.
Error executing action "Update attributes of an AD User". Reason: ERROR_REASON	L'azione non è andata a buon fine. Controlla la connessione al server Active Directory, i parametri di input o le credenziali del account di servizio.

Risultato dello script

La tabella seguente elenca il valore per l'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.