# Agent Endpoint

Instalacja, aktualizacja i usuwanie agenta Endpoint w systemach Windows, macOS i Linux oraz dane, które zgłasza z urządzenia.

Requires: Device Identity (DIAM)

> **Wymagany dodatek:** Agent Endpoint jest częścią dodatku **DIAM** (Device Identity).

**Agent Endpoint** to oprogramowanie instalowane na każdym punkcie końcowym. Rejestruje maszynę, zgłasza jej stan zabezpieczeń zgodnie z harmonogramem i wykonuje [akcje zdalne](https://dts-identity.com/pl/docs/endpoints/remote-actions.md) wywoływane z konsoli. Bez niego urządzenie nie może pojawić się w [inwentarzu](https://dts-identity.com/pl/docs/endpoints/device-inventory.md). Urządzenia zarejestrowane poprzednim klientem dla systemu Windows nadal działają; różnice i sposób ich przeniesienia opisano na stronie [Legacy client](https://dts-identity.com/pl/docs/endpoints/legacy-client.md).

## Obsługiwane platformy

| Platforma | Obsługiwane od |
|---|---|
| **Windows** | Windows 11 i Windows Server 2019, x64 |
| **macOS** | macOS 12 Monterey, Intel i Apple silicon |
| **Linux** | Debian 11, Ubuntu 22.04 i Red Hat Enterprise Linux 9 (w tym Rocky i Alma), x64 i ARM64, z systemd |

Starsze wersje nie są obsługiwane. Jeśli maszyna ma moduł TPM 2.0 (Windows, Linux) lub Secure Enclave (Apple silicon, komputery Mac z układem T2), agent przechowuje w nim swój klucz urządzenia; w pozostałych przypadkach używa klucza zapisanego na dysku.

## Co zostaje zainstalowane

| Platforma | Pakiet | Co działa |
|---|---|---|
| Windows | `.msi` | Usługa **DTS Endpoint Agent** (`DTSAgent`), zainstalowana w `%ProgramFiles%\DTS\Agent` i uruchamiana przy starcie systemu. Okno agenta uruchamia się przy każdym zalogowaniu użytkownika. |
| macOS | `.pkg` | Demon systemowy w `/Library/DTS/Agent` oraz aplikacja **DTS Endpoint Agent** na pasku menu każdej sesji użytkownika. |
| Linux | `.deb`, `.rpm` | Usługa `dts-agent.service` i ikona stanu w sesjach z pulpitem. Na serwerach bez pulpitu działa sama usługa. |

Agent przechowuje swój stan, w tym tożsamość urządzenia, w `%ProgramData%\DTS\Agent` (Windows), `/Library/Application Support/DTS/Agent` (macOS) lub `/var/lib/dts-agent` (Linux), dzięki czemu aktualizacja w miejscu nie powoduje ponownej rejestracji maszyny. Jego pliki dziennika znajdują się tam w folderze `logs` i są przechowywane przez siedem dni.

## Wymagania [#requirements]

- **Uprawnienia administratora lub roota** do instalacji, ponieważ pakiet rejestruje usługę systemową.
- **Wychodzący ruch HTTPS do instancji platformy.** Agent sam nawiązuje połączenie i utrzymuje je otwarte. Reguła zapory dla ruchu przychodzącego nie jest potrzebna.
- **Serwer proxy, który inspekcjonuje TLS**, działa, gdy jego certyfikat główny jest zaufany we własnym magazynie systemu operacyjnego (magazyn komputera w systemie Windows, pęk kluczy System w systemie macOS, pakiet CA dystrybucji w systemie Linux). W agencie niczego się nie konfiguruje.

## Pobranie instalatora

Instalator jest budowany dla konkretnej instancji: adres platformy i certyfikat potrzebny agentowi do rejestracji są w nim osadzone, a sam instalator jest podpisany cyfrowo. Instalator z innej instancji nie zadziała, a podczas instalacji nie ma nic do skonfigurowania.

1. Otwórz **Ustawienia urządzeń → Rejestracja**.
2. Zamów kompilację, jeśli żadna jeszcze nie istnieje, a następnie **pobierz** ją, gdy będzie gotowa. Karta pokazuje wersję oraz sumy kontrolne SHA-1 i SHA-256.
3. Zweryfikuj sumy kontrolne i rozprowadź pakiet na punkty końcowe.

Konsola oferuje obecnie pakiet dla systemu Windows. Pakiety dla systemów macOS i Linux nie są jeszcze dostępne do pobrania w konsoli.

Certyfikat rejestracji, który to zakotwicza, oraz jego rotacja są opisane w sekcji [Ustawienia urządzeń](https://dts-identity.com/pl/docs/endpoints/device-settings.md).

## Instalacja i rejestracja [#install-and-enroll]

Zainstaluj pakiet z uprawnieniami administratora, ręcznie albo za pomocą narzędzia do dystrybucji oprogramowania lub MDM. Pakiet instaluje się dla wszystkich użytkowników i uruchamia usługę. Pakiety nie przyjmują żadnych opcji, więc instalacja w trybie cichym nie wymaga niczego poza zwykłymi przełącznikami danej platformy:

```
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
```

Rejestracja przebiega dalej samoczynnie. Agent tworzy swój klucz urządzenia, rejestruje się na platformie i otrzymuje tożsamość urządzenia. Na punkcie końcowym nie trzeba niczego wpisywać. W zależności od trybu **Rejestracja urządzeń** w [ustawieniach urządzeń](https://dts-identity.com/pl/docs/endpoints/device-settings.md) urządzenie jest zarządzane od razu albo czeka na zatwierdzenie w [inwentarzu urządzeń](https://dts-identity.com/pl/docs/endpoints/device-inventory.md).

W systemie **macOS** część danych o stanie zabezpieczeń (na przykład część ustawień zabezpieczeń) wymaga uprawnienia Pełny dostęp do dysku, którego pakiet nie może nadać. Należy nadać je agentowi profilem preferencji prywatności (PPPC) z MDM; bez niego tych wartości brakuje, a pozostałe dane są zgłaszane normalnie.

> **Uwaga:** Tożsamość urządzenia powstaje przy pierwszej rejestracji i jest zapisywana na maszynie. Ponowne wgranie obrazu systemu albo skasowanie tego stanu powoduje powstanie **nowego** wpisu urządzenia. Stary pozostaje w inwentarzu, dopóki nie wygaśnie albo nie zostanie usunięty.

## Co zgłasza agent

Stan zabezpieczeń jest zbierany co pięć minut i wysyłany jako różnica względem ostatniego zgłoszenia, wraz z pełną migawką co najmniej raz dziennie albo zawsze wtedy, gdy platforma o nią poprosi. Pomiędzy zgłoszeniami agent wysyła co kilka sekund krótkie zgłoszenie obecności, dzięki czemu urządzenie widnieje jako połączone.

Agent zgłasza:

- **System operacyjny i sprzęt**: wersja, kompilacja, architektura, model komputera, procesor i pamięć oraz to, czy maszyna jest wirtualna.
- **Tożsamość maszyny i jej użytkowników**: nazwa hosta, domena, aktualnie zalogowane konto oraz konta użytkowników urządzenia.
- **Konfigurację sieci**: karty sieciowe z adresami MAC i IP, bramy i serwery DNS.
- **Wolumeny i szyfrowanie dysku** (BitLocker, FileVault, szyfrowane wolumeny Linux).
- **Zainstalowane oprogramowanie** z producentem, wersją i datą instalacji.
- **Stan zabezpieczeń**: zapora, Microsoft Defender w systemie Windows oraz ustawienia takie jak Secure Boot, TPM, Gatekeeper, System Integrity Protection, to, czy komputer Mac jest zarządzany przez MDM, i to, czy po zablokowaniu ekranu wymagane jest hasło.
- **Brakujące aktualizacje systemu operacyjnego** z krytycznością i informacją, czy wymagane jest ponowne uruchomienie.
- **Czy sesja konsoli jest zablokowana**, wraz ze zgłoszeniem obecności. Strona urządzenia pokazuje to tylko wtedy, gdy [zostanie to włączone](https://dts-identity.com/pl/docs/endpoints/device-settings.md).
- **Własny stan**: wersja, status izolacji i stan rejestracji MFA.

Agent nie zbiera na punkcie końcowym **żadnych danych geolokalizacyjnych** (przybliżoną lokalizację platforma wyprowadza z adresu IP połączenia) ani **historii przeglądania, zawartości plików, naciśnięć klawiszy czy zrzutów ekranu**. **Lista procesów**, z wierszami poleceń i kontem, na którym działa każdy proces, jest zbierana tylko wtedy, gdy administrator uruchomi tę [akcję zdalną](https://dts-identity.com/pl/docs/endpoints/remote-actions.md).

Zakres zbierania danych jest stały. Jest taki sam na każdym urządzeniu danej platformy, a użytkownicy mogą się z nim zapoznać w oknie agenta (poniżej). Zaplanuj wdrożenie wspólnie z osobami odpowiedzialnymi w organizacji za porozumienia z radą pracowników albo za zatwierdzenie w zakresie ochrony danych: inwentarz, zalogowane konto i zbierana na żądanie lista procesów są w większości jurysdykcji danymi osobowymi.

## Okno agenta

Każdy użytkownik widzi agenta w obszarze powiadomień (Windows), na pasku menu (macOS) lub jako ikonę stanu (Linux). Jego menu pokazuje czas ostatniego zgłoszenia, a **Sprawdź teraz** prosi platformę o nowy wynik zgodności. Okno ma następujące strony:

| Strona | Co pokazuje |
|---|---|
| **Stan** | Czy urządzenie jest połączone, zarejestrowane i zgłasza dane oraz co aktualnie nie działa. |
| **Zgodność** | Ostatni wynik zgodności urządzenia z kontrolami zakończonymi niepowodzeniem. |
| **Logowanie dwuskładnikowe** | W systemie Windows drugie składniki użytkownika do [logowania do systemu Windows](https://dts-identity.com/pl/docs/endpoints/windows-logon-mfa.md), gdy urządzenie samo je weryfikuje. |
| **Prywatność** | Każde zapytanie wykonywane przez agenta i dane, które ostatnio wysłał. |
| **Informacje** | Wersja oraz **Wyślij diagnostykę** / **Zapisz diagnostykę** na potrzeby zgłoszeń do wsparcia. |

## Wiersz polecenia

Agent instaluje polecenie `dts-agent` dla administratorów i wsparcia na urządzeniu:

| Polecenie | Przeznaczenie |
|---|---|
| `dts-agent status` | Stan agenta w formacie JSON: połączenie, rejestracja, ostatnie zgłoszenie, izolacja oraz każdy krok, który aktualnie kończy się niepowodzeniem, wraz z komunikatem. Pierwsze miejsce do sprawdzenia, gdy urządzenie działa nieprawidłowo. |
| `dts-agent compliance --refresh` | Ostatni wynik zgodności, ponownie pobrany z platformy. |
| `dts-agent revert-isolation` | Lokalnie znosi izolację sieciową; należy uruchomić jako administrator lub root. Dla urządzenia, które izolacja odcięła od platformy. Zniesienie jest rejestrowane. |

## Zachowanie przy niedostępnej platformie

Agent ponawia próby w rosnących odstępach, maksymalnie co pięć minut, i łączy się ponownie samodzielnie. Zgłoszenia stanu zabezpieczeń nie są kolejkowane w czasie rozłączenia, więc po awarii platforma widzi stan bieżący, a nie pominiętą historię. Urządzenie pojawia się w konsoli jako offline mniej więcej dziesięć sekund po ostatnim zgłoszeniu obecności. Sieć VPN typu full tunnel, która kieruje cały ruch przez sieć firmową, musi również przepuszczać połączenie z instancją, w przeciwnym razie urządzenie pozostaje offline, dopóki VPN jest aktywny.

## Aktualizacja

Agent **nie** aktualizuje się sam. Aktualizacja to nowy pakiet, wdrażany tak samo jak pierwszy.

1. Zamów nową wersję w sekcji **Ustawienia urządzeń → Rejestracja** i pobierz ją.
2. Rozprowadź ją na punkty końcowe narzędziem do dystrybucji oprogramowania lub MDM.

Instalacja aktualizuje oprogramowanie w miejscu i zachowuje tożsamość urządzenia, dzięki czemu urządzenia nie rejestrują się ponownie, a ich historia zostaje zachowana. Przetestuj aktualizację na grupie pilotażowej, zanim wdrożysz ją w całej flocie.

## Odinstalowanie [#uninstall]

1. **Odinstaluj agenta** w sposób zwykły dla danej platformy (**Ustawienia → Aplikacje** w systemie Windows, narzędzie do dystrybucji oprogramowania lub MDM, `apt remove` lub `dnf remove` w systemie Linux). W systemie macOS uruchom `sudo dts-agent uninstall`. Odinstalowanie najpierw znosi izolację sieciową, a następnie usuwa usługę, pliki programu, stan agenta i jego klucz urządzenia.
2. **Usuń urządzenie** w [inwentarzu](https://dts-identity.com/pl/docs/endpoints/device-inventory.md). Odinstalowanie nie powiadamia platformy, więc wpis pozostaje, dopóki nie zostanie usunięty.

> **Uwaga:** W systemach Debian i Ubuntu `apt remove` zachowuje stan agenta, dopóki pakiet nie zostanie wyczyszczony (`apt purge`). Usunięcie pakietu `.rpm` oraz odinstalowanie w systemach Windows i macOS usuwa ten stan.

## Rozwiązywanie problemów

- **Urządzenie nigdy nie pojawia się w inwentarzu.** Uruchom `dts-agent status` na urządzeniu: polecenie wskazuje krok, który kończy się niepowodzeniem. Sprawdź, czy punkt końcowy może wychodzącym ruchem dotrzeć do instancji i czy tryb rejestracji przyjmuje nowe urządzenia. Instalator zbudowany dla innej instancji nigdy się nie zarejestruje.
- **Status zgłasza błąd połączenia, choć sieć działa.** Zwykle jest to serwer proxy inspekcjonujący TLS, którego certyfikat główny nie znajduje się w magazynie systemu operacyjnego. Zobacz [Wymagania](#requirements).
- **Urządzenie pojawia się dwa razy.** Maszynie wgrano nowy obraz systemu albo utraciła ona lokalny stan i zarejestrowała się ponownie. Usuń stary wpis.
- **Dane o oprogramowaniu lub poprawkach wyglądają na nieaktualne.** Stan zabezpieczeń jest zgłaszany zgodnie z harmonogramem. Użyj [akcji zdalnej](https://dts-identity.com/pl/docs/endpoints/remote-actions.md) **Request full update**, aby wymusić pełne zgłoszenie.
- **Przeglądarka prosi podczas logowania o zgodę na dostęp do sieci lokalnej.** Kontrole zgodności przy logowaniu działają w ten sposób, że strona logowania odpytuje agenta na tej samej maszynie. Chrome 142 i nowsze oraz Edge pytają użytkownika, zanim witryna uzyska dostęp do adresu lokalnego. Użytkownicy mogą na to zezwolić raz dla każdej witryny. W zarządzanych flotach należy zezwolić na to centralnie dla adresu logowania za pomocą zasady przeglądarki `LoopbackNetworkAllowedForUrls`, w przeciwnym razie monit zobaczy każdy użytkownik.
- **Urządzenia odciętego przez izolację nie można już zwolnić z konsoli.** Uruchom `dts-agent revert-isolation` na urządzeniu jako administrator lub root.

## Zobacz również

- [Ustawienia urządzeń](https://dts-identity.com/pl/docs/endpoints/device-settings.md): instalator i certyfikat rejestracji.
- [Inwentarz urządzeń](https://dts-identity.com/pl/docs/endpoints/device-inventory.md): zarejestrowane urządzenia i ich stan zabezpieczeń.
- [Akcje zdalne](https://dts-identity.com/pl/docs/endpoints/remote-actions.md): co można wywołać na punkcie końcowym.
- [MFA przy logowaniu do systemu Windows](https://dts-identity.com/pl/docs/endpoints/windows-logon-mfa.md): funkcja logowania oparta na agencie.
- [Legacy client](https://dts-identity.com/pl/docs/endpoints/legacy-client.md): urządzenia, na których nadal działa poprzedni klient dla systemu Windows.
