Végponthoz készült Microsoft Defender üzembe helyezése Linux a Puppet használatával

A következőre érvényes:: Microsoft Defender for Endpoint Plan 1, Microsoft Defender for Endpoint Plan 2

A Végponthoz készült Defendert többféle eszközzel és módszerrel helyezheti üzembe Linux. Ez a cikk azt ismerteti, hogyan helyezheti üzembe a Végponthoz készült Defendert Linux a Puppet használatával. Ha másik módszert szeretne használni, tekintse meg a Kapcsolódó tartalom szakaszt.

Fontos

Ha több biztonsági megoldást szeretne egymás mellett futtatni, tekintse meg a teljesítménnyel, konfigurációval és támogatással kapcsolatos szempontokat ismertető cikket.

Előfordulhat, hogy már konfigurálta a kölcsönös biztonsági kizárásokat a Végponthoz készült Microsoft Defender előkészített eszközökhöz. Ha továbbra is kölcsönös kizárásokat kell beállítania az ütközések elkerülése érdekében, tekintse meg az Végponthoz készült Microsoft Defender hozzáadása a meglévő megoldás kizárási listájához című témakört.

Fontos

Ez a cikk harmadik féltől származó eszközökkel kapcsolatos információkat tartalmaz. Ez segít az integrációs forgatókönyvek teljesítésében, a Microsoft azonban nem nyújt hibaelhárítási támogatást külső eszközökhöz.
Támogatásért forduljon a külső gyártóhoz.

Előfeltételek és rendszerkövetelmények

A kezdés előtt tekintse meg a Végponthoz készült Defender előfeltételei Linux című cikket az előfeltételek és a rendszerkövetelmények leírásáért.

Emellett a Puppet üzembe helyezéséhez ismernie kell a Puppet felügyeleti feladatait, konfigurálnia kell a Puppetet, és ismernie kell a csomagok üzembe helyezésének módját. A Puppetnek számos módja van arra, hogy ugyanazt a feladatot elvégezze. Ezek az utasítások feltételezik a támogatott Puppet-modulok rendelkezésre állását, például az apt-t a csomag üzembe helyezéséhez. Előfordulhat, hogy a szervezet más munkafolyamatot használ. További információt a Puppet dokumentációjában talál.

Az előkészítési csomag letöltése

Töltse le az előkészítési csomagot Microsoft Defender portálról.

Figyelmeztetés

A Végponthoz készült Defender telepítőcsomag újracsomagolása nem támogatott forgatókönyv. Ez negatív hatással lehet a termék integritására, és kedvezőtlen eredményekhez vezethet, beleértve, de nem kizárólagosan az illetéktelen módosítási riasztások aktiválását és a frissítések alkalmazásának sikertelenségét.

Jelentkezzen be a Microsoft Defender portálra, majd lépjen aRendszerbeállítások>>végpontok>Eszközkezelés>Előkészítés területre.
Az első legördülő menüben válassza a Linux Server elemet operációs rendszerként. A második legördülő menüben válassza az Előnyben részesített Linux konfigurációkezelő eszközt telepítési módszerként.
Válassza az Előkészítési csomag letöltése lehetőséget, és mentse a fájlt a következő formátumban WindowsDefenderATPOnboardingPackage.zip: .

Bontsa ki az archívum tartalmát a következő paranccsal:

unzip WindowsDefenderATPOnboardingPackage.zip

A várt kimenet a következő:

Archive:  WindowsDefenderATPOnboardingPackage.zip
inflating: mdatp_onboard.json

Címtárstruktúra létrehozása

Létre kell hoznia egy könyvtárstruktúrát, amellyel üzembe helyezheti a Végponthoz készült Defendert a Linux a Puppet-kiszolgáló által felügyelt eszközökön. Ez a példa a és a modult apthasználja, yumrepopuppetlabs és feltételezi, hogy a modulok telepítve vannak a Puppet-kiszolgálón.

A Puppet telepítése esetén a modulok mappájában hozza létre a és install_mdatp/filesa mappátinstall_mdatp/manifests. A modulok mappája általában a Puppet-kiszolgálón található /etc/puppetlabs/code/environments/production/modules .
Másolja a mdatp_onboard.json korábban létrehozott fájlt a install_mdatp/files mappába.

Hozzon létre egy init.pp fájlt, amely tartalmazza az üzembehelyezési utasításokat:

pwd

/etc/puppetlabs/code/environments/production/modules

tree install_mdatp

install_mdatp
├── files
│   └── mdatp_onboard.json
└── manifests
    └── init.pp

Puppet-jegyzék létrehozása

A jegyzékfájl kétféleképpen hozható létre:

Használjon telepítőszkriptet; Vagy
Konfigurálja manuálisan az adattárakat.

Jegyzékfájl létrehozása a Végponthoz készült Defender üzembe helyezéséhez telepítőszkript használatával

Töltse le a telepítő bash szkriptet. Kérje le a telepítő bash szkriptet a Microsoft GitHub-adattárból, vagy töltse le a következő paranccsal.

wget https://raw.githubusercontent.com/microsoft/mdatp-xplat/refs/heads/master/linux/installation/mde_installer.sh /etc/puppetlabs/code/environments/production/modules/install_mdatp/files/

Adja hozzá az alábbi tartalmat a install_mdatp/manifests/init.pp fájlhoz. A fájlt közvetlenül a GitHubról is letöltheti


# Puppet manifest to install Microsoft Defender for Endpoint on Linux.
# @param channel The release channel based on your environment, insider-fast or prod.

class install_mdatp (
  $channel = 'prod',
) {
  # Ensure that the directory /tmp/mde_install exists
  file { '/tmp/mde_install':
    ensure => directory,
    mode   => '0755',
  }

  # Copy the installation script to the destination
  file { '/tmp/mde_install/mde_installer.sh':
    ensure => file,
    source => 'puppet:///modules/install_mdatp/mde_installer.sh',
    mode   => '0777',
  }

  # Copy the onboarding script to the destination
  file { '/tmp/mde_install/mdatp_onboard.json':
    ensure => file,
    source => 'puppet:///modules/install_mdatp/mdatp_onboard.json',
    mode   => '0777',
  }

  # Install MDE on the host using an external script
  exec { 'install_mde':
    command     => "/tmp/mde_install/mde_installer.sh --install --channel ${channel} --onboard /tmp/mde_install/mdatp_onboard.json",
    path        => '/bin:/usr/bin',
    user        => 'root',
    logoutput   => true,
    require     => File['/tmp/mde_install/mde_installer.sh', '/tmp/mde_install/mdatp_onboard.json'], # Ensure the script is copied before running the installer
  }

}

Megjegyzés:

A telepítőszkript más paramétereket is támogat, például a csatornát, a valós idejű védelmet, a verziót, az egyéni helytelepítést stb. Az elérhető lehetőségek listájából való választáshoz tekintse meg a súgót: ./mde_installer.sh --help

Jegyzékfájl létrehozása a Végponthoz készült Defender üzembe helyezéséhez az adattárak manuális konfigurálásával

Adja hozzá az alábbi tartalmat a install_mdatp/manifests/init.pp fájlhoz. A GitHubról is letöltheti.

# Puppet manifest to install Microsoft Defender for Endpoint on Linux.
# @param channel The release channel based on your environment, insider-fast or prod.

class install_mdatp::configure_debian_repo (
  String $channel,
  String $distro,
  String $version ) {
  # Configure the APT repository for Debian-based systems

  $release = $channel ? {
    'prod'  => $facts['os']['distro']['codename'],
    default => $channel
    }
  
  apt::source { 'microsoftpackages':
    location => "https://packages.microsoft.com/${distro}/${version}/prod",
    release  => $release,
    repos    => 'main',
    key      => {
      'id'     => 'BC528686B50D79E339D3721CEB3E94ADBE1229CF',
      'server' => 'keyserver.ubuntu.com',
    },
  }
}

class install_mdatp::configure_redhat_repo (
  String $channel,
  String $distro,
  String $version) {
  # Configure the Yum repository for RedHat-based systems
  
  yumrepo { 'microsoftpackages':
    baseurl  => "https://packages.microsoft.com/rhel/${version}/prod",
    descr    => 'packages-microsoft-com-prod',
    enabled  => 1,
    gpgcheck => 1,
    gpgkey   => 'https://packages.microsoft.com/keys/microsoft.asc',
  }
}

class install_mdatp::install {
  # Common configurations for both Debian and RedHat
  
  file { ['/etc/opt', '/etc/opt/microsoft', '/etc/opt/microsoft/mdatp']:
    ensure  => directory,
    owner   => 'root',
    group   => 'root',
    mode    => '0755',
  }

  file { '/etc/opt/microsoft/mdatp/mdatp_onboard.json':
    source  => 'puppet:///modules/install_mdatp/mdatp_onboard.json',
    owner   => 'root',
    group   => 'root',
    mode    => '0600',
    require => File['/etc/opt/microsoft/mdatp'],
  }

  # Install mdatp package
  package { 'mdatp':
    ensure  => installed,
    require => [
      File['/etc/opt/microsoft/mdatp/mdatp_onboard.json'],
    ],
  }
}


class install_mdatp (
  $channel = 'prod'
) {
  # Include the appropriate class based on the OS family
  
  $distro = downcase($facts['os']['name'])
  $version = $facts['os']['release']['major']
  
  case $facts['os']['family'] {
    'Debian': {
      class { 'install_mdatp::configure_debian_repo':
        channel => 'prod',
        distro => $distro,
        version => $version
        } -> class { 'install_mdatp::install': }
    }
    'RedHat': {
      class { 'install_mdatp::configure_redhat_repo':
        channel => 'prod',
        distro => $distro,
        version => $version,
        } -> class { 'install_mdatp::install': }
    }
    default: { fail("${facts['os']['family']} is currently not supported.")}
  }
}

Megjegyzés:

A végponthoz készült Defender a Linux a következő csatornák egyikéről telepíthető: insiders-fast, insiders-slow, prod. Minden csatorna egy Linux szoftveradattárnak felel meg. A csatorna kiválasztása határozza meg az eszköz számára kínált frissítések típusát és gyakoriságát. A-ben insiders-fast lévő eszközök az elsők, amelyek előzetes verzióban kapják meg a frissítéseket és az új funkciókat, majd a insiders-slowés végül a prodelemet. Jegyezze fel a disztribúciót és a verziót, és azonosítsa a legközelebbi bejegyzést a alatt https://packages.microsoft.com/config/[distro]/[version].

Figyelmeztetés

Ha a kezdeti telepítés után vált a csatornára, újra kell telepíteni a terméket. A termékcsatorna váltása: távolítsa el a meglévő csomagot, konfigurálja újra az eszközt az új csatorna használatára, és a jelen dokumentumban leírt lépéseket követve telepítse a csomagot az új helyről.

A jegyzékfájl belefoglalása a site.pp fájlba

Adja meg a cikkben korábban ismertetett jegyzékfájlt a site.pp fájlban:

cat /etc/puppetlabs/code/environments/production/manifests/site.pp

node "default" {
    include install_mdatp
}

A regisztrált ügynökeszközök rendszeres időközönként lekérdezik a Puppet Servert, és amint észlelik őket, telepítsenek új konfigurációs profilokat és szabályzatokat.

A Puppet üzembe helyezésének monitorozása

Az ügynökeszközön a következő parancs futtatásával is ellenőrizheti az üzembe helyezés állapotát:

mdatp health

...
healthy                                 : true
health_issues                           : []
licensed                                : true
org_id                                  : "[your organization identifier]"
...

healthy: Győződjön meg arról, hogy a Végponthoz készült Defender üzembe helyezése és működtetése sikeresen megtörtént.
health_issues: Az állapot hamissá válását okozó problémákat ismerteti.
licensed: Megerősíti, hogy az eszköz a szervezethez van kötve.
orgId: A Végponthoz készült Defender szervezeti azonosítója.

A telepítési problémák elhárítása

Ha telepítési problémákat tapasztal, az önkiszolgáló hibaelhárításhoz kövesse az alábbi lépéseket:

A telepítési hiba esetén automatikusan generált napló megkereséséről a Naplótelepítési problémák című témakörben talál további információt.
További információ a gyakori telepítési problémákról: Telepítési problémák.
Ha az eszköz falseállapota , tekintse meg a Végponthoz készült Defender-ügynök állapotával kapcsolatos problémákat.
A termék teljesítményével kapcsolatos problémákért lásd: Teljesítményproblémák elhárítása.
A proxyval és a kapcsolattal kapcsolatos problémákért lásd: Felhőkapcsolati problémák elhárítása.

Ha támogatást szeretne kapni a Microsofttól, nyisson meg egy támogatási jegyet, és adja meg az ügyfélelemzővel létrehozott naplófájlokat.

Szabályzatok konfigurálása Microsoft Defender Linux

A víruskereső és az EDR beállításainak konfigurálásához tekintse meg a következő cikkeket:

A Végponthoz készült Defender biztonsági beállításainak kezelése ismerteti, hogyan konfigurálhatja a beállításokat a Microsoft Defender portálon. (Ez a módszer ajánlott.)
A Végponthoz készült Defender beállításainak megadása Linux a konfigurálható beállításokat ismerteti.

Operációs rendszer frissítései

Amikor az operációs rendszert egy új főverzióra frissíti, először el kell távolítania a Végponthoz készült Defendert Linux, telepítenie kell a frissítést, majd újra kell konfigurálnia a Végponthoz készült Defendert Linux az eszközön.

Uninstallation

Hozzon létre egy ehhez hasonló remove_mdatp modult install_mdatp a fájlban a init.pp következő tartalommal:

class remove_mdatp {
    package { 'mdatp':
        ensure => 'purged',
    }
}

Visszajelzés

Hasznosnak találta ezt az oldalt?

Last updated on 2026-05-23