Integrar o Active Directory ao Google SecOps

Este documento explica como integrar o Active Directory ao Google Security Operations.

Observação: essa integração usa um ou mais componentes de código aberto. É possível fazer o download de uma cópia compactada do código-fonte completo dessa integração no bucket do Cloud Storage.

Casos de uso

A integração do Active Directory usa os recursos do Google SecOps para oferecer suporte aos seguintes casos de uso:

• Ativar e desativar usuários: desative uma conta de usuário potencialmente comprometida e evite outros acessos não autorizados.

• Redefinir senhas: redefina automaticamente a senha do usuário no Active Directory e notifique o usuário sobre a mudança.

• Gerenciar grupos: adicione novos usuários aos grupos de segurança apropriados com base no papel deles e verifique se eles têm as permissões de acesso corretas.

• Recuperar informações do usuário: recupere detalhes do usuário, como associações a grupos, horário do último login e dados de contato de uma conta de usuário específica.

• Automatizar a saída: desative contas, remova-as de grupos e transfira a propriedade de arquivos quando um funcionário sair.

Antes de começar

Antes de configurar a integração do Active Directory no Google SecOps, verifique se o ambiente de rede, os Active Directory Domain Services (AD DS) e as credenciais da conta de serviço atendem a todos os pré-requisitos operacionais.

Para preparar o ambiente para integração, conclua os seguintes pré-requisitos:

1. Verifique a conectividade de rede e a resolução de DNS entre sua instância do Google SecOps (ou agente remoto) e seus controladores de domínio do Active Directory.

2. Opcional: se você estiver se conectando por LDAPS (porta 636, necessária para redefinições de senha) usando uma autoridade de certificação interna, configure o certificado de CA codificando o certificado raiz ou intermediário em uma string base64.

3. Crie uma conta de serviço dedicada do Active Directory de acordo com o princípio de privilégio mínimo.

4. Revise as permissões de ação necessárias para determinar os atributos e direitos de acesso necessários para as ações específicas que você planeja executar.

5. Delegue permissões nas unidades organizacionais de destino para as ações que você planeja usar (com usuários e computadores do Active Directory ou PowerShell e dsacls), garantindo que a conta de serviço tenha acesso explícito de leitura e gravação ao atributo userAccountControl.

Requisitos de rede e DNS

O Google SecOps se comunica diretamente com os controladores de domínio do Active Directory usando o protocolo LDAP ou LDAPS por TCP.

Verifique se o ambiente de rede atende às seguintes regras de conectividade:

• Conectividade de porta: verifique se os firewalls e o roteamento da rede permitem a comunicação de saída do Google SecOps (ou do agente remoto) com os controladores de domínio do Active Directory nas seguintes portas:

  • LDAP (padrão): abra a porta 389/TCP para comunicação LDAP não criptografada.
  • LDAPS (recomendado, obrigatório para senhas): abra a porta 636/TCP (ou sua porta SSL/TLS personalizada). O LDAPS é necessário para o tráfego de diretório criptografado e é obrigatório para ações de modificação de senha.

• Resolução de DNS e nome do host: o Active Directory requer uma resolução precisa do nome do host para corresponder aos certificados SSL/TLS e às vinculações de serviço do diretório. Se seu domínio for resolvido por um nome DNS totalmente qualificado por meio da configuração de DNS interna, nenhuma outra configuração de host será necessária. Se a resolução de DNS não estiver disponível na imagem do contêiner do agente remoto, configure o arquivo /etc/hosts.

Configurar o arquivo /etc/hosts

Essa configuração é opcional. Se o controlador do domínio já estiver resolvido pela configuração de DNS interno, pule esta seção. Se o agente remoto não conseguir resolver o controlador de domínio do Active Directory usando DNS, mapeie o host manualmente no arquivo /etc/hosts para corresponder aos certificados SSL/TLS e às vinculações do serviço de diretório.

Para configurar o arquivo /etc/hosts, siga estas etapas:

1. Abra /etc/hosts em um editor de texto com privilégios de administrador:

   sudo vi /etc/hosts
   

2. Adicione uma entrada que mapeie o endereço IP do controlador do domínio para o nome de domínio totalmente qualificado (FQDN, na sigla em inglês):

   192.0.2.195 dc01.example.local
   

3. Salve e feche o arquivo.

Se você não precisar de um certificado de CA para a integração, prossiga para a configuração dos requisitos de autenticação e conta de serviço. Caso contrário, configure o certificado de CA.

Configurar o certificado de CA

Esta etapa é opcional. Se você se conectar usando o LDAP padrão (porta 389) ou um certificado público confiável, pule esta seção e prossiga para Requisitos de autenticação e conta de serviço. Se você se conectar por LDAPS (porta 636, necessária para redefinições de senha) usando um certificado emitido por uma CA particular ou interna, forneça a string de certificado codificada em base64 durante a configuração para estabelecer uma conexão TLS confiável.

Para configurar e fazer upload do certificado de CA, siga estas etapas:

1. Codifique o arquivo de certificado formatado em PEM:

   • Linux: bash base64 -w 0 mycert.crt

   • macOS: bash base64 -i mycert.crt

2. Copie a string de saída completa (incluindo cabeçalhos codificados) e cole-a no campo Arquivo de certificado de CA - analisado em string Base64 na configuração de integração do Google SecOps.

3. Defina o parâmetro Servidor como o FQDN do controlador do domínio (não o endereço IP) para que o nome do host corresponda ao nome comum (CN) ou ao nome alternativo do sujeito (SAN) no certificado.

4. Clique em Testar para validar o handshake de TLS.

Requisitos de autenticação e conta de serviço

A integração do Active Directory é autenticada usando credenciais padrão do AD DS.

Verifique se a configuração de autenticação está em conformidade com as seguintes práticas de segurança:

• Conta de serviço dedicada: crie uma conta de serviço dedicada (como svc_secops_ad) especificamente para playbooks automatizados do Google SecOps. Evite usar contas de usuário interativas ou contas de administrador de domínio integradas.

• Formato do nome de usuário: o nome de usuário pode ser fornecido como um nome principal de usuário (UPN, na sigla em inglês) (como [e-mail]) ou como um nome de logon de nível inferior (EXAMPLE\svc_secops).

• PoLP: não adicione a conta de serviço a grupos integrados privilegiados, como Administradores de domínio, Administradores corporativos ou Operadores de conta. Em vez disso, conceda permissões granulares em UOs específicas em que os objetos de usuário, computador ou grupo residem.

Configurar permissões de ação (privilégio mínimo)

Conceda à conta de serviço de autenticação apenas as permissões do Active Directory e o acesso ao atributo LDAP necessários para as ações específicas que você planeja executar.

Importante: as ações de verificação de status e ciclo de vida (incluindo Ativar conta, Desativar conta, Ativar computador, Desativar computador e Enriquecer entidades) exigem direitos explícitos de leitura e gravação de propriedade no atributo userAccountControl.

Se a conta de serviço não puder ler userAccountControl, o Active Directory omitirá o atributo das respostas do LDAP. No Google SecOps, isso produz exceções nulas não processadas (como TypeError: 'NoneType' object is not subscriptable). Verifique se esse atributo foi delegado explicitamente em todas as UOs de destino.

Consulte as permissões mínimas para ações do Active Directory na tabela a seguir:

Nome da ação	Permissão do AD DS / direito estendido obrigatório	Classe de objeto de destino	Descrição / Escopo do atributo
Ping	Read Property	Usuário, raiz do domínio	Consulta o objeto da conta de serviço configurado (sAMAccountName, userPrincipalName, mail) para validar a conectividade e as credenciais do diretório.
Enriquecer entidades	List Contents Read Property (atributos de destino: userAccountControl, sAMAccountName, mail, memberOf, lockoutTime, pwdLastSet)	Usuário, computador, grupo	Consulta atributos de usuários e computadores e resolve associações de grupos aninhados. Requer Read Property em userAccountControl para evitar erros de subscrito nulo.
Desativar conta	Read Property: userAccountControl Write Property: userAccountControl	Usuário	Lê e define a flag ACCOUNTDISABLE (0x0002) no objeto do usuário de destino.
Ativar conta	Read Property: userAccountControl Write Property: userAccountControl	Usuário	Lê e limpa a sinalização ACCOUNTDISABLE (0x0002) no objeto do usuário de destino.
Desativar computador	Read Property: userAccountControl Write Property: userAccountControl	Computador	Lê e define a flag ACCOUNTDISABLE no objeto do computador de destino.
Ativar o computador	Read Property: userAccountControl Write Property: userAccountControl	Computador	Lê e limpa a flag ACCOUNTDISABLE no objeto do computador de destino.
Liberar conta bloqueada	Read Property: lockoutTime Write Property: lockoutTime	Usuário	Lê e define o atributo lockoutTime como 0 para desbloquear uma conta de usuário bloqueada.
Forçar atualização de senha	Read Property: pwdLastSet Write Property: pwdLastSet	Usuário	Lê e define o atributo pwdLastSet como 0 para exigir que o usuário mude a senha no próximo login.
Definir senha do usuário	Direito estendido: Reset Password (User-Force-Change-Password) (Opcional) Write Property: unicodePwd	Usuário	Redefine a senha do usuário de destino. Requer LDAPS (porta 636) ou StartTLS.
Adicionar usuário ao grupo	Read Property: member Write Property: member	Grupo	Adiciona o nome distinto do usuário de destino (distinguishedName) ao atributo member do grupo.
Remover usuário do grupo	Read Property: member Write Property: member	Grupo	Remove o nome diferenciado (distinguishedName) do usuário de destino do atributo member do grupo.
Alterar UO do usuário	Delete Child Object (usuário) na UO de origem Create Child Object (usuário) na UO de destino Write Property: name, distinguishedName	Unidade organizacional, usuário	Move objetos de usuário entre UOs usando o LDAP modify_dn.
Alterar UO do host	Delete Child Object (computador) na UO de origem Create Child Object (computador) na UO de destino Write Property: name, distinguishedName	Unidade organizacional, computador	Move objetos de computador entre UOs usando o LDAP modify_dn.
Atualizar atributos de um usuário do AD	Write Property em atributos de destino (como mail, title, department, telephoneNumber, description ou manager)	Usuário	Modifica os valores de atributos especificados no objeto de usuário de destino.
Atualizar atributos de um host do AD	Write Property em atributos de destino (como description ou location)	Computador	Modifica os valores de atributos especificados no objeto do computador de destino.
Receber participantes do grupo	List Contents Read Property: member, sAMAccountName, distinguishedName	Grupo, usuário, computador	Consulta a associação ao grupo e os atributos da conta do membro.
Receber detalhes de contato do gerente	Read Property: manager Read Property: cn, telephoneNumber, mail, displayName, title	Usuário	Lê o atributo manager do objeto do usuário de destino e recupera os detalhes de contato do gerente.
O usuário está no grupo	Read Property: memberOf, sAMAccountName	Usuário, grupo	Avalia se uma conta de usuário pertence ao grupo de segurança ou distribuição especificado.
Listar grupos de usuários	Read Property: memberOf, sAMAccountName	Usuário, grupo	Retorna a lista de todos os grupos atribuídos à conta de usuário especificada.
Pesquisar no Active Directory	List Contents Read Property em atributos consultados	Usuário, computador, grupo, unidade organizacional	Executa consultas de filtro LDAP personalizadas na subárvore do diretório.

Como delegar permissões no Active Directory

Para aplicar o PoLP sem conceder direitos administrativos amplos, delegue permissões em UOs de destino usando o console gráfico do ADUC ou as ferramentas de linha de comando PowerShell e dsacls. Você só precisa usar um desses métodos e delegar as permissões necessárias para as ações específicas que planeja executar.

Delegar controle usando o ADUC

Se preferir usar uma interface gráfica, use o Assistente de Delegação de Controle no ADUC para delegar permissões específicas de objetos e propriedades.

Execute o assistente na UO de destino para conceder as permissões de objeto e propriedade necessárias para as ações que você planeja usar (como ler e gravar sinalizações de controle de conta, redefinir senhas ou desbloquear contas).

Para orientações detalhadas sobre como executar o assistente, consulte a documentação da Microsoft sobre Delegação de controle no AD DS.

Delegar controle usando o PowerShell e o dsacls

Se você preferir uma abordagem de linha de comando ou quiser automatizar as atribuições de permissão, use o PowerShell com o utilitário dsacls.exe integrado em vez do ADUC.

Execute apenas os exemplos de comando que se aplicam às ações que você planeja usar em uma estação de trabalho administrativa ou em um controlador de domínio, substituindo a UO de destino e o nome da conta de serviço:

• Conceda permissões de leitura e gravação em userAccountControl para objetos de usuário (para ativar ou desativar contas de usuário e evitar erros de enriquecimento): powershell dsacls.exe "OU=Users,DC=example,DC=local" /I:S /G "EXAMPLE\svc_secops_ad:RPWP;userAccountControl;user"
• Conceda permissões de leitura e gravação em userAccountControl para objetos de computador (para ativar ou desativar computadores): powershell dsacls.exe "OU=Computers,DC=example,DC=local" /I:S /G "EXAMPLE\svc_secops_ad:RPWP;userAccountControl;computer"
• Conceda permissões para desbloquear a conta (lockoutTime): powershell dsacls.exe "OU=Users,DC=example,DC=local" /I:S /G "EXAMPLE\svc_secops_ad:RPWP;lockoutTime;user"
• Conceda permissões para forçar a mudança de senha (pwdLastSet): powershell dsacls.exe "OU=Users,DC=example,DC=local" /I:S /G "EXAMPLE\svc_secops_ad:RPWP;pwdLastSet;user"
• Conceda direitos de redefinição de senha (direito estendido Reset Password): powershell dsacls.exe "OU=Users,DC=example,DC=local" /I:S /G "EXAMPLE\svc_secops_ad:CA;Reset Password;user"
• Conceda direitos de modificação de associação em um grupo de segurança: powershell dsacls.exe "CN=SecOps-Quarantine,OU=Groups,DC=example,DC=local" /G "EXAMPLE\svc_secops_ad:RPWP;member;group"

Para mais detalhes sobre sintaxe e chaves de parâmetro, consulte a documentação da Microsoft sobre dsacls.

Observação: no Active Directory, os membros de grupos administrativos protegidos têm a herança desativada pelo processo interno AdminSDHolder. As permissões delegadas atribuídas no nível da UO não se aplicam às contas de admin protegidas.

Para mais informações sobre como gerenciar objetos protegidos, consulte a documentação da Microsoft sobre AdminSDHolder e contas protegidas.

Parâmetros de integração

A integração com o Active Directory requer os seguintes parâmetros:

Parâmetro	Descrição
Server	Obrigatório. O nome do host, o nome do DNS ou o endereço IP do servidor do Active Directory. A integração se comunica usando o protocolo LDAP. Para usar uma porta personalizada, anexe-a ao endereço (como mydomain.com:636). Por padrão, a integração usa a porta 636 quando o SSL/TLS está ativado e a porta 389 quando está desativado.
Username	Obrigatório. O nome de usuário ou endereço de e-mail do usuário para se conectar ao Active Directory, como DOMAIN\username ou [e-mail]. Esse parâmetro também aceita o atributo userPrincipalName.
Password	Obrigatório. A senha da conta de usuário.
Domain	Obrigatório. O caminho DNS completo para seu domínio no namespace de rede. Informe o nome de domínio totalmente qualificado (FQDN) do seu domínio no seguinte formato: SUBDOMAIN.ROOT_DOMAIN. Por exemplo, se o domínio interno do Active Directory for example.local, o FQDN a ser inserido será example.local. Se o domínio interno do Active Directory for corp.example.com, o FQDN a ser inserido será corp.example.com.
Custom Query Fields	Opcional. Uma lista separada por vírgulas de campos personalizados do Active Directory para incluir em consultas, como customField1, customField2.
CA Certificate File - parsed into Base64 String	Opcional. A string do arquivo de certificado de CA codificada no formato base64 obtida ao configurar o certificado de CA. Forneça o valor total.
Use SSL	Opcional. Se selecionada, a integração valida o certificado SSL ao se conectar ao servidor do Active Directory e usa LDAPS seguro (porta 636). Se não estiver selecionada, o LDAP padrão (porta 389) será usado.
Debug Logging	Opcional. Se selecionada, a integração vai registrar informações detalhadas de depuração para operações do Active Directory.

Para instruções sobre como configurar uma integração no Google SecOps, consulte Configurar integrações.

Se necessário, você pode fazer mudanças depois. Depois de configurar uma instância de integração, é possível usá-la em playbooks. Para mais informações sobre como configurar e oferecer suporte a várias instâncias, consulte Como oferecer suporte a várias instâncias.

Ações

Para mais informações sobre ações, consulte Responder a ações pendentes na sua mesa de trabalho e Executar uma ação manual no seu caso.

Adicionar usuário ao grupo

Use a ação Adicionar usuário ao grupo para adicionar usuários do caso a um ou mais grupos do Active Directory, como adicionar uma conta a um grupo de acesso restrito durante uma investigação. A ação identifica automaticamente os usuários-alvo do caso e os adiciona aos grupos especificados.

Essa ação é executada na entidade User do Google SecOps.

Entradas da ação

A ação Adicionar usuário ao grupo requer os seguintes parâmetros:

Parâmetro	Descrição
Group Name	Obrigatório. Uma lista separada por vírgulas de grupos para adicionar usuários.

Saídas da ação

A ação Adicionar usuário ao grupo fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do painel de casos	Indisponível
Tabela de enriquecimento	Indisponível
Resultado JSON	Indisponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Adicionar usuário ao grupo pode retornar as seguintes mensagens de saída:

Mensagem de resposta	Descrição da mensagem
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	A ação foi concluída.
Action wasn't able to add the following users to the group "GROUP_NAME" in Active Directory: ENTITY_ID	A ação falhou para os usuários especificados. Verifique se a conta de serviço tem permissão para modificar o atributo member no grupo de destino.
The following users were not found in Active Directory: ENTITY_ID	A ação falhou para os usuários especificados. Verifique se as contas de usuário existem no Active Directory e se os identificadores de entidade correspondem a nomes de usuário ou endereços de e-mail válidos.
The following groups were not found in Active Directory: GROUP_NAME	A ação falhou para os grupos especificados. Verifique a ortografia dos nomes dos grupos no parâmetro Group Name e confirme se os grupos existem no domínio configurado.
No users were added to the group "GROUP_NAME" in Active Directory.	A ação falhou para o grupo especificado. Verifique se os usuários de destino existem no Active Directory e se a conta de serviço tem acesso de gravação ao grupo especificado.
No users were added to the provided groups in Active Directory.	A ação falhou. Confirme se o caso contém entidades User válidas e se os grupos especificados existem no Active Directory.
Error executing action "Add User To Group". Reason: ERROR_REASON	A ação falhou. Verifique a conexão com o servidor do Active Directory, os parâmetros de entrada ou as credenciais da conta de serviço.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Adicionar usuário ao grupo:

Nome do resultado do script	Valor
is_success	true ou false

Mudar UO do host

Use a ação Mudar UO do host para mover computadores no caso para uma unidade organizacional diferente no Active Directory, como mover uma máquina comprometida para uma UO de quarentena com políticas restritas. A ação identifica automaticamente os computadores de destino do caso e os move para a UO de destino especificada.

Essa ação é executada na entidade Hostname do Google SecOps.

Entradas da ação

A ação Alterar UO do host requer os seguintes parâmetros:

Parâmetro	Descrição
OU Name	Obrigatório. O nome da nova UO host.

Saídas da ação

A ação Alterar UO do host fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do painel de casos	Indisponível
Tabela de enriquecimento	Indisponível
Resultado JSON	Indisponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Alterar UO do host pode retornar as seguintes mensagens de saída:

Mensagem de resposta	Descrição da mensagem
Changed OU for the following hosts: ENTITY_ID	A ação foi concluída.
Failed to change OU for the following hosts : ENTITY_ID	A ação falhou para os hosts especificados. Verifique se a UO de destino existe e se a conta de serviço tem permissão para mover objetos de computador entre as UOs de origem e de destino.
The following hosts were not found in Active Directory: ENTITY_ID	A ação falhou para os hosts especificados. Verifique se as contas de computador existem no Active Directory e correspondem às entidades Hostname no caso.
The action didn't change OU on any hosts.	A ação falhou. Verifique se os computadores de destino e a UO de destino existem no Active Directory e se a conta de serviço tem permissões para mover as contas de computador.
Error executing action "Change Host OU". Reason: ERROR_REASON	A ação falhou. Verifique a conexão com o servidor do Active Directory, o parâmetro OU Name ou as credenciais da conta de serviço.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Alterar UO do host:

Nome do resultado do script	Valor
is_success	true ou false

Mudar a UO do usuário

Use a ação Alterar UO do usuário para mover os usuários do caso para uma unidade organizacional diferente no Active Directory, como mover uma conta para uma UO restrita durante um incidente ou fluxo de trabalho de desligamento. A ação identifica automaticamente os usuários-alvo do caso e os move para a UO de destino especificada.

Essa ação é executada na entidade User do Google SecOps.

Entradas da ação

A ação Alterar UO do usuário requer os seguintes parâmetros:

Parâmetro	Descrição
OU Name	Obrigatório. O nome da nova UO de usuário.

Saídas da ação

A ação Alterar UO do usuário fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do painel de casos	Indisponível
Tabela de enriquecimento	Indisponível
Resultado JSON	Indisponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Alterar UO do usuário pode retornar as seguintes mensagens de saída:

Mensagem de resposta	Descrição da mensagem
Changed OU for the following users: ENTITY_ID	A ação foi concluída.
Failed to change OU for the following users : ENTITY_ID	A ação falhou para os usuários especificados. Verifique se a UO de destino existe e se a conta de serviço tem permissão para mover objetos de usuário entre as UOs de origem e de destino.
The following users were not found in Active Directory: ENTITY_ID	A ação falhou para os usuários especificados. Verifique se as contas de usuário existem no Active Directory e correspondem às entidades User no caso.
The action didn't change OU on any users.	A ação falhou. Verifique se os usuários de destino e a UO de destino existem no Active Directory e se a conta de serviço tem permissões para mover as contas de usuário.
Error executing action "Change User OU". Reason: ERROR_REASON	A ação falhou. Verifique a conexão com o servidor do Active Directory, o parâmetro OU Name ou as credenciais da conta de serviço.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Alterar UO do usuário:

Nome do resultado do script	Valor
is_success	true ou false

Desativar conta

Use a ação Desativar conta para desativar contas de usuário no Active Directory. Essa ação segmenta automaticamente os usuários anexados ao caso.

Essa ação é executada na entidade User do Google SecOps.

Entradas da ação

Nenhuma.

Saídas da ação

A ação Desativar conta fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do painel de casos	Indisponível
Tabela de enriquecimento	Indisponível
Resultado JSON	Indisponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Desativar conta pode retornar as seguintes mensagens de saída:

Mensagem de resposta	Descrição da mensagem
Disabled account for the following users: ENTITY_ID	A ação foi concluída.
Failed to disable account for the following users: ENTITY_ID	A ação falhou para os usuários especificados. Verifique se a conta de serviço tem permissões de leitura e gravação para o atributo userAccountControl nas contas de usuário de destino e se os usuários não são contas administrativas protegidas.
The following users were not found in Active Directory: ENTITY_ID	A ação falhou para os usuários especificados. Verifique se as contas de usuário existem no Active Directory e correspondem às entidades User no caso.
No users were disabled in Active Directory.	A ação falhou. Confirme se o caso contém entidades User válidas e se a conta de serviço tem permissão para desativar as contas de destino.
Error executing action "Disable Account". Reason: ERROR_REASON	A ação falhou. Verifique a conexão com o servidor do Active Directory ou as credenciais da conta de serviço.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Desativar conta:

Nome do resultado do script	Valor
is_success	true ou false

Desativar computador

Use a ação Desativar computador para desativar contas de computador no Active Directory e impedir que máquinas comprometidas ou não autorizadas se autentiquem no domínio. A ação segmenta automaticamente os nomes de host anexados ao caso.

Essa ação é executada na entidade Hostname do Google SecOps.

Entradas da ação

Nenhuma.

Saídas da ação

A ação Desativar computador fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do painel de casos	Indisponível
Tabela de enriquecimento	Indisponível
Resultado JSON	Indisponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Desativar computador pode retornar as seguintes mensagens de saída:

Mensagem de resposta	Descrição da mensagem
Successfully disabled the following computers in Active Directory: ENTITY_ID The following computers were already disabled in Active Directory: ENTITY_ID	A ação foi concluída.
Action wasn't able to disable the following computers in Active Directory: ENTITY_ID	A ação falhou nos computadores especificados. Verifique se a conta de serviço tem permissões de leitura e gravação para o atributo userAccountControl nos objetos do computador de destino.
The following computers were not found in Active Directory: ENTITY_ID	A ação falhou nos computadores especificados. Verifique se as contas de computador existem no Active Directory e correspondem às entidades Hostname no caso.
No computers were disabled in Active Directory.	A ação falhou. Confirme se o caso contém entidades Hostname válidas e se a conta de serviço tem permissão para desativar as contas de computador de destino.
Error executing action "Disable Computer". Reason: ERROR_REASON	A ação falhou. Verifique a conexão com o servidor do Active Directory ou as credenciais da conta de serviço.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Desativar computador:

Nome do resultado do script	Valor
is_success	true ou false

Ativar conta

Use a ação Ativar conta para reativar contas de usuário desativadas no Active Directory. A ação segmenta automaticamente os usuários anexados ao caso.

Essa ação é executada na entidade User do Google SecOps.

Entradas da ação

Nenhuma.

Saídas da ação

A ação Ativar conta fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do painel de casos	Indisponível
Tabela de enriquecimento	Indisponível
Resultado JSON	Indisponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Ativar conta pode retornar as seguintes mensagens de saída:

Mensagem de resposta	Descrição da mensagem
Successfully enabled the following users in Active Directory: ENTITY_ID The following users were already enabled in Active Directory: ENTITY_ID	A ação foi concluída.
Action wasn't able to enable the following users in Active Directory: ENTITY_ID	A ação falhou para os usuários especificados. Verifique se a conta de serviço tem permissões de leitura e gravação para o atributo userAccountControl nas contas de usuário de destino.
The following users were not found in Active Directory: ENTITY_ID	A ação falhou para os usuários especificados. Verifique se as contas de usuário existem no Active Directory e correspondem às entidades User no caso.
No users were enabled in Active Directory.	A ação falhou. Confirme se o caso contém entidades User válidas e se a conta de serviço tem permissão para ativar as contas de destino.
Error executing action "Enable Account". Reason: ERROR_REASON	A ação falhou. Verifique a conexão com o servidor do Active Directory ou as credenciais da conta de serviço.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Ativar conta:

Nome do resultado do script	Valor
is_success	true ou false

Ativar computador

Use a ação Ativar computador para reativar as contas de computador desativadas no Active Directory para que as máquinas possam se autenticar no domínio novamente. A ação visa automaticamente os nomes de host anexados ao caso.

Essa ação é executada na entidade Hostname do Google SecOps.

Entradas da ação

Nenhuma.

Saídas da ação

A ação Ativar computador fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do painel de casos	Indisponível
Tabela de enriquecimento	Indisponível
Resultado JSON	Indisponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Ativar computador pode retornar as seguintes mensagens de saída:

Mensagem de resposta	Descrição da mensagem
Successfully enabled the following computers in Active Directory: ENTITY_ID The following computers were already enabled in Active Directory: ENTITY_ID	A ação foi concluída.
Action wasn't able to enable the following computers in Active Directory: ENTITY_ID	A ação falhou nos computadores especificados. Verifique se a conta de serviço tem permissões de leitura e gravação para o atributo userAccountControl nos objetos do computador de destino.
The following computers were not found in Active Directory: ENTITY_ID	A ação falhou nos computadores especificados. Verifique se as contas de computador existem no Active Directory e correspondem às entidades Hostname no caso.
No computers were enabled in Active Directory.	A ação falhou. Confirme se o caso contém entidades Hostname válidas e se a conta de serviço tem permissão para ativar as contas de computador de destino.
Error executing action "Enable Computer". Reason: ERROR_REASON	A ação falhou. Verifique a conexão com o servidor do Active Directory ou as credenciais da conta de serviço.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Ativar computador:

Nome do resultado do script	Valor
is_success	true ou false

Enriquecer entidades

Use a ação Enriquecer entidades para recuperar detalhes do perfil do Active Directory, status da conta e associações de grupo para usuários e computadores no caso. É possível enriquecer as entidades com todas as informações de diretório disponíveis ou limitar os resultados e a tabela de casos a atributos específicos.

Essa ação é assíncrona. Ajuste o valor do tempo limite do script no ambiente de desenvolvimento integrado do Google SecOps para a ação, se necessário.

A ação Enriquecer entidades é executada nas seguintes entidades do Google SecOps:

• User
• Hostname

Entradas da ação

A ação Enriquecer entidades requer os seguintes parâmetros:

Parâmetro	Descrição
Mark Entities as Internal	Opcional. Se selecionada, a ação marca automaticamente as entidades enriquecidas como internas. Ativado por padrão.
Create Case Wall Table	Opcional. Se selecionada, a ação gera uma tabela de mural de casos com os atributos do Active Directory recuperados para cada entidade enriquecida. Ativado por padrão.
Specific Attribute Names To Enrich With	Opcional. Uma lista separada por vírgulas de nomes de atributos para enriquecer as entidades. Se você não fornecer nenhum valor, a ação vai enriquecer as entidades com todos os atributos disponíveis. Se um atributo tiver vários valores, a ação vai enriquecer o atributo com todos os valores disponíveis. Esse parâmetro diferencia maiúsculas de minúsculas.
Should Case Wall Table be filtered by the specified Attributes?	Opcional. Se selecionada, a ação preenche a tabela do painel de casos apenas com os atributos especificados em Specific Attribute Names To Enrich With.
Should JSON result be filtered by the specified Attributes?	Opcional. Se selecionado, o resultado JSON retorna apenas os atributos especificados em Specific Attribute Names To Enrich With.

Saídas da ação

A ação Enriquecer entidades fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do painel de casos	Disponível
Tabela de enriquecimento de entidades	Disponível
Resultado JSON	Disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Tabela do painel de casos

A ação Enriquecer entidades fornece a seguinte tabela no Case Wall quando Create Case Wall Table é selecionado:

• Nome da tabela: Report for: <var class="readonly">ENTITY_ID</var>
• Colunas: nomes e valores de atributos do Active Directory recuperados para a entidade (ou filtrados pelo parâmetro Specific Attribute Names To Enrich With se Should Case Wall Table be filtered by the specified Attributes? estiver selecionado).

Enriquecimento de entidades

A ação Enriquecer entidades é compatível com o seguinte enriquecimento de entidade:

Nome do campo de enriquecimento	Lógica
AD_primaryGroupID	A ação retorna o valor se ele existir no resultado JSON.
AD_logonCount	A ação retorna o valor se ele existir no resultado JSON.
AD_cn	A ação retorna o valor se ele existir no resultado JSON.
AD_countryCode	A ação retorna o valor se ele existir no resultado JSON.
AD_objectClass	A ação retorna o valor se ele existir no resultado JSON.
AD_userPrincipalName	A ação retorna o valor se ele existir no resultado JSON.
AD_adminCount	A ação retorna o valor se ele existir no resultado JSON.
AD_lastLogonTimestamp	A ação retorna o valor se ele existir no resultado JSON.
AD_manager	A ação retorna o valor se ele existir no resultado JSON.
AD_instanceType	A ação retorna o valor se ele existir no resultado JSON.
AD_distinguishedName	A ação retorna o valor se ele existir no resultado JSON.
AD_dSCorePropagationData	A ação retorna o valor se ele existir no resultado JSON.
AD_msDS-SupportedEncryptionTypes	A ação retorna o valor se ele existir no resultado JSON.
AD_objectSid	A ação retorna o valor se ele existir no resultado JSON.
AD_whenCreated	A ação retorna o valor se ele existir no resultado JSON.
AD_uSNCreated	A ação retorna o valor se ele existir no resultado JSON.
AD_lockoutTime	A ação retorna o valor se ele existir no resultado JSON.
AD_badPasswordTime	A ação retorna o valor se ele existir no resultado JSON.
AD_pwdLastSet	A ação retorna o valor se ele existir no resultado JSON.
AD_sAMAccountName	A ação retorna o valor se ele existir no resultado JSON.
AD_objectCategory	A ação retorna o valor se ele existir no resultado JSON.
AD_lastLogon	A ação retorna o valor se ele existir no resultado JSON.
AD_objectGUID	A ação retorna o valor se ele existir no resultado JSON.
AD_whenChanged	A ação retorna o valor se ele existir no resultado JSON.
AD_badPwdCount	A ação retorna o valor se ele existir no resultado JSON.
AD_accountExpires	A ação retorna o valor se ele existir no resultado JSON.
AD_displayName	A ação retorna o valor se ele existir no resultado JSON.
AD_name	A ação retorna o valor se ele existir no resultado JSON.
AD_memberOf	A ação retorna o valor se ele existir no resultado JSON.
AD_codePage	A ação retorna o valor se ele existir no resultado JSON.
AD_userAccountControl	A ação retorna o valor se ele existir no resultado JSON.
AD_sAMAccountType	A ação retorna o valor se ele existir no resultado JSON.
AD_uSNChanged	A ação retorna o valor se ele existir no resultado JSON.
AD_sn	A ação retorna o valor se ele existir no resultado JSON.
AD_givenName	A ação retorna o valor se ele existir no resultado JSON.
AD_lastLogoff	A ação retorna o valor se ele existir no resultado JSON.

Resultado JSON

O exemplo a seguir mostra a saída do resultado JSON recebida ao usar a ação Enriquecer entidades:

[
    {
        "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]"
    }
]

Mensagens de saída

A ação Enrich Entities pode retornar as seguintes mensagens de saída:

Mensagem de resposta	Descrição da mensagem
Active Directory Permalink: SERVER Enriched the following Users ENTITY_ID Enriched the following Hosts ENTITY_ID All entities were enriched.	A ação foi concluída.
The following entities were not found in Active Directory: ENTITY_ID	A ação falhou para as entidades especificadas. Verifique se as contas de usuário ou host existem no Active Directory e correspondem aos identificadores de entidade no caso.
Failed to enrich the following Users ENTITY_ID	A ação falhou para os usuários especificados. Verifique se a conta de serviço tem permissão para ler atributos (incluindo userAccountControl) nas contas de usuário de destino e se os atributos personalizados existem no Active Directory.
Failed to enrich the following Hosts ENTITY_ID	A ação falhou para os hosts especificados. Verifique se a conta de serviço tem permissão para ler atributos (incluindo userAccountControl) nas contas de computador de destino e confira se há atributos personalizados no Active Directory.
No entities were enriched.	A ação falhou. Confirme se o caso contém entidades User ou Hostname válidas que existem no Active Directory.
Error executing action "Enrich Entities". Reason: ERROR_REASON	A ação falhou. Verifique a conexão com o servidor do Active Directory, os campos de consulta personalizados ou as credenciais da conta de serviço.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Enriquecer entidades:

Nome do resultado do script	Valor
is_success	true ou false

Forçar atualização de senha

Use a ação Forçar atualização de senha para exigir que os usuários alterem a senha no próximo login. A ação segmenta automaticamente os usuários anexados ao caso.

Essa ação é executada na entidade User do Google SecOps.

Entradas da ação

Nenhuma.

Saídas da ação

A ação Forçar atualização de senha fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do painel de casos	Indisponível
Tabela de enriquecimento	Indisponível
Resultado JSON	Indisponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Forçar atualização de senha pode retornar as seguintes mensagens de saída:

Mensagem de resposta	Descrição da mensagem
Forced password update on next logon for the following users: ENTITY_ID	A ação foi concluída.
Failed to force password update on next logon for the following users: ENTITY_ID	A ação falhou para os usuários especificados. Verifique se a conta de serviço tem permissões de leitura e gravação para o atributo pwdLastSet nas contas de usuário de destino.
The following users were not found in Active Directory: ENTITY_ID	A ação falhou para os usuários especificados. Verifique se as contas de usuário existem no Active Directory e correspondem às entidades User no caso.
Password update wasn't forced on any users.	A ação falhou. Confirme se o caso contém entidades User válidas e se a conta de serviço tem permissão para atualizar as configurações de validade da senha.
Error executing action "Force Password Update". Reason: ERROR_REASON	A ação falhou. Verifique a conexão com o servidor do Active Directory ou as credenciais da conta de serviço.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Forçar atualização de senha:

Nome do resultado do script	Valor
is_success	true ou false

Receber participantes do grupo

Use a ação Receber membros do grupo para listar os usuários, computadores ou ambos que pertencem a um grupo específico do Active Directory. Se quiser, você pode restringir a pesquisa a uma unidade organizacional ou grupo principal específico e incluir membros de subgrupos aninhados.

Essa ação não é executada em entidades do Google SecOps.

Entradas da ação

A ação Get Group Members requer os seguintes parâmetros:

Parâmetro	Descrição
Group Name	Obrigatório. O nome do grupo que contém os membros listados.
Members Type	Obrigatório. O tipo de membro a ser recuperado do grupo. Os valores possíveis são os seguintes: Only Users Only Hosts Both O valor padrão é Only Users.
Where To Search	Obrigatório. Um Organizational Unit ou Group específico para definir o escopo da pesquisa. Os valores possíveis são os seguintes: Select Option Organizational Unit Group O valor padrão é Select Option.
Filter Object Value	Opcional. O nome do Organizational Unit ou Group em que a ação pesquisa o grupo de destino. Esse parâmetro é obrigatório se Where To Search estiver definido como Organizational Unit ou Group.
Perform Nested Search	Opcional. Se selecionada, a ação recupera membros de subgrupos aninhados que pertencem ao grupo de destino.
Limit	Opcional. O número máximo de listagens a serem recuperadas do Active Directory. O valor padrão é 100.

Saídas da ação

A ação Get Group Members fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do painel de casos	Disponível
Tabela de enriquecimento	Indisponível
Resultado JSON	Disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Tabela do painel de casos

A ação Get Group Members fornece a seguinte tabela no Case Wall:

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

Resultado JSON

O exemplo a seguir mostra a saída do resultado JSON recebida ao usar a ação Receber participantes do grupo:

[
  {
    "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"
  }
]

Mensagens de saída

A ação Get Group Members pode retornar as seguintes mensagens de saída:

Mensagem de resposta	Descrição da mensagem
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.	A ação foi concluída.
Error executing action "Get Group Members". Reason: Filter Object Value should be provided	A ação falhou. Informe um nome de UO ou grupo válido no parâmetro Filter Object Value quando Where To Search estiver definido como Organizational Unit ou Group.
Error executing action "Get Group Members". Reason: Given value for Limit should be a positive number.	A ação falhou. Insira um número inteiro maior que 0 no parâmetro Limit.
Error executing action "Get Group Members". Reason: Given group doesn't exist in Active Directory.	A ação falhou. Verifique o nome do grupo no parâmetro Group Name e confirme se o grupo existe no escopo de pesquisa configurado.
Error executing action "Get Group Members". Reason: Specified Organizational Unit doesn't exist in Active Directory.	A ação falhou. Verifique se a unidade organizacional especificada em Filter Object Value existe no Active Directory.
Error executing action "Get Group Members". Reason: Specified Group in "Filter Object Value" doesn't exist in Active Directory.	A ação falhou. Verifique se o grupo pai especificado em Filter Object Value existe no Active Directory.
Error executing action "Get Group Members". Reason: ERROR_REASON	A ação falhou. Verifique a conexão com o servidor do Active Directory, os parâmetros de entrada ou as credenciais da conta de serviço.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Receber participantes do grupo:

Nome do resultado do script	Valor
is_success	true ou false

Receber detalhes de contato do gerente

Use a ação Receber detalhes de contato do gerente para procurar o gerente de um usuário no Active Directory e recuperar os dados de contato dele. A ação segmenta automaticamente os usuários anexados ao caso.

Essa ação é executada na entidade User do Google SecOps.

Entradas da ação

Nenhuma.

Saídas da ação

A ação Receber detalhes de contato do gerente fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do painel de casos	Disponível
Tabela de enriquecimento de entidades	Disponível
Resultado JSON	Disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Tabela do painel de casos

A ação Receber detalhes de contato do gerente fornece a seguinte tabela no Mural de casos:

• Nome da tabela: Manager Contact: <var class="readonly">ENTITY_ID</var>
• Colunas:
  • Manager Name
  • Manager Phone

Enriquecimento de entidades

A ação Receber detalhes de contato do gerente é compatível com o seguinte enriquecimento de entidade:

Nome do campo de enriquecimento	Lógica
AD_Manager_Name	A ação retorna o valor se ele existir no resultado JSON.
AD_Manager_phone	A ação retorna o valor se ele existir no resultado JSON.
AD_primaryGroupID	A ação retorna o valor se ele existir no resultado JSON.
AD_logonCount	A ação retorna o valor se ele existir no resultado JSON.
AD_cn	A ação retorna o valor se ele existir no resultado JSON.
AD_countryCode	A ação retorna o valor se ele existir no resultado JSON.
AD_objectClass	A ação retorna o valor se ele existir no resultado JSON.
AD_userPrincipalName	A ação retorna o valor se ele existir no resultado JSON.
AD_adminCount	A ação retorna o valor se ele existir no resultado JSON.
AD_lastLogonTimestamp	A ação retorna o valor se ele existir no resultado JSON.
AD_manager	A ação retorna o valor se ele existir no resultado JSON.
AD_instanceType	A ação retorna o valor se ele existir no resultado JSON.
AD_distinguishedName	A ação retorna o valor se ele existir no resultado JSON.
AD_dSCorePropagationData	A ação retorna o valor se ele existir no resultado JSON.
AD_msDS-SupportedEncryptionTypes	A ação retorna o valor se ele existir no resultado JSON.
AD_objectSid	A ação retorna o valor se ele existir no resultado JSON.
AD_whenCreated	A ação retorna o valor se ele existir no resultado JSON.
AD_uSNCreated	A ação retorna o valor se ele existir no resultado JSON.
AD_lockoutTime	A ação retorna o valor se ele existir no resultado JSON.
AD_badPasswordTime	A ação retorna o valor se ele existir no resultado JSON.
AD_pwdLastSet	A ação retorna o valor se ele existir no resultado JSON.
AD_sAMAccountName	A ação retorna o valor se ele existir no resultado JSON.
AD_objectCategory	A ação retorna o valor se ele existir no resultado JSON.
AD_lastLogon	A ação retorna o valor se ele existir no resultado JSON.
AD_objectGUID	A ação retorna o valor se ele existir no resultado JSON.
AD_whenChanged	A ação retorna o valor se ele existir no resultado JSON.
AD_badPwdCount	A ação retorna o valor se ele existir no resultado JSON.
AD_accountExpires	A ação retorna o valor se ele existir no resultado JSON.
AD_displayName	A ação retorna o valor se ele existir no resultado JSON.
AD_name	A ação retorna o valor se ele existir no resultado JSON.
AD_memberOf	A ação retorna o valor se ele existir no resultado JSON.
AD_codePage	A ação retorna o valor se ele existir no resultado JSON.
AD_userAccountControl	A ação retorna o valor se ele existir no resultado JSON.
AD_sAMAccountType	A ação retorna o valor se ele existir no resultado JSON.
AD_uSNChanged	A ação retorna o valor se ele existir no resultado JSON.
AD_sn	A ação retorna o valor se ele existir no resultado JSON.
AD_givenName	A ação retorna o valor se ele existir no resultado JSON.
AD_lastLogoff	A ação retorna o valor se ele existir no resultado JSON.

Resultado JSON

O exemplo a seguir mostra a saída do resultado JSON recebida ao usar a ação Receber detalhes de contato do gerente:

[
   {
        "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]"
    }
]

Mensagens de saída

A ação Receber detalhes de contato do gerente pode retornar as seguintes mensagens de saída:

Mensagem de resposta	Descrição da mensagem
Retrieved manager details for the following users: ENTITY_ID	A ação foi concluída.
The following users don't have managers specified in Active Directory: ENTITY_ID	A ação falhou para os usuários especificados. Verifique se o atributo manager está preenchido nas contas de usuário de destino no Active Directory.
Failed to retrieve manager details for the following users: ENTITY_ID	A ação falhou para os usuários especificados. Verifique se a conta de serviço tem permissão para ler o atributo manager e o perfil de usuário do gerente no Active Directory.
The following users were not found in Active Directory: ENTITY_ID	A ação falhou para os usuários especificados. Verifique se as contas de usuário existem no Active Directory e correspondem às entidades User no caso.
No manager details were retrieved for the provided users.	A ação falhou. Confirme se o caso contém entidades User válidas que têm um gerente atribuído no Active Directory.
Error executing action "Get Manager Contact Details". Reason: ERROR_REASON	A ação falhou. Verifique a conexão com o servidor do Active Directory ou as credenciais da conta de serviço.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Get Manager Contact Details:

Nome do resultado do script	Valor
is_success	true ou false

O usuário está no grupo

Use a ação O usuário está no grupo para verificar se usuários específicos pertencem a um determinado grupo do Active Directory. Por padrão, a ação verifica as entidades User no caso, ou você pode inserir uma lista separada por vírgulas de nomes de usuário no parâmetro User Name para verificar contas específicas diretamente.

Essa ação é executada na entidade User do Google SecOps.

Entradas da ação

A ação O usuário está no grupo requer os seguintes parâmetros:

Parâmetro	Descrição
Group Name	Obrigatório. O nome do grupo a ser verificado, como administrators.
User Name	Opcional. Uma lista separada por vírgulas de nomes de usuário para verificar. Se você não fornecer um valor, a ação vai verificar as entidades User no caso.
Where To Search	Obrigatório. Um Organizational Unit ou Group específico para definir o escopo da pesquisa. Os valores possíveis são os seguintes: Select Option Organizational Unit Group O valor padrão é Select Option.
Filter Object Value	Opcional. O nome do Organizational Unit ou Group em que a ação pesquisa o grupo de destino. Esse parâmetro é obrigatório se Where To Search estiver definido como Organizational Unit ou Group.
Search In Subgroups	Opcional. Se selecionada, a ação pesquisa recursivamente em subgrupos aninhados.

Saídas da ação

A ação O usuário está no grupo fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do painel de casos	Indisponível
Tabela de enriquecimento	Indisponível
Resultado JSON	Disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Resultado JSON

O exemplo a seguir mostra a saída do resultado JSON recebida ao usar a ação O usuário está no grupo:

[
    {
        "EntityResult": true,
        "Entity": "[e-mail]"
    }, {
        "EntityResult": false,
        "Entity": "[e-mail]"
    }, {
        "EntityResult": true,
        "Entity": "[e-mail]"
    }
]

Mensagens de saída

A ação O usuário está no grupo pode retornar as seguintes mensagens de saída:

Mensagem de resposta	Descrição da mensagem
USER_NAME IN GROUP_NAME; USER_NAME NOT in GROUP_NAME;	A ação foi concluída.
The following users were not found in Active Directory: USER_NAME	A ação falhou para os usuários especificados. Verifique se os nomes de usuário ou as entidades User existem no Active Directory.
None of the provided users were found in Active Directory.	A ação falhou. Confirme se o caso contém entidades User válidas ou se os nomes de usuário especificados no parâmetro User Name existem no Active Directory.
Error executing action "Is User In Group". Reason: Filter Object Value should be provided	A ação falhou. Informe um nome de UO ou grupo válido no parâmetro Filter Object Value quando Where To Search estiver definido como Organizational Unit ou Group.
Error executing action "Is User In Group". Reason: Given group doesn't exist in Active Directory.	A ação falhou. Verifique o nome do grupo no parâmetro Group Name e confirme se o grupo existe no escopo de pesquisa configurado.
Error executing action "Is User In Group". Reason: Specified Organizational Unit doesn't exist in Active Directory.	A ação falhou. Verifique se a unidade organizacional especificada em Filter Object Value existe no Active Directory.
Error executing action "Is User In Group". Reason: Specified Group in "Filter Object Value" doesn't exist in Active Directory.	A ação falhou. Verifique se o grupo pai especificado em Filter Object Value existe no Active Directory.
Error executing action "Is User In Group". Reason: ERROR_REASON	A ação falhou. Verifique a conexão com o servidor do Active Directory, os parâmetros de entrada ou as credenciais da conta de serviço.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação O usuário está no grupo:

Nome do resultado do script	Valor
is_success	true ou false

Listar grupos de usuários

Use a ação Listar grupos de usuários para recuperar uma lista de todos os grupos do Active Directory a que um usuário pertence. A ação segmenta automaticamente os usuários anexados ao caso.

Essa ação é executada na entidade User do Google SecOps.

Entradas da ação

Nenhuma.

Saídas da ação

A ação Listar grupos de usuários fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do painel de casos	Indisponível
Tabela de enriquecimento	Indisponível
Resultado JSON	Disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Resultado JSON

O exemplo a seguir mostra a saída do resultado JSON recebida ao usar a ação Listar grupos de usuários:

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

Mensagens de saída

A ação Listar grupos de usuários pode retornar as seguintes mensagens de saída:

Mensagem de resposta	Descrição da mensagem
Groups were listed for the following users: ENTITY_ID	A ação foi concluída.
No groups were found for the following users: ENTITY_ID	A ação falhou para os usuários especificados. Verifique se as contas de usuário estão atribuídas a pelo menos um grupo explícito no atributo memberOf no Active Directory.
Failed to list groups for the following users: ENTITY_ID	A ação falhou para os usuários especificados. Verifique se a conta de serviço tem permissão para ler o atributo memberOf nas contas de usuário de destino.
The following users were not found in Active Directory: ENTITY_ID	A ação falhou para os usuários especificados. Verifique se as contas de usuário existem no Active Directory e correspondem às entidades User no caso.
No groups were listed.	A ação falhou. Confirme se o caso contém entidades User válidas que pertencem a grupos no Active Directory.
Error executing action "List User Groups". Reason: ERROR_REASON	A ação falhou. Verifique a conexão com o servidor do Active Directory ou as credenciais da conta de serviço.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Listar grupos de usuários:

Nome do resultado do script	Valor
is_success	true ou false

Ping

Use a ação Ping para verificar se o Google SecOps pode se conectar e autenticar no servidor do Active Directory usando as configurações de integração definidas.

Essa ação não é executada em entidades do Google SecOps.

Entradas da ação

Nenhuma.

Saídas da ação

A ação Ping fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do painel de casos	Indisponível
Tabela de enriquecimento	Indisponível
Resultado JSON	Indisponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Ping pode retornar as seguintes mensagens de saída:

Mensagem de resposta	Descrição da mensagem
Connected successfully.	A ação foi concluída.
Error executing action "Ping". Reason: ERROR_REASON	A ação falhou. Verifique o endereço do servidor, a porta, as configurações de SSL ou as credenciais da conta de serviço na configuração da integração.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Ping:

Nome do resultado do script	Valor
is_success	true ou false

Liberar conta bloqueada

Use a ação Liberar conta bloqueada para desbloquear contas de usuário no Active Directory que foram bloqueadas após muitas tentativas de login com falha. A ação segmenta automaticamente os usuários anexados ao caso.

Essa ação é executada na entidade User do Google SecOps.

Entradas da ação

Nenhuma.

Saídas da ação

A ação Liberar conta bloqueada fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do painel de casos	Indisponível
Tabela de enriquecimento	Indisponível
Resultado JSON	Indisponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Liberar conta bloqueada pode retornar as seguintes mensagens de saída:

Mensagem de resposta	Descrição da mensagem
Unlocked account for the following users: ENTITY_ID	A ação foi concluída.
Failed to unlock account for the following users: ENTITY_ID	A ação falhou para os usuários especificados. Verifique se a conta de serviço tem permissões de leitura e gravação para o atributo lockoutTime nas contas de usuário de destino.
The following users were not found in Active Directory: ENTITY_ID	A ação falhou para os usuários especificados. Verifique se as contas de usuário existem no Active Directory e correspondem às entidades User no caso.
No accounts were unlocked.	A ação falhou. Confirme se o caso contém entidades User válidas e se a conta de serviço tem permissão para desbloquear as contas de destino.
Error executing action "Release Locked Account". Reason: ERROR_REASON	A ação falhou. Verifique a conexão com o servidor do Active Directory ou as credenciais da conta de serviço.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Liberar conta bloqueada:

Nome do resultado do script	Valor
is_success	true ou false

Remover usuário do grupo

Use a ação Remover usuário do grupo para remover usuários do caso de um ou mais grupos do Active Directory, como revogar o acesso elevado ao grupo durante um incidente. A ação identifica automaticamente os usuários-alvo do caso e os remove dos grupos especificados.

Essa ação é executada na entidade User do Google SecOps.

Entradas da ação

A ação Remover usuário do grupo requer os seguintes parâmetros:

Parâmetro	Descrição
Group Name	Obrigatório. Uma lista separada por vírgulas de grupos dos quais os usuários serão removidos.

Saídas da ação

A ação Remover usuário do grupo fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do painel de casos	Indisponível
Tabela de enriquecimento	Indisponível
Resultado JSON	Indisponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Remover usuário do grupo pode retornar as seguintes mensagens de saída:

Mensagem de resposta	Descrição da mensagem
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	A ação foi concluída.
Action wasn't able to remove the following users from the group "GROUP_NAME" in Active Directory: ENTITY_ID	A ação falhou para os usuários especificados. Verifique se a conta de serviço tem permissão para modificar o atributo member no grupo de destino.
The following users were not found in Active Directory: ENTITY_ID	A ação falhou para os usuários especificados. Verifique se as contas de usuário existem no Active Directory e correspondem às entidades User no caso.
The following groups were not found in Active Directory: GROUP_NAME	A ação falhou para os grupos especificados. Verifique a ortografia dos nomes dos grupos no parâmetro Group Name e confirme se os grupos existem no domínio configurado.
No users were removed from the group "GROUP_NAME" in Active Directory.	A ação falhou para o grupo especificado. Verifique se os usuários de destino existem no Active Directory e se a conta de serviço tem acesso de gravação ao grupo especificado.
No users were removed from the provided groups in Active Directory.	A ação falhou. Confirme se o caso contém entidades User válidas e se os grupos especificados existem no Active Directory.
Error executing action "Remove User From Group". Reason: ERROR_REASON	A ação falhou. Verifique a conexão com o servidor do Active Directory, os parâmetros de entrada ou as credenciais da conta de serviço.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Remover usuário do grupo:

Nome do resultado do script	Valor
is_success	true ou false

Pesquisar no Active Directory

Use a ação Pesquisar no Active Directory para pesquisar usuários, computadores, grupos ou unidades organizacionais no diretório usando condições de pesquisa integradas ou uma consulta personalizada. Também é possível filtrar a pesquisa por unidades organizacionais específicas e escolher quais campos do diretório incluir nos resultados.

Essa ação não é executada em entidades do Google SecOps.

Entradas da ação

A ação Pesquisar no Active Directory requer os seguintes parâmetros:

Parâmetro	Descrição
Search Condition	Obrigatório. A condição a ser aplicada à pesquisa. Os valores possíveis são os seguintes: Contains Exact Match Starts With Custom LDAP Query O valor padrão é Contains.
Include Domain	Opcional. Se selecionada, a ação inclui o componente de domínio ao pesquisar com as condições Contains, Exact Match ou Starts With.
Search Object	Obrigatório. Um tipo de objeto a ser pesquisado quando não estiver usando Custom LDAP Query. Os valores possíveis são os seguintes: Select Option User Host Group Organizational Unit O valor padrão é Select Option.
Filter Object Value	Obrigatório. Um valor de objeto para filtrar ou a string de consulta LDAP completa quando Search Condition está definido como Custom LDAP Query.
Custom Fields	Opcional. Uma lista separada por vírgulas de atributos LDAP a serem retornados nos resultados da pesquisa.
Specific OUs to Search	Opcional. Uma lista separada por vírgulas de nomes de unidades organizacionais para restringir o escopo da pesquisa.
Include Default Search Fields	Opcional. Se selecionada, a ação inclui campos padrão do Active Directory nos resultados retornados, além de qualquer Custom Fields especificado. Ativado por padrão.
Max Records To Return	Opcional. Um número máximo de registros a serem recuperados do Active Directory. O valor padrão é 100.
Sort Field	Opcional. Um nome de atributo LDAP usado para classificar as entradas retornadas.

Saídas da ação

A ação Pesquisar no Active Directory fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do painel de casos	Disponível
Tabela de enriquecimento	Indisponível
Resultado JSON	Disponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Tabela do painel de casos

A ação Pesquisar no Active Directory fornece a seguinte tabela no Case Wall:

• Nome da tabela: Active Directory Search Results
• Colunas: atributos do Active Directory retornados para as entradas de diretório correspondentes (com base em Include Default Search Fields e Custom Fields).

Resultado JSON

O exemplo a seguir mostra a saída do resultado JSON recebida ao usar a ação Pesquisar 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"
        ]
      }
    ]

Mensagens de saída

A ação Pesquisar no Active Directory pode retornar as seguintes mensagens de saída:

Mensagem de resposta	Descrição da mensagem
Successfully performed the query "QUERY_STRING" in Active Directory. No results to show following the query: "QUERY_STRING".	A ação foi concluída.
Error executing action "Search Active Directory". Reason: you need to select "Search Object" or choose "Custom LDAP Query" as a "Search Condition"	A ação falhou. Selecione um tipo de objeto válido no parâmetro Search Object ou mude Search Condition para Custom LDAP Query.
Error executing action "Search Active Directory". Reason: Value for the parameter "Max Records To Return" should be a positive number.	A ação falhou. Insira um número inteiro maior que 0 no parâmetro Max Records To Return.
Error executing action "Search Active Directory". Reason: The following OUs were not found in Active Directory: OU_NAMES	A ação falhou. Verifique a ortografia das unidades organizacionais no parâmetro Specific OUs to Search e confirme se elas existem no Active Directory.
Error executing action "Search Active Directory". Reason: Knowingly invalid query was executed: "QUERY_STRING". Please verify the inputs and try again.	A ação falhou. Verifique a sintaxe da consulta personalizada ou do valor do filtro no parâmetro Filter Object Value e se os nomes Custom Fields ou Sort Field especificados são atributos LDAP válidos.
Error executing action "Search Active Directory". Reason: ERROR_REASON	A ação falhou. Verifique a conexão com o servidor do Active Directory, os parâmetros de entrada ou as credenciais da conta de serviço.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Pesquisar Active Directory:

Nome do resultado do script	Valor
is_success	true ou false

Definir senha do usuário

Use a ação Definir senha do usuário para redefinir a senha dos usuários no caso para uma nova senha. Verifique se a integração está conectada por SSL (LDAPS) e se a nova senha atende às regras de complexidade de senha do seu domínio.

Essa ação é executada na entidade User do Google SecOps.

Entradas da ação

A ação Definir senha do usuário requer os seguintes parâmetros:

Parâmetro	Descrição
New Password	Obrigatório. O valor da nova senha.

Saídas da ação

A ação Definir senha do usuário fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do painel de casos	Indisponível
Tabela de enriquecimento	Indisponível
Resultado JSON	Indisponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Definir senha do usuário pode retornar as seguintes mensagens de saída:

Mensagem de resposta	Descrição da mensagem
Reset password for the following users: ENTITY_ID	A ação foi concluída.
Failed to reset password for the following users: ENTITY_ID	A ação falhou para os usuários especificados. Verifique se a nova senha atende aos requisitos de complexidade e histórico de senhas do domínio e se os usuários de destino não são contas administrativas protegidas.
The following users were not found in Active Directory: ENTITY_ID	A ação falhou para os usuários especificados. Verifique se as contas de usuário existem no Active Directory e correspondem às entidades User no caso.
No passwords were changed.	A ação falhou. Confirme se o caso contém entidades User válidas e se a conta de serviço tem permissão para redefinir senhas nas contas de destino.
Failed to execute "Set User Password" action! Watch Over Extended Rights permission or SSL connection.	A ação falhou. Verifique se Use SSL está selecionado na configuração de integração (LDAPS na porta 636) e se a conta de serviço tem o direito estendido Redefinir senha.
Error executing action "Set User Password". Reason: ERROR_REASON	A ação falhou. Verifique a conexão com o servidor do Active Directory, os parâmetros de entrada ou as credenciais da conta de serviço.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Definir senha do usuário:

Nome do resultado do script	Valor
is_success	true ou false

Atualizar atributos de um host do AD

Use a ação Atualizar atributos de um host do AD para atualizar uma propriedade de diretório específica em contas de computador no caso, como atualizar o campo Description de um computador com notas de incidente. A ação identifica automaticamente os computadores de destino do caso e aplica o novo valor.

Essa ação é executada na entidade Hostname do Google SecOps.

Entradas da ação

A ação Atualizar atributos de um host do AD requer os seguintes parâmetros:

Parâmetro	Descrição
Attribute Name	Obrigatório. O nome do atributo a ser atualizado, como Description.
Attribute Value	Obrigatório. O novo valor do atributo.

Saídas da ação

A ação Atualizar atributos de um host do AD fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do painel de casos	Indisponível
Tabela de enriquecimento	Indisponível
Resultado JSON	Indisponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Atualizar atributos de um host do AD pode retornar as seguintes mensagens de saída:

Mensagem de resposta	Descrição da mensagem
Successfully updated attribute "ATTRIBUTE_NAME" on the following hosts in Active Directory: ENTITY_ID_LIST	A ação foi concluída.
Action wasn't able to update attribute "ATTRIBUTE_NAME" on the following hosts in Active Directory: ENTITY_ID_LIST	A ação falhou para os hosts especificados. Verifique se a conta de serviço tem permissão de gravação para o atributo especificado nas contas de computador de destino e se o formato do valor é válido para esse atributo.
The following hosts were not found in Active Directory: ENTITY_ID_LIST	A ação falhou para os hosts especificados. Verifique se as contas de computador existem no Active Directory e correspondem às entidades Hostname no caso.
No hosts were updated in Active Directory.	A ação falhou. Confirme se o caso contém entidades Hostname válidas e se a conta de serviço tem permissão para atualizar o atributo especificado.
Error executing action "Update attributes of an AD Host". Reason: Provided attribute doesn't exist in Active Directory.	A ação falhou. Verifique a ortografia do atributo no parâmetro Attribute Name e confirme se ele é um atributo de computador válido do Active Directory.
Error executing action "Update attributes of an AD Host". Reason: ERROR_REASON	A ação falhou. Verifique a conexão com o servidor do Active Directory, os parâmetros de entrada ou as credenciais da conta de serviço.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Atualizar atributos de um host do AD:

Nome do resultado do script	Valor
is_success	true ou false

Atualizar atributos de um usuário do AD

Use a ação Atualizar atributos de um usuário do AD para atualizar uma propriedade de diretório específica nas contas de usuário no caso, como atualizar o campo Description, title ou department de um usuário. A ação identifica automaticamente os usuários-alvo do caso e aplica o novo valor.

Essa ação é executada na entidade User do Google SecOps.

Entradas da ação

A ação Atualizar atributos de um usuário do AD requer os seguintes parâmetros:

Parâmetro	Descrição
Attribute Name	Obrigatório. O nome do atributo a ser atualizado, como Description.
Attribute Value	Obrigatório. O novo valor do atributo.

Saídas da ação

A ação Atualizar atributos de um usuário do AD fornece as seguintes saídas:

Tipo de saída da ação	Disponibilidade
Anexo do Painel de Casos	Indisponível
Link do Painel de Casos	Indisponível
Tabela do painel de casos	Indisponível
Tabela de enriquecimento	Indisponível
Resultado JSON	Indisponível
Mensagens de saída	Disponível
Resultado do script	Disponível

Mensagens de saída

A ação Atualizar atributos de um usuário do AD pode retornar as seguintes mensagens de saída:

Mensagem de resposta	Descrição da mensagem
Successfully updated attribute "ATTRIBUTE_NAME" for the following users in Active Directory: ENTITY_ID_LIST	A ação foi concluída.
Action wasn't able to update attribute "ATTRIBUTE_NAME" for the following users in Active Directory: ENTITY_ID_LIST	A ação falhou para os usuários especificados. Verifique se a conta de serviço tem permissão de gravação para o atributo especificado nas contas de usuário de destino e se o formato do valor é válido para esse atributo.
The following users were not found in Active Directory: ENTITY_ID_LIST	A ação falhou para os usuários especificados. Verifique se as contas de usuário existem no Active Directory e correspondem às entidades User no caso.
No users were updated in Active Directory.	A ação falhou. Confirme se o caso contém entidades User válidas e se a conta de serviço tem permissão para atualizar o atributo especificado.
Error executing action "Update attributes of an AD User". Reason: Provided attribute doesn't exist in Active Directory.	A ação falhou. Verifique a ortografia do atributo no parâmetro Attribute Name e confirme se ele é um atributo de usuário válido do Active Directory.
Error executing action "Update attributes of an AD User". Reason: ERROR_REASON	A ação falhou. Verifique a conexão com o servidor do Active Directory, os parâmetros de entrada ou as credenciais da conta de serviço.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Atualizar atributos de um usuário do AD:

Nome do resultado do script	Valor
is_success	true ou false

Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais do Google SecOps.