Integra Active Directory con Google SecOps

En este documento, se explica cómo integrar Active Directory con Google Security Operations.

Nota: Esta integración usa uno o más componentes de código abierto. Puedes descargar una copia comprimida del código fuente completo de esta integración desde el bucket de Cloud Storage.

Casos de uso

La integración de Active Directory usa las capacidades de Google SecOps para admitir los siguientes casos de uso:

• Activa y desactiva usuarios: Desactiva una cuenta de usuario potencialmente vulnerada y evita más accesos no autorizados.

• Restablecer contraseñas: Restablece automáticamente la contraseña del usuario en Active Directory y notifica al usuario sobre el cambio.

• Administra grupos: Agrega usuarios nuevos a los grupos de seguridad adecuados según su rol y asegúrate de que tengan los permisos de acceso correctos.

• Recuperar información del usuario: Recupera detalles del usuario, como las membresías de grupos, la hora del último acceso y la información de contacto de una cuenta de usuario específica.

• Automatiza la desvinculación: Inhabilita las cuentas, quítalas de los grupos y transfiere la propiedad de los archivos cuando un empleado se desvincule.

Antes de comenzar

Antes de configurar la integración de Active Directory en Google SecOps, verifica que tu entorno de red, los Servicios de dominio de Active Directory (AD DS) y las credenciales de la cuenta de servicio cumplan con todos los requisitos operativos.

Para preparar tu entorno para la integración, completa los siguientes requisitos previos:

1. Verifica la conectividad de red y la resolución de DNS entre tu instancia de Google SecOps (o agente remoto) y tus controladores de dominio de Active Directory.

2. Opcional: Si te conectas a través de LDAPS (puerto 636, obligatorio para restablecer la contraseña) con una autoridad certificadora interna, configura el certificado de la AC codificando tu certificado raíz o intermedio en una cadena base64.

3. Crea una cuenta de servicio de Active Directory dedicada que se adhiera al principio de privilegio mínimo.

4. Revisa los permisos de acción requeridos para determinar los atributos y los derechos de acceso necesarios para las acciones específicas que planeas ejecutar.

5. Delega permisos en las unidades organizativas de destino para las acciones que planeas usar (con Usuarios y computadoras de Active Directory o PowerShell y dsacls), y asegúrate de que la cuenta de servicio tenga acceso explícito de lectura y escritura al atributo userAccountControl.

Requisitos de red y DNS

Google SecOps se comunica directamente con los controladores de dominio de Active Directory con el Protocolo ligero de acceso a directorios (LDAP o LDAPS) a través de TCP.

Asegúrate de que tu entorno de red cumpla con las siguientes reglas de conectividad:

• Conectividad de puertos: Asegúrate de que los firewalls y el enrutamiento de tu red permitan la comunicación saliente de Google SecOps (o tu agente remoto) a tus controladores de dominio de Active Directory en los siguientes puertos:

  • LDAP (estándar): Abre el puerto 389/TCP para la comunicación LDAP sin encriptar.
  • LDAPS (recomendado, obligatorio para las contraseñas): Abre el puerto 636/TCP (o tu puerto SSL/TLS personalizado). LDAPS es necesario para el tráfico de directorio encriptado y es obligatorio para las acciones de modificación de contraseñas.

• Resolución de DNS y nombres de host: Active Directory requiere una resolución de nombres de host precisa para que coincida con los certificados SSL/TLS y las vinculaciones de servicios de directorio. Si tu dominio se resuelve con un nombre de DNS completamente calificado a través de tu configuración de DNS interna, no se necesita ninguna configuración de host adicional. Si la resolución de DNS no está disponible en la imagen de contenedor del agente remoto, configura el archivo /etc/hosts.

Configura el archivo /etc/hosts

Esta configuración es opcional. Si tu controlador de dominio ya se resolvió con la configuración de DNS interno, omite esta sección. Si tu agente remoto no puede resolver el controlador de dominio de Active Directory con DNS, asigna el host de forma manual en el archivo /etc/hosts para que coincida con los certificados SSL/TLS y las vinculaciones del servicio de directorio.

Para configurar el archivo /etc/hosts, completa los siguientes pasos:

1. Abre /etc/hosts en un editor de texto con privilegios de administrador:

   sudo vi /etc/hosts
   

2. Agrega una entrada que asigne la dirección IP del controlador de dominio a su nombre de dominio completamente calificado (FQDN):

   192.0.2.195 dc01.example.local
   

3. Guarde y cierre el archivo.

Si no necesitas un certificado de la AC para la integración, continúa con la configuración de los requisitos de autenticación y cuenta de servicio. De lo contrario, configura tu certificado de la AC.

Configura el certificado de la AC

Este paso es opcional. Si te conectas con LDAP estándar (puerto 389) o usas un certificado de confianza pública, omite esta sección y continúa con los requisitos de autenticación y de cuenta de servicio. Si te conectas a través de LDAPS (puerto 636, obligatorio para restablecer contraseñas) con un certificado emitido por una CA privada o interna, proporciona la cadena de certificado codificada en Base64 durante la configuración para establecer una conexión TLS de confianza.

Para configurar y subir el certificado de la AC, completa los siguientes pasos:

1. Codifica tu archivo de certificado con formato PEM:

   • Linux: bash base64 -w 0 mycert.crt

   • macOS: bash base64 -i mycert.crt

2. Copia la cadena de salida completa (incluidos los encabezados codificados) y pégala en el campo Archivo de certificado de la AC: analizado en una cadena Base64 en la configuración de la integración de Google SecOps.

3. Establece el parámetro Servidor en el FQDN del controlador de dominio (no en su dirección IP) para que el nombre de host coincida con el nombre común (CN) o el nombre alternativo del sujeto (SAN) en el certificado.

4. Haz clic en Probar para validar el protocolo de enlace TLS.

Requisitos de autenticación y cuenta de servicio

La integración de Active Directory se autentica con credenciales estándar de AD DS.

Asegúrate de que tu configuración de autenticación cumpla con las siguientes prácticas de seguridad:

• Cuenta de servicio dedicada: Crea una cuenta de servicio dedicada (como svc_secops_ad) específicamente para los playbooks automatizados de Google SecOps. Evita usar cuentas de usuario interactivas o cuentas de administrador de dominio integradas.

• Formato del nombre de usuario: El nombre de usuario se puede proporcionar como un nombre principal de usuario (UPN) (como [e-mail]) o como un nombre de acceso de nivel inferior (EXAMPLE\svc_secops).

• PoLP: No agregues la cuenta de servicio a grupos integrados con privilegios, como Administradores de dominio, Administradores de empresa o Operadores de cuenta. En su lugar, otorga permisos detallados en las UO específicas en las que residen los objetos de usuario, computadora o grupo.

Configura los permisos de acción (privilegio mínimo)

Otorga a la cuenta de servicio de autenticación solo los permisos de Active Directory y el acceso a los atributos de LDAP necesarios para las acciones específicas que planeas ejecutar.

Importante: Las acciones de verificación de estado y del ciclo de vida (incluidas Habilitar cuenta, Inhabilitar cuenta, Habilitar computadora, Inhabilitar computadora y Enriquecer entidades) requieren derechos explícitos de lectura y escritura de propiedades en el atributo userAccountControl.

Si la cuenta de servicio no puede leer userAccountControl, Active Directory omite el atributo por completo de las respuestas de LDAP. En Google SecOps, esto produce excepciones nulas no controladas (como TypeError: 'NoneType' object is not subscriptable). Asegúrate de que este atributo se delegue de forma explícita en todas las UO de destino.

Consulta los permisos mínimos para las acciones de Active Directory en la siguiente tabla:

Nombre de la acción	Permiso de AD DS/derecho extendido obligatorio	Clase de objeto de destino	Descripción/Alcance del atributo
Ping	Read Property	Usuario, raíz del dominio	Consulta el objeto de cuenta de servicio configurado (sAMAccountName, userPrincipalName, mail) para validar la conectividad y las credenciales del directorio.
Enriquece entidades	List Contents Read Property (atributos de destino: userAccountControl, sAMAccountName, mail, memberOf, lockoutTime, pwdLastSet)	Usuario, computadora, grupo	Consulta los atributos de usuario y computadora, y resuelve las membresías de grupos anidados. Requiere Read Property en userAccountControl para evitar errores de subíndice nulo.
Inhabilitar cuenta	Read Property: userAccountControl Write Property: userAccountControl	Usuario	Lee y establece la marca ACCOUNTDISABLE (0x0002) en el objeto de usuario de destino.
Habilitar cuenta	Read Property: userAccountControl Write Property: userAccountControl	Usuario	Lee y borra la marca ACCOUNTDISABLE (0x0002) en el objeto de usuario de destino.
Inhabilitar computadora	Read Property: userAccountControl Write Property: userAccountControl	Computadora	Lee y establece la marca ACCOUNTDISABLE en el objeto de computadora de destino.
Habilita el uso de la computadora	Read Property: userAccountControl Write Property: userAccountControl	Computadora	Lee y borra la marca ACCOUNTDISABLE en el objeto de la computadora de destino.
Liberar cuenta bloqueada	Read Property: lockoutTime Write Property: lockoutTime	Usuario	Lee y establece el atributo lockoutTime en 0 para desbloquear una cuenta de usuario bloqueada.
Forzar la actualización de la contraseña	Read Property: pwdLastSet Write Property: pwdLastSet	Usuario	Lee y establece el atributo pwdLastSet en 0 para exigir que el usuario cambie su contraseña en el próximo acceso.
Establecer contraseña de usuario	Derecho extendido: Reset Password (User-Force-Change-Password) (Opcional) Write Property: unicodePwd	Usuario	Restablece la contraseña del usuario de destino. Requiere LDAPS (puerto 636) o StartTLS.
Agregar usuario al grupo	Read Property: member Write Property: member	Grupo	Agrega el nombre distinguido (distinguishedName) del usuario de destino al atributo member del grupo.
Quita un usuario de un grupo	Read Property: member Write Property: member	Grupo	Quita el nombre distinguido (distinguishedName) del usuario objetivo del atributo member del grupo.
Cambiar la UO del usuario	Delete Child Object (usuario) en la UO de origen Create Child Object (usuario) en la UO de destino Write Property: name, distinguishedName	Unidad organizativa, usuario	Mueve objetos de usuario entre UO con el modify_dn de LDAP.
Cambia la UO del host	Delete Child Object (computadora) en la UO de origen Create Child Object (computadora) en la UO de destino Write Property: name, distinguishedName	Unidad organizativa, computadora	Mueve objetos de computadora entre las UO con el modify_dn de LDAP.
Actualiza los atributos de un usuario de AD	Write Property en los atributos de destino (como mail, title, department, telephoneNumber, description o manager)	Usuario	Modifica los valores de los atributos especificados en el objeto de usuario de destino.
Actualiza los atributos de un host de AD	Write Property en los atributos de destino (como description o location)	Computadora	Modifica los valores de los atributos especificados en el objeto de computadora de destino.
Obtén miembros del grupo	List Contents Read Property: member, sAMAccountName, distinguishedName	Grupo, usuario, computadora	Consulta la membresía de grupos y los atributos de las cuentas de los miembros.
Obtén los datos de contacto del administrador	Read Property: manager Read Property: cn, telephoneNumber, mail, displayName, title	Usuario	Lee el atributo manager del objeto de usuario de destino y recupera los datos de contacto del administrador.
Is User In Group	Read Property: memberOf, sAMAccountName	Usuario, grupo	Evalúa si una cuenta de usuario pertenece al grupo de seguridad o distribución especificado.
Enumera los grupos de usuarios	Read Property: memberOf, sAMAccountName	Usuario, grupo	Devuelve la lista de todos los grupos asignados a la cuenta de usuario especificada.
Busca en Active Directory	List Contents Read Property en los atributos consultados	Usuario, computadora, grupo, unidad organizativa	Ejecuta consultas de filtro LDAP personalizadas en el subárbol del directorio.

Delega permisos en Active Directory

Para aplicar el PoLP sin otorgar derechos administrativos amplios, delega permisos en las UO de destino con la consola gráfica de ADUC o las herramientas de línea de comandos de PowerShell y dsacls. Solo necesitas usar uno de estos métodos y delegar los permisos necesarios para las acciones específicas que planeas ejecutar.

Delega el control con ADUC

Si prefieres usar una interfaz gráfica, usa el Asistente para delegación de control en ADUC para delegar permisos específicos de objetos y propiedades.

Ejecuta el asistente en la UO de destino para otorgar los permisos de objeto y propiedad necesarios para las acciones que planeas usar (como leer y escribir marcas de control de cuentas, restablecer contraseñas o desbloquear cuentas).

Para obtener orientación paso a paso sobre cómo ejecutar el asistente, consulta la documentación de Microsoft sobre la delegación de control en AD DS.

Delega el control con PowerShell y dsacls

Si prefieres un enfoque de línea de comandos o deseas automatizar las asignaciones de permisos, usa PowerShell con la utilidad integrada dsacls.exe en lugar de ADUC.

Ejecuta solo los ejemplos de comandos que se aplican a las acciones que planeas usar en una estación de trabajo administrativa o un controlador de dominio, sustituyendo tu UO de destino y el nombre de la cuenta de servicio:

• Otorga permisos de lectura y escritura en userAccountControl para los objetos de usuario (para habilitar o inhabilitar cuentas de usuario y evitar errores de enriquecimiento): powershell dsacls.exe "OU=Users,DC=example,DC=local" /I:S /G "EXAMPLE\svc_secops_ad:RPWP;userAccountControl;user"
• Otorga permisos de lectura y escritura en userAccountControl para objetos de computadora (para habilitar o inhabilitar computadoras): powershell dsacls.exe "OU=Computers,DC=example,DC=local" /I:S /G "EXAMPLE\svc_secops_ad:RPWP;userAccountControl;computer"
• Otorga permisos para desbloquear la cuenta (lockoutTime): powershell dsacls.exe "OU=Users,DC=example,DC=local" /I:S /G "EXAMPLE\svc_secops_ad:RPWP;lockoutTime;user"
• Otorga permisos para forzar el cambio de contraseña (pwdLastSet): powershell dsacls.exe "OU=Users,DC=example,DC=local" /I:S /G "EXAMPLE\svc_secops_ad:RPWP;pwdLastSet;user"
• Otorga derechos de restablecimiento de contraseña (derecho extendido Reset Password): powershell dsacls.exe "OU=Users,DC=example,DC=local" /I:S /G "EXAMPLE\svc_secops_ad:CA;Reset Password;user"
• Otorga derechos de modificación de membresía en un grupo de seguridad: powershell dsacls.exe "CN=SecOps-Quarantine,OU=Groups,DC=example,DC=local" /G "EXAMPLE\svc_secops_ad:RPWP;member;group"

Para obtener más detalles sobre la sintaxis y los interruptores de parámetros, consulta la documentación de Microsoft sobre dsacls.

Nota: En Active Directory, los miembros de grupos administrativos protegidos tienen la herencia inhabilitada por el proceso interno de AdminSDHolder. Los permisos delegados asignados a nivel de la UO no se aplicarán a las cuentas administrativas protegidas.

Para obtener más información sobre la administración de objetos protegidos, consulta la documentación de Microsoft sobre AdminSDHolder y cuentas protegidas.

Parámetros de integración

La integración de Active Directory requiere los siguientes parámetros:

Parámetro	Descripción
Server	Obligatorio. Es el nombre de host, el nombre de DNS o la dirección IP del servidor de Active Directory. La integración se comunica con el protocolo LDAP. Para usar un puerto personalizado, agrégalo a la dirección (como mydomain.com:636). De forma predeterminada, la integración usa el puerto 636 cuando SSL/TLS está habilitado y el puerto 389 cuando está inhabilitado.
Username	Obligatorio. Es el nombre de usuario o la dirección de correo electrónico del usuario que se conectará a Active Directory, como DOMAIN\username o [e-mail]. Este parámetro también acepta el atributo userPrincipalName.
Password	Obligatorio. Es la contraseña de la cuenta de usuario.
Domain	Obligatorio. Es la ruta de acceso de DNS completa a tu dominio dentro del espacio de nombres de red. Proporciona el nombre de dominio completamente calificado (FQDN) de tu dominio en el siguiente formato: SUBDOMAIN.ROOT_DOMAIN. Por ejemplo, si tu dominio interno de Active Directory es example.local, el FQDN que debes ingresar es example.local. Si tu dominio interno de Active Directory es corp.example.com, el FQDN que debes ingresar es corp.example.com.
Custom Query Fields	Es opcional. Es una lista separada por comas de campos personalizados de Active Directory que se incluirán en las consultas, como customField1, customField2.
CA Certificate File - parsed into Base64 String	Es opcional. Es la cadena del archivo de certificado de la AC codificada en el formato base64 que se obtiene cuando se configura el certificado de la AC. Proporciona el valor completo.
Use SSL	Es opcional. Si se selecciona, la integración valida el certificado SSL cuando se conecta al servidor de Active Directory y usa LDAPS seguro (puerto 636). Si no se selecciona, se usa el LDAP estándar (puerto 389).
Debug Logging	Es opcional. Si se selecciona, la integración registra información de depuración detallada para las operaciones de Active Directory.

Para obtener instrucciones sobre cómo configurar una integración en Google SecOps, consulta Configura integraciones.

Si es necesario, puedes realizar cambios más adelante. Después de configurar una instancia de integración, puedes usarla en las guías. Para obtener más información sobre cómo configurar y admitir varias instancias, consulta Cómo admitir varias instancias.

Acciones

Para obtener más información sobre las acciones, consulta Responde a las acciones pendientes desde tu escritorio y Ejecuta una acción manual en tu caso.

Agregar usuario al grupo

Usa la acción Agregar usuario al grupo para agregar usuarios del caso a uno o más grupos de Active Directory, como agregar una cuenta a un grupo de acceso restringido durante una investigación. La acción identifica automáticamente a los usuarios objetivo del caso y los agrega a los grupos especificados.

Esta acción se ejecuta en la entidad User de Google SecOps.

Entradas de acción

La acción Add User To Group requiere los siguientes parámetros:

Parámetro	Descripción
Group Name	Obligatorio. Es una lista separada por comas de los grupos a los que se agregarán los usuarios.

Resultados de la acción

La acción Agregar usuario al grupo proporciona los siguientes resultados:

Tipo de resultado de la acción	Disponibilidad
Archivo adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	No disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	No disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Mensajes de salida

La acción Agregar usuario al grupo puede devolver los siguientes mensajes de salida:

Mensaje de salida	Descripción del mensaje
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	La acción se realizó correctamente.
Action wasn't able to add the following users to the group "GROUP_NAME" in Active Directory: ENTITY_ID	No se pudo realizar la acción para los usuarios especificados. Verifica que la cuenta de servicio tenga permiso para modificar el atributo member en el grupo de destino.
The following users were not found in Active Directory: ENTITY_ID	No se pudo realizar la acción para los usuarios especificados. Verifica que las cuentas de usuario existan en Active Directory y que los identificadores de entidad coincidan con nombres de usuario o direcciones de correo electrónico válidos.
The following groups were not found in Active Directory: GROUP_NAME	No se pudo realizar la acción en los grupos especificados. Verifica la ortografía de los nombres de los grupos en el parámetro Group Name y confirma que los grupos existan en el dominio configurado.
No users were added to the group "GROUP_NAME" in Active Directory.	No se pudo realizar la acción para el grupo especificado. Verifica que los usuarios de destino existan en Active Directory y que la cuenta de servicio tenga acceso de escritura al grupo especificado.
No users were added to the provided groups in Active Directory.	No se pudo realizar la acción. Confirma que el caso contenga entidades User válidas y que los grupos especificados existan en Active Directory.
Error executing action "Add User To Group". Reason: ERROR_REASON	No se pudo realizar la acción. Verifica la conexión al servidor de Active Directory, los parámetros de entrada o las credenciales de la cuenta de servicio.

Resultado de secuencia de comandos

En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Agregar usuario al grupo:

Nombre del resultado de la secuencia de comandos	Valor
is_success	true o false

Cambia la UO del host

Usa la acción Cambiar la UO del host para mover las computadoras del caso a una unidad organizativa diferente en Active Directory, como mover una máquina vulnerada a una UO de cuarentena con políticas restringidas. La acción identifica automáticamente las computadoras de destino del caso y las mueve a la UO de destino especificada.

Esta acción se ejecuta en la entidad Hostname de Google SecOps.

Entradas de acción

La acción Cambiar la UO del host requiere los siguientes parámetros:

Parámetro	Descripción
OU Name	Obligatorio. Es el nombre de la nueva UO de host.

Resultados de la acción

La acción Cambiar la UO del host proporciona los siguientes resultados:

Tipo de resultado de la acción	Disponibilidad
Archivo adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	No disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	No disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Mensajes de salida

La acción Cambiar la UO del host puede devolver los siguientes mensajes de salida:

Mensaje de salida	Descripción del mensaje
Changed OU for the following hosts: ENTITY_ID	La acción se realizó correctamente.
Failed to change OU for the following hosts : ENTITY_ID	La acción falló para los hosts especificados. Verifica que la UO de destino exista y que la cuenta de servicio tenga permiso para mover objetos de computadora entre las UO de origen y de destino.
The following hosts were not found in Active Directory: ENTITY_ID	La acción falló para los hosts especificados. Verifica que las cuentas de computadora existan en Active Directory y coincidan con las entidades Hostname del caso.
The action didn't change OU on any hosts.	No se pudo realizar la acción. Verifica que las computadoras de destino y la UO de destino existan en Active Directory y que la cuenta de servicio tenga permisos para mover las cuentas de computadora.
Error executing action "Change Host OU". Reason: ERROR_REASON	No se pudo realizar la acción. Verifica la conexión al servidor de Active Directory, el parámetro OU Name o las credenciales de la cuenta de servicio.

Resultado de secuencia de comandos

En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Cambiar la UO del host:

Nombre del resultado de la secuencia de comandos	Valor
is_success	true o false

Cambia la UO del usuario

Usa la acción Cambiar la UO del usuario para mover a los usuarios del caso a una unidad organizativa diferente en Active Directory, como mover una cuenta a una UO restringida durante un incidente o un flujo de trabajo de baja. La acción identifica automáticamente a los usuarios objetivo del caso y los mueve a la UO de destino especificada.

Esta acción se ejecuta en la entidad User de Google SecOps.

Entradas de acción

La acción Cambiar la UO del usuario requiere los siguientes parámetros:

Parámetro	Descripción
OU Name	Obligatorio. Es el nombre de la nueva UO de usuario.

Resultados de la acción

La acción Cambiar la UO del usuario proporciona los siguientes resultados:

Tipo de resultado de la acción	Disponibilidad
Archivo adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	No disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	No disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Mensajes de salida

La acción Cambiar la UO del usuario puede devolver los siguientes mensajes de salida:

Mensaje de salida	Descripción del mensaje
Changed OU for the following users: ENTITY_ID	La acción se realizó correctamente.
Failed to change OU for the following users : ENTITY_ID	No se pudo realizar la acción para los usuarios especificados. Verifica que la UO de destino exista y que la cuenta de servicio tenga permiso para mover objetos de usuario entre las UO de origen y de destino.
The following users were not found in Active Directory: ENTITY_ID	No se pudo realizar la acción para los usuarios especificados. Verifica que las cuentas de usuario existan en Active Directory y coincidan con las entidades de User en el caso.
The action didn't change OU on any users.	No se pudo realizar la acción. Verifica que los usuarios de destino y la UO de destino existan en Active Directory y que la cuenta de servicio tenga permisos para mover las cuentas de usuario.
Error executing action "Change User OU". Reason: ERROR_REASON	No se pudo realizar la acción. Verifica la conexión al servidor de Active Directory, el parámetro OU Name o las credenciales de la cuenta de servicio.

Resultado de secuencia de comandos

En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Cambiar la UO del usuario:

Nombre del resultado de la secuencia de comandos	Valor
is_success	true o false

Inhabilitar cuenta

Usa la acción Inhabilitar cuenta para desactivar las cuentas de usuario en Active Directory. Esta acción se orienta automáticamente a los usuarios adjuntos al caso.

Esta acción se ejecuta en la entidad User de Google SecOps.

Entradas de acción

Ninguno

Resultados de la acción

La acción Inhabilitar cuenta proporciona los siguientes resultados:

Tipo de resultado de la acción	Disponibilidad
Archivo adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	No disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	No disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Mensajes de salida

La acción Inhabilitar cuenta puede devolver los siguientes mensajes de salida:

Mensaje de salida	Descripción del mensaje
Disabled account for the following users: ENTITY_ID	La acción se realizó correctamente.
Failed to disable account for the following users: ENTITY_ID	No se pudo realizar la acción para los usuarios especificados. Verifica que la cuenta de servicio tenga permisos de lectura y escritura para el atributo userAccountControl en las cuentas de usuario de destino y que los usuarios no sean cuentas de administrador protegidas.
The following users were not found in Active Directory: ENTITY_ID	No se pudo realizar la acción para los usuarios especificados. Verifica que las cuentas de usuario existan en Active Directory y coincidan con las entidades de User en el caso.
No users were disabled in Active Directory.	No se pudo realizar la acción. Confirma que el caso contenga entidades User válidas y que la cuenta de servicio tenga permiso para inhabilitar las cuentas de destino.
Error executing action "Disable Account". Reason: ERROR_REASON	No se pudo realizar la acción. Verifica la conexión al servidor de Active Directory o las credenciales de la cuenta de servicio.

Resultado de secuencia de comandos

En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Inhabilitar cuenta:

Nombre del resultado de la secuencia de comandos	Valor
is_success	true o false

Inhabilitar computadora

Usa la acción Inhabilitar computadora para desactivar las cuentas de computadora en Active Directory y evitar que las máquinas comprometidas o no autorizadas se autentiquen en el dominio. La acción se orienta automáticamente a los nombres de host adjuntos al caso.

Esta acción se ejecuta en la entidad Hostname de Google SecOps.

Entradas de acción

Ninguno

Resultados de la acción

La acción Inhabilitar computadora proporciona los siguientes resultados:

Tipo de resultado de la acción	Disponibilidad
Archivo adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	No disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	No disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Mensajes de salida

La acción Inhabilitar computadora puede devolver los siguientes mensajes de salida:

Mensaje de salida	Descripción del mensaje
Successfully disabled the following computers in Active Directory: ENTITY_ID The following computers were already disabled in Active Directory: ENTITY_ID	La acción se realizó correctamente.
Action wasn't able to disable the following computers in Active Directory: ENTITY_ID	La acción falló en las computadoras especificadas. Verifica que la cuenta de servicio tenga permisos de lectura y escritura para el atributo userAccountControl en los objetos de la computadora de destino.
The following computers were not found in Active Directory: ENTITY_ID	La acción falló en las computadoras especificadas. Verifica que las cuentas de computadora existan en Active Directory y coincidan con las entidades Hostname del caso.
No computers were disabled in Active Directory.	No se pudo realizar la acción. Confirma que el caso contenga entidades Hostname válidas y que la cuenta de servicio tenga permiso para inhabilitar las cuentas de las computadoras de destino.
Error executing action "Disable Computer". Reason: ERROR_REASON	No se pudo realizar la acción. Verifica la conexión al servidor de Active Directory o las credenciales de la cuenta de servicio.

Resultado de secuencia de comandos

En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Inhabilitar computadora:

Nombre del resultado de la secuencia de comandos	Valor
is_success	true o false

Habilitar cuenta

Usa la acción Habilitar cuenta para volver a habilitar las cuentas de usuario inhabilitadas en Active Directory. La acción se orienta automáticamente a los usuarios adjuntos al caso.

Esta acción se ejecuta en la entidad User de Google SecOps.

Entradas de acción

Ninguno

Resultados de la acción

La acción Habilitar cuenta proporciona los siguientes resultados:

Tipo de resultado de la acción	Disponibilidad
Archivo adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	No disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	No disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Mensajes de salida

La acción Habilitar cuenta puede devolver los siguientes mensajes de salida:

Mensaje de salida	Descripción del mensaje
Successfully enabled the following users in Active Directory: ENTITY_ID The following users were already enabled in Active Directory: ENTITY_ID	La acción se realizó correctamente.
Action wasn't able to enable the following users in Active Directory: ENTITY_ID	No se pudo realizar la acción para los usuarios especificados. Verifica que la cuenta de servicio tenga permisos de lectura y escritura para el atributo userAccountControl en las cuentas de usuario de destino.
The following users were not found in Active Directory: ENTITY_ID	No se pudo realizar la acción para los usuarios especificados. Verifica que las cuentas de usuario existan en Active Directory y coincidan con las entidades de User en el caso.
No users were enabled in Active Directory.	No se pudo realizar la acción. Confirma que el caso contenga entidades de User válidas y que la cuenta de servicio tenga permiso para habilitar las cuentas de destino.
Error executing action "Enable Account". Reason: ERROR_REASON	No se pudo realizar la acción. Verifica la conexión al servidor de Active Directory o las credenciales de la cuenta de servicio.

Resultado de secuencia de comandos

En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Habilitar cuenta:

Nombre del resultado de la secuencia de comandos	Valor
is_success	true o false

Habilitar computadora

Usa la acción Habilitar computadora para volver a habilitar las cuentas de computadora inhabilitadas en Active Directory, de modo que las máquinas puedan volver a autenticarse en el dominio. La acción se orienta automáticamente a los nombres de host adjuntos al caso.

Esta acción se ejecuta en la entidad Hostname de Google SecOps.

Entradas de acción

Ninguno

Resultados de la acción

La acción Habilitar computadora proporciona los siguientes resultados:

Tipo de resultado de la acción	Disponibilidad
Archivo adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	No disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	No disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Mensajes de salida

La acción Habilitar computadora puede devolver los siguientes mensajes de salida:

Mensaje de salida	Descripción del mensaje
Successfully enabled the following computers in Active Directory: ENTITY_ID The following computers were already enabled in Active Directory: ENTITY_ID	La acción se realizó correctamente.
Action wasn't able to enable the following computers in Active Directory: ENTITY_ID	La acción falló en las computadoras especificadas. Verifica que la cuenta de servicio tenga permisos de lectura y escritura para el atributo userAccountControl en los objetos de la computadora de destino.
The following computers were not found in Active Directory: ENTITY_ID	La acción falló en las computadoras especificadas. Verifica que las cuentas de computadora existan en Active Directory y coincidan con las entidades Hostname del caso.
No computers were enabled in Active Directory.	No se pudo realizar la acción. Confirma que el caso contenga entidades Hostname válidas y que la cuenta de servicio tenga permiso para habilitar las cuentas de computadora de destino.
Error executing action "Enable Computer". Reason: ERROR_REASON	No se pudo realizar la acción. Verifica la conexión al servidor de Active Directory o las credenciales de la cuenta de servicio.

Resultado de secuencia de comandos

En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Habilitar computadora:

Nombre del resultado de la secuencia de comandos	Valor
is_success	true o false

Enriquece entidades

Usa la acción Enriquecer entidades para recuperar los detalles del perfil de Active Directory, el estado de la cuenta y las membresías de grupos de los usuarios y las computadoras del caso. Puedes enriquecer las entidades con toda la información disponible del directorio o limitar los resultados y la tabla de casos a atributos específicos.

Esta acción es asíncrona. Si es necesario, ajusta el valor de tiempo de espera de la secuencia de comandos en el IDE de Google SecOps para la acción.

La acción Enrich Entities se ejecuta en las siguientes entidades de Google SecOps:

• User
• Hostname

Entradas de acción

La acción Enrich Entities requiere los siguientes parámetros:

Parámetro	Descripción
Mark Entities as Internal	Es opcional. Si se selecciona, la acción marca automáticamente las entidades enriquecidas correctamente como entidades internas. Habilitada de forma predeterminada.
Create Case Wall Table	Es opcional. Si se selecciona, la acción genera una tabla de muro de casos que contiene los atributos de Active Directory recuperados para cada entidad enriquecida. Habilitada de forma predeterminada.
Specific Attribute Names To Enrich With	Es opcional. Es una lista separada por comas de los nombres de atributos con los que se enriquecerán las entidades. Si no proporcionas ningún valor, la acción enriquece las entidades con todos los atributos disponibles. Si un atributo contiene varios valores, la acción enriquece el atributo con todos los valores disponibles. Este parámetro distingue mayúsculas de minúsculas.
Should Case Wall Table be filtered by the specified Attributes?	Es opcional. Si se selecciona, la acción propaga la tabla del muro de casos solo con los atributos especificados en Specific Attribute Names To Enrich With.
Should JSON result be filtered by the specified Attributes?	Es opcional. Si se selecciona, el resultado JSON solo devuelve los atributos especificados en Specific Attribute Names To Enrich With.

Resultados de la acción

La acción Enrich Entities proporciona los siguientes resultados:

Tipo de resultado de la acción	Disponibilidad
Archivo adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	Disponible
Tabla de enriquecimiento de entidades	Disponible
Resultado de JSON	Disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Tabla del muro de casos

La acción Enrich Entities proporciona la siguiente tabla en el Muro de casos cuando se selecciona Create Case Wall Table:

• Nombre de la tabla: Report for: <var class="readonly">ENTITY_ID</var>
• Columnas: Son los nombres y valores de los atributos de Active Directory recuperados para la entidad (o filtrados por el parámetro Specific Attribute Names To Enrich With si se selecciona Should Case Wall Table be filtered by the specified Attributes?).

Enriquecimiento de entidades

La acción Enrich Entities admite el siguiente enriquecimiento de entidades:

Nombre del campo de enriquecimiento	Lógica
AD_primaryGroupID	La acción devuelve el valor si existe en el resultado JSON.
AD_logonCount	La acción devuelve el valor si existe en el resultado JSON.
AD_cn	La acción devuelve el valor si existe en el resultado JSON.
AD_countryCode	La acción devuelve el valor si existe en el resultado JSON.
AD_objectClass	La acción devuelve el valor si existe en el resultado JSON.
AD_userPrincipalName	La acción devuelve el valor si existe en el resultado JSON.
AD_adminCount	La acción devuelve el valor si existe en el resultado JSON.
AD_lastLogonTimestamp	La acción devuelve el valor si existe en el resultado JSON.
AD_manager	La acción devuelve el valor si existe en el resultado JSON.
AD_instanceType	La acción devuelve el valor si existe en el resultado JSON.
AD_distinguishedName	La acción devuelve el valor si existe en el resultado JSON.
AD_dSCorePropagationData	La acción devuelve el valor si existe en el resultado JSON.
AD_msDS-SupportedEncryptionTypes	La acción devuelve el valor si existe en el resultado JSON.
AD_objectSid	La acción devuelve el valor si existe en el resultado JSON.
AD_whenCreated	La acción devuelve el valor si existe en el resultado JSON.
AD_uSNCreated	La acción devuelve el valor si existe en el resultado JSON.
AD_lockoutTime	La acción devuelve el valor si existe en el resultado JSON.
AD_badPasswordTime	La acción devuelve el valor si existe en el resultado JSON.
AD_pwdLastSet	La acción devuelve el valor si existe en el resultado JSON.
AD_sAMAccountName	La acción devuelve el valor si existe en el resultado JSON.
AD_objectCategory	La acción devuelve el valor si existe en el resultado JSON.
AD_lastLogon	La acción devuelve el valor si existe en el resultado JSON.
AD_objectGUID	La acción devuelve el valor si existe en el resultado JSON.
AD_whenChanged	La acción devuelve el valor si existe en el resultado JSON.
AD_badPwdCount	La acción devuelve el valor si existe en el resultado JSON.
AD_accountExpires	La acción devuelve el valor si existe en el resultado JSON.
AD_displayName	La acción devuelve el valor si existe en el resultado JSON.
AD_name	La acción devuelve el valor si existe en el resultado JSON.
AD_memberOf	La acción devuelve el valor si existe en el resultado JSON.
AD_codePage	La acción devuelve el valor si existe en el resultado JSON.
AD_userAccountControl	La acción devuelve el valor si existe en el resultado JSON.
AD_sAMAccountType	La acción devuelve el valor si existe en el resultado JSON.
AD_uSNChanged	La acción devuelve el valor si existe en el resultado JSON.
AD_sn	La acción devuelve el valor si existe en el resultado JSON.
AD_givenName	La acción devuelve el valor si existe en el resultado JSON.
AD_lastLogoff	La acción devuelve el valor si existe en el resultado JSON.

Resultado de JSON

En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción Enrich Entities:

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

Mensajes de salida

La acción Enrich Entities puede devolver los siguientes mensajes de salida:

Mensaje de salida	Descripción del mensaje
Active Directory Permalink: SERVER Enriched the following Users ENTITY_ID Enriched the following Hosts ENTITY_ID All entities were enriched.	La acción se realizó correctamente.
The following entities were not found in Active Directory: ENTITY_ID	No se pudo realizar la acción en las entidades especificadas. Verifica que las cuentas de usuario o host existan en Active Directory y coincidan con los identificadores de entidad en el caso.
Failed to enrich the following Users ENTITY_ID	No se pudo realizar la acción para los usuarios especificados. Verifica que la cuenta de servicio tenga permiso para leer atributos (incluido userAccountControl) en las cuentas de usuario de destino y comprueba que existan atributos personalizados en Active Directory.
Failed to enrich the following Hosts ENTITY_ID	La acción falló para los hosts especificados. Verifica que la cuenta de servicio tenga permiso para leer atributos (incluido userAccountControl) en las cuentas de computadora de destino y comprueba que existan atributos personalizados en Active Directory.
No entities were enriched.	No se pudo realizar la acción. Confirma que el caso contenga entidades User o Hostname válidas que existan en Active Directory.
Error executing action "Enrich Entities". Reason: ERROR_REASON	No se pudo realizar la acción. Verifica la conexión con el servidor de Active Directory, los campos de consulta personalizados o las credenciales de la cuenta de servicio.

Resultado de secuencia de comandos

En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Enrich Entities:

Nombre del resultado de la secuencia de comandos	Valor
is_success	true o false

Forzar la actualización de la contraseña

Usa la acción Forzar actualización de contraseña para exigir que los usuarios cambien su contraseña la próxima vez que accedan. La acción se orienta automáticamente a los usuarios adjuntos al caso.

Esta acción se ejecuta en la entidad User de Google SecOps.

Entradas de acción

Ninguno

Resultados de la acción

La acción Forzar actualización de contraseña proporciona los siguientes resultados:

Tipo de resultado de la acción	Disponibilidad
Archivo adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	No disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	No disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Mensajes de salida

La acción Forzar actualización de contraseña puede devolver los siguientes mensajes de salida:

Mensaje de salida	Descripción del mensaje
Forced password update on next logon for the following users: ENTITY_ID	La acción se realizó correctamente.
Failed to force password update on next logon for the following users: ENTITY_ID	No se pudo realizar la acción para los usuarios especificados. Verifica que la cuenta de servicio tenga permisos de lectura y escritura para el atributo pwdLastSet en las cuentas de usuario de destino.
The following users were not found in Active Directory: ENTITY_ID	No se pudo realizar la acción para los usuarios especificados. Verifica que las cuentas de usuario existan en Active Directory y coincidan con las entidades de User en el caso.
Password update wasn't forced on any users.	No se pudo realizar la acción. Confirma que el caso contenga entidades User válidas y que la cuenta de servicio tenga permiso para actualizar la configuración de vencimiento de la contraseña.
Error executing action "Force Password Update". Reason: ERROR_REASON	No se pudo realizar la acción. Verifica la conexión al servidor de Active Directory o las credenciales de la cuenta de servicio.

Resultado de secuencia de comandos

En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Forzar actualización de contraseña:

Nombre del resultado de la secuencia de comandos	Valor
is_success	true o false

Obtener miembros del grupo

Usa la acción Obtener miembros del grupo para enumerar los usuarios, las computadoras o ambos que pertenecen a un grupo específico de Active Directory. De manera opcional, puedes limitar la búsqueda a una unidad organizativa o un grupo superior específicos, y, además, incluir miembros de subgrupos anidados.

Esta acción no se ejecuta en las entidades de Google SecOps.

Entradas de acción

La acción Obtener miembros del grupo requiere los siguientes parámetros:

Parámetro	Descripción
Group Name	Obligatorio. Es el nombre del grupo que contiene los miembros indicados.
Members Type	Obligatorio. Es el tipo de miembro que se recuperará del grupo. Los valores posibles son los siguientes: Only Users Only Hosts Both El valor predeterminado es Only Users.
Where To Search	Obligatorio. Un Organizational Unit o Group específico para definir el alcance de la búsqueda Los valores posibles son los siguientes: Select Option Organizational Unit Group El valor predeterminado es Select Option.
Filter Object Value	Es opcional. Es el nombre de Organizational Unit o Group en el que la acción busca el grupo de destino. Este parámetro es obligatorio si Where To Search se establece en Organizational Unit o Group.
Perform Nested Search	Es opcional. Si se selecciona, la acción recupera los miembros de los subgrupos anidados que pertenecen al grupo de destino.
Limit	Es opcional. Es la cantidad máxima de fichas que se recuperarán de Active Directory. El valor predeterminado es 100.

Resultados de la acción

La acción Get Group Members proporciona los siguientes resultados:

Tipo de resultado de la acción	Disponibilidad
Archivo adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	Disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	Disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Tabla del muro de casos

La acción Obtener miembros del grupo proporciona la siguiente tabla en el Muro del caso:

• Nombre de la tabla: Members of Active Directory group: <var class="readonly">GROUP_NAME</var>
• Columnas:
  • Distinguished Name
  • SAM Account Name
  • User Principal Name
  • Type

Resultado de JSON

En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción Obtener miembros del 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"
  }
]

Mensajes de salida

La acción Obtener miembros del grupo puede devolver los siguientes mensajes de salida:

Mensaje de salida	Descripción del mensaje
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.	La acción se realizó correctamente.
Error executing action "Get Group Members". Reason: Filter Object Value should be provided	No se pudo realizar la acción. Proporciona un nombre de grupo o de UO válido en el parámetro Filter Object Value cuando Where To Search se establezca en Organizational Unit o Group.
Error executing action "Get Group Members". Reason: Given value for Limit should be a positive number.	No se pudo realizar la acción. Ingresa un número entero mayor que 0 en el parámetro Limit.
Error executing action "Get Group Members". Reason: Given group doesn't exist in Active Directory.	No se pudo realizar la acción. Verifica el nombre del grupo en el parámetro Group Name y confirma que el grupo exista dentro del permiso de búsqueda configurado.
Error executing action "Get Group Members". Reason: Specified Organizational Unit doesn't exist in Active Directory.	No se pudo realizar la acción. Verifica que la unidad organizativa especificada en Filter Object Value exista en Active Directory.
Error executing action "Get Group Members". Reason: Specified Group in "Filter Object Value" doesn't exist in Active Directory.	No se pudo realizar la acción. Verifica que el grupo superior especificado en Filter Object Value exista en Active Directory.
Error executing action "Get Group Members". Reason: ERROR_REASON	No se pudo realizar la acción. Verifica la conexión al servidor de Active Directory, los parámetros de entrada o las credenciales de la cuenta de servicio.

Resultado de secuencia de comandos

En la siguiente tabla, se indica el valor del resultado de la secuencia de comandos cuando se usa la acción Obtener miembros del grupo:

Nombre del resultado de la secuencia de comandos	Valor
is_success	true o false

Obtén los datos de contacto del administrador

Usa la acción Obtener detalles de contacto del administrador para buscar al administrador de un usuario en Active Directory y recuperar su información de contacto. La acción se orienta automáticamente a los usuarios adjuntos al caso.

Esta acción se ejecuta en la entidad User de Google SecOps.

Entradas de acción

Ninguno

Resultados de la acción

La acción Obtener detalles de contacto del administrador proporciona los siguientes resultados:

Tipo de resultado de la acción	Disponibilidad
Archivo adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	Disponible
Tabla de enriquecimiento de entidades	Disponible
Resultado de JSON	Disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Tabla del muro de casos

La acción Obtener detalles de contacto del administrador proporciona la siguiente tabla en el Muro de casos:

• Nombre de la tabla: Manager Contact: <var class="readonly">ENTITY_ID</var>
• Columnas:
  • Manager Name
  • Manager Phone

Enriquecimiento de entidades

La acción Obtener detalles de contacto del administrador admite el siguiente enriquecimiento de entidades:

Nombre del campo de enriquecimiento	Lógica
AD_Manager_Name	La acción devuelve el valor si existe en el resultado JSON.
AD_Manager_phone	La acción devuelve el valor si existe en el resultado JSON.
AD_primaryGroupID	La acción devuelve el valor si existe en el resultado JSON.
AD_logonCount	La acción devuelve el valor si existe en el resultado JSON.
AD_cn	La acción devuelve el valor si existe en el resultado JSON.
AD_countryCode	La acción devuelve el valor si existe en el resultado JSON.
AD_objectClass	La acción devuelve el valor si existe en el resultado JSON.
AD_userPrincipalName	La acción devuelve el valor si existe en el resultado JSON.
AD_adminCount	La acción devuelve el valor si existe en el resultado JSON.
AD_lastLogonTimestamp	La acción devuelve el valor si existe en el resultado JSON.
AD_manager	La acción devuelve el valor si existe en el resultado JSON.
AD_instanceType	La acción devuelve el valor si existe en el resultado JSON.
AD_distinguishedName	La acción devuelve el valor si existe en el resultado JSON.
AD_dSCorePropagationData	La acción devuelve el valor si existe en el resultado JSON.
AD_msDS-SupportedEncryptionTypes	La acción devuelve el valor si existe en el resultado JSON.
AD_objectSid	La acción devuelve el valor si existe en el resultado JSON.
AD_whenCreated	La acción devuelve el valor si existe en el resultado JSON.
AD_uSNCreated	La acción devuelve el valor si existe en el resultado JSON.
AD_lockoutTime	La acción devuelve el valor si existe en el resultado JSON.
AD_badPasswordTime	La acción devuelve el valor si existe en el resultado JSON.
AD_pwdLastSet	La acción devuelve el valor si existe en el resultado JSON.
AD_sAMAccountName	La acción devuelve el valor si existe en el resultado JSON.
AD_objectCategory	La acción devuelve el valor si existe en el resultado JSON.
AD_lastLogon	La acción devuelve el valor si existe en el resultado JSON.
AD_objectGUID	La acción devuelve el valor si existe en el resultado JSON.
AD_whenChanged	La acción devuelve el valor si existe en el resultado JSON.
AD_badPwdCount	La acción devuelve el valor si existe en el resultado JSON.
AD_accountExpires	La acción devuelve el valor si existe en el resultado JSON.
AD_displayName	La acción devuelve el valor si existe en el resultado JSON.
AD_name	La acción devuelve el valor si existe en el resultado JSON.
AD_memberOf	La acción devuelve el valor si existe en el resultado JSON.
AD_codePage	La acción devuelve el valor si existe en el resultado JSON.
AD_userAccountControl	La acción devuelve el valor si existe en el resultado JSON.
AD_sAMAccountType	La acción devuelve el valor si existe en el resultado JSON.
AD_uSNChanged	La acción devuelve el valor si existe en el resultado JSON.
AD_sn	La acción devuelve el valor si existe en el resultado JSON.
AD_givenName	La acción devuelve el valor si existe en el resultado JSON.
AD_lastLogoff	La acción devuelve el valor si existe en el resultado JSON.

Resultado de JSON

En el siguiente ejemplo, se muestra el resultado en formato JSON que se recibe cuando se usa la acción Obtener detalles de contacto del administrador:

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

Mensajes de salida

La acción Obtener detalles de contacto del administrador puede devolver los siguientes mensajes de salida:

Mensaje de salida	Descripción del mensaje
Retrieved manager details for the following users: ENTITY_ID	La acción se realizó correctamente.
The following users don't have managers specified in Active Directory: ENTITY_ID	No se pudo realizar la acción para los usuarios especificados. Verifica que el atributo manager esté propagado en las cuentas de usuario de destino en Active Directory.
Failed to retrieve manager details for the following users: ENTITY_ID	No se pudo realizar la acción para los usuarios especificados. Verifica que la cuenta de servicio tenga permiso para leer el atributo manager y el perfil de usuario del administrador en Active Directory.
The following users were not found in Active Directory: ENTITY_ID	No se pudo realizar la acción para los usuarios especificados. Verifica que las cuentas de usuario existan en Active Directory y coincidan con las entidades de User en el caso.
No manager details were retrieved for the provided users.	No se pudo realizar la acción. Confirma que el caso contenga entidades User válidas que tengan un administrador asignado en Active Directory.
Error executing action "Get Manager Contact Details". Reason: ERROR_REASON	No se pudo realizar la acción. Verifica la conexión al servidor de Active Directory o las credenciales de la cuenta de servicio.

Resultado de secuencia de comandos

En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Obtener detalles de contacto del administrador:

Nombre del resultado de la secuencia de comandos	Valor
is_success	true o false

Is User In Group

Usa la acción Is User In Group para verificar si los usuarios específicos pertenecen a un grupo de Active Directory determinado. De forma predeterminada, la acción verifica las entidades User en el caso, o puedes ingresar una lista de nombres de usuario separada por comas en el parámetro User Name para verificar cuentas específicas directamente.

Esta acción se ejecuta en la entidad User de Google SecOps.

Entradas de acción

La acción Is User In Group requiere los siguientes parámetros:

Parámetro	Descripción
Group Name	Obligatorio. Es el nombre del grupo que se verificará, como administrators.
User Name	Es opcional. Es una lista separada por comas de los nombres de usuario que se deben verificar. Si no proporcionas un valor, la acción verifica las entidades User en el caso.
Where To Search	Obligatorio. Un Organizational Unit o Group específico para definir el alcance de la búsqueda. Los valores posibles son los siguientes: Select Option Organizational Unit Group El valor predeterminado es Select Option.
Filter Object Value	Es opcional. Es el nombre del Organizational Unit o Group en el que la acción busca el grupo de destino. Este parámetro es obligatorio si Where To Search se establece en Organizational Unit o Group.
Search In Subgroups	Es opcional. Si se selecciona, la acción busca de forma recurrente dentro de los subgrupos anidados.

Resultados de la acción

La acción Is User In Group proporciona los siguientes resultados:

Tipo de resultado de la acción	Disponibilidad
Archivo adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	No disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	Disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Resultado de JSON

En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción Is User In Group:

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

Mensajes de salida

La acción Is User In Group puede devolver los siguientes mensajes de salida:

Mensaje de salida	Descripción del mensaje
USER_NAME IN GROUP_NAME; USER_NAME NOT in GROUP_NAME;	La acción se realizó correctamente.
The following users were not found in Active Directory: USER_NAME	No se pudo realizar la acción para los usuarios especificados. Verifica que los nombres de usuario o las entidades User existan en Active Directory.
None of the provided users were found in Active Directory.	No se pudo realizar la acción. Confirma que el caso contenga entidades User válidas o que los nombres de usuario especificados en el parámetro User Name existan en Active Directory.
Error executing action "Is User In Group". Reason: Filter Object Value should be provided	No se pudo realizar la acción. Proporciona un nombre de grupo o de UO válido en el parámetro Filter Object Value cuando Where To Search se establezca en Organizational Unit o Group.
Error executing action "Is User In Group". Reason: Given group doesn't exist in Active Directory.	No se pudo realizar la acción. Verifica el nombre del grupo en el parámetro Group Name y confirma que el grupo exista dentro del permiso de búsqueda configurado.
Error executing action "Is User In Group". Reason: Specified Organizational Unit doesn't exist in Active Directory.	No se pudo realizar la acción. Verifica que la unidad organizativa especificada en Filter Object Value exista en Active Directory.
Error executing action "Is User In Group". Reason: Specified Group in "Filter Object Value" doesn't exist in Active Directory.	No se pudo realizar la acción. Verifica que el grupo superior especificado en Filter Object Value exista en Active Directory.
Error executing action "Is User In Group". Reason: ERROR_REASON	No se pudo realizar la acción. Verifica la conexión al servidor de Active Directory, los parámetros de entrada o las credenciales de la cuenta de servicio.

Resultado de secuencia de comandos

En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Is User In Group:

Nombre del resultado de la secuencia de comandos	Valor
is_success	true o false

Enumera los grupos de usuarios

Usa la acción List User Groups para recuperar una lista de todos los grupos de Active Directory a los que pertenece un usuario. La acción se orienta automáticamente a los usuarios adjuntos al caso.

Esta acción se ejecuta en la entidad User de Google SecOps.

Entradas de acción

Ninguno

Resultados de la acción

La acción List User Groups proporciona los siguientes resultados:

Tipo de resultado de la acción	Disponibilidad
Archivo adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	No disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	Disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Resultado de JSON

En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción List User Groups:

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

Mensajes de salida

La acción List User Groups puede devolver los siguientes mensajes de salida:

Mensaje de salida	Descripción del mensaje
Groups were listed for the following users: ENTITY_ID	La acción se realizó correctamente.
No groups were found for the following users: ENTITY_ID	No se pudo realizar la acción para los usuarios especificados. Verifica que las cuentas de usuario estén asignadas a, al menos, un grupo explícito en el atributo memberOf en Active Directory.
Failed to list groups for the following users: ENTITY_ID	No se pudo realizar la acción para los usuarios especificados. Verifica que la cuenta de servicio tenga permiso para leer el atributo memberOf en las cuentas de usuario de destino.
The following users were not found in Active Directory: ENTITY_ID	No se pudo realizar la acción para los usuarios especificados. Verifica que las cuentas de usuario existan en Active Directory y coincidan con las entidades de User en el caso.
No groups were listed.	No se pudo realizar la acción. Confirma que el caso contenga entidades User válidas que pertenezcan a grupos en Active Directory.
Error executing action "List User Groups". Reason: ERROR_REASON	No se pudo realizar la acción. Verifica la conexión al servidor de Active Directory o las credenciales de la cuenta de servicio.

Resultado de secuencia de comandos

En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción List User Groups:

Nombre del resultado de la secuencia de comandos	Valor
is_success	true o false

Ping

Usa la acción Ping para verificar que Google SecOps pueda conectarse y autenticarse en tu servidor de Active Directory con los parámetros de configuración de integración establecidos.

Esta acción no se ejecuta en las entidades de Google SecOps.

Entradas de acción

Ninguno

Resultados de la acción

La acción Ping proporciona los siguientes resultados:

Tipo de resultado de la acción	Disponibilidad
Archivo adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	No disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	No disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Mensajes de salida

La acción Ping puede devolver los siguientes mensajes de resultado:

Mensaje de salida	Descripción del mensaje
Connected successfully.	La acción se realizó correctamente.
Error executing action "Ping". Reason: ERROR_REASON	No se pudo realizar la acción. Verifica la dirección del servidor, el puerto, la configuración de SSL o las credenciales de la cuenta de servicio en la configuración de la integración.

Resultado de secuencia de comandos

En la siguiente tabla, se indica el valor del resultado de la secuencia de comandos cuando se usa la acción Ping:

Nombre del resultado de la secuencia de comandos	Valor
is_success	true o false

Cómo desbloquear una cuenta

Usa la acción Liberar cuenta bloqueada para desbloquear las cuentas de usuario de Active Directory que se bloquearon después de demasiados intentos de acceso fallidos. La acción se orienta automáticamente a los usuarios adjuntos al caso.

Esta acción se ejecuta en la entidad User de Google SecOps.

Entradas de acción

Ninguno

Resultados de la acción

La acción Liberar cuenta bloqueada proporciona los siguientes resultados:

Tipo de resultado de la acción	Disponibilidad
Archivo adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	No disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	No disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Mensajes de salida

La acción Liberar cuenta bloqueada puede devolver los siguientes mensajes de salida:

Mensaje de salida	Descripción del mensaje
Unlocked account for the following users: ENTITY_ID	La acción se realizó correctamente.
Failed to unlock account for the following users: ENTITY_ID	No se pudo realizar la acción para los usuarios especificados. Verifica que la cuenta de servicio tenga permisos de lectura y escritura para el atributo lockoutTime en las cuentas de usuario de destino.
The following users were not found in Active Directory: ENTITY_ID	No se pudo realizar la acción para los usuarios especificados. Verifica que las cuentas de usuario existan en Active Directory y coincidan con las entidades de User en el caso.
No accounts were unlocked.	No se pudo realizar la acción. Confirma que el caso contenga entidades User válidas y que la cuenta de servicio tenga permiso para desbloquear las cuentas de destino.
Error executing action "Release Locked Account". Reason: ERROR_REASON	No se pudo realizar la acción. Verifica la conexión al servidor de Active Directory o las credenciales de la cuenta de servicio.

Resultado de secuencia de comandos

En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Liberar cuenta bloqueada:

Nombre del resultado de la secuencia de comandos	Valor
is_success	true o false

Quitar usuario del grupo

Usa la acción Quitar usuario del grupo para quitar usuarios del caso de uno o más grupos de Active Directory, como revocar el acceso elevado al grupo durante un incidente. La acción identifica automáticamente a los usuarios objetivo del caso y los quita de los grupos especificados.

Esta acción se ejecuta en la entidad User de Google SecOps.

Entradas de acción

La acción Quitar usuario del grupo requiere los siguientes parámetros:

Parámetro	Descripción
Group Name	Obligatorio. Es una lista separada por comas de los grupos de los que se quitarán los usuarios.

Resultados de la acción

La acción Quitar usuario del grupo proporciona los siguientes resultados:

Tipo de resultado de la acción	Disponibilidad
Archivo adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	No disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	No disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Mensajes de salida

La acción Quitar usuario del grupo puede devolver los siguientes mensajes de salida:

Mensaje de salida	Descripción del mensaje
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	La acción se realizó correctamente.
Action wasn't able to remove the following users from the group "GROUP_NAME" in Active Directory: ENTITY_ID	No se pudo realizar la acción para los usuarios especificados. Verifica que la cuenta de servicio tenga permiso para modificar el atributo member en el grupo de destino.
The following users were not found in Active Directory: ENTITY_ID	No se pudo realizar la acción para los usuarios especificados. Verifica que las cuentas de usuario existan en Active Directory y coincidan con las entidades de User en el caso.
The following groups were not found in Active Directory: GROUP_NAME	No se pudo realizar la acción en los grupos especificados. Verifica la ortografía de los nombres de los grupos en el parámetro Group Name y confirma que los grupos existan en el dominio configurado.
No users were removed from the group "GROUP_NAME" in Active Directory.	No se pudo realizar la acción para el grupo especificado. Verifica que los usuarios de destino existan en Active Directory y que la cuenta de servicio tenga acceso de escritura al grupo especificado.
No users were removed from the provided groups in Active Directory.	No se pudo realizar la acción. Confirma que el caso contenga entidades User válidas y que los grupos especificados existan en Active Directory.
Error executing action "Remove User From Group". Reason: ERROR_REASON	No se pudo realizar la acción. Verifica la conexión al servidor de Active Directory, los parámetros de entrada o las credenciales de la cuenta de servicio.

Resultado de secuencia de comandos

En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Quitar usuario del grupo:

Nombre del resultado de la secuencia de comandos	Valor
is_success	true o false

Buscar en Active Directory

Usa la acción Buscar en Active Directory para buscar usuarios, computadoras, grupos o unidades organizativas en tu directorio con condiciones de búsqueda integradas o una consulta personalizada. También puedes filtrar la búsqueda por unidades organizativas específicas y elegir qué campos del directorio incluir en los resultados.

Esta acción no se ejecuta en las entidades de Google SecOps.

Entradas de acción

La acción Buscar en Active Directory requiere los siguientes parámetros:

Parámetro	Descripción
Search Condition	Obligatorio. Es la condición que se aplicará a la búsqueda. Los valores posibles son los siguientes: Contains Exact Match Starts With Custom LDAP Query El valor predeterminado es Contains.
Include Domain	Es opcional. Si se selecciona, la acción incluye el componente de dominio cuando se realiza una búsqueda con las condiciones Contains, Exact Match o Starts With.
Search Object	Obligatorio. Es un tipo de objeto que se busca cuando no se usa Custom LDAP Query. Los valores posibles son los siguientes: Select Option User Host Group Organizational Unit El valor predeterminado es Select Option.
Filter Object Value	Obligatorio. Es un valor de objeto por el que se filtrará o la cadena de consulta de LDAP completa cuando Search Condition se establezca en Custom LDAP Query.
Custom Fields	Es opcional. Es una lista separada por comas de los atributos de LDAP que se mostrarán en los resultados de la búsqueda.
Specific OUs to Search	Es opcional. Es una lista separada por comas de los nombres de las unidades organizativas para restringir el alcance de la búsqueda.
Include Default Search Fields	Es opcional. Si se selecciona, la acción incluye los campos predeterminados de Active Directory en los resultados que se devuelven, además de cualquier Custom Fields especificado. Habilitada de forma predeterminada.
Max Records To Return	Es opcional. Es la cantidad máxima de registros que se recuperarán de Active Directory. El valor predeterminado es 100.
Sort Field	Es opcional. Es un nombre de atributo de LDAP que se usa para ordenar las entradas que se devuelven.

Resultados de la acción

La acción Buscar en Active Directory proporciona los siguientes resultados:

Tipo de resultado de la acción	Disponibilidad
Archivo adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	Disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	Disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Tabla del muro de casos

La acción Buscar en Active Directory proporciona la siguiente tabla en el Muro del caso:

• Nombre de la tabla: Active Directory Search Results
• Columnas: Atributos de Active Directory que se devuelven para las entradas de directorio coincidentes (según Include Default Search Fields y Custom Fields).

Resultado de JSON

En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción Buscar en 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"
        ]
      }
    ]

Mensajes de salida

La acción Buscar en Active Directory puede devolver los siguientes mensajes de salida:

Mensaje de salida	Descripción del mensaje
Successfully performed the query "QUERY_STRING" in Active Directory. No results to show following the query: "QUERY_STRING".	La acción se realizó correctamente.
Error executing action "Search Active Directory". Reason: you need to select "Search Object" or choose "Custom LDAP Query" as a "Search Condition"	No se pudo realizar la acción. Selecciona un tipo de objeto válido en el parámetro Search Object o cambia Search Condition por Custom LDAP Query.
Error executing action "Search Active Directory". Reason: Value for the parameter "Max Records To Return" should be a positive number.	No se pudo realizar la acción. Ingresa un número entero mayor que 0 en el parámetro Max Records To Return.
Error executing action "Search Active Directory". Reason: The following OUs were not found in Active Directory: OU_NAMES	No se pudo realizar la acción. Verifica la ortografía de las unidades organizativas en el parámetro Specific OUs to Search y confirma que existan en Active Directory.
Error executing action "Search Active Directory". Reason: Knowingly invalid query was executed: "QUERY_STRING". Please verify the inputs and try again.	No se pudo realizar la acción. Verifica la sintaxis de tu consulta personalizada o el valor del filtro en el parámetro Filter Object Value y comprueba que los nombres de Custom Fields o Sort Field especificados sean atributos LDAP válidos.
Error executing action "Search Active Directory". Reason: ERROR_REASON	No se pudo realizar la acción. Verifica la conexión al servidor de Active Directory, los parámetros de entrada o las credenciales de la cuenta de servicio.

Resultado de secuencia de comandos

En la siguiente tabla, se indica el valor del resultado de la secuencia de comandos cuando se usa la acción Buscar en Active Directory:

Nombre del resultado de la secuencia de comandos	Valor
is_success	true o false

Establece la contraseña del usuario

Usa la acción Establecer contraseña de usuario para restablecer la contraseña de los usuarios en el caso a una nueva. Asegúrate de que la integración esté conectada a través de SSL (LDAPS) y de que la contraseña nueva cumpla con las reglas de complejidad de contraseñas de tu dominio.

Esta acción se ejecuta en la entidad User de Google SecOps.

Entradas de acción

La acción Establecer contraseña de usuario requiere los siguientes parámetros:

Parámetro	Descripción
New Password	Obligatorio. Es el valor de la contraseña nueva.

Resultados de la acción

La acción Establecer contraseña de usuario proporciona los siguientes resultados:

Tipo de resultado de la acción	Disponibilidad
Archivo adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	No disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	No disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Mensajes de salida

La acción Establecer contraseña de usuario puede devolver los siguientes mensajes de salida:

Mensaje de salida	Descripción del mensaje
Reset password for the following users: ENTITY_ID	La acción se realizó correctamente.
Failed to reset password for the following users: ENTITY_ID	No se pudo realizar la acción para los usuarios especificados. Verifica que la contraseña nueva cumpla con los requisitos de complejidad y de historial de contraseñas del dominio y que los usuarios de destino no sean cuentas administrativas protegidas.
The following users were not found in Active Directory: ENTITY_ID	No se pudo realizar la acción para los usuarios especificados. Verifica que las cuentas de usuario existan en Active Directory y coincidan con las entidades de User en el caso.
No passwords were changed.	No se pudo realizar la acción. Confirma que el caso contenga entidades de User válidas y que la cuenta de servicio tenga permiso para restablecer las contraseñas de las cuentas de destino.
Failed to execute "Set User Password" action! Watch Over Extended Rights permission or SSL connection.	No se pudo realizar la acción. Asegúrate de que Use SSL esté seleccionado en la configuración de la integración (LDAPS en el puerto 636) y de que la cuenta de servicio tenga el derecho extendido Restablecer contraseña.
Error executing action "Set User Password". Reason: ERROR_REASON	No se pudo realizar la acción. Verifica la conexión al servidor de Active Directory, los parámetros de entrada o las credenciales de la cuenta de servicio.

Resultado de secuencia de comandos

En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Establecer contraseña de usuario:

Nombre del resultado de la secuencia de comandos	Valor
is_success	true o false

Actualiza los atributos de un host de AD

Usa la acción Actualizar atributos de un host de AD para actualizar una propiedad de directorio específica en las cuentas de computadora del caso, como actualizar el campo Description de una computadora con notas del incidente. La acción identifica automáticamente las computadoras de destino del caso y aplica el valor nuevo.

Esta acción se ejecuta en la entidad Hostname de Google SecOps.

Entradas de acción

La acción Actualizar atributos de un host de AD requiere los siguientes parámetros:

Parámetro	Descripción
Attribute Name	Obligatorio. Es el nombre del atributo que se actualizará, como Description.
Attribute Value	Obligatorio. Es el valor nuevo del atributo.

Resultados de la acción

La acción Actualizar atributos de un host de AD proporciona los siguientes resultados:

Tipo de resultado de la acción	Disponibilidad
Archivo adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	No disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	No disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Mensajes de salida

La acción Actualizar atributos de un host de AD puede devolver los siguientes mensajes de salida:

Mensaje de salida	Descripción del mensaje
Successfully updated attribute "ATTRIBUTE_NAME" on the following hosts in Active Directory: ENTITY_ID_LIST	La acción se realizó correctamente.
Action wasn't able to update attribute "ATTRIBUTE_NAME" on the following hosts in Active Directory: ENTITY_ID_LIST	La acción falló para los hosts especificados. Verifica que la cuenta de servicio tenga permiso de escritura para el atributo especificado en las cuentas de computadora de destino y que el formato del valor sea válido para ese atributo.
The following hosts were not found in Active Directory: ENTITY_ID_LIST	La acción falló para los hosts especificados. Verifica que las cuentas de computadora existan en Active Directory y coincidan con las entidades Hostname del caso.
No hosts were updated in Active Directory.	No se pudo realizar la acción. Confirma que el caso contenga entidades Hostname válidas y que la cuenta de servicio tenga permiso para actualizar el atributo especificado.
Error executing action "Update attributes of an AD Host". Reason: Provided attribute doesn't exist in Active Directory.	No se pudo realizar la acción. Verifica la ortografía del atributo en el parámetro Attribute Name y confirma que sea un atributo de computadora válido de Active Directory.
Error executing action "Update attributes of an AD Host". Reason: ERROR_REASON	No se pudo realizar la acción. Verifica la conexión al servidor de Active Directory, los parámetros de entrada o las credenciales de la cuenta de servicio.

Resultado de secuencia de comandos

En la siguiente tabla, se indica el valor del resultado de la secuencia de comandos cuando se usa la acción Actualizar los atributos de un host de AD:

Nombre del resultado de la secuencia de comandos	Valor
is_success	true o false

Actualiza los atributos de un usuario de AD

Usa la acción Actualizar atributos de un usuario de AD para actualizar una propiedad de directorio específica en las cuentas de usuario del caso, como actualizar el campo Description, title o department de un usuario. La acción identifica automáticamente a los usuarios de destino del caso y aplica el valor nuevo.

Esta acción se ejecuta en la entidad User de Google SecOps.

Entradas de acción

La acción Actualizar atributos de un usuario de AD requiere los siguientes parámetros:

Parámetro	Descripción
Attribute Name	Obligatorio. Es el nombre del atributo que se actualizará, como Description.
Attribute Value	Obligatorio. Es el valor nuevo del atributo.

Resultados de la acción

La acción Actualizar atributos de un usuario de AD proporciona los siguientes resultados:

Tipo de resultado de la acción	Disponibilidad
Archivo adjunto del muro de casos	No disponible
Vínculo al muro de casos	No disponible
Tabla del muro de casos	No disponible
Tabla de enriquecimiento	No disponible
Resultado de JSON	No disponible
Mensajes de salida	Disponible
Resultado de secuencia de comandos	Disponible

Mensajes de salida

La acción Actualizar atributos de un usuario de AD puede devolver los siguientes mensajes de salida:

Mensaje de salida	Descripción del mensaje
Successfully updated attribute "ATTRIBUTE_NAME" for the following users in Active Directory: ENTITY_ID_LIST	La acción se realizó correctamente.
Action wasn't able to update attribute "ATTRIBUTE_NAME" for the following users in Active Directory: ENTITY_ID_LIST	No se pudo realizar la acción para los usuarios especificados. Verifica que la cuenta de servicio tenga permiso de escritura para el atributo especificado en las cuentas de usuario de destino y que el formato del valor sea válido para ese atributo.
The following users were not found in Active Directory: ENTITY_ID_LIST	No se pudo realizar la acción para los usuarios especificados. Verifica que las cuentas de usuario existan en Active Directory y coincidan con las entidades de User en el caso.
No users were updated in Active Directory.	No se pudo realizar la acción. Confirma que el caso contenga entidades User válidas y que la cuenta de servicio tenga permiso para actualizar el atributo especificado.
Error executing action "Update attributes of an AD User". Reason: Provided attribute doesn't exist in Active Directory.	No se pudo realizar la acción. Verifica la ortografía del atributo en el parámetro Attribute Name y confirma que sea un atributo de usuario de Active Directory válido.
Error executing action "Update attributes of an AD User". Reason: ERROR_REASON	No se pudo realizar la acción. Verifica la conexión al servidor de Active Directory, los parámetros de entrada o las credenciales de la cuenta de servicio.

Resultado de secuencia de comandos

En la siguiente tabla, se indica el valor del resultado de la secuencia de comandos cuando se usa la acción Actualizar atributos de un usuario de AD:

Nombre del resultado de la secuencia de comandos	Valor
is_success	true o false

¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.