> Source: https://docs.cyberelements.io/bastion/4.6/lt/Installation/ClientAndAgent/AgentLinuxInstallation/

# Linux agento įdiegimas

CyberElements Bastion naudoja Linux agentą, kad apribotų galimą tinklo prieigą iš vartotojų pasiekiamų SSH serverių (apibrėžtų prieigos politikose / sutartyse).

## Būtinosios sąlygos

Kad agentas veiktų tinkamai, reikia kelių būtinųjų sąlygų:

- Suderinamos OS: Red Hat 9 ir Debian 12
- Įdiegta užkarda `iptables`
- Prisijungimas kita paskyra nei `root`

> **Informacija**
>
> Linux agentas nedaro poveikio vartotojui `root`, nes šis vartotojas visada turi pakankamai teisių pašalinti bet kokius jam taikomus apribojimus.
>
> Be to, kadangi kai kurios paslaugos naudoja `root` teises, papildomi tinklo apribojimai galėtų padaryti šias paslaugas nestabilias.

## Veikimas

Linux agentą sudaro kelios dalys:

- systemd paslauga, pavadinta `cleanroom-filter`
- PAM modulis, pavadintas `pam_clr_filter`
- Red Hat skirta SELinux politika, leidžianti SSH serveriui bendrauti su paslauga `cleanroom-filter`

Bendra veikimo seka yra tokia:

```mermaid
sequenceDiagram
    autonumber
    participant MED as Mediation Controller
    participant GW_SSH as Edge Gateway<br/>SSH įrašymo įrenginys
    participant SSH as SSH tikslinė sistema<br/>SSH serveris
    participant PAM as SSH tikslinė sistema<br/>PAM modulis pam_clr_filter
    participant svc as SSH tikslinė sistema<br/>tarnyba cleanroom-filter

    MED->>GW_SSH: Užklausa atidaryti<br/>SSH taikomąją programą
    GW_SSH->>+MED: Filtravimo informacijos gavimas<br/>seansui
    MED->>-GW_SSH: Tinklo filtravimo<br/>informacijos siuntimas
    GW_SSH->>+SSH: SSH ryšys
    SSH-->-PAM: SSH seanso sukūrimas
    PAM->>+svc: Vartotojo vardo siuntimas
    Note right of svc: iptables grandinės clr-LOGIN <br/>sukūrimas vartotojui
    svc->>-PAM: Unikalaus tokeno siuntimas
    Note over PAM: Aplinkos kintamojo CLR-ID<br/> su unikaliu tokenu pridėjimas<br/> prie vartotojo seanso
    GW_SSH->>svc: Leistinų tinklų sąrašo siuntimas
    Note over svc: iptables OUTPUT taisyklės sukūrimas<br/> vartotojo srautui nukreipti į anksčiau sukurtą<br/> iptables grandinę
    Note over svc: Leidimų pridėjimas į vartotojui<br/> sukurtą iptables grandinę
    break SSH seanso pabaiga
        SSH->>+GW_SSH: Pranešimas apie seanso pabaigą
        SSH-->svc: SSH seanso pabaigos aptikimas
        Note over svc: Vartotojui sukurtos<br/> iptables OUTPUT taisyklės panaikinimas
        Note over svc: Vartotojui sukurtos<br/> iptables grandinės panaikinimas
        GW_SSH->>-MED: Pranešimas apie vartotojo<br/> SSH seanso pabaigą
    end
```

1. Mediation Controller serveris siunčia komponentui Edge Gateway informaciją naujam SSH seansui atidaryti.
2. SSH įrašymo paslauga paprašo Mediation Controller serverio tinklo filtravimo informacijos, taikytinos SSH seansui.
3. Mediation Controller atsako autorizuotų tinklų sąrašu.
4. Tada SSH įrašymo paslauga užmezga ryšį su tiksliniu SSH serveriu.
5. Prisijungimas prie SSH serverio paleidžia seanso kūrimo seką, taigi ir perėjimą per `sshd` priskirtus PAM modulius.
6. Linux agento PAM modulis `pam_clr_filter` siunčia vartotojo vardą paslaugai `cleanroom-filter`, kuri sukuria naują iptables grandinę, pavadintą `clr-LOGIN`, kur LOGIN pakeičiamas gautu vartotojo vardu.
7. Sukūrusi iptables grandinę, paslauga `cleanroom-filter` sugeneruoja atsitiktinį tokeną ir nusiunčia jį PAM moduliui `pam_clr_filter`. Šis modulis įrašo tokeną į vartotojo aplinkos kintamąjį `CLR-ID`.
8. SSH įrašymo paslauga per vykdomąjį failą `/usr/local/ipdiva/bin/cleanroom-netfiltersession.py` nusiunčia paslaugai `cleanroom-filter` autorizuotinų tinklų sąrašą. Tada paslauga sukuria iptables taisyklę `OUTPUT`, kuri visą vartotojo, identifikuojamo pagal jo UID, duomenų srautą nukreipia į 6 veiksme sukurtą iptables grandinę. Visi vartotojui autorizuotini srautai įtraukiami į iptables grandinę.
9. Inicijavus SSH seanso pabaigą, informacija siunčiama komponento Edge Gateway SSH įrašymo paslaugai.
10. Paslauga `cleanroom-filter` aptinka vartotojo seanso pabaigą ir išvalo pridėtas iptables taisykles: panaikina direktyvą `OUTPUT`, nukreipiančią vartotojo duomenų srautą į iptables grandinę, ir panaikina pačią grandinę.
11. Kai Edge Gateway gauna SSH seanso pabaigą, jis persiunčia šią informaciją į Mediation Controller.

## Įdiegimas

> **Būtini `root` leidimai**
>
> Agentui įdiegti reikia `root` privilegijų.

Paketą .deb arba .rpm galima atsisiųsti iš administravimo konsolės:

1. Atidarykite darbo sritį „Configurations“ naudodami mygtuką viršuje kairėje: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Open_Configurations_workspace_CLR.png)
2. Atidarykite plytelę „Toolbox“ ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Configurations_Toolbox_tile_CLR.png)
3. Pirmajame skirtuke „Integration Tools“ pasirinkite norimai operacinei sistemai tinkamą sąrankos programą ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Configurations_Toolbox_clr_Integration_tools.png)

Gavę paketą, nusiųskite jį į Linux serverio katalogą `/tmp/`. Tada vykdykite savo operacinės sistemos diegimo instrukcijas:

**Debian**

> Vykdykite šias komandas su atitinkamais `root` leidimais:
>
> ```
> 1
> 2
> ```
>
> Antroji komanda automatiškai įtraukia dvi eilutes į failą `/etc/pam.d/sshd`, tačiau šią operaciją galima atlikti ir rankiniu būdu:
>
> ```
> 27
> 28
> 29
> 30
> 31
> 32
> 33
> 34
> 35
> 36
> 37
> ```

**Red Hat**

> Vykdykite šias komandas su `root` leidimais:
>
> ```
> 1
> 2
> ```
>
> Antroji komanda automatiškai įtraukia dvi eilutes į failą `/etc/pam.d/sshd`, tačiau šią operaciją galima atlikti ir rankiniu būdu:
>
> ```
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> ```
