# Akcje zdalne

Izolowanie urządzenia, zmiana jego rejestracji MFA, przypinanie użytkownika i wykonywanie poleceń na urządzeniu przez API zarządzania.

Requires: Device Identity (DIAM)

> **Wymagany dodatek:** Akcje zdalne wymagają dodatku **DIAM** (Device Identity) z funkcją **deviceTrust**.

Na połączonym urządzeniu można wykonywać działania z poziomu konsoli. Poniższe akcje stanowią część inwentarza urządzeń przeznaczoną do reagowania na incydenty: pozwalają odizolować komputer, zmienić wymagania przy logowaniu lub poprawić przypisanie właściciela bez fizycznego dostępu do urządzenia.

## Akcje w konsoli

Otwórz urządzenie w [inwentarzu urządzeń](https://dts-identity.com/pl/docs/endpoints/device-inventory.md) i użyj jego menu **Akcje**.

| Akcja | Działanie |
|---|---|
| **Izoluj** | Odcina urządzenie od sieci w celu ograniczenia incydentu. Zobacz [co blokuje izolacja](#what-isolation-actually-blocks). |
| **Cofnij izolację** | Usuwa reguły izolacji i przywraca normalny dostęp do sieci. |
| **Configure MFA** | Ustawia rejestrację MFA urządzenia na **Wymagane**, **Opcjonalne** lub **Wyłączone**, weryfikowaną na urządzeniu. Zablokowane, dopóki [polityka zgodności urządzeń](https://dts-identity.com/pl/docs/security/conditional-access/device-compliance-policies.md#windows-logon) ustala tryb dla tego urządzenia. Zobacz [MFA przy logowaniu do systemu Windows](https://dts-identity.com/pl/docs/endpoints/windows-logon-mfa.md). |
| **Przypnij użytkownika** / **Przypnij grupę** | Łączy konto systemu operacyjnego urządzenia z wybranym kontem pracownika albo pozwala korzystać z urządzenia każdemu członkowi grupy. Konto systemu operacyjnego jest wstępnie wypełnione kontem, które logowało się ostatnio, i można je zamiast tego wpisać, dzięki czemu urządzenie można przypiąć, zanim jego użytkownik zaloguje się po raz pierwszy: nazwa użytkownika bez domeny oraz krótka nazwa domeny (`DEV`, a nie `dev.example.com`) lub, w przypadku konta lokalnego, nazwa komputera. W systemie Windows domena jest wymagana. Proponowane są konta o pasującej nazwie użytkownika. Urządzenie może mieć kilka przypiętych kont (po jednym na konto systemu operacyjnego) oraz grup; pokazuje je lista **Przypięte konta** na karcie **Przegląd** i tam też usuwa się przypięcie. Urządzenie, którego aktywny użytkownik nie jest jednym z przypiętych użytkowników, jest oznaczane na liście, dzięki czemu widać, że urządzenie zmieniło użytkownika. |
| **Install updates** | Instaluje aktualizacje systemu operacyjnego, które urządzenie zgłosiło jako brakujące. Zobacz [instalowanie brakujących aktualizacji](#installing-missing-updates). |
| **Zbierz dane diagnostyczne** | Prosi agenta Endpoint o jego logi i stan z ostatnich 24, 48 lub 72 godzin, pseudonimizowane na urządzeniu. Zobacz [pakiety diagnostyczne](#diagnostics-packages). |
| **Usuń urządzenie** | Usuwa rekord z inwentarza. Niczego nie odinstalowuje na komputerze. |

Każda akcja jest zapisywana w [dzienniku audytu](https://dts-identity.com/pl/docs/monitoring/audit-logs.md) wraz z informacją, kto ją wywołał.

### Co faktycznie blokuje izolacja [#what-isolation-actually-blocks]

Izolacja instaluje lokalne reguły zapory na punkcie końcowym. Jest to środek ograniczający, a nie wyłącznik zasilania: celowo zachowywana jest łączność wystarczająca do dalszego zarządzania komputerem i późniejszego zniesienia izolacji.

**Zablokowane:** cały pozostały ruch przychodzący i wychodzący, IPv4 i IPv6.

**Celowo nadal dozwolone:**

- Połączenie urządzenia z platformą, aby izolację można było cofnąć zdalnie.
- DNS, DHCP i automatyczna konfiguracja serwera proxy, aby komputer zachował podstawowe rozpoznawanie nazw i adresowanie.
- Uwierzytelnianie w domenie Windows, aby logowanie do domeny nadal działało.
- Synchronizacja czasu, aby zegar pozostał poprawny (agent Endpoint).
- Ruch pętli zwrotnej (loopback) na samym komputerze.

Z operacyjnego punktu widzenia istotne są dwie właściwości. Reguły są **trwałe i stosowane przy uruchamianiu systemu**, więc ponowne uruchomienie nie znosi izolacji, a izolacja zaczyna działać jeszcze przed uruchomieniem usługi klienta. Ponadto reguły są **usuwane wyłącznie przez cofnięcie izolacji** lub przez odinstalowanie [agenta Endpoint](https://dts-identity.com/pl/docs/endpoints/device-client.md#uninstall), który najpierw znosi izolację. Odinstalowanie [Legacy client](https://dts-identity.com/pl/docs/endpoints/legacy-client.md) z odizolowanego komputera pozostawia go odizolowanym, dlatego tam należy najpierw cofnąć izolację. Jeśli izolacja odetnie urządzenie od platformy, polecenie `dts-agent revert-isolation` na urządzeniu znosi ją lokalnie.

Izolacja jest dostępna w systemach Windows, macOS i Linux z agentem Endpoint oraz w systemie Windows z Legacy client. Na komputerze z systemem Linux, który hostuje kontenery, izolacja odcina również sieć kontenerów, a własna zapora hosta może nadal blokować to, na co izolacja zezwala.

### Izolacja częściowa

Urządzenie może zgłosić stan **Częściowo izolowane**. Jest to stan, a nie tryb do wyboru: klient porównuje faktycznie obecne reguły izolacji z pełnym oczekiwanym zestawem i zgłasza izolację częściową, gdy obecne są niektóre, ale nie wszystkie reguły. Zwykle oznacza to, że izolacja lub jej cofnięcie zakończyły się tylko częściowo. Należy traktować to jako „brak ograniczenia” i ponownie wykonać akcję.

## Instalowanie brakujących aktualizacji [#installing-missing-updates]

> **Uwaga:** Instalowanie aktualizacji jest częścią zarządzania poprawkami, które wymaga planu **Pro** z dodatkiem **DIAM**. W innych planach karta Patches nadal zawiera listę brakujących aktualizacji, ale nie wyświetla przycisków instalacji.

Karta **Patches** urządzenia zawiera listę aktualizacji systemu operacyjnego, które komputer zgłosił jako brakujące.
Z aktualnym agentem punktu końcowego można je zainstalować z tego miejsca. Na urządzeniu z poprzednim klientem DTS oraz w systemie Linux przyciski instalacji są wyszarzone.

Każda aktualizacja ma własny przycisk **Zainstaluj**, a **Zainstaluj wszystkie oczekujące aktualizacje** nad sekcją **Aktualizacje systemu**
uruchamia wszystkie w jednym przebiegu. Akcja zbiorcza najpierw prosi o potwierdzenie; pojedyncza aktualizacja
uruchamia się od razu, chyba że jest oznaczona jako *Wymagane ponowne uruchomienie*, wtedy również wymaga potwierdzenia. Aktualizacje pochodzące
z katalogu podatności, a nie z samego komputera, nie mają przycisku: są to
aktualizacje aplikacji, a ta akcja steruje wyłącznie własnym mechanizmem aktualizacji systemu operacyjnego.

Co dzieje się po kliknięciu:

- Urządzenie potwierdza, że instalacja **się rozpoczęła**, a nie że się zakończyła. Instalacja trwa od kilku minut do
  kilku godzin w tle, dlatego konsola nigdy nie zgłasza aktualizacji jako zainstalowanej.
- Poprawka zachowuje znacznik **Installation requested** do czasu ponownego zgłoszenia stanu przez urządzenie, a
  **wszystkie przyciski instalacji na urządzeniu są zablokowane**, dopóki znacznik jest aktywny. Komputer instaluje jeden zestaw
  aktualizacji naraz, więc zapobiega to także nakładaniu się instalacji uruchomionych przez dwóch administratorów. Znacznik wygasa
  po dwóch godzinach na wypadek, gdyby instalacja nigdy nie zgłosiła wyniku.
- **Nieudana instalacja jest sygnalizowana przy aktualizacji.** Urządzenie przekazuje komunikat własnego
  mechanizmu aktualizacji w jego brzmieniu, a przyciski są od razu ponownie dostępne, zamiast po dwóch
  godzinach. Komunikat pozostaje przy aktualizacji do czasu jej zainstalowania lub rozpoczęcia kolejnej próby.
- **Każdy zakończony przebieg trafia do dziennika audytu** jako `DEVICE_UPDATES_INSTALLED` lub
  `DEVICE_UPDATES_FAILED` z komunikatem urządzenia, dzięki czemu wynik pozostaje czytelny po zniknięciu znacznika,
  a [alarm](https://dts-identity.com/pl/docs/monitoring/alarms.md) może zgłaszać nieudane instalacje.
- Lista jest korygowana, gdy urządzenie wyśle kolejny raport stanu. **Odśwież stan urządzenia** w
  nagłówku urządzenia żąda tego raportu od razu, zamiast czekać na raport dzienny, a alert
  o trwającej instalacji powtarza ten przycisk.
- **Urządzenie nigdy nie jest uruchamiane ponownie.** Aktualizacja oznaczona jako *Wymagane ponowne uruchomienie* zaczyna działać po następnym
  ponownym uruchomieniu, które pozostaje w gestii użytkownika lub regularnych prac konserwacyjnych.

Wymagania i ograniczenia:

- Urządzenie musi mieć status **Połączono**. Instalacje nie są umieszczane w kolejce dla urządzeń offline: odroczona
  instalacja uruchomiłaby się kilka dni później, w dowolnym momencie, na podstawie listy aktualnej w chwili
  umieszczenia w kolejce.
- Akcja wymaga **aktualnego agenta punktu końcowego**. Nie jest oferowana dla urządzeń z wcześniejszym
  klientem ani w systemie Linux, gdzie agent nie steruje żadnym mechanizmem aktualizacji.
- W systemie Windows jednocześnie działa tylko jedna sesja instalacji. Konsola blokuje przyciski, dopóki
  instalacja jest otwarta, więc rzadko się to ujawnia; żądanie, które mimo to dotrze, jest odrzucane z
  komunikatem, a nie pomijane bez informacji.

### Aktualizacje aplikacji [#application-updates]

Na urządzeniach z systemem Windows z aktualnym agentem punktu końcowego karta Patches zawiera również **Aktualizacje aplikacji**
z katalogu pakietów, a potwierdzona aktualizacja ma własny przycisk **Pobierz i zainstaluj**. Urządzenie samo pobiera
instalator z adresu dostawcy, sprawdza go pod kątem sumy kontrolnej z katalogu i podpisu dostawcy
oraz uruchamia go w trybie cichym; konsola nigdy nie obsługuje tego pliku. Obowiązuje wszystko, co opisano powyżej:
urządzenie potwierdza rozpoczęcie, przyciski pozostają zablokowane w trakcie działania, niepowodzenie jest wyświetlane przy aktualizacji, a
urządzenie nigdy nie jest uruchamiane ponownie. Aktualizacja, która kończy się dopiero po ponownym uruchomieniu, jest zgłaszana jako zainstalowana.

Aktualizacja aplikacji bez przycisku podaje pod spodem przyczynę, na przykład:

- pakiet jest **Niepotwierdzone** (pasuje kilka pakietów lub instalator różni się od zainstalowanego):
  należy go wybrać za pomocą opcji **Wybierz pakiet** obok aktualizacji;
- aplikacja jest **Zainstalowano w profilu użytkownika** lub jej instalator **instaluje dla poszczególnych użytkowników**;
- kilka aplikacji na urządzeniu to ten sam pakiet, na przykład dwa środowiska uruchomieniowe obok siebie;
- instalator **nie ma trybu cichego**, najpierw usuwa zainstalowaną wersję lub jest spakowany w
  archiwum;
- informacje o aktualizacji **nie są aktualne**: instalacje korzystają z danych katalogu nie starszych niż siedem dni;
- urządzenie działa pod kontrolą systemu macOS: aktualizacje aplikacji są tam wyświetlane, ale nie są instalowane.

Instalowanie aktualizacji aplikacji działa także na odizolowanym urządzeniu: izolacja przepuszcza samego agenta
punktu końcowego, a agent pobiera instalator. Ta akcja nie jest dostępna przez API.

## Pakiety diagnostyczne [#diagnostics-packages]

Gdy urządzenie działa nieprawidłowo, a nikt nie ma dostępu do komputera, opcja **Zbierz dane diagnostyczne** w menu **Akcje** prosi agenta Endpoint o jego logi i stan z ostatnich 24, 48 lub 72 godzin. Urządzenie musi być połączone. Na urządzeniu, na którym nadal działa poprzedni klient DTS, ta pozycja menu jest wyszarzona. Pakiet dociera w ciągu około pół minuty i jest wyświetlany na karcie **Diagnostyka** urządzenia, skąd można go pobrać jako plik JSON.

- **Pseudonimizacja na urządzeniu.** Zanim pakiet opuści komputer, agent zastępuje nazwy użytkowników, adresy e-mail, nazwy domen i hostów, identyfikatory SID, adresy IP i MAC, numery seryjne oraz ścieżki profili symbolami zastępczymi, takimi jak `user-1` lub `host-2`. Ta sama wartość otrzymuje w całym pakiecie ten sam symbol, dzięki czemu powiązania pozostają czytelne. Mapowanie nigdy nie opuszcza urządzenia. Kody błędów, znaczniki czasu, wersje i stany pozostają bez zmian.
- **Nigdy nie są dołączane:** klucze, tokeny, hasła, kody, dzienniki zdarzeń systemu Windows i surowe dane o stanie zabezpieczeń.
- **Rozmiar.** Agent utrzymuje pakiet poniżej 1 MB i w razie potrzeby pomija najstarsze wiersze logów. Taki pakiet jest oznaczany jako obcięty.
- **Przechowywanie.** Pakiet jest usuwany 14 dni po zebraniu.
- **Audyt.** Zebranie jest rejestrowane jako `DEVICE_COMMAND_SENT`, a każde pobranie jako `DEVICE_DIAGNOSTICS_DOWNLOADED`, w obu przypadkach z administratorem, który to wykonał.

Pseudonimizowany pakiet nadal stanowi dane osobowe. Należy przekazywać go do wsparcia wyłącznie w ramach umowy powierzenia przetwarzania danych obejmującej daną instancję.

## Urządzenia offline i polecenia w kolejce

Urządzenie jest uznawane za offline po około dziesięciu sekundach od ostatniego zgłoszenia.

Trzy akcje można **umieścić w kolejce do wykonania po ponownym połączeniu**: **Izoluj**, **Cofnij izolację** i **Configure MFA**. Jeśli urządzenie jest offline, konsola proponuje umieszczenie polecenia w kolejce, a polecenie jest dostarczane automatycznie w chwili powrotu urządzenia. Każda inna akcja na urządzeniu offline natychmiast kończy się niepowodzeniem i nie jest zapisywana.

Zasady kolejki:

- **Jedno oczekujące polecenie na temat.** Izolacja i rejestracja MFA są umieszczane w kolejce oddzielnie, ale nowsze polecenie izolacji zastępuje oczekujące starsze, więc na urządzeniu nie mogą się gromadzić sprzeczne instrukcje.
- **Polecenia w kolejce wygasają po siedmiu dniach**, jeśli urządzenie nigdy nie wróci.
- **Oczekujące akcje są widoczne na stronie urządzenia** i można je anulować przed dostarczeniem.
- Dostarczenie jest również zapisywane w dzienniku audytu, dzięki czemu widać zarówno moment umieszczenia polecenia w kolejce, jak i moment, w którym faktycznie dotarło do urządzenia.

## Przez API [#through-the-api]

> **Uwaga:** Wymaga funkcji **deviceTrust**.

Te same polecenia są dostępne programowo; w ten sposób można włączyć izolowanie do playbooka SOAR lub własnych narzędzi.

```bash
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}'
```

Wywołanie wymaga zakresu `devices.query`. Ustaw `queueIfOffline` na `true`, aby uzyskać opisane powyżej działanie kolejki; wartość domyślna to `false`, więc zwykłe wywołanie dla urządzenia offline szybko kończy się niepowodzeniem, zamiast zostać odroczone.

### Dostępne polecenia

| Polecenie | Parametry | Przeznaczenie |
|---|---|---|
| `Isolate` | brak | Odcięcie urządzenia od sieci. |
| `RevertIsolation` | brak | Przywrócenie dostępu do sieci. |
| `SetMfaEnrollment` | `enrollment`: `Required`, `Optional`, `Disabled` | Ustawienie rejestracji MFA dla logowania do systemu Windows. |
| `RequestFullUpdate` | brak | Żądanie ponownego przesłania przez urządzenie pełnego stanu zabezpieczeń. Niczego nie zmienia na punkcie końcowym. |
| `GetProcessList` | brak | Zwrócenie aktualnie uruchomionych procesów. |
| `TerminateProcesses` | `pids` (agent Endpoint) lub `signature` (Legacy client) | Zatrzymanie procesów o tych identyfikatorach, odczytanych z `GetProcessList` tego samego urządzenia, lub procesów wykrytego produktu. Agent Endpoint nigdy nie zatrzymuje samego siebie ani procesu krytycznego dla systemu. |
| `Run` | `signature` | Uruchomienie wykrytego produktu. Tylko Legacy client. |
| `Scan` | `signature`, `scanType`: `full`, `default` lub `path`, `path`, `clean` | Uruchomienie skanowania antywirusowego wskazanym produktem zabezpieczającym. |
| `UpdateDefinitions` | `signature` | Aktualizacja definicji złośliwego oprogramowania wskazanego produktu. |
| `EnableRTP` | `signature` | Ponowne włączenie ochrony w czasie rzeczywistym. |
| `SetFirewallState` | `signature`, `operation`: `enable` lub `disable`, `password` | Włączenie lub wyłączenie produktu zapory. |
| `SetAgentState` | `signature`, `operation`: `enable` lub `disable` | Włączenie lub wyłączenie agenta zarządzania poprawkami. Tylko Legacy client. |
| `GetProductInfo` | `productList` | Odczyt szczegółów wskazanych produktów. Tylko Legacy client. |
| `GetRunningState` | `signatureList` | Sprawdzenie, czy wskazane produkty są uruchomione. Tylko Legacy client. |
| `BlockEndpointDestinations` | `destinations` | Zablokowanie określonych adresów lub sieci IPv4 na punkcie końcowym. Tylko Legacy client. |
| `UnblockEndpointDestinations` | `filterKeys` | Usunięcie wcześniej ustawionych blokad miejsc docelowych. Tylko Legacy client. |
| `GetEndpointBlockedDestinationsList` | brak | Wyświetlenie listy aktualnie obowiązujących blokad miejsc docelowych. Tylko Legacy client. |
| `DownloadMissingPatches` | `patches` | Pobranie aktualizacji systemu operacyjnego, które urządzenie zgłosiło jako brakujące. Bez listy: wszystkich oferowanych urządzeniu. |
| `InstallMissingPatches` | `patches` | Zainstalowanie tych aktualizacji. Urządzenie nigdy nie jest w tym celu uruchamiane ponownie. |
| `CollectDiagnostics` | `hours` (od 1 do 72, domyślnie 24) | Zwrócenie logów i stanu agenta z tego okna, pseudonimizowanych na urządzeniu. Przez API pakiet trafia do wywołującego i nie jest przechowywany. |

Parametr `patches` zawiera identyfikatory zgłoszone przez samo urządzenie w polu `missingPatches`: numer KB w systemie Windows, własny identyfikator aktualizacji, jeśli nie ma ona numeru KB, oraz etykietę aktualizacji w systemie macOS. Najpierw należy je odczytać z danych o poprawkach urządzenia. Te dwa polecenia wymagają aktualnego agenta punktu końcowego; działają na własnym mechanizmie aktualizacji systemu operacyjnego, a w systemie Linux otrzymują odpowiedź o braku obsługi.

Parametr `signature` identyfikuje produkt zabezpieczający **w postaci zgłoszonej przez dane urządzenie**. Należy go najpierw odczytać z danych produktów samego urządzenia za pomocą `GetProductInfo`, zamiast zakładać identyfikator stały dla wszystkich komputerów.

Na urządzeniu z agentem Endpoint polecenia `Scan`, `UpdateDefinitions` i `EnableRTP` działają na programie Microsoft Defender (Windows), a `SetFirewallState` na zaporze systemu operacyjnego (Windows i macOS); parametr `signature` jest tam nadal wymagany, ale nie jest oceniany. Polecenie oznaczone jako *tylko Legacy client* jest dla takiego urządzenia odrzucane. W Legacy client polecenia na poziomie produktu działają na oprogramowaniu zabezpieczającym innych producentów zainstalowanym na punkcie końcowym i działają tylko tam, gdzie produkt obsługuje daną operację. Niepowodzenie należy traktować jako „produkt odmówił”, a nie „urządzenie jest nieosiągalne”; te dwa przypadki są zgłaszane inaczej.

Blokowanie miejsc docelowych dotyczy wyłącznie IPv4.

## Rozwiązywanie problemów

- **Przekroczono limit czasu polecenia.** Urządzenie było osiągalne, ale nie odpowiedziało na czas. Sprawdź, czy jest nadal połączone, i spróbuj ponownie. Tylko trzy akcje, które można umieścić w kolejce, przetrwają ponowne połączenie; wszystkie inne trzeba wydać ponownie.
- **Akcja trafiła do kolejki, choć urządzenie wygląda na online.** Lista pokazuje ostatni znany stan. Jeśli urządzenie przestało się zgłaszać kilka sekund temu, jest już traktowane jako offline.
- **Urządzenie pozostaje odizolowane po usunięciu klienta.** W przypadku Legacy client reguły zapory są lokalne i przetrwają usunięcie klienta. Zainstaluj ponownie klienta, cofnij izolację, a następnie poprawnie go odinstaluj. Agent Endpoint znosi izolację podczas odinstalowywania.
- **Urządzenie zgłasza izolację częściową.** Ponownie wykonaj **Izoluj** lub **Cofnij izolację**, aby doprowadzić je do określonego stanu.

## Zobacz także

- [Inwentarz urządzeń](https://dts-identity.com/pl/docs/endpoints/device-inventory.md): lista urządzeń i strony szczegółów.
- [MFA przy logowaniu do systemu Windows](https://dts-identity.com/pl/docs/endpoints/windows-logon-mfa.md): działanie ustawienia rejestracji MFA na punkcie końcowym.
- [Agent Endpoint](https://dts-identity.com/pl/docs/endpoints/device-client.md): co działa na komputerze.
- [Dzienniki audytu](https://dts-identity.com/pl/docs/monitoring/audit-logs.md): miejsce zapisu każdego polecenia i jego dostarczenia.
