Endpoint-agent
Installeer, werk bij en verwijder de endpoint-agent op Windows, macOS en Linux, en lees wat deze van het apparaat meldt.
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
| Platform | Ondersteund vanaf |
|---|---|
| Windows | Windows 11 en Windows Server 2019, x64 |
| macOS | macOS 12 Monterey, Intel en Apple silicon |
| Linux | Debian 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
| Platform | Pakket | Wat er draait |
|---|---|---|
| Windows | .msi | De 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 | .pkg | Een systeemdaemon onder /Library/DTS/Agent en de app DTS Endpoint Agent in de menubalk van elke gebruikerssessie. |
| Linux | .deb, .rpm | De 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.
- Open Apparaatinstellingen → Registratie.
- 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.
- 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.rpmDe 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:
| Pagina | Toont |
|---|---|
| Status | Of het apparaat verbonden en geregistreerd is en meldt, en wat er momenteel mislukt. |
| Compliance | Het laatste complianceresultaat van het apparaat met de controles die zijn mislukt. |
| Aanmelden met twee factoren | Op Windows de tweede factoren van de gebruiker voor de Windows-aanmelding, wanneer het apparaat ze zelf verifieert. |
| Privacy | Elke query die de agent uitvoert en de gegevens die hij het laatst heeft verzonden. |
| Over | De versie, en Diagnose verzenden / Diagnose opslaan voor supportgevallen. |
De opdrachtregel
De agent installeert een opdracht dts-agent voor beheerders en support op het apparaat:
| Opdracht | Doel |
|---|---|
dts-agent status | De 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 --refresh | Het laatste complianceresultaat, opnieuw opgevraagd bij het platform. |
dts-agent revert-isolation | Heft 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.
- Vraag de nieuwe versie aan onder Apparaatinstellingen → Registratie en download die.
- 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
- Deïnstalleer de agent op de gebruikelijke manier van het platform (Instellingen → Apps op Windows, uw softwaredistributie of MDM,
apt removeofdnf removeop Linux). Voer op macOSsudo dts-agent uninstalluit. De deïnstallatie heft eerst een netwerkisolatie op en verwijdert daarna de service, de programmabestanden, de toestand van de agent en zijn apparaatsleutel. - 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 removede 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 statusuit 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-isolationuit op het apparaat als beheerder of root.
Zie ook
- Apparaatinstellingen voor het installatieprogramma en het registratiecertificaat.
- Apparaatinventaris voor de geregistreerde apparaten en hun beveiligingsstatus.
- Acties op afstand voor wat u op een endpoint kunt starten.
- MFA bij het aanmelden bij Windows voor de aanmeldfunctie die op de agent voortbouwt.
- Legacy client voor apparaten waarop nog de vorige Windows-client draait.