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

¿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 .json archivo 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.

Descripción	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.
  • Las actualizaciones de definiciones solo se producen cuando se inicia un examen, incluso si automaticDefinitionUpdateEnabled se establece en en modo a true petición.
• Pasivo (passive): ejecuta el motor antivirus en modo pasivo. En este caso, se aplican todas las siguientes opciones:
  • La protección en tiempo real está desactivada: Microsoft Defender Antivirus 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 mueven archivos y se espera que el administrador de seguridad realice las acciones necesarias.
  • Las actualizaciones de inteligencia de seguridad están activadas: las alertas están disponibles en el inquilino del administrador de seguridad.
  • Las actualizaciones de definiciones solo se producen cuando se inicia un examen, incluso si automaticDefinitionUpdateEnabled se establece true en en modo pasivo.

Descripción	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 la versión 101.10.72 de Defender para punto de conexión o posterior. El valor predeterminado se cambia de real_time a passive en la versión 101.23062.0001 de Defender para punto de conexión o posterior. Se recomienda usar también exámenes programados según sus necesidades.

Habilitación o deshabilitación de la supervisión del comportamiento

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

Descripción	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 la versión 101.45.00 de Defender para punto de conexión o posterior. Esta característica solo se aplica cuando está habilitada la protección en tiempo real.

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.

Descripción	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 la versión 101.45.00 de Defender para punto de conexión 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.

Descripción	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 Microsoft Defender para punto de conexión versión 101.45.00 o posterior. 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.

Descripción	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 Microsoft Defender para punto de conexión versión 101.45.00 o posterior.

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). Las exclusiones definidas por el administrador (admin_only) se configuran mediante la directiva de Defender para punto de conexión. Esta configuración se puede usar para impedir que los usuarios locales definan sus propias exclusiones.

Descripción	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 la versión 100.83.73 de Defender para punto de conexión o posterior. También puede configurar exclusiones en exclusionSettings

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).

Descripción	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.

Descripción	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.

Descripción	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.

Descripción	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.

Descripción	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).

Descripción	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

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 la opción de ejecución.

Descripción	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 la versión 101.85.27 de Defender para punto de conexión o posterior.

Unmonitor filesystems

Configure los sistemas de archivos para que no se superen o excluyan de la protección en tiempo real (RTP). Los sistemas de archivos configurados se validan en la lista de sistemas de archivos permitidos de Microsoft Defender. Los sistemas de archivos solo se pueden supervisar después de una validación correcta. Estos sistemas de archivos no supervisados configurados todavía se examinan mediante exámenes rápidos, completos y personalizados en Microsoft Defender Antivirus.

Descripción	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:

Esta es la lista predeterminada de sistemas de archivos supervisados para RTP: btrfs, , ecryptfs, ext2ext3, 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.

Descripción	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 la versión 101.85.27 de Defender para punto de conexión 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.

Descripción	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.

Descripción	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 la versión 100.83.73 de Defender para punto de conexión 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.

Descripción	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.

Descripción	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.

Descripción	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). Las opciones definidas por el administrador (admin_only) son las opciones de tipo de amenaza configuradas por la directiva de Defender para punto de conexión. Esta configuración se puede usar para impedir que los usuarios locales definan su propia configuración para distintos tipos de amenazas.

Descripción	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 la versión 100.83.73 de Defender para punto de conexión 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.

Descripción	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 la versión 101.04.76 de Defender para punto de conexión 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.

Descripción	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 la versión 101.04.76 de Defender para punto de conexión o posterior.

Preferencias de configuración de exclusión

Las preferencias de configuración de exlusiones están actualmente en versión preliminar.

Nota:

Las exclusiones globales están actualmente en versión preliminar pública y están disponibles en Defender para punto de conexión a partir de la versión 101.23092.0012 o posterior en los anillos Insiders Slow y Production.

La exclusionSettings sección del perfil de configuración se usa para configurar varias exclusiones para Microsoft Defender para punto de conexión para Linux.

Descripción	Valor JSON
Clave	exclusionSettings
Tipo de datos	Diccionario (preferencia anidada)
Comentarios	Consulte las secciones siguientes para obtener una descripción del contenido del diccionario.

Nota:

Las exclusiones de antivirus ya configuradas en (antivirusEngine) en JSON administrado seguirán funcionando tal y como están sin ningún impacto. Todas las exclusiones nuevas, incluidas las exclusiones antivirus, se pueden agregar en esta sección completamente nueva (exclusionSettings). Esta sección está fuera de la etiqueta (antivirusEngine) como su dedicada únicamente para configurar todos los tipos de exclusiones que vendrán en el futuro. También puede seguir usando (antivirusEngine) para configurar exclusiones de antivirus.

Combinar directiva

Especifica la directiva de combinación para exclusiones. Especifica si 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. Se aplica a las exclusiones de todos los ámbitos.

Descripción	Valor JSON
Clave	mergePolicy
Tipo de datos	Cadena
Posibles valores	merge (valor predeterminado) admin_only
Comentarios	Disponible en la versión de Defender para punto de conexión de septiembre de 2023 o posterior.

Exclusiones

Las entidades que deben excluirse se pueden especificar mediante rutas de acceso completas, extensiones o nombres de archivo. Cada entidad de exclusión, es decir, la ruta de acceso completa, la extensión o el nombre de archivo tiene un ámbito opcional que se puede especificar. Si no se especifica, el valor predeterminado del ámbito de esta sección es global. (Las exclusiones se especifican como una matriz de elementos, el administrador puede especificar tantos elementos como sea necesario, en cualquier orden).

Descripción	Valor JSON
Clave	Exclusiones
Tipo de datos	Diccionario (preferencia anidada)
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.

Descripción	Valor JSON
Clave	$type
Tipo de datos	Cadena
Posibles valores	excludedPath excludedFileExtension excludedFileName

Ámbitos de exclusión (opcional)

Especifica el conjunto de ámbitos de exlusiones del contenido excluido. Actualmente, los ámbitos admitidos son epp y global.

Si no se especifica nada en para una exclusión en exclusionSettings en la configuración administrada, global se considera ámbito.

Nota:

Las exclusiones de antivirus configuradas anteriormente en (antivirusEngine) en JSON administrado seguirán funcionando y su ámbito se considera (epp) ya que se agregaron como exclusiones antivirus.

Descripción	Valor JSON
Clave	ámbitos
Tipo de datos	Conjunto de cadenas
Posibles valores	Epp global

Nota:

Las exclusiones aplicadas anteriormente mediante (mdatp_managed.json) o mediante la CLI no se verán afectadas. El ámbito de esas exclusiones será (epp) ya que se agregaron en (antivirusEngine).

Ruta de acceso al contenido excluido

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

Descripción	Valor JSON
Clave	ruta de acceso
Tipo de datos	Cadena
Posibles valores	rutas de acceso válidas
Comentarios	Solo se aplica si $type se excluyePath. No se admite el carácter comodín si la exclusión tiene global como ámbito.

Tipo de ruta de acceso (archivo o directorio)

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

Nota:

La ruta de acceso del archivo ya debe existir si se agrega la exclusión de archivos con ámbito global.

Descripción	Valor JSON
Clave	isDirectory
Tipo de datos	Booleano
Posibles valores	false (predeterminado) true
Comentarios	Solo se aplica si $type se excluyePath. No se admite el carácter comodín si la exclusión tiene global como ámbito.

Extensión de archivo excluida del examen

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

Descripción	Valor JSON
Clave	extensión
Tipo de datos	Cadena
Posibles valores	extensiones de archivo válidas
Comentarios	Solo se aplica si $type es excludedFileExtension. No se admite si la exclusión tiene global como ámbito.

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).

Descripción	Valor JSON
Clave	name
Tipo de datos	Cadena
Posibles valores	cualquier cadena
Comentarios	Solo se aplica si $type es excludedFileName. El carácter comodín y el nombre del proceso no se admiten si la exclusión tiene global como ámbito, debe proporcionar la ruta de acceso completa.

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.

Descripción	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 la versión 101.23062.0010 de Defender para punto de conexión 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.

Descripción	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 la versión 101.23062.0010 de Defender para punto de conexión 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.

Descripción	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 la versión 101.23062.0010 de Defender para punto de conexión 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).

Descripción	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.

Descripción	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 para Microsoft Defender para punto de conexión en Linux.

Descripción	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.

Descripción	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 la versión 101.56.62 de Defender para punto de conexión 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.

Descripción	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:

Descripción	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)

En función del nivel de cumplimiento, las actualizaciones automáticas de inteligencia de seguridad se instalan de forma diferente. En el modo RTP, las actualizaciones se instalan periódicamente. En modo pasivo o a petición, las actualizaciones se instalan antes de cada examen.

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.

Descripción	Valor JSON	Valor del portal de Defender
Clave	Funciones	No disponible
Tipo de datos	Diccionario (preferencia anidada)	n/a
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.

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

Configuraciones de sensor adicionales

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

Descripción	Valor JSON	Valor del portal de Defender
Clave	supplementarySensorConfigurations	No disponible
Tipo de datos	Diccionario (preferencia anidada)	n/a
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.

Descripción	Valor JSON	Valor del portal de Defender
Clave	enableFilePermissionEvents	No disponible
Tipo de datos	Cadena	n/a
Posibles valores	disabled (valor predeterminado) habilitado	n/a
Comentarios	Disponible en la versión 101.23062.0010 de Defender para punto de conexión 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.

Descripción	Valor JSON	Valor del portal de Defender
Clave	enableFileOwnershipEvents	No disponible
Tipo de datos	Cadena	n/a
Posibles valores	disabled (valor predeterminado) habilitado	n/a
Comentarios	Disponible en la versión 101.23062.0010 de Defender para punto de conexión 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.

Descripción	Valor JSON	Valor del portal de Defender
Clave	enableRawSocketEvent	No disponible
Tipo de datos	Cadena	n/a
Posibles valores	disabled (valor predeterminado) habilitado	n/a
Comentarios	Disponible en la versión 101.23062.0010 de Defender para punto de conexión 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.

Descripción	Valor JSON	Valor del portal de Defender
Clave	enableBootLoaderCalls	No disponible
Tipo de datos	Cadena	n/a
Posibles valores	disabled (valor predeterminado) habilitado	n/a
Comentarios	Disponible en la versión 101.68.80 de Defender para punto de conexión 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.

Descripción	Valor JSON	Valor del portal de Defender
Clave	enableProcessCalls	No disponible
Tipo de datos	Cadena	n/a
Posibles valores	disabled (valor predeterminado) habilitado	n/a
Comentarios	Disponible en la versión 101.68.80 de Defender para punto de conexión 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.

Descripción	Valor JSON	Valor del portal de Defender
Clave	enablePseudofsCalls	No disponible
Tipo de datos	Cadena	n/a
Posibles valores	disabled (valor predeterminado) habilitado	n/a
Comentarios	Disponible en la versión 101.68.80 de Defender para punto de conexión 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.

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

Notificar eventos sospechosos de AV a EDR

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

Descripción	Valor JSON	Valor del portal de Defender
Clave	sendLowfiEvents	No disponible
Tipo de datos	Cadena	n/a
Posibles valores	disabled (valor predeterminado) habilitado	n/a
Comentarios	Disponible en la versión 101.23062.0010 de Defender para punto de conexión 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.

Descripción	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

Descripción	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.

Descripción	Valor JSON	Valor del portal de Defender
Clave	disableIcmpInspection	No disponible
Tipo de datos	Booleano	n/a
Posibles valores	true (valor predeterminado) false	n/a
Comentarios	Disponible en la versión 101.23062.0010 de Defender para punto de conexión 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:

• Habilita la protección en tiempo real (RTP)
• Especifica 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.
• Habilita las actualizaciones automáticas de inteligencia de seguridad
• Habilita la protección entregada en la nube
• Habilita el 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 todas las Microsoft Defender para punto de conexión comunicación con solo una configuración de proxy en este JSON.

Perfil completo

{
"antivirusEngine":{
      "enforcementLevel":"passive",
      "behaviorMonitoring": "disabled",
      "scanAfterDefinitionUpdate":true,
      "scanArchives":true,
      "scanHistoryMaximumItems": 10000,
      "scanResultsRetentionDays": 90,
      "maximumOnDemandScanThreads":2,
      "exclusionsMergePolicy":"merge",
      "allowedThreats":[
         "<EXAMPLE DO NOT USE>EICAR-Test-File (not a virus)"
      ],
      "disallowedThreatActions":[
         "allow",
         "restore"
      ],
      "nonExecMountPolicy":"unmute",
      "unmonitoredFilesystems": ["nfs,fuse"],
      "enableFileHashComputation": false,
      "threatTypeSettingsMergePolicy":"merge",
      "threatTypeSettings":[
         {
            "key":"potentially_unwanted_application",
            "value":"block"
         },
         {
            "key":"archive_bomb",
            "value":"audit"
         }
      ],
      "scanFileModifyPermissions":false,
      "scanFileModifyOwnership":false,
      "scanNetworkSocketEvent":false,
      "offlineDefinitionUpdateUrl": "http://172.22.199.67:8000/linux/production/<EXAMPLE DO NOT USE>",
      "offlineDefintionUpdateFallbackToCloud":false,
      "offlineDefinitionUpdate":"disabled"
   },
   "cloudService":{
      "enabled":true,
      "diagnosticLevel":"optional",
      "automaticSampleSubmissionConsent":"safe",
      "automaticDefinitionUpdateEnabled":true,
      "proxy": "<EXAMPLE DO NOT USE> http://proxy.server:port/",
      "definitionUpdatesInterval":28800
   },
   "features":{
      "moduleLoad":"disabled",
      "supplementarySensorConfigurations":{
        "enableFilePermissionEvents":"disabled",
        "enableFileOwnershipEvents":"disabled",
        "enableRawSocketEvent":"disabled",
        "enableBootLoaderCalls":"disabled",
        "enableProcessCalls":"disabled",
        "enablePseudofsCalls":"diabled",
        "enableEbpfModuleLoadEvents":"disabled",
        "sendLowfiEvents":"disabled"
      },
      "ebpfSupplementaryEventProvider":"enabled",
      "offlineDefinitionUpdateVerifySig": "disabled"
   },
   "networkProtection":{
      "enforcementLevel":"disabled",
      "disableIcmpInspection":true
   },
   "edr":{
      "groupIds":"GroupIdExample",
      "tags": [
         {
         "key": "GROUP",
         "value": "Tag"
         }
       ]
   },
"exclusionSettings":{
  "exclusions":[
     {
        "$type":"excludedPath",
        "isDirectory":true,
        "path":"/home/*/git<EXAMPLE DO NOT USE>",
        "scopes": [
              "epp"
        ]
     },
     {
        "$type":"excludedPath",
        "isDirectory":true,
        "path":"/run<EXAMPLE DO NOT USE>",
        "scopes": [
              "global"
        ]
     },
     {
        "$type":"excludedPath",
        "isDirectory":false,
        "path":"/var/log/system.log<EXAMPLE DO NOT USE><EXCLUDED IN ALL SCENARIOS>",
        "scopes": [
              "epp", "global"
        ]
     },
     {
        "$type":"excludedFileExtension",
        "extension":".pdf<EXAMPLE DO NOT USE>",
        "scopes": [
              "epp"
        ]
     },
     {
        "$type":"excludedFileName",
        "name":"/bin/cat<EXAMPLE DO NOT USE><NO SCOPE PROVIDED - GLOBAL CONSIDERED>"
     }
  ],
  "mergePolicy":"admin_only"
}
}

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:

• cloud-diagnostic
• 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 /etc/opt/microsoft/mdatp/managed/mdatp_managed.json archivo.

Sugerencia

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