Skip to Content

Endpoint-agent

Installeer, werk bij en verwijder de endpoint-agent op Windows, macOS en Linux, en lees wat deze van het apparaat meldt.

RequiresDevice Identity (DIAM)

Add-on vereist: De endpoint-agent maakt deel uit van de add-on DIAM (Device Identity).

De endpoint-agent is de software die u op elk endpoint installeert. Hij registreert de machine, meldt de beveiligingsstatus ervan volgens een schema en voert de acties op afstand uit die u vanuit de console start. Zonder hem kan een apparaat niet in de inventaris verschijnen. Apparaten die met de vorige Windows-client zijn geregistreerd, blijven werken; zie Legacy client voor wat er verschilt en hoe u ze overzet.

Ondersteunde platforms

PlatformOndersteund vanaf
WindowsWindows 11 en Windows Server 2019, x64
macOSmacOS 12 Monterey, Intel en Apple silicon
LinuxDebian 11, Ubuntu 22.04 en Red Hat Enterprise Linux 9 (inclusief Rocky en Alma), x64 en ARM64, met systemd

Oudere versies worden niet ondersteund. Heeft de machine een TPM 2.0 (Windows, Linux) of een Secure Enclave (Apple silicon, Macs met een T2-chip), dan bewaart de agent zijn apparaatsleutel daarin; anders gebruikt hij een sleutel die op schijf is opgeslagen.

Wat er wordt geïnstalleerd

PlatformPakketWat er draait
Windows.msiDe service DTS Endpoint Agent (DTSAgent), geïnstalleerd onder %ProgramFiles%\DTS\Agent en gestart bij het opstarten. Het agentvenster start bij elke aanmelding van een gebruiker.
macOS.pkgEen systeemdaemon onder /Library/DTS/Agent en de app DTS Endpoint Agent in de menubalk van elke gebruikerssessie.
Linux.deb, .rpmDe service dts-agent.service en een statuspictogram in bureaubladsessies. Servers zonder bureaublad draaien alleen de service.

De agent bewaart zijn toestand, inclusief zijn apparaatidentiteit, in %ProgramData%\DTS\Agent (Windows), /Library/Application Support/DTS/Agent (macOS) of /var/lib/dts-agent (Linux), zodat een upgrade ter plaatse de machine niet opnieuw registreert. Zijn logbestanden staan daar in de map logs en worden zeven dagen bewaard.

Vereisten

  • Beheerders- of rootrechten om te installeren, omdat het pakket een systeemservice registreert.
  • Uitgaand HTTPS naar uw platforminstantie. De agent maakt zelf de verbinding en houdt die open. Een inkomende firewallregel is niet nodig.
  • Een proxy die TLS inspecteert, werkt zodra het rootcertificaat ervan wordt vertrouwd in het eigen archief van het besturingssysteem (het machinearchief op Windows, de systeemsleutelhanger op macOS, de CA-bundel van de distributie op Linux). Op de agent hoeft niets te worden geconfigureerd.

Het installatieprogramma ophalen

Het installatieprogramma wordt voor uw instantie gebouwd: het platformadres en het certificaat dat de agent nodig heeft om zich te registreren, zitten erin ingebed, en het is met een codecertificaat ondertekend. Een installatieprogramma van een andere instantie werkt niet, en er valt bij de installatie niets te configureren.

  1. Open Apparaatinstellingen → Registratie.
  2. Vraag een build aan als die er nog niet is, en download die zodra de build gereed is. De kaart toont de versie en de SHA-1- en SHA-256-controlesommen.
  3. Controleer de controlesommen en verspreid het pakket naar uw endpoints.

De console biedt momenteel het Windows-pakket aan. De pakketten voor macOS en Linux zijn nog niet in de console te downloaden.

Zie Apparaatinstellingen voor het registratiecertificaat dat dit verankert en voor het roteren ervan.

Installeren en registreren

Installeer het pakket met beheerdersrechten, met de hand of via uw softwaredistributie of MDM. Het installeert voor alle gebruikers en start de service. De pakketten kennen geen opties, dus een stille installatie heeft niets nodig naast de gebruikelijke schakelaars van het platform:

msiexec /i dts-agent-<version>.msi /qn
sudo installer -pkg dts-agent-<version>.pkg -target /
sudo apt install ./dts-agent_<version>_amd64.deb
sudo dnf install ./dts-agent-<version>.x86_64.rpm

De registratie verloopt daarna vanzelf. De agent maakt zijn apparaatsleutel aan, meldt zich aan bij het platform en ontvangt zijn apparaatidentiteit. Op het endpoint hoeft niets te worden ingevoerd. Afhankelijk van de modus Apparaatregistratie in de apparaatinstellingen wordt het apparaat direct beheerd of wacht het op uw goedkeuring in de apparaatinventaris.

Op macOS heeft een deel van de beveiligingsstatus (bijvoorbeeld delen van de beveiligingsinstellingen) volledige schijftoegang nodig, die een pakket niet kan verlenen. Verleen die aan de agent met een profiel voor privacyvoorkeuren (PPPC) vanuit uw MDM; zonder dat profiel ontbreken die waarden en wordt de rest zoals gewoonlijk gemeld.

Let op: De apparaatidentiteit ontstaat bij de eerste registratie en wordt op de machine opgeslagen. Wordt een apparaat opnieuw geïnstalleerd of die toestand gewist, dan ontstaat er een nieuw apparaatrecord. Het oude blijft in de inventaris staan totdat het verloopt of u het verwijdert.

Wat de agent meldt

De beveiligingsstatus wordt elke vijf minuten verzameld en als verschil met het vorige rapport verstuurd, met minstens eenmaal per dag een volledige momentopname of telkens wanneer het platform erom vraagt. Tussen de rapporten door stuurt de agent om de paar seconden een korte terugmelding, en dat is wat een apparaat als verbonden laat verschijnen.

De agent meldt:

  • Besturingssysteem en hardware: versie, build, architectuur, computermodel, CPU en geheugen, en of de machine virtueel is.
  • Identiteit van de machine en haar gebruikers: hostnaam, domein, het account dat momenteel is aangemeld en de gebruikersaccounts van het apparaat.
  • Netwerkconfiguratie: adapters met MAC- en IP-adressen, gateways en DNS-servers.
  • Volumes en schijfversleuteling (BitLocker, FileVault, versleutelde Linux-volumes).
  • Geïnstalleerde software met leverancier, versie en installatiedatum.
  • Beveiligingstoestand: firewall, Microsoft Defender op Windows, en instellingen zoals Secure Boot, TPM, Gatekeeper, System Integrity Protection, of de Mac door een MDM wordt beheerd, en of na het vergrendelen van het scherm een wachtwoord vereist is.
  • Ontbrekende updates van het besturingssysteem met ernst en of een herstart nodig is.
  • Of de consolesessie is vergrendeld, met de terugmelding. De apparaatpagina toont dit alleen wanneer u het inschakelt.
  • Zijn eigen toestand: versie, isolatiestatus en de stand van de MFA-registratie.

Hij verzamelt op het endpoint geen geolocatie (het platform leidt de globale locatie af uit het IP-adres van de verbinding), en geen browsergeschiedenis, bestandsinhoud, toetsaanslagen of schermafbeeldingen. De processenlijst, met opdrachtregels en het account waaronder elk proces draait, wordt alleen verzameld wanneer een beheerder die actie op afstand uitvoert.

De omvang van de gegevensverzameling ligt vast. Deze is op elk apparaat van een platform gelijk, en gebruikers kunnen haar in het agentvenster lezen (zie hieronder). Plan de uitrol samen met wie in uw organisatie verantwoordelijk is voor ondernemingsraadovereenkomsten of de privacygoedkeuring: de inventaris, het aangemelde account en de op verzoek verzamelde processenlijst zijn in de meeste rechtsstelsels persoonsgegevens.

Het agentvenster

Elke gebruiker ziet de agent in het systeemvak (Windows), in de menubalk (macOS) of als statuspictogram (Linux). Het menu ervan toont het tijdstip van het laatste rapport, en Nu controleren vraagt het platform om een actueel complianceresultaat. Het venster heeft deze pagina's:

PaginaToont
StatusOf het apparaat verbonden en geregistreerd is en meldt, en wat er momenteel mislukt.
ComplianceHet laatste complianceresultaat van het apparaat met de controles die zijn mislukt.
Aanmelden met twee factorenOp Windows de tweede factoren van de gebruiker voor de Windows-aanmelding, wanneer het apparaat ze zelf verifieert.
PrivacyElke query die de agent uitvoert en de gegevens die hij het laatst heeft verzonden.
OverDe versie, en Diagnose verzenden / Diagnose opslaan voor supportgevallen.

De opdrachtregel

De agent installeert een opdracht dts-agent voor beheerders en support op het apparaat:

OpdrachtDoel
dts-agent statusDe toestand van de agent als JSON: verbinding, registratie, het laatste rapport, isolatie, en elke stap die momenteel mislukt, met de melding ervan. Het eerste waar u naar kijkt wanneer een apparaat zich vreemd gedraagt.
dts-agent compliance --refreshHet laatste complianceresultaat, opnieuw opgevraagd bij het platform.
dts-agent revert-isolationHeft de netwerkisolatie lokaal op, uitgevoerd als beheerder of root. Voor een apparaat dat door de isolatie van het platform is afgesneden. Het opheffen wordt vastgelegd.

Gedrag wanneer het platform onbereikbaar is

De agent blijft het proberen met toenemende intervallen van maximaal vijf minuten en maakt zelfstandig opnieuw verbinding. Rapporten over de beveiligingsstatus worden tijdens de onderbreking niet in de wachtrij gezet, zodat het platform na een storing de huidige toestand ziet en niet de gemiste historie. Ongeveer tien seconden na de laatste terugmelding verschijnt het apparaat in de console als offline. Een full-tunnel-VPN die al het verkeer via het bedrijfsnetwerk leidt, moet ook de verbinding met uw instantie toestaan, anders blijft het apparaat offline zolang de VPN actief is.

Bijwerken

De agent werkt zichzelf niet bij. Een update is een nieuw pakket, dat op dezelfde manier wordt uitgerold als het eerste.

  1. Vraag de nieuwe versie aan onder Apparaatinstellingen → Registratie en download die.
  2. Rol die met uw softwaredistributie of MDM uit naar de endpoints.

De installatie werkt ter plaatse bij en behoudt de apparaatidentiteit, zodat apparaten zich niet opnieuw registreren en hun historie behouden blijft. Test de upgrade op een pilotgroep voordat u haar vlootbreed uitrolt.

Deïnstalleren

  1. Deïnstalleer de agent op de gebruikelijke manier van het platform (Instellingen → Apps op Windows, uw softwaredistributie of MDM, apt remove of dnf remove op Linux). Voer op macOS sudo dts-agent uninstall uit. De deïnstallatie heft eerst een netwerkisolatie op en verwijdert daarna de service, de programmabestanden, de toestand van de agent en zijn apparaatsleutel.
  2. Verwijder het apparaat in de inventaris. De deïnstallatie stelt het platform niet op de hoogte, dus het record blijft bestaan totdat u het verwijdert.

Let op: Op Debian en Ubuntu bewaart apt remove de toestand van de agent totdat u het pakket volledig verwijdert (apt purge). Het verwijderen van het .rpm-pakket en de deïnstallatie op Windows en macOS verwijderen deze wel.

Probleemoplossing

  • Het apparaat verschijnt nooit in de inventaris. Voer dts-agent status uit op het apparaat: dat noemt de stap die mislukt. Controleer of het endpoint uw instantie uitgaand kan bereiken en of de registratiemodus nieuwe apparaten accepteert. Een installatieprogramma dat voor een andere instantie is gebouwd, registreert zich nooit.
  • De status meldt een verbindingsfout, maar het netwerk werkt. Meestal een proxy die TLS inspecteert, waarvan het rootcertificaat niet in het archief van het besturingssysteem staat. Zie Vereisten.
  • Een apparaat verschijnt tweemaal. De machine is opnieuw geïnstalleerd of heeft haar lokale toestand verloren en zich opnieuw geregistreerd. Verwijder het oude record.
  • Software- of patchgegevens lijken verouderd. De beveiligingsstatus wordt volgens schema gemeld. Gebruik de actie op afstand Request full update om een volledig rapport af te dwingen.
  • De browser vraagt tijdens het aanmelden om toestemming voor toegang tot het lokale netwerk. Compliancecontroles bij het aanmelden werken doordat de aanmeldpagina de agent op de machine zelf bevraagt. Chrome 142 en nieuwer, en Edge, vragen de gebruiker om toestemming voordat een website een lokaal adres mag bereiken. Gebruikers kunnen dit eenmaal per site toestaan. Sta het op beheerde vloten centraal toe voor uw aanmeldadres met het browserbeleid LoopbackNetworkAllowedForUrls, anders ziet elke gebruiker de vraag.
  • Een apparaat dat door de isolatie is afgesneden, kan niet meer vanuit de console worden vrijgegeven. Voer dts-agent revert-isolation uit op het apparaat als beheerder of root.

Zie ook

Op deze pagina