Externe acties
Isoleer een apparaat, wijzig de MFA-registratie, zet de gebruiker vast en voer apparaatopdrachten uit via de beheer-API.
Add-on vereist: Externe acties vereisen de DIAM-add-on (Device Identity) met de functie deviceTrust.
Op een verbonden apparaat kunt u vanuit de console acties uitvoeren. De onderstaande acties vormen de incidentresponshelft van de apparaatinventaris: u isoleert een machine, wijzigt wat deze bij het aanmelden vereist, of corrigeert aan wie deze toebehoort, zonder de machine fysiek aan te raken.
Acties in de console
Open een apparaat in de apparaatinventaris en gebruik het menu Acties.
| Actie | Wat deze doet |
|---|---|
| Isoleren | Sluit het apparaat af van het netwerk om een incident in te dammen. Zie wat isolatie blokkeert. |
| Isolatie opheffen | Verwijdert de isolatieregels en herstelt de normale netwerktoegang. |
| MFA voor apparaat configureren | Zet de MFA-registratie van het apparaat op Vereist, Optioneel of Uitgeschakeld, geverifieerd op het apparaat. Vergrendeld zolang een compliancebeleid voor apparaten de modus voor dit apparaat instelt. Zie MFA bij de Windows-aanmelding. |
| Gebruiker vastzetten / Groep vastzetten | Koppelt een OS-account van het apparaat aan een medewerkersaccount naar keuze, of laat elk lid van een groep het apparaat gebruiken. Het OS-account is vooraf ingevuld met het account dat het laatst was aangemeld en kan ook worden ingetypt, zodat een apparaat kan worden vastgezet voordat de gebruiker zich voor het eerst aanmeldt: de gebruikersnaam zonder het domein, en de korte domeinnaam (DEV, niet dev.example.com) of, voor een lokaal account, de computernaam. Op Windows is het domein verplicht. Accounts waarvan de gebruikersnaam overeenkomt, worden voorgesteld. Een apparaat kan meerdere vastgezette accounts (één per OS-account) en groepen hebben; de lijst Vastgezette accounts op het tabblad Overzicht toont ze, en daar wordt een vastzetting verwijderd. Een apparaat waarvan de actieve gebruiker niet een van de vastgezette gebruikers is, wordt in de lijst gemarkeerd; zo wordt een apparaat zichtbaar dat van eigenaar is gewisseld. |
| Updates installeren | Installeert de updates van het besturingssysteem die het apparaat als ontbrekend heeft gemeld. Zie ontbrekende updates installeren. |
| Diagnose verzamelen | Vraagt de endpoint-agent om zijn logboeken en status van de laatste 24, 48 of 72 uur, op het apparaat gepseudonimiseerd. Zie diagnosepakketten. |
| Apparaat verwijderen | Verwijdert de vermelding uit de inventaris. Er wordt niets op de machine verwijderd. |
Elke actie wordt vastgelegd in het auditlogboek, inclusief wie de actie heeft gestart.
Wat isolatie werkelijk blokkeert
Isolatie installeert lokale firewallregels op het endpoint. Het is een inperkingsmaatregel, geen aan/uit-schakelaar: er blijft bewust voldoende connectiviteit behouden om de machine beheerbaar te houden en de isolatie weer te kunnen opheffen.
Geblokkeerd: al het overige inkomende en uitgaande verkeer, IPv4 en IPv6.
Bewust nog toegestaan:
- De verbinding van het apparaat terug naar het platform, zodat u de isolatie op afstand kunt opheffen.
- DNS, DHCP en automatische proxyconfiguratie, zodat de machine basale naamomzetting en adressering behoudt.
- Windows-domeinverificatie, zodat aanmelden bij het domein blijft werken.
- Tijdsynchronisatie, zodat de klok juist blijft (endpoint-agent).
- Loopbackverkeer op de machine zelf.
Twee eigenschappen zijn operationeel belangrijk. De regels zijn permanent en worden bij het opstarten toegepast, dus een herstart heft de isolatie niet op, en de isolatie werkt al voordat de clientservice start. En de regels worden alleen verwijderd door de isolatie op te heffen, of door de endpoint-agent te verwijderen, die de isolatie eerst opheft. Als u de legacy client van een geïsoleerde machine verwijdert, blijft deze geïsoleerd, dus hef daar eerst de isolatie op. Sluit de isolatie een apparaat van het platform af, dan heft dts-agent revert-isolation op het apparaat de isolatie lokaal op.
Isolatie is beschikbaar op Windows, macOS en Linux met de endpoint-agent, en op Windows met de legacy client. Op een Linux-machine die containers host, sluit isolatie ook het netwerk van de containers af, en een eigen firewall van de host kan nog steeds blokkeren wat isolatie toestaat.
Gedeeltelijke isolatie
Een apparaat kan Gedeeltelijk geïsoleerd melden. Dit is een status, geen modus die u kunt kiezen: de client vergelijkt de werkelijk aanwezige isolatieregels met de volledige verwachte set, en meldt gedeeltelijke isolatie wanneer sommige, maar niet alle regels aanwezig zijn. Dit betekent meestal dat een isolatie of opheffing slechts gedeeltelijk is voltooid. Behandel het als "niet ingedamd" en voer de actie opnieuw uit.
Ontbrekende updates installeren
Opmerking: Het installeren van updates maakt deel uit van patchbeheer, waarvoor het Pro-plan met de DIAM-add-on nodig is. In andere plannen toont het tabblad Ontbrekende patches nog steeds de ontbrekende updates, maar zonder installatieknoppen.
Het tabblad Ontbrekende patches van een apparaat toont de updates van het besturingssysteem die de machine als ontbrekend heeft gemeld. Met de actuele endpoint-agent kunt u ze daar installeren. Op een apparaat met de vorige DTS-client, en op Linux, zijn de installatieknoppen grijs.
Elke update heeft een eigen knop Installeren, en Alle openstaande updates installeren boven de sectie Systeemupdates start ze allemaal in één run. De bulkactie vraagt eerst om bevestiging; een afzonderlijke update start direct, tenzij deze is gemarkeerd als Herstart vereist, waarvoor ook om bevestiging wordt gevraagd. Updates die uit de kwetsbaarhedencatalogus komen in plaats van van de machine zelf, hebben geen knop: het zijn applicatie-updates, en deze actie stuurt alleen het eigen updatemechanisme van het besturingssysteem aan.
Wat er na de klik gebeurt:
- Het apparaat bevestigt dat de installatie is gestart, niet dat deze is voltooid. Een installatie loopt minuten tot uren op de achtergrond, dus de console meldt een update nooit als geïnstalleerd.
- De patch houdt een markering Installatie aangevraagd totdat het apparaat zijn status opnieuw meldt, en zolang die er staat, zijn alle installatieknoppen van het apparaat vergrendeld. Een machine installeert één set updates tegelijk, en zo wordt ook voorkomen dat twee beheerders installaties op elkaar stapelen. De markering vervalt na twee uur, voor het geval een installatie nooit terugmeldt.
- Een mislukte installatie wordt bij de update vermeld. Het apparaat geeft door wat het eigen updatemechanisme meldde, in diens bewoordingen, en de knoppen zijn direct weer vrij in plaats van pas na twee uur. Een melding blijft bij de update staan totdat deze is geïnstalleerd of u een nieuwe poging start.
- Elke voltooide run staat in het auditlogboek, als
DEVICE_UPDATES_INSTALLEDofDEVICE_UPDATES_FAILEDmet het bericht van het apparaat, zodat de uitkomst leesbaar blijft nadat de markering is verdwenen, en een alarm mislukte installaties kan melden. - De lijst wordt bijgewerkt wanneer het apparaat zijn volgende statusrapport verzendt. Apparaatstatus vernieuwen in de kop van het apparaat vraagt dat rapport direct op in plaats van op het dagelijkse rapport te wachten, en de melding over de lopende installatie herhaalt de knop.
- Het apparaat wordt nooit opnieuw opgestart. Een update die is gemarkeerd als Herstart vereist, wordt van kracht na de volgende herstart, die bij de gebruiker of uw reguliere onderhoud blijft.
Vereisten en beperkingen:
- Het apparaat moet verbonden zijn. Installaties worden niet in de wachtrij geplaatst voor offline apparaten: een uitgestelde installatie zou dagen later, op een willekeurig moment, worden uitgevoerd tegen een lijst die actueel was toen deze in de wachtrij werd geplaatst.
- De actie vereist de actuele endpoint-agent. Deze wordt niet aangeboden voor apparaten met de eerdere client, en niet op Linux, waar de agent geen updatemechanisme aanstuurt.
- Op Windows loopt slechts één installatiesessie tegelijk. De console vergrendelt de knoppen zolang een installatie openstaat, dus dit komt zelden voor; een verzoek dat toch binnenkomt, wordt met een melding geweigerd in plaats van stilzwijgend genegeerd.
Applicatie-updates
Op Windows-apparaten met de actuele endpoint-agent toont het tabblad Ontbrekende patches ook applicatie-updates uit de pakketcatalogus, en een bevestigde update heeft een eigen knop Downloaden & installeren. Het apparaat downloadt het installatieprogramma zelf van het adres van de leverancier, controleert het aan de hand van de controlesom uit de catalogus en de handtekening van de leverancier, en voert het op de achtergrond uit; de console verwerkt het bestand nooit. Alles hierboven geldt ook hier: het apparaat bevestigt de start, de knoppen blijven vergrendeld zolang de installatie loopt, een fout wordt bij de update getoond, en het apparaat wordt nooit opnieuw opgestart. Een update die pas met een herstart is voltooid, wordt als geïnstalleerd gemeld.
Een applicatie-update zonder knop vermeldt eronder waarom, bijvoorbeeld:
- het pakket is niet bevestigd (meerdere pakketten passen, of het installatieprogramma wijkt af van de geïnstalleerde variant): kies het met Pakket kiezen naast de update;
- de applicatie is in een gebruikersprofiel geïnstalleerd, of het installatieprogramma installeert per gebruiker;
- meerdere applicaties op het apparaat zijn hetzelfde pakket, zoals twee runtimes naast elkaar;
- het installatieprogramma heeft geen stille modus, verwijdert eerst de geïnstalleerde versie, of zit in een archief;
- de update-informatie is niet actueel: installaties gebruiken catalogusgegevens van maximaal zeven dagen oud;
- het apparaat draait macOS: applicatie-updates worden daar weergegeven, maar niet geïnstalleerd.
Het installeren van applicatie-updates werkt ook op een geïsoleerd apparaat: de isolatie laat de endpoint-agent zelf door, en de agent downloadt het installatieprogramma. Het wordt niet via de API aangeboden.
Diagnosepakketten
Wanneer een apparaat zich vreemd gedraagt en niemand bij de machine kan, vraagt Diagnose verzamelen in het menu Acties de endpoint-agent om zijn logboeken en status van de laatste 24, 48 of 72 uur. Het apparaat moet verbonden zijn. Op een apparaat dat nog de vorige DTS-client draait, is het menu-item grijs. Het pakket komt binnen ongeveer een halve minuut binnen en wordt vermeld op het tabblad Diagnose van het apparaat, waar het als JSON-bestand wordt gedownload.
- Op het apparaat gepseudonimiseerd. Voordat het pakket de machine verlaat, vervangt de agent gebruikersnamen, e-mailadressen, domein- en hostnamen, SID's, IP- en MAC-adressen, serienummers en profielpaden door plaatshouders zoals
user-1ofhost-2. Dezelfde waarde krijgt in het hele pakket dezelfde plaatshouder, zodat verbanden leesbaar blijven. De toewijzing verlaat het apparaat nooit. Foutcodes, tijdstempels, versies en statussen blijven zoals ze zijn. - Nooit opgenomen: sleutels, tokens, wachtwoorden, codes, Windows-gebeurtenislogboeken en de ruwe gegevens over de beveiligingshouding.
- Grootte. De agent houdt een pakket onder 1 MB en laat zo nodig de oudste logregels weg. Zo'n pakket wordt als ingekort gemarkeerd.
- Bewaartermijn. Een pakket wordt 14 dagen na het verzamelen verwijderd.
- Audit. Het verzamelen wordt vastgelegd als
DEVICE_COMMAND_SENTen elke download alsDEVICE_DIAGNOSTICS_DOWNLOADED, telkens met de beheerder die het deed.
Een gepseudonimiseerd pakket blijft een persoonsgegeven. Geef het alleen door aan support binnen de verwerkersovereenkomst die uw instantie dekt.
Offline apparaten en opdrachten in de wachtrij
Een apparaat wordt ongeveer tien seconden na de laatste check-in als offline beschouwd.
Drie acties kunnen in de wachtrij worden geplaatst voor wanneer de verbinding terugkeert: Isoleren, Isolatie opheffen en MFA voor apparaat configureren. Als het apparaat offline is, biedt de console aan de opdracht in de wachtrij te plaatsen, en deze wordt automatisch afgeleverd zodra het apparaat terugkeert. Elke andere actie mislukt direct op een offline apparaat in plaats van te worden opgeslagen.
Regels van de wachtrij:
- Eén openstaande opdracht per onderwerp. Isolatie en MFA-registratie worden afzonderlijk in de wachtrij geplaatst, maar een nieuwere isolatieopdracht vervangt een oudere openstaande, zodat een apparaat geen tegenstrijdige instructies kan verzamelen.
- Opdrachten in de wachtrij verlopen na zeven dagen als het apparaat nooit terugkeert.
- Openstaande acties zijn zichtbaar op de apparaatpagina en kunnen vóór aflevering worden geannuleerd.
- De aflevering wordt ook in het auditlogboek vastgelegd, zodat u zowel ziet wanneer een opdracht in de wachtrij is geplaatst als wanneer deze het apparaat werkelijk heeft bereikt.
Via de API
Opmerking: Vereist de functie deviceTrust.
Dezelfde opdrachten zijn programmatisch beschikbaar; daarmee koppelt u inperking aan een SOAR-playbook of uw eigen tooling.
curl -X POST https://<your-instance>/api/v1/devices/<deviceUid>/query/Isolate \
-H "Authorization: Bearer <access token>" \
-H "Content-Type: application/json" \
-d '{"queueIfOffline": true}'De aanroep vereist de scope devices.query. Stel queueIfOffline in op true om het hierboven beschreven wachtrijgedrag te krijgen; de standaardwaarde is false, dus een gewone aanroep tegen een offline apparaat mislukt direct in plaats van te worden uitgesteld.
Beschikbare opdrachten
| Opdracht | Parameters | Doel |
|---|---|---|
Isolate | geen | Het apparaat van het netwerk afsluiten. |
RevertIsolation | geen | De netwerktoegang herstellen. |
SetMfaEnrollment | enrollment: Required, Optional, Disabled | MFA-registratie voor de Windows-aanmelding instellen. |
RequestFullUpdate | geen | Het apparaat vragen de volledige beveiligingshouding opnieuw te verzenden. Wijzigt niets op het endpoint. |
GetProcessList | geen | De momenteel actieve processen teruggeven. |
TerminateProcesses | pids (endpoint-agent) of signature (legacy client) | De processen met deze id's stoppen, uitgelezen met GetProcessList van hetzelfde apparaat, of die van een gedetecteerd product. De endpoint-agent stopt nooit zichzelf of een systeemkritiek proces. |
Run | signature | Een gedetecteerd product starten. Alleen legacy client. |
Scan | signature, scanType: full, default of path, path, clean | Een malwarescan van het genoemde beveiligingsproduct starten. |
UpdateDefinitions | signature | De malwaredefinities van het genoemde product bijwerken. |
EnableRTP | signature | Realtimebescherming weer inschakelen. |
SetFirewallState | signature, operation: enable of disable, password | Een firewallproduct in- of uitschakelen. |
SetAgentState | signature, operation: enable of disable | Een patchbeheeragent in- of uitschakelen. Alleen legacy client. |
GetProductInfo | productList | Gegevens van de genoemde producten uitlezen. Alleen legacy client. |
GetRunningState | signatureList | Controleren of de genoemde producten actief zijn. Alleen legacy client. |
BlockEndpointDestinations | destinations | Specifieke IPv4-adressen of netwerken op het endpoint blokkeren. Alleen legacy client. |
UnblockEndpointDestinations | filterKeys | Eerder ingestelde bestemmingsblokkeringen verwijderen. Alleen legacy client. |
GetEndpointBlockedDestinationsList | geen | De momenteel actieve bestemmingsblokkeringen weergeven. Alleen legacy client. |
DownloadMissingPatches | patches | De updates van het besturingssysteem downloaden die het apparaat als ontbrekend heeft gemeld. Zonder de lijst: alles wat wordt aangeboden. |
InstallMissingPatches | patches | Die updates installeren. Het apparaat wordt daarvoor nooit opnieuw opgestart. |
CollectDiagnostics | hours (1 tot 72, standaard 24) | De logboeken en status van de agent over dat venster teruggeven, op het apparaat gepseudonimiseerd. Via de API gaat het pakket naar de aanroeper en wordt het niet opgeslagen. |
De parameter patches bevat de ID's die het apparaat zelf onder missingPatches heeft gemeld: een KB-nummer op Windows, de eigen identificatie van de update waar deze geen KB-nummer heeft, een updatelabel op macOS. Lees ze eerst uit de patchgegevens van het apparaat. Deze twee opdrachten vereisen de actuele endpoint-agent; ze werken op het eigen updatemechanisme van het besturingssysteem en worden op Linux beantwoord als niet ondersteund.
De parameter signature identificeert een beveiligingsproduct zoals dat apparaat het meldt. Lees deze eerst uit de eigen productgegevens van het apparaat, met GetProductInfo, in plaats van uit te gaan van een identificatie die op alle machines gelijk is.
Op een apparaat met de endpoint-agent werken Scan, UpdateDefinitions en EnableRTP op Microsoft Defender (Windows) en SetFirewallState op de firewall van het besturingssysteem (Windows en macOS); signature is daar nog steeds verplicht, maar wordt niet geëvalueerd. Een opdracht die als alleen legacy client is gemarkeerd, wordt voor zo'n apparaat geweigerd. Op de legacy client werken opdrachten op productniveau op beveiligingssoftware van derden die op het endpoint is geïnstalleerd, en werken alleen waar dat product de bewerking ondersteunt. Behandel een mislukking als "het product weigerde", niet als "het apparaat is onbereikbaar"; die twee worden verschillend gemeld.
Bestemmingsblokkering geldt alleen voor IPv4.
Probleemoplossing
- Er trad een time-out op voor de opdracht. Het apparaat was bereikbaar, maar antwoordde niet op tijd. Controleer of het nog verbonden is en probeer het opnieuw. Alleen de drie acties die in de wachtrij kunnen worden geplaatst, overleven een herverbinding; al het andere moet opnieuw worden uitgevoerd.
- De actie is in de wachtrij geplaatst terwijl het apparaat online lijkt. De lijst toont de laatst bekende status. Als het apparaat enkele seconden geleden stopte met inchecken, wordt het al als offline behandeld.
- Een apparaat blijft geïsoleerd nadat de client is verwijderd. Met de legacy client zijn de firewallregels lokaal en overleven ze de client. Installeer opnieuw een client, hef de isolatie op en verwijder de client daarna correct. De endpoint-agent heft de isolatie op wanneer hij wordt verwijderd.
- Het apparaat meldt gedeeltelijke isolatie. Voer Isoleren of Isolatie opheffen opnieuw uit om het in een gedefinieerde status te brengen.
Zie ook
- Apparaatinventaris voor de apparaatlijst en de detailpagina's.
- MFA bij de Windows-aanmelding voor wat de instelling voor MFA-registratie op het endpoint doet.
- Endpoint-agent voor wat er op de machine draait.
- Auditlogboeken waar elke opdracht en de aflevering ervan worden vastgelegd.