Establecer preferencias para Microsoft Defender para punto de conexión en Linux

Se aplica a:

• Microsoft Defender para punto de conexión Plan 1
• Microsoft Defender para punto de conexión Plan 2
• Microsoft Defender XDR

¿Quiere experimentar Defender para punto de conexión? Regístrese para obtener una prueba gratuita.

Importante

Este artículo contiene instrucciones sobre cómo establecer preferencias para Defender para punto de conexión en Linux en entornos empresariales. Si está interesado en configurar el producto en un dispositivo desde la línea de comandos, consulte Recursos.

En entornos empresariales, Defender para punto de conexión en Linux se puede administrar a través de un perfil de configuración. Este perfil se implementa desde la herramienta de administración que prefiera. Las preferencias administradas por la empresa tienen prioridad sobre las establecidas localmente en el dispositivo. En otras palabras, los usuarios de la empresa no pueden cambiar las preferencias que se establecen a través de este perfil de configuración. Si se agregaron exclusiones a través del perfil de configuración administrada, solo se pueden quitar a través del perfil de configuración administrada. La línea de comandos funciona para las exclusiones que se agregaron localmente.

En este artículo se describe la estructura de este perfil (incluido un perfil recomendado que puede usar para empezar) e instrucciones sobre cómo implementar el perfil.

Estructura del perfil de configuración

El perfil de configuración es un archivo .json que consta de entradas identificadas por una clave (que denota el nombre de la preferencia), seguidas de un valor, que depende de la naturaleza de la preferencia. Los valores pueden ser simples, como un valor numérico o complejos, como una lista anidada de preferencias.

Normalmente, usaría una herramienta de administración de configuración para insertar un archivo con el nombre mdatp_managed.json en la ubicación /etc/opt/microsoft/mdatp/managed/.

El nivel superior del perfil de configuración incluye preferencias de todo el producto y entradas para subáreas del producto, que se explican con más detalle en las secciones siguientes.

Preferencias del motor antivirus

La sección antivirusEngine del perfil de configuración se usa para administrar las preferencias del componente antivirus del producto.

Description	Valor JSON	Valor del portal de Defender
Clave	antivirusEngine	Motor antivirus
Tipo de datos	Diccionario (preferencia anidada)	Sección contraída
Comentarios	Consulte las secciones siguientes para obtener una descripción del contenido del diccionario.	Consulte las secciones siguientes para obtener una descripción de las propiedades de la directiva.

Nivel de cumplimiento para el motor antivirus

Especifica la preferencia de cumplimiento del motor antivirus. Hay tres valores para establecer el nivel de cumplimiento:

• En tiempo real (real_time): la protección en tiempo real (examinar archivos a medida que se modifican) está habilitada.
• A petición (on_demand): los archivos se examinan solo a petición. En esto:
  • La protección en tiempo real está desactivada.
• Pasivo (passive): ejecuta el motor antivirus en modo pasivo. En esto:
  • La protección en tiempo real está desactivada: Antivirus de Microsoft Defender no corrige las amenazas.
  • El examen a petición está activado: siga usando las funcionalidades de examen en el punto de conexión.
  • La corrección automática de amenazas está desactivada: no se moverá ningún archivo y se espera que el administrador de seguridad realice las acciones necesarias.
  • Las actualizaciones de inteligencia de seguridad están activadas: las alertas estarán disponibles en el inquilino de los administradores de seguridad.

Description	Valor JSON	Valor del portal de Defender
Clave	enforcementLevel	Nivel de cumplimiento
Tipo de datos	Cadena	Desplegar
Posibles valores	real_time on_demand passive (valor predeterminado)	No configurado En tiempo real OnDemand Pasivo (valor predeterminado)

Nota:

Disponible en Defender para punto de conexión, versión 101.10.72 o posterior. El valor predeterminado se cambia de real_time a pasivo para endpoint versión 101.23062.0001 o posterior. Se recomienda usar también exámenes programados según sus necesidades.

Habilitar o deshabilitar la supervisión del comportamiento

Determina si la funcionalidad de bloqueo y supervisión del comportamiento está habilitada en el dispositivo o no.

Description	Valor JSON	Valor del portal de Defender
Clave	behaviorMonitoring	Habilitación de la supervisión del comportamiento
Tipo de datos	Cadena	Desplegar
Posibles valores	disabled (valor predeterminado) enabled	No configurado Deshabilitado (valor predeterminado) Habilitado

Nota:

Disponible en Defender para punto de conexión, versión 101.45.00 o posterior. Esta característica solo se aplica cuando está habilitada Real-Time característica protección.

Ejecución de un examen después de actualizar las definiciones

Especifica si se debe iniciar un examen del proceso después de que se descarguen nuevas actualizaciones de inteligencia de seguridad en el dispositivo. Al habilitar esta configuración, se desencadena un examen antivirus en los procesos en ejecución del dispositivo.

Description	Valor JSON	Valor del portal de Defender
Clave	scanAfterDefinitionUpdate	Habilitación del examen después de la actualización de la definición
Tipo de datos	Booleano	Desplegar
Posibles valores	true (valor predeterminado) false	No configurado Deshabilitada Habilitado (valor predeterminado)

Nota:

Disponible en Defender para punto de conexión, versión 101.45.00 o posterior. Esta característica solo funciona cuando el nivel de cumplimiento está establecido en real-time.

Examinar archivos (solo exámenes antivirus a petición)

Especifica si se deben examinar los archivos durante los exámenes antivirus a petición.

Description	Valor JSON	Valor del portal de Defender
Clave	scanArchives	Habilitación del examen de archivos
Tipo de datos	Booleano	Desplegar
Posibles valores	true (valor predeterminado) false	No configurado Deshabilitada Habilitado (valor predeterminado)

Nota:

Disponible en La versión 101.45.00 o posterior de Microsoft Defender para punto de conexión. Los archivos de archivo nunca se examinan durante la protección en tiempo real. Cuando se extraen los archivos de un archivo, se examinan. La opción scanArchives se puede usar para forzar el examen de archivos solo durante el examen a petición.

Grado de paralelismo para los exámenes a petición

Especifica el grado de paralelismo para los exámenes a petición. Esto corresponde al número de subprocesos utilizados para realizar el examen y afecta al uso de la CPU y a la duración del examen a petición.

Description	Valor JSON	Valor del portal de Defender
Clave	maximumOnDemandScanThreads	número máximo de subprocesos de examen a petición
Tipo de datos	Entero	Alternar conmutador & entero
Posibles valores	2 (valor predeterminado). Los valores permitidos son enteros entre 1 y 64.	No configurado (desactivación predeterminada de los valores predeterminados en 2) Configurado (activar) y entero entre 1 y 64.

Nota:

Disponible en La versión 101.45.00 o posterior de Microsoft Defender para punto de conexión.

Directiva de combinación de exclusión

Especifica la directiva de combinación para exclusiones. Puede ser una combinación de exclusiones definidas por el administrador y definidas por el usuario (merge) o solo exclusiones definidas por el administrador (admin_only). Esta configuración se puede usar para impedir que los usuarios locales definan sus propias exclusiones.

Description	Valor JSON	Valor del portal de Defender
Clave	exclusionesMergePolicy	Combinación de exclusiones
Tipo de datos	Cadena	Desplegar
Posibles valores	merge (valor predeterminado) admin_only	No configurado merge (valor predeterminado) admin_only

Nota:

Disponible en Defender para punto de conexión, versión 100.83.73 o posterior.

Exclusiones de análisis

Entidades que se han excluido del examen. Las exclusiones se pueden especificar mediante rutas de acceso completas, extensiones o nombres de archivo. (Las exclusiones se especifican como una matriz de elementos, el administrador puede especificar tantos elementos como sea necesario, en cualquier orden).

Description	Valor JSON	Valor del portal de Defender
Clave	Exclusiones	Exclusiones de análisis
Tipo de datos	Diccionario (preferencia anidada)	Lista de propiedades dinámicas
Comentarios	Consulte las secciones siguientes para obtener una descripción del contenido del diccionario.

Tipo de exclusión

Especifica el tipo de contenido excluido del examen.

Description	Valor JSON	Valor del portal de Defender
Clave	$type	Tipo
Tipo de datos	Cadena	Desplegable
Posibles valores	excludedPath excludedFileExtension excludedFileName	Ruta de acceso Extensión de archivo Nombre del proceso

Ruta de acceso al contenido excluido

Se usa para excluir contenido del examen por ruta de acceso completa del archivo.

Description	Valor JSON	Valor del portal de Defender
Clave	ruta de acceso	Ruta de acceso
Tipo de datos	Cadena	Cadena
Posibles valores	rutas de acceso válidas	rutas de acceso válidas
Comentarios	Aplicable solo si $type está excluidoPath	Acceso en el menú emergente Editar instancia

Tipo de ruta de acceso (archivo o directorio)

Indica si la propiedad path hace referencia a un archivo o directorio.

Description	Valor JSON	Valor del portal de Defender
Clave	isDirectory	Es directorio
Tipo de datos	Booleano	Desplegar
Posibles valores	false (valor predeterminado) true	Habilitado Deshabilitado
Comentarios	Aplicable solo si $type está excluidoPath	Acceso en el menú emergente Editar instancia

Extensión de archivo excluida del examen

Se usa para excluir contenido del examen por extensión de archivo.

Description	Valor JSON	Valor del portal de Defender
Clave	extensión	Extensión de archivo
Tipo de datos	Cadena	Cadena
Posibles valores	extensiones de archivo válidas	extensiones de archivo válidas
Comentarios	Solo se aplica si $type es excludedFileExtension	Se accede a ella en el menú emergente Configurar instancia

Proceso excluido del examen*

Especifica un proceso para el que se excluye toda la actividad de archivo del examen. El proceso se puede especificar por su nombre (por ejemplo, cat) o por la ruta de acceso completa (por ejemplo, /bin/cat).

Description	Valor JSON	Valor del portal de Defender
Clave	name	Nombre de archivo
Tipo de datos	Cadena	Cadena
Posibles valores	cualquier cadena	cualquier cadena
Comentarios	Aplicable solo si $type es excludedFileName	Se accede a ella en el menú emergente Configurar instancia

Muting Non Exec mounts (Silenciar montajes no ejecutivos)

Especifica el comportamiento de RTP en el punto de montaje marcado como noexec. Hay dos valores para la configuración:

• Sin conmutar (unmute): el valor predeterminado, todos los puntos de montaje se examinan como parte de RTP.
• Muted (mute): los puntos de montaje marcados como noexec no se examinan como parte de RTP, estos puntos de montaje se pueden crear para:
  • Archivos de base de datos en servidores de base de datos para mantener archivos de base de datos.
  • El servidor de archivos puede mantener los puntos de montaje de los archivos de datos sin la opción noexec.
  • La copia de seguridad puede mantener los puntos de montaje de los archivos de datos sin opción de ejecución.

Description	Valor JSON	Valor del portal de Defender
Clave	nonExecMountPolicy	exclusión mutua de montaje no ejecutado
Tipo de datos	Cadena	Desplegar
Posibles valores	unmute (valor predeterminado) mute	No configurado unmute (predeterminado) mudo

Nota:

Disponible en Defender para punto de conexión, versión 101.85.27 o posterior.

Unmonitor Filesystems

Configure los sistemas de archivos para que no se superen o excluyan de Real Time Protection (RTP). Los sistemas de archivos configurados se validan en la lista de sistemas de archivos permitidos de Microsoft Defender. Solo después de la validación correcta, se permitirá que el sistema de archivos no se pueda supervisar. Estos sistemas de archivos no supervisados configurados seguirán siendo examinados por exámenes rápidos, completos y personalizados.

Description	Valor JSON	Valor del portal de Defender
Clave	unmonitoredFilesystems	Sistemas de archivos no supervisados
Tipo de datos	Matriz de cadenas	Lista de cadenas dinámicas

Nota:

El sistema de archivos configurado no se supervisará solo si está presente en la lista de sistemas de archivos no supervisados permitidos de Microsoft.

De forma predeterminada, NFS y Fuse no se supervisan de los exámenes RTP, Quick y Full. Sin embargo, todavía se pueden examinar mediante un examen personalizado. Por ejemplo, para quitar NFS de la lista de sistemas de archivos no supervisados, actualice el archivo de configuración administrado como se muestra a continuación. Esto agregará automáticamente NFS a la lista de sistemas de archivos supervisados para RTP.

{
   "antivirusEngine":{
      "unmonitoredFilesystems": ["Fuse"]
  }
}

Para quitar NFS y Fuse de la lista no supervisada de sistemas de archivos, haga lo siguiente.

{
   "antivirusEngine":{
      "unmonitoredFilesystems": []
  }
}

Nota:

Aquí; es la lista predeterminada de sistemas de archivos supervisados para RTP: btrfs, , ecryptfs, ext3ext2, ext4, fuseblk, jfs, overlay, ramfs, reiserfs, tmpfs, , vfat, xfs.

Si es necesario agregar cualquier sistema de archivos supervisado a la lista de sistemas de archivos no supervisados, Microsoft debe evaluarlo y habilitarlo a través de la configuración en la nube. A continuación, los clientes pueden actualizar managed_mdatp.json para anular la supervisión de ese sistema de archivos.

Configuración de la característica de cálculo de hash de archivos

Habilita o deshabilita la característica de cálculo hash de archivos. Cuando esta característica está habilitada, Defender para punto de conexión calcula los hashes de los archivos que examina. Tenga en cuenta que la habilitación de esta característica podría afectar al rendimiento del dispositivo. Para obtener más información, consulte: Crear indicadores para archivos.

Description	Valor JSON	Valor del portal de Defender
Clave	enableFileHashComputation	Habilitación del cálculo de hash de archivos
Tipo de datos	Booleano	Desplegar
Posibles valores	false (valor predeterminado) true	No configurado Deshabilitado (valor predeterminado) Habilitado

Nota:

Disponible en Defender para punto de conexión, versión 101.85.27 o posterior.

Amenazas permitidas

Lista de amenazas (identificadas por su nombre) que no están bloqueadas por el producto y que, en su lugar, pueden ejecutarse.

Description	Valor JSON	Valor del portal de Defender
Clave	allowedThreats	Amenazas permitidas
Tipo de datos	Matriz de cadenas	Lista de cadenas dinámicas

Acciones de amenazas no permitidas

Restringe las acciones que el usuario local de un dispositivo puede realizar cuando se detectan amenazas. Las acciones incluidas en esta lista no se muestran en la interfaz de usuario.

Description	Valor JSON	Valor del portal de Defender
Clave	disallowedThreatActions	Acciones de amenazas no permitidas
Tipo de datos	Matriz de cadenas	Lista de cadenas dinámicas
Posibles valores	allow (impide que los usuarios permitan amenazas) restore (impide que los usuarios restaure amenazas desde la cuarentena)	allow (impide que los usuarios permitan amenazas) restore (restringe a los usuarios la restauración de amenazas desde la cuarentena)

Nota:

Disponible en Defender para punto de conexión, versión 100.83.73 o posterior.

Configuración del tipo de amenaza

La preferencia threatTypeSettings en el motor antivirus se usa para controlar cómo el producto controla determinados tipos de amenazas.

Description	Valor JSON	Valor del portal de Defender
Clave	threatTypeSettings	Configuración del tipo de amenaza
Tipo de datos	Diccionario (preferencia anidada)	Lista de propiedades dinámicas
Comentarios	Consulte las secciones siguientes para obtener una descripción del contenido del diccionario.	Consulte las secciones siguientes para obtener una descripción de las propiedades dinámicas.

Tipo de amenaza

Tipo de amenaza para la que está configurado el comportamiento.

Description	Valor JSON	Valor del portal de Defender
Clave	clave	Tipo de amenaza
Tipo de datos	Cadena	Desplegar
Posibles valores	potentially_unwanted_application archive_bomb	potentially_unwanted_application archive_bomb

Acción que puede realizar

Acción que se debe realizar al encontrarse con una amenaza del tipo especificado en la sección anterior. Puede ser:

• Auditoría: el dispositivo no está protegido contra este tipo de amenaza, pero se registra una entrada sobre la amenaza. (Predeterminado)
• Bloquear: el dispositivo está protegido contra este tipo de amenaza y se le notifica en la consola de seguridad.
• Desactivado: el dispositivo no está protegido contra este tipo de amenaza y no se registra nada.

Description	Valor JSON	Valor del portal de Defender
Clave	valor	Acción que puede realizar
Tipo de datos	Cadena	Desplegar
Posibles valores	audit (valor predeterminado) block off	auditoría Bloquear desactivado

Directiva de combinación de configuración de tipos de amenazas

Especifica la directiva de combinación para la configuración del tipo de amenaza. Puede ser una combinación de opciones definidas por el administrador y definidas por el usuario (merge) o solo una configuración definida por el administrador (admin_only). Esta configuración se puede usar para impedir que los usuarios locales definan su propia configuración para distintos tipos de amenazas.

Description	Valor JSON	Valor del portal de Defender
Clave	threatTypeSettingsMergePolicy	Combinación de opciones del tipo de amenaza
Tipo de datos	Cadena	Desplegar
Posibles valores	merge (valor predeterminado) admin_only	No configurado merge (valor predeterminado) admin_only

Nota:

Disponible en Defender para punto de conexión, versión 100.83.73 o posterior.

Retención del historial de exámenes antivirus (en días)

Especifique el número de días que los resultados se conservan en el historial de exámenes del dispositivo. Los resultados del examen antiguos se quitan del historial. Archivos en cuarentena antiguos que también se quitan del disco.

Description	Valor JSON	Valor del portal de Defender
Clave	scanResultsRetentionDays	Retención de resultados de examen
Tipo de datos	Cadena	Conmutador de alternancia y entero
Posibles valores	90 (valor predeterminado). Los valores permitidos van de 1 día a 180 días.	No configurado (desactivar : valor predeterminado de 90 días) Configurado (activar) y el valor permitido de 1 a 180 días.

Nota:

Disponible en Defender para punto de conexión, versión 101.04.76 o posterior.

Número máximo de elementos en el historial de examen del antivirus

Especifique el número máximo de entradas que se conservarán en el historial de exámenes. Las entradas incluyen todos los exámenes a petición realizados en el pasado y todas las detecciones antivirus.

Description	Valor JSON	Valor del portal de Defender
Clave	scanHistoryMaximumItems	Tamaño del historial de exámenes
Tipo de datos	Cadena	Alternar y entero
Posibles valores	10000 (valor predeterminado). Los valores permitidos van de 5000 elementos a 15000 elementos.	No configurado (desactivar : valor predeterminado de 10000) Configurado (activar) y el valor permitido de 5000 a 15000 elementos.

Nota:

Disponible en Defender para punto de conexión, versión 101.04.76 o posterior.

Opciones avanzadas de examen

La siguiente configuración se puede configurar para habilitar ciertas características avanzadas de examen.

Nota:

La habilitación de estas características podría afectar al rendimiento del dispositivo. Por lo tanto, se recomienda mantener los valores predeterminados.

Configuración del examen de eventos de permisos de modificación de archivos

Cuando esta característica está habilitada, Defender para punto de conexión examinará los archivos cuando se hayan cambiado sus permisos para establecer los bits de ejecución.

Nota:

Esta característica solo se aplica cuando la enableFilePermissionEvents característica está habilitada. Para obtener más información, consulte la sección Características opcionales avanzadas a continuación para obtener más información.

Description	Valor JSON	Valor del portal de Defender
Clave	scanFileModifyPermissions	No disponible
Tipo de datos	Booleano	No aplicable
Posibles valores	false (predeterminado) true	No aplicable

Nota:

Disponible en defender para punto de conexión versión 101.23062.0010 o posterior.

Configuración del examen de eventos de propiedad de modificación de archivos

Cuando esta característica está habilitada, Defender para punto de conexión examinará los archivos para los que ha cambiado la propiedad.

Nota:

Esta característica solo se aplica cuando la enableFileOwnershipEvents característica está habilitada. Para obtener más información, consulte la sección Características opcionales avanzadas a continuación para obtener más información.

Description	Valor JSON	Valor del portal de Defender
Clave	scanFileModifyOwnership	No disponible
Tipo de datos	Booleano	No aplicable
Posibles valores	false (predeterminado) true	No aplicable

Nota:

Disponible en defender para punto de conexión versión 101.23062.0010 o posterior.

Configuración del examen de eventos de socket sin procesar

Cuando esta característica está habilitada, Defender para punto de conexión examinará eventos de socket de red, como la creación de sockets sin formato o sockets de paquetes, o la opción de socket de configuración.

Nota:

Esta característica solo se aplica cuando la supervisión del comportamiento está habilitada. Esta característica solo se aplica cuando la enableRawSocketEvent característica está habilitada. Para obtener más información, consulte la sección Características opcionales avanzadas a continuación para obtener más información.

Description	Valor JSON	Valor del portal de Defender
Clave	scanNetworkSocketEvent	No disponible
Tipo de datos	Booleano	No aplicable
Posibles valores	false (predeterminado) true	No aplicable

Nota:

Disponible en defender para punto de conexión versión 101.23062.0010 o posterior.

Preferencias de protección entregadas en la nube

La entrada cloudService del perfil de configuración se usa para configurar la característica de protección controlada por la nube del producto.

Nota:

La protección proporcionada en la nube se aplica con cualquier configuración de nivel de cumplimiento (real_time, on_demand, pasiva).

Description	Valor JSON	Valor del portal de Defender
Clave	cloudService	Preferencias de protección entregada en la nube
Tipo de datos	Diccionario (preferencia anidada)	Sección contraída
Comentarios	Consulte las secciones siguientes para obtener una descripción del contenido del diccionario.	Consulte las secciones siguientes para obtener una descripción de la configuración de la directiva.

Habilitación o deshabilitación de la protección entregada en la nube

Determina si la protección entregada en la nube está habilitada en el dispositivo o no. Para mejorar la seguridad de los servicios, se recomienda mantener activada esta característica.

Description	Valor JSON	Valor del portal de Defender
Clave	habilitado	Habilitación de la protección entregada en la nube
Tipo de datos	Booleano	Desplegar
Posibles valores	true (valor predeterminado) false	No configurado Deshabilitada Habilitado (valor predeterminado)

Nivel de recopilación de diagnóstico

Los datos de diagnóstico se usan para mantener Defender para punto de conexión seguro y actualizado, detectar, diagnosticar y corregir problemas, y también realizar mejoras en el producto. Esta configuración determina el nivel de diagnóstico enviado por el producto a Microsoft. Para obtener más información, consulte Privacidad de Microsoft Defender para punto de conexión en Linux.

Description	Valor JSON	Valor del portal de Defender
Clave	diagnosticLevel	Nivel de recopilación de datos de diagnóstico
Tipo de datos	Cadena	Desplegar
Posibles valores	optional required (valor predeterminado)	No configurado opcional (valor predeterminado) necesario

Configuración del nivel de bloque en la nube

Esta configuración determina la agresividad de Defender para punto de conexión al bloquear y examinar archivos sospechosos. Si esta configuración está activada, Defender para punto de conexión es más agresivo al identificar archivos sospechosos que bloquear y examinar; de lo contrario, es menos agresivo y, por lo tanto, bloquea y examina con menos frecuencia.

Hay cinco valores para establecer el nivel de bloque en la nube:

• Normal (normal): el nivel de bloqueo predeterminado.
• Moderado (moderate): solo proporciona veredicto para las detecciones de alta confianza.
• Alto (high): bloquea agresivamente los archivos desconocidos al tiempo que optimiza el rendimiento (mayor posibilidad de bloquear archivos no dañinos).
• High Plus (high_plus): bloquea agresivamente los archivos desconocidos y aplica medidas de protección adicionales (podrían afectar al rendimiento del dispositivo cliente).
• Tolerancia cero (zero_tolerance): bloquea todos los programas desconocidos.

Description	Valor JSON	Valor del portal de Defender
Clave	cloudBlockLevel	Configuración del nivel de bloque en la nube
Tipo de datos	Cadena	Desplegar
Posibles valores	normal (valor predeterminado) moderate high high_plus zero_tolerance	No configurado Normal (predeterminada) Moderado Alto High_Plus Zero_Tolerance

Nota:

Disponible en Defender para punto de conexión, versión 101.56.62 o posterior.

Habilitar o deshabilitar envíos de ejemplo automáticos

Determina si se envían muestras sospechosas (que probablemente contengan amenazas) a Microsoft. Hay tres niveles para controlar el envío de muestras:

• Ninguno: no se envían muestras sospechosas a Microsoft.
• Seguro: solo las muestras sospechosas que no contienen información de identificación personal (PII) se envían automáticamente. Este es el valor predeterminado para esta configuración.
• Todos: todos los ejemplos sospechosos se envían a Microsoft.

Description	Valor JSON	Valor del portal de Defender
Clave	automaticSampleSubmissionConsent	Habilitación de envíos de ejemplo automáticos
Tipo de datos	Cadena	Desplegar
Posibles valores	none safe (valor predeterminado) all	No configurado Ninguno Seguro (valor predeterminado) todas

Habilitación o deshabilitación de actualizaciones automáticas de inteligencia de seguridad

Determina si las actualizaciones de inteligencia de seguridad se instalan automáticamente:

Description	Valor JSON	Valor del portal de Defender
Clave	automaticDefinitionUpdateEnabled	Actualizaciones automáticas de inteligencia de seguridad
Tipo de datos	Booleano	Desplegar
Posibles valores	true (valor predeterminado) false	No configurado Deshabilitada Habilitado (valor predeterminado)

Características opcionales avanzadas

La siguiente configuración se puede configurar para habilitar ciertas características avanzadas.

Nota:

La habilitación de estas características podría afectar al rendimiento del dispositivo. Se recomienda mantener los valores predeterminados.

Description	Valor JSON	Valor del portal de Defender
Clave	Funciones	No disponible
Tipo de datos	Diccionario (preferencia anidada)	No aplicable
Comentarios	Consulte las secciones siguientes para obtener una descripción del contenido del diccionario.

Característica de carga de módulos

Determina si se supervisan los eventos de carga de módulos (eventos abiertos de archivos en bibliotecas compartidas).

Nota:

Esta característica solo se aplica cuando la supervisión del comportamiento está habilitada.

Description	Valor JSON	Valor del portal de Defender
Clave	moduleLoad	No disponible
Tipo de datos	Cadena	No aplicable
Posibles valores	disabled (valor predeterminado) habilitado	No aplicable
Comentarios	Disponible en Defender para punto de conexión, versión 101.68.80 o posterior.

Configuraciones de sensor adicionales

Las siguientes opciones se pueden usar para configurar ciertas características avanzadas del sensor complementario.

Description	Valor JSON	Valor del portal de Defender
Clave	supplementarySensorConfigurations	No disponible
Tipo de datos	Diccionario (preferencia anidada)	No aplicable
Comentarios	Consulte las secciones siguientes para obtener una descripción del contenido del diccionario.

Configuración de la supervisión de eventos de permisos de modificación de archivos

Determina si se supervisan los eventos de permisos de modificación de archivos (chmod).

Nota:

Cuando esta característica está habilitada, Defender para punto de conexión supervisará los cambios en los bits de ejecución de los archivos, pero no examinará estos eventos. Para obtener más información, consulte la sección Características de análisis avanzado para obtener más información.

Description	Valor JSON	Valor del portal de Defender
Clave	enableFilePermissionEvents	No disponible
Tipo de datos	Cadena	No aplicable
Posibles valores	disabled (valor predeterminado) habilitado	No aplicable
Comentarios	Disponible en defender para punto de conexión versión 101.23062.0010 o posterior.

Configuración de la supervisión de eventos de propiedad de modificación de archivos

Determina si se supervisan los eventos de propiedad de modificación de archivos (chown).

Nota:

Cuando esta característica está habilitada, Defender para punto de conexión supervisará los cambios en la propiedad de los archivos, pero no examinará estos eventos. Para obtener más información, consulte la sección Características de análisis avanzado para obtener más información.

Description	Valor JSON	Valor del portal de Defender
Clave	enableFileOwnershipEvents	No disponible
Tipo de datos	Cadena	No aplicable
Posibles valores	disabled (valor predeterminado) habilitado	No aplicable
Comentarios	Disponible en defender para punto de conexión versión 101.23062.0010 o posterior.

Configuración de la supervisión de eventos de socket sin procesar

Determina si se supervisan los eventos de socket de red que implican la creación de sockets sin procesar o de paquetes, o la opción de socket de configuración.

Nota:

Esta característica solo se aplica cuando la supervisión del comportamiento está habilitada. Cuando esta característica está habilitada, Defender para punto de conexión supervisará estos eventos de socket de red, pero no examinará estos eventos. Para obtener más información, consulte la sección Características avanzadas de examen anterior para obtener más detalles.

Description	Valor JSON	Valor del portal de Defender
Clave	enableRawSocketEvent	No disponible
Tipo de datos	Cadena	No aplicable
Posibles valores	disabled (valor predeterminado) habilitado	No aplicable
Comentarios	Disponible en defender para punto de conexión versión 101.23062.0010 o posterior.

Configuración de la supervisión de eventos del cargador de arranque

Determina si los eventos del cargador de arranque se supervisan y examinan.

Nota:

Esta característica solo se aplica cuando la supervisión del comportamiento está habilitada.

Description	Valor JSON	Valor del portal de Defender
Clave	enableBootLoaderCalls	No disponible
Tipo de datos	Cadena	No aplicable
Posibles valores	disabled (valor predeterminado) habilitado	No aplicable
Comentarios	Disponible en Defender para punto de conexión, versión 101.68.80 o posterior.

Configuración de la supervisión de eventos de ptrace

Determina si los eventos de ptrace se supervisan y examinan.

Nota:

Esta característica solo se aplica cuando la supervisión del comportamiento está habilitada.

Description	Valor JSON	Valor del portal de Defender
Clave	enableProcessCalls	No disponible
Tipo de datos	Cadena	No aplicable
Posibles valores	disabled (valor predeterminado) habilitado	No aplicable
Comentarios	Disponible en Defender para punto de conexión, versión 101.68.80 o posterior.

Configuración de la supervisión de eventos de pseudofs

Determina si los eventos de seudofs se supervisan y examinan.

Nota:

Esta característica solo se aplica cuando la supervisión del comportamiento está habilitada.

Description	Valor JSON	Valor del portal de Defender
Clave	enablePseudofsCalls	No disponible
Tipo de datos	Cadena	No aplicable
Posibles valores	disabled (valor predeterminado) habilitado	No aplicable
Comentarios	Disponible en Defender para punto de conexión, versión 101.68.80 o posterior.

Configuración de la supervisión de eventos de carga de módulos mediante eBPF

Determina si los eventos de carga de módulos se supervisan mediante eBPF y se examinan.

Nota:

Esta característica solo se aplica cuando la supervisión del comportamiento está habilitada.

Description	Valor JSON	Valor del portal de Defender
Clave	enableEbpfModuleLoadEvents	No disponible
Tipo de datos	Cadena	No aplicable
Posibles valores	disabled (valor predeterminado) habilitado	No aplicable
Comentarios	Disponible en Defender para punto de conexión, versión 101.68.80 o posterior.

Notificar eventos sospechosos de AV a EDR

Determina si los eventos sospechosos de Antivirus se notifican a EDR.

Description	Valor JSON	Valor del portal de Defender
Clave	sendLowfiEvents	No disponible
Tipo de datos	Cadena	No aplicable
Posibles valores	disabled (valor predeterminado) habilitado	No aplicable
Comentarios	Disponible en defender para punto de conexión versión 101.23062.0010 o posterior.

Configuraciones de protección de red

Los siguientes valores se pueden usar para configurar características avanzadas de inspección de Network Protection para controlar qué tráfico inspecciona Network Protection.

Nota:

Para que sean eficaces, la protección de red debe estar activada. Para obtener más información, consulte Activar la protección de red para Linux.

Description	Valor JSON	Valor del portal de Defender
Clave	networkProtection	Protección de red
Tipo de datos	Diccionario (preferencia anidada)	Sección contraída
Comentarios	Consulte las secciones siguientes para obtener una descripción del contenido del diccionario.	Consulte las secciones siguientes para obtener una descripción de la configuración de directiva.

Nivel de cumplimiento

Description	Valor JSON	Valor del portal de Defender
Clave	enforcementLevel	Nivel de cumplimiento
Tipo de datos	Cadena	Desplegar
Posibles valores	disabled (valor predeterminado) audit block	No configurado disabled (valor predeterminado) auditoría Bloquear

Configuración de la inspección ICMP

Determina si los eventos ICMP se supervisan y examinan.

Nota:

Esta característica solo se aplica cuando la supervisión del comportamiento está habilitada.

Description	Valor JSON	Valor del portal de Defender
Clave	disableIcmpInspection	No disponible
Tipo de datos	Booleano	No aplicable
Posibles valores	true (valor predeterminado) false	No aplicable
Comentarios	Disponible en defender para punto de conexión versión 101.23062.0010 o posterior.

Perfil de configuración recomendado

Para empezar, se recomienda el siguiente perfil de configuración para su empresa para aprovechar todas las características de protección que proporciona Defender para punto de conexión.

El siguiente perfil de configuración:

• Habilitación de la protección en tiempo real (RTP)
• Especifique cómo se controlan los siguientes tipos de amenazas:
  • Las aplicaciones potencialmente no deseadas (PUA) están bloqueadas
  • Las bombas de archivo (archivo con una alta tasa de compresión) se auditan en los registros de productos.
• Habilitación de actualizaciones automáticas de inteligencia de seguridad
• Habilitar la protección proporcionada en la nube
• Habilitación del envío automático de ejemplos en el safe nivel

Perfil de ejemplo

{
   "antivirusEngine":{
      "enforcementLevel":"real_time",
      "threatTypeSettings":[
         {
            "key":"potentially_unwanted_application",
            "value":"block"
         },
         {
            "key":"archive_bomb",
            "value":"audit"
         }
      ]
   },
   "cloudService":{
      "automaticDefinitionUpdateEnabled":true,
      "automaticSampleSubmissionConsent":"safe",
      "enabled":true,
      "proxy": "<EXAMPLE DO NOT USE> http://proxy.server:port/"
   }
}

Ejemplo de perfil de configuración completa

El siguiente perfil de configuración contiene entradas para todas las opciones descritas en este documento y se puede usar para escenarios más avanzados en los que quiera tener más control sobre el producto.

Nota:

No es posible controlar toda la comunicación de Microsoft Defender para punto de conexión con solo una configuración de proxy en este JSON.

Perfil completo

{
   "antivirusEngine":{
      "enforcementLevel":"real_time",
      "behaviorMonitoring": "enabled",
      "scanAfterDefinitionUpdate":true,
      "scanArchives":true,
      "scanHistoryMaximumItems": 10000,
      "scanResultsRetentionDays": 90,
      "maximumOnDemandScanThreads":2,
      "exclusionsMergePolicy":"merge",
      "exclusions":[
         {
            "$type":"excludedPath",
            "isDirectory":false,
            "path":"/var/log/system.log<EXAMPLE DO NOT USE>"
         },
         {
            "$type":"excludedPath",
            "isDirectory":true,
            "path":"/run<EXAMPLE DO NOT USE>"
         },
         {
            "$type":"excludedPath",
            "isDirectory":true,
            "path":"/home/*/git<EXAMPLE DO NOT USE>"
         },
         {
            "$type":"excludedFileExtension",
            "extension":".pdf<EXAMPLE DO NOT USE>"
         },
         {
            "$type":"excludedFileName",
            "name":"cat<EXAMPLE DO NOT USE>"
         }
      ],
      "allowedThreats":[
         "<EXAMPLE DO NOT USE>EICAR-Test-File (not a virus)"
      ],
      "disallowedThreatActions":[
         "allow",
         "restore"
      ],
      "nonExecMountPolicy":"unmute",
      "unmonitoredFilesystems": ["nfs,fuse"],
      "threatTypeSettingsMergePolicy":"merge",
      "threatTypeSettings":[
         {
            "key":"potentially_unwanted_application",
            "value":"block"
         },
         {
            "key":"archive_bomb",
            "value":"audit"
         }
      ]
   },
   "cloudService":{
      "enabled":true,
      "diagnosticLevel":"optional",
      "automaticSampleSubmissionConsent":"safe",
      "automaticDefinitionUpdateEnabled":true,
      "proxy": "<EXAMPLE DO NOT USE> http://proxy.server:port/"
   }
}

Adición de una etiqueta o un identificador de grupo al perfil de configuración

Al ejecutar el mdatp health comando por primera vez, el valor de la etiqueta y el identificador de grupo estarán en blanco. Para agregar una etiqueta o un identificador de grupo al mdatp_managed.json archivo, siga estos pasos:

1. Abra el perfil de configuración desde la ruta de acceso /etc/opt/microsoft/mdatp/managed/mdatp_managed.json.
2. Vaya a la parte inferior del archivo, donde se encuentra el cloudService bloque.
3. Agregue la etiqueta o el identificador de grupo necesarios como ejemplo siguiente al final del corchete de cierre para cloudService.

  },
  "cloudService": {
    "enabled": true,
    "diagnosticLevel": "optional",
    "automaticSampleSubmissionConsent": "safe",
    "automaticDefinitionUpdateEnabled": true,
    "proxy": "http://proxy.server:port/"
},
"edr": {
  "groupIds":"GroupIdExample",
  "tags": [
            {
            "key": "GROUP",
            "value": "Tag"
            }
          ]
      }
}

Nota:

Agregue la coma después del corchete de cierre al final del cloudService bloque. Además, asegúrese de que hay dos corchetes de cierre después de agregar tag o bloque de id. de grupo (consulte el ejemplo anterior). En este momento, el único nombre de clave admitido para las etiquetas es GROUP.

Validación del perfil de configuración

El perfil de configuración debe ser un archivo con formato JSON válido. Hay muchas herramientas que se pueden usar para comprobar esto. Por ejemplo, si ha python instalado en el dispositivo:

python -m json.tool mdatp_managed.json

Si el json tiene un formato correcto, el comando anterior lo devuelve al terminal y devuelve un código de salida de 0. De lo contrario, se muestra un error que describe el problema y el comando devuelve un código de salida de 1.

Comprobación de que el archivo mdatp_managed.json funciona según lo previsto

Para comprobar que /etc/opt/microsoft/mdatp/managed/mdatp_managed.json funciona correctamente, debería ver "[managed]" junto a esta configuración:

• cloud_enabled
• cloud_automatic_sample_submission_consent
• passive_mode_enabled
• real_time_protection_enabled
• automatic_definition_update_enabled

Nota:

No es necesario reiniciar el demonio de mdatp para que los cambios en la mayoría de las configuraciones de mdatp_managed.json surtan efecto. Excepción: Las siguientes configuraciones requieren un reinicio del demonio para que surta efecto:

• diagnóstico en la nube
• log-rotation-parameters

Implementación del perfil de configuración

Una vez que haya creado el perfil de configuración para su empresa, puede implementarlo a través de la herramienta de administración que usa la empresa. Defender para punto de conexión en Linux lee la configuración administrada del archivo /etc/opt/microsoft/mdatp/managed/mdatp_managed.json .

Sugerencia

¿Desea obtener más información? Interactúe con la comunidad de seguridad de Microsoft en nuestra comunidad tecnológica: Microsoft Defender para punto de conexión Tech Community.