Развертывание Microsoft Defender для конечной точки на Linux с помощью SaltStack

Применяется к: Microsoft Defender for Endpoint Plan 1, Microsoft Defender for Endpoint Plan 2

Вы можете развернуть Defender для конечной точки на Linux с помощью различных средств и методов. В этой статье описывается развертывание Defender для конечной точки на Linux с помощью SaltStack. Для успешного развертывания необходимо выполнить все действия, описанные в этой статье. (Чтобы использовать другой метод, см. раздел Связанное содержимое.)

Важно!

Если вы хотите параллельно запустить несколько решений безопасности, см. раздел Рекомендации по производительности, конфигурации и поддержке.

Возможно, вы уже настроили взаимные исключения безопасности для устройств, подключенных к Microsoft Defender для конечной точки. Если вам по-прежнему нужно настроить взаимные исключения, чтобы избежать конфликтов, см. раздел Добавление Microsoft Defender для конечной точки в список исключений для существующего решения.

Важно!

Эта статья содержит сведения о сторонних средствах. Это предоставляется для выполнения сценариев интеграции, однако корпорация Майкрософт не предоставляет поддержку по устранению неполадок для сторонних средств.
Обратитесь за поддержкой к стороннему поставщику.

Предварительные требования и требования к системе

Прежде чем приступить к работе, ознакомьтесь с разделом Предварительные требования для Defender для конечной точки на Linux, чтобы узнать о предварительных требованиях и требования к системе.

Кроме того, для развертывания SaltStack необходимо быть знакомым с администрированием SaltStack, установить SaltStack, настроить master и minions и знать, как применять состояния. SaltStack имеет множество способов выполнения одной и той же задачи. В этих инструкциях предполагается наличие поддерживаемых модулей SaltStack, таких как apt и unarchive для развертывания пакета. Ваша организация может использовать другой рабочий процесс. Дополнительные сведения см. в документации по SaltStack.

Вот несколько важных моментов:

SaltStack устанавливается по крайней мере на одном компьютере (SaltStack вызывает компьютер в качестве master).
Master SaltStack принял подключения управляемых узлов (SaltStack вызывает узлы в качестве миньонов).
Миньоны SaltStack могут разрешать связь с master SaltStack (по умолчанию миньоны пытаются связаться с компьютером с именем salt).
Выполните следующий тест проверки ping: sudo salt '*' test.ping
Master SaltStack имеет расположение файлового сервера, из которого можно распространять файлы Microsoft Defender для конечной точки (по умолчанию SaltStack использует папку /srv/salt в качестве точки распространения по умолчанию).

Скачивание пакета подключения

Предупреждение

Переупаковка пакета установки Defender для конечной точки не поддерживается. Это может негативно повлиять на целостность продукта и привести к неблагоприятным результатам, включая, помимо прочего, активацию оповещений и обновлений о незаконном изменении.

Войдите на портал Microsoft Defender, а затем перейдите в разделПараметры>системы>Конечные> точкиУправление устройствами>Подключение.
В первом раскрывающемся меню выберите Linux Server в качестве операционной системы. Во втором раскрывающемся меню выберите предпочитаемое средство управления конфигурацией Linux в качестве метода развертывания.
Выберите Скачать пакет подключения и сохраните файл как WindowsDefenderATPOnboardingPackage.zip.
Извлеките содержимое архива с помощью следующей команды:
```
unzip WindowsDefenderATPOnboardingPackage.zip
```
Ожидаемый результат:
```
Archive:  WindowsDefenderATPOnboardingPackage.zip
inflating: mdatp_onboard.json
```

Создание файлов состояний SaltStack

Создать файлы состояний SaltStack можно двумя способами:

Используйте скрипт установщика (рекомендуется): С помощью этого метода скрипт автоматизирует развертывание путем установки агента, подключения устройства к порталу Microsoft Defender и настройки репозиториев для выбора правильного агента, совместимого с дистрибутивом Linux.
Настройте репозитории вручную: При использовании этого метода репозитории необходимо настроить вручную, а также выбрать версию агента, совместимую с дистрибутивом Linux. Этот метод обеспечивает более детальный контроль над процессом развертывания.

Создание файлов состояния SaltStack с помощью скрипта установщика

Извлеките скрипт bash установщика из репозитория Microsoft GitHub или скачайте его с помощью следующей команды:
```
wget https://raw.githubusercontent.com/microsoft/mdatp-xplat/refs/heads/master/linux/installation/mde_installer.sh /srv/salt/mde/
```

Создайте файл /srv/salt/install_mdatp.sls состояния со следующим содержимым. То же самое можно скачать с сайта GitHub.

#Download the mde_installer.sh: https://github.com/microsoft/mdatp-xplat/blob/master/linux/installation/mde_installer.sh
 install_mdatp_package:
   cmd.run:
     - name: /srv/salt/mde/mde_installer.sh --install --onboard /srv/salt/mde/mdatp_onboard.json
     - shell: /bin/bash
     - unless: 'pgrep -f mde_installer.sh'

Примечание.

Скрипт установщика также поддерживает другие параметры, такие как канал (insiders-fast, insiders-slow, prod (по умолчанию)), защита в режиме реального времени, версия, установка пользовательского расположения и т. д. Чтобы выбрать из списка доступных параметров, проверка справку с помощью следующей команды:./mde_installer.sh --help

Создание файлов состояния SaltStack путем настройки репозиториев вручную

На этом шаге вы создадите файл состояния SaltState в репозитории конфигурации (как правило, /srv/salt), который применяет необходимые состояния для развертывания и подключения Defender для конечной точки. Затем добавьте репозиторий Defender для конечной точки и ключ: install_mdatp.sls.

Примечание.

Defender для конечной точки на Linux можно развернуть из одного из следующих каналов:

insiders-fast, обозначается как [channel]
insiders - медленный, обозначается как [channel]
prod, обозначается как [channel] имя версии (см. Linux репозиторий программного обеспечения для продуктов Майкрософт)

Каждый канал соответствует репозиторию программного обеспечения Linux. Выбор канала определяет тип и частоту обновлений, предлагаемых вашему устройству. Устройства в программе предварительной оценки являются первыми, кто получает обновления и новые функции, за которыми следуют инсайдеры медленно, и, наконец, prod.

Для предварительного просмотра новых функций и предоставления ранних отзывов рекомендуется настроить некоторые устройства в организации для использования программы предварительной оценки быстрой или медленной для участников программы предварительной оценки.

Предупреждение

Переключение канала после начальной установки требует переустановки продукта. Чтобы переключить канал продукта, удалите существующий пакет, перенастройте устройство для использования нового канала и выполните действия, описанные в этом документе, чтобы установить пакет из нового расположения.

Запишите дистрибутив и версию и определите ближайшие для него записи в разделе https://packages.microsoft.com/config/[distro]/.

В следующих командах замените [distro] и [version] своими сведениями.

Примечание.

Для Oracle Linux и Amazon Linux 2 замените [distro] на "rhel". Для Amazon Linux 2 замените [version] на "7". Для использования Oracle замените [version] версией Oracle Linux.

cat /srv/salt/install_mdatp.sls

add_ms_repo:
  pkgrepo.managed:
    - humanname: Microsoft Defender Repository
    {% if grains['os_family'] == 'Debian' %}
    - name: deb [arch=amd64,armhf,arm64] https://packages.microsoft.com/[distro]/[version]/[channel] [codename] main
    - dist: [codename]
    - file: /etc/apt/sources.list.d/microsoft-[channel].list
    - key_url: https://packages.microsoft.com/keys/microsoft.asc
    - refresh: true
    {% elif grains['os_family'] == 'RedHat' %}
    - name: packages-microsoft-[channel]
    - file: microsoft-[channel]
    - baseurl: https://packages.microsoft.com/[distro]/[version]/[channel]/
    - gpgkey: https://packages.microsoft.com/keys/microsoft.asc
    - gpgcheck: true
    {% endif %}

Добавьте установленное состояние install_mdatp.sls пакета в после состояния, определенного add_ms_repo ранее.
```
install_mdatp_package:
  pkg.installed:
    - name: mdatp
    - required: add_ms_repo
```

Добавьте развертывание файла подключения в после install_mdatp.slsinstall_mdatp_package , как определено ранее.

copy_mde_onboarding_file:
  file.managed:
    - name: /etc/opt/microsoft/mdatp/mdatp_onboard.json
    - source: salt://mde/mdatp_onboard.json
    - required: install_mdatp_package

Файл состояния завершенной установки должен выглядеть примерно так:

add_ms_repo:
pkgrepo.managed:
- humanname: Microsoft Defender Repository
{% if grains['os_family'] == 'Debian' %}
- name: deb [arch=amd64,armhf,arm64] https://packages.microsoft.com/[distro]/[version]/prod [codename] main
- dist: [codename]
- file: /etc/apt/sources.list.d/microsoft-[channel].list
- key_url: https://packages.microsoft.com/keys/microsoft.asc
- refresh: true
{% elif grains['os_family'] == 'RedHat' %}
- name: packages-microsoft-[channel]
- file: microsoft-[channel]
- baseurl: https://packages.microsoft.com/[distro]/[version]/[channel]/
- gpgkey: https://packages.microsoft.com/keys/microsoft.asc
- gpgcheck: true
{% endif %}

install_mdatp_package:
pkg.installed:
- name: mdatp
- required: add_ms_repo

copy_mde_onboarding_file:
file.managed:
- name: /etc/opt/microsoft/mdatp/mdatp_onboard.json
- source: salt://mde/mdatp_onboard.json
- required: install_mdatp_package

Создайте файл состояния SaltState в репозитории конфигурации (как правило, /srv/salt), который применяет необходимые состояния для отключения и удаления Defender для конечной точки. Перед использованием файла состояния отключения необходимо скачать пакет offboarding с портала Microsoft Defender и извлечь его так же, как и пакет подключения. Скачанный пакет отключения действителен только в течение ограниченного периода времени.
Создайте файл uninstall_mdapt.sls состояния удаления и добавьте состояние для удаления mdatp_onboard.json файла.
```
cat /srv/salt/uninstall_mdatp.sls
```
```
remove_mde_onboarding_file:
  file.absent:
    - name: /etc/opt/microsoft/mdatp/mdatp_onboard.json
```
Добавьте развертывание файла offboarding в uninstall_mdatp.sls файл после состояния, remove_mde_onboarding_file определенного в предыдущем разделе.
```
 offboard_mde:
  file.managed:
    - name: /etc/opt/microsoft/mdatp/mdatp_offboard.json
    - source: salt://mde/mdatp_offboard.json
```

Добавьте удаление пакета MDATP в uninstall_mdatp.sls файл после состояния, offboard_mde определенного в предыдущем разделе.

remove_mde_packages:
  pkg.removed:
    - name: mdatp

Файл состояния полного удаления должен выглядеть примерно так:

remove_mde_onboarding_file:
  file.absent:
    - name: /etc/opt/microsoft/mdatp/mdatp_onboard.json

offboard_mde:
  file.managed:
    - name: /etc/opt/microsoft/mdatp/mdatp_offboard.json
    - source: salt://mde/offboard/mdatp_offboard.json

remove_mde_packages:
   pkg.removed:
     - name: mdatp

Развертывание Defender в конечной точке с помощью файлов состояний, созданных ранее

Этот шаг применяется как к скрипту установщика, так и к методу настройки вручную. На этом шаге вы примените состояние к миньонам. Следующая команда применяет состояние к компьютерам с именем, начинающимся с mdetest.

Установки:
```
salt 'mdetest*' state.apply install_mdatp
```
Важно!

Когда продукт запускается в первый раз, он загружает последние определения защиты от вредоносных программ. В зависимости от подключения к Интернету этот процесс может занять несколько минут.

Проверка и настройка.

salt 'mdetest*' cmd.run 'mdatp connectivity test'

salt 'mdetest*' cmd.run 'mdatp health'

Удаления:

salt 'mdetest*' state.apply uninstall_mdatp

Устранение неполадок при установке

Чтобы устранить неполадки, выполните приведенные ниже действия.

Сведения о том, как найти журнал, который создается автоматически при возникновении ошибки установки, см. в разделе Проблемы с установкой журнала.
Сведения о распространенных проблемах с установкой см. в разделе Проблемы с установкой.
Если работоспособность устройства — false, см. статью Проблемы работоспособности агента Defender для конечной точки.
Сведения о проблемах с производительностью продукта см. в статье Устранение проблем с производительностью.
Сведения о проблемах с прокси-сервером и подключением см. в статье Устранение неполадок с подключением к облаку.

Чтобы получить поддержку от Корпорации Майкрософт, откройте запрос в службу поддержки и предоставьте файлы журнала, созданные с помощью анализатора клиента.

Настройка политик для Microsoft Defender в Linux

Вы можете настроить параметры антивирусной программы или EDR на конечных точках с помощью любого из следующих методов:

См. раздел Настройка параметров для Microsoft Defender для конечной точки в Linux.
Сведения о настройке параметров на портале Microsoft Defender см. в разделе Управление параметрами безопасности.

Обновления операционной системы

При обновлении операционной системы до новой основной версии необходимо сначала удалить Defender для конечной точки на Linux, установить обновление и, наконец, перенастроить Defender для конечной точки на Linux устройстве.

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2026-05-21

Развертывание Microsoft Defender для конечной точки на Linux с помощью SaltStack

Предварительные требования и требования к системе

Скачивание пакета подключения

Создание файлов состояний SaltStack

Создание файлов состояния SaltStack с помощью скрипта установщика

Создание файлов состояния SaltStack путем настройки репозиториев вручную

Развертывание Defender в конечной точке с помощью файлов состояний, созданных ранее

Устранение неполадок при установке

Настройка политик для Microsoft Defender в Linux

Обновления операционной системы

Связанные материалы

Обратная связь

Дополнительные ресурсы