通过 Chef 在 Linux 上部署 Defender for Endpoint

项目
12/21/2024

重要

本文包含有关第三方工具的信息。这样做是为了帮助完成集成方案，但是，Microsoft不提供对第三方工具的故障排除支持。
请联系第三方供应商获取支持。

适用于：

Microsoft Defender for Endpoint 服务器版
服务器的Microsoft Defender

简介

本文介绍如何使用两种方法通过 Chef 在 Linux 上大规模部署 Defender for Endpoint：

使用安装程序脚本安装
手动配置存储库以更精细地控制部署

先决条件

有关先决条件和系统要求的说明，请参阅 Linux 上的Microsoft Defender for Endpoint。

下载载入包

登录到Microsoft Defender门户，然后导航到“设置>终结点”“>设备管理>”“载入”。
在第一个下拉菜单中，选择“ Linux 服务器 ”作为操作系统。在第二个下拉菜单中，选择“ 首选 Linux 配置管理工具 ”作为部署方法。
选择 “下载载入包 ”，并将文件保存为 WindowsDefenderATPOnboardingPackage.zip。

使用以下命令提取存档的内容：

命令：

unzip WindowsDefenderATPOnboardingPackage.zip

预期输出为：

Archive:  WindowsDefenderATPOnboardingPackage.zip
inflating: mdatp_onboard.json

创建目录结构

在开始之前，请确保已安装 Chef 组件，并且 Chef 存储库 (chef 生成的存储库 <>) 存在，以存储用于部署到 Chef 托管 Linux 服务器上的 Defender for Endpoint 的指南。

以下命令为名为 mdatp 的新指南创建新的文件夹结构。如果已有一本要用于添加 Defender for Endpoint 部署的指南，也可以使用现有指南。

chef generate cookbook mdatp

创建食谱后，在创建的食谱文件夹中创建一个文件文件夹：

mkdir mdatp/files

复制到 mdatp_onboard.json/tmp 文件夹。

在 Chef 工作站上，导航到 mdatp/recipes 文件夹，该文件夹在生成食谱时自动创建。使用首选文本编辑器 (（如 vi 或 nano) ）将以下说明添加到 default.rb 文件的末尾，然后保存并关闭该文件：

include_recipe“：：install_mdatp”

创建食谱

可以通过以下任一方法创建指南：

使用安装程序脚本创建指南

下载安装程序 bash 脚本。从 Microsoft GitHub 存储库中拉取安装程序 bash 脚本，或使用以下命令下载该脚本：
```
wget https://raw.githubusercontent.com/microsoft/mdatp-xplat/refs/heads/master/linux/installation/mde_installer.sh /tmp
```

在 recipes 文件夹中~/cookbooks/mdatp/recipes/install_mdatp.rb创建名为 install_mdatp.rb 的新食谱文件，并将以下文本添加到该文件。也可以直接从 GitHub 下载文件。

mdatp = "/etc/opt/microsoft/mdatp"

#Download the onboarding json from tenant, keep the same at specific location
onboarding_json = "/tmp/mdatp_onboard.json"

#Download the installer script from: https://github.com/microsoft/mdatp-xplat/blob/master/linux/installation/mde_installer.sh
#Place the same at specific location, edit this if needed
mde_installer= "/tmp/mde_installer.sh"


## Invoke the mde-installer script 
bash 'Installing mdatp using mde-installer' do
    code <<-EOS
    chmod +x #{mde_installer}
    #{mde_installer} --install --onboard #{onboarding_json}
    EOS
end

注意

安装程序脚本还支持其他参数，例如通道、实时保护、版本等。若要从可用选项列表中选择，请通过以下命令检查帮助：./mde_installer.sh --help

通过手动配置存储库创建指南

在 recipes 文件夹中~/cookbooks/mdatp/recipes/install_mdatp.rb创建名为 install_mdatp.rb 的新食谱文件，并将以下文本添加到该文件。也可以直接从 Github 下载文件。

#Add Microsoft Defender
case node['platform_family']
when 'debian'
 apt_repository 'MDATPRepo' do
   arch               'amd64'
   cache_rebuild      true
   cookbook           false
   deb_src            false
   key                'BC528686B50D79E339D3721CEB3E94ADBE1229CF'
   keyserver          "keyserver.ubuntu.com"
   distribution       'jammy'
   repo_name          'microsoft-prod'
   components         ['main']
   uri                "https://packages.microsoft.com/ubuntu/22.04/prod"
 end
apt_package "mdatp"
when 'rhel'
 yum_repository 'microsoft-prod' do
   baseurl            "https://packages.microsoft.com/rhel/7/prod/"
   description        "Microsoft Defender for Endpoint"
   enabled            true
   gpgcheck           true
   gpgkey             "https://packages.microsoft.com/keys/microsoft.asc"
 end
 if node['platform_version'] <= 8 then
    yum_package "mdatp"
 else
    dnf_package "mdatp"
 end
end

#Create MDATP Directory
mdatp = "/etc/opt/microsoft/mdatp"
onboarding_json = "/tmp/mdatp_onboard.json"

directory "#{mdatp}" do
  owner 'root'
  group 'root'
  mode 0755
  recursive true
end

#Onboarding using tenant json 
file "#{mdatp}/mdatp_onboard.json" do
  content lazy { ::File.open(onboarding_json).read }
  owner 'root'
  group 'root'
  mode '0644'
  action :create_if_missing
end

注意

可以修改 os 分发、分发版本号、频道 (prod/insider-fast、insiders-slow) 和存储库名称，以匹配要部署到的版本和要部署到的通道。运行 chef-client --local-mode --runlist 'recipe[mdatp]' 以在 Chef 工作站上测试食谱。

解决安装问题

若要排查问题，请：

有关如何查找发生安装错误时自动生成的日志的信息，请参阅日志安装问题。
有关常见安装问题的信息，请参阅安装问题。
如果设备的运行状况为 false，请参阅 Defender for Endpoint 代理运行状况问题。
有关产品性能问题，请参阅排查性能问题。
有关代理和连接问题，请参阅排查云连接问题。

若要从Microsoft获取支持，请打开支持票证，并使用客户端分析器提供创建的日志文件。

如何在 Linux 上为Microsoft Defender配置策略

可以使用以下任一方法在终结点上配置防病毒或 EDR 设置：

请参阅在 Linux 上设置Microsoft Defender for Endpoint首选项。
请参阅安全设置管理以在 Microsoft Defender 门户中配置设置。

卸载 MDATP 指南

若要卸载 Defender，请将以下内容保存为食谱 ~/cookbooks/mdatp/recipes/uninstall_mdatp.rb。

#Uninstall the Defender package
case node['platform_family']
when 'debian'
 apt_package "mdatp" do
   action :remove
 end
when 'rhel'
 if node['platform_version'] <= 8
then
    yum_package "mdatp" do
      action :remove
    end
 else
    dnf_package "mdatp" do
      action :remove
    end
 end
end

若要将此步骤作为食谱的一部分包含在食谱中，请将添加到 include_recipe ':: uninstall_mdatpdefault.rb recipe 文件夹中的文件中。确保已从default.rb文件中删除。include_recipe '::install_mdatp'

提示

想要了解更多信息？ Engage技术社区中的Microsoft安全社区：Microsoft Defender for Endpoint技术社区。

通过