> Source: https://docs.cyberelements.io/bastion/4.6/lt/Usage/AdminConsoleReference/RDSServers/

# RDS servers

Modulis **RDS servers** užregistruoja Bastion sistemoje Windows Remote Desktop Services serverius, kuriuose bus talpinamos publikuotos taikomosios programos arba nuotoliniai darbalaukiai. Šiame ekrane administratorius gali aptikti serverius kataloge, juos užregistruoti, įdiegti ar pašalinti juose Bastion agentą ir masiškai kurti taikomąsias programas, nukreiptas į tuos serverius.

Taikomosios programos, kurios šiuos serverius pateikia vartotojams, deklaruojamos modulyje [Applications](https://docs.cyberelements.io/bastion/4.6/lt/Usage/AdminConsoleReference/Applications/) ir padaromos prieinamos per sutartį [access contract](https://docs.cyberelements.io/bastion/4.6/lt/Usage/AdminConsoleReference/AccessContracts/).

> **Būtinoji sąlyga: domenas turi leisti RDS serverių valdymą**
>
> Šiame ekrane rodomi tik **LDAP / Active Directory** autentifikavimo domenai, kuriuose pažymėta parinktis **Allow RDS server management** – būtent ši parinktis daro domeną tinkamą, ir ji pažymima modulyje [Authentication domain](https://docs.cyberelements.io/bastion/4.6/lt/Usage/AdminConsoleReference/AuthenticationDomain/). Kiti domenų tipai (vietinis katalogas, SAML, anoniminis) niekada nerodomi, nepriklausomai nuo jų konfigūracijos.

---

## Serverių sąrašas

Pagrindiniame ekrane rodomas puslapiuotas jau užregistruotų RDS serverių sąrašas.

### Filtrai ir paieška

| Elementas | Aprašas |
|---|---|
| **Domain** | Tinkamų LDAP domenų išplečiamasis sąrašas. Viršuje pridedamas apibendrinantis įrašas **All**, kad būtų rodomi visi serveriai, nepriklausomai nuo domeno. |
| **Paieškos laukas** | Filtruoja pateiktus serverius pagal poeilutę. Paieška paleidžiama praėjus 700 ms po paskutinio klavišo paspaudimo arba iš karto paspaudus `Enter`. Išvalymo mygtukas (kryželis) išvalo paiešką. |
| **Pagination** | Puslapio dydžio parinkiklis (`15`, `25` arba `50`). |
| **Lentelės stulpeliai** | **Name**, **Host**, **LDAP domain**. |

Lentelėje galima pasirinkti kelis elementus. Kol negrąžinamas nė vienas serveris, rodomas tuščios būsenos pranešimas.

### Įrankių juostos veiksmai

Įrankių juostos mygtukai priklauso nuo konteksto: tie, kurie veikia esamus serverius, lieka išjungti, kol nepasirenkama bent viena eilutė.

| Veiksmas | Prieinamumas | Poveikis |
|---|---|---|
| **+** — patarimas **Register RDS servers** | Visada pasiekiamas | Atidaro registravimo langą su trimis skirtukais (žr. skyrių [Vieno ar kelių serverių registravimas](#register-one-or-several-servers)). |
| **×** (Naikinti) | Pasirinkta ≥ 1 | Atidaro patvirtinimo langą (žr. skyrių [Serverio naikinimas](#delete-a-server)). |
| **Deploy Agent** | Pasirinkta ≥ 1 | Atidaro formą, skirtą Bastion agentui įdiegti pasirinktuose serveriuose (žr. skyrių [Deploy Agent (tiesioginis veiksmas)](#deploy-agent-direct-action)). |
| **Remove Agent** | Pasirinkta ≥ 1 | Atidaro formą, skirtą Bastion agentui pašalinti iš pasirinktų serverių (žr. skyrių [Agento šalinimas](#agent-removal)). |
| **New applications** | Pasirinkta ≥ 1 | Atidaro masinio taikomosios programos kūrimo formą; programa sukuriama kiekvienam pasirinktam serveriui (žr. skyrių [Masinis taikomųjų programų kūrimas](#bulk-application-creation)). |

---

## Vieno ar kelių serverių registravimas

Mygtukas **+** atidaro modalinį langą su **trimis skirtukais**. Skirtukas **Server registration** visada aktyvus. Kiti du tampa aktyvūs tik tada, kai juos aktualius padaro bent vieno serverio pasirinkimas.

**Server registration**

> Skirtuke rodomos dvi greta esančios sritys. Kairėje – kataloge pasiekiamų serverių aptikimas; dešinėje – šiam registravimui pasirinktų serverių sąrašas.
>
> | Elementas | Aprašas |
> |---|---|
> | **Domain** | Tikslinis LDAP domenas. Kairiajame sąraše paliekami tik šio domeno serveriai. |
> | **Paieškos laukas** | Filtras pagal poeilutę. Suaktyvinamas po 1200 ms neveiklumo arba paspaudus `Enter`. |
> | **Kairysis sąrašas** | Domene aptikti RDS serveriai (pavadinimas, domenas, DNS). Jau užregistruoti serveriai automatiškai neįtraukiami. Apačioje yra mygtukai **Select all** ir **Refresh**. |
> | **Dešinysis sąrašas** | Šiam registravimui pasirinkti serveriai. Serveriai pridedami vilkant ir numetant iš kairiojo sąrašo; kiekvieną plytelę galima pašalinti atskirai jos uždarymo kryželiu. |
> | **Skaitiklis** | Rodo pasirinktų serverių skaičių, palyginti su didžiausiu leistinu, forma ***n* / 200 RDS servers**. |
>
> Kiekvienam dešinėje pridėtam serveriui siūlomi du žymės langeliai:
>
> | Žymės langelis | Poveikis |
> |---|---|
> | **Deploy an agent** | Pažymi šį serverį, kad toje pačioje operacijoje jame būtų įdiegtas Bastion agentas. Suaktyvina skirtuką **Agent deployment**. |
> | **Create applications** | Pažymi šį serverį, kad jam būtų sukurtos skirtuke **New applications** apibrėžtos taikomosios programos. Suaktyvina tą skirtuką. |
>
> Du virš plytelių esantys mygtukai **Deploy an agent** ir **Create applications** vienu kartu pažymi arba atžymi atitinkamą žymės langelį **visuose** pasirinktuose serveriuose.
>
> > **Pasirinkimo riba**
> >
> > Per vieną registravimo operaciją galima apdoroti ne daugiau kaip **200 serverių**. Bet koks bandymas pridėti serverių virš šios ribos atmetamas ir rodomas perspėjimo pranešimas.
>
> > **Nepasiekiami domenai**
> >
> > Jei kuris nors iš užklaustų domenų neatsako, klaidos pranešime pateikiami nepavykę domenai ir atliktų bandymų skaičius (`Error` – kai nepavyksta iš karto, `5 retries` – po penkių bandymų). Pasiekiamų domenų serveriai vis tiek rodomi.

**Agent deployment**

> Skirtukas aktyvus tik tada, kai bent vienam dešiniojo sąrašo serveriui pažymėtas žymės langelis **Agent deployment**. Visi laukai privalomi.
>
> | Laukas | Aprašas |
> |---|---|
> | **Target Server** | Serveris, į kurį diegiamas agentas. **Kelių serverių režimu paslėptas ir išjungtas**: tada tikslas apskaičiuojamas pagal pasirinktus serverius. |
> | **Target drive** | Disko, kuriame bus įdiegtas agentas, raidė. |
> | **Target directory** | Agento diegimo kelias serveryje. Simboliai `"` ir `'` atmetami įvedant. |
> | **Gateway** | Bastion Edge Gateway, valdantis diegimą. |
> | **Domain** | Diegimo paskyros autentifikavimo domenas. |
> | **Username** | Paskyra, kuriai leidžiama diegti programinę įrangą tiksliniame serveryje. |
> | **Password** | Diegimo paskyros slaptažodis (paslėptas). |

**New applications**

> Skirtukas aktyvus tik tada, kai bent vienam dešiniojo sąrašo serveriui pažymėtas žymės langelis **New applications**.
>
> Skirtuke rodoma **taikomųjų programų šablonų**, kuriuos reikia sukurti kiekviename pasirinktame serveryje, lentelė. Trys veiksmai:
>
> | Mygtukas | Poveikis |
> |---|---|
> | **+** — patarimas **New application template** | Atidaro taikomosios programos pridėjimo formą grupiniu režimu. Siūlomi tik paslaugų tipai **RDP** ir **HTML5 RDP**. |
> | **Edit** | Aktyvus, kai pasirinkta lygiai viena eilutė. |
> | **×** | Pašalina pasirinktus šablonus. |
>
> Lentelės stulpeliai:
>
> | Stulpelis | Turinys |
> |---|---|
> | **Name** | Šablono pavadinimas, prieš kurį rodoma paslaugos tipo piktograma. |
> | **Recording** | Vaizdinė vaizdo įrašymo parinkties žyma. |
> | **SSO / Remote application / Working directory** | Pasirinkto SSO režimo (`SSO`, `No SSO`, `Ask password`, `Fixed SSO`), neprivalomo pseudonimo, nuotolinės taikomosios programos pavadinimo (RemoteApp) ir paleidimo aplanko suvestinė. |
>
> Šablonų pavadinimai sąraše turi būti **unikalūs**: dublikatas atmetamas ir rodomas perspėjimas.
>
> > **Šablono pavadinimo parametrizavimas**
> >
> > Norėdami kiekvienam serveriui sugeneruoti skirtingą pavadinimą, šablono lauke **Name** naudokite simbolius `{` ir `}`. Be riestinių skliaustų serverio pavadinimas pridedamas šablono pavadinimo pabaigoje. Su riestiniais skliaustais jis pakeičia `{}`.
> >
> > - Šablonas `Application RDP`, pritaikytas serveriui `srv1` → `Application RDP srv1`
> > - Šablonas `Application {} RDP`, pritaikytas serveriui `srv1` → `Application srv1 RDP`

### Patvirtinimas ir ataskaita

Mygtukas **Validate** aktyvus tik tada, kai:

- dešiniajame sąraše yra bent vienas serveris,
- skirtukas **Agent deployment** tinkamai užpildytas (kai jo reikia),
- skirtuke **New applications** yra bent vienas šablonas (kai jo reikia).

Pateikus atidaromas **ataskaitos** langas su atskiru skirtuku kiekvienai operacijai (registravimas, agento diegimas, taikomųjų programų kūrimas). Vykdymo metu kiekvienai eilutei suteikiama būsena: *vykdoma*, *sėkminga*, *bendroji klaida*, *leidimas nesuteiktas*, *agentas jau yra* arba *nežinoma būsena (nėra atsakymo)*. Mygtukas **Close** tampa aktyvus tik baigus visas operacijas.

> **Agento diegimo stebėjimas**
>
> Agentas diegiamas asinchroniškai, todėl ataskaita kas 5 sekundes apklausia serverį ir atnaujina būseną, kol užduotis pažymėta `INPROGRESS`.

---

## Deploy Agent (tiesioginis veiksmas)

Įrankių juostos mygtukas **Deploy Agent** tiesiogiai atidaro diegimo formą, iš anksto užpildytą pagrindiniame sąraše pasirinktais serveriais – tada lauke **Target Server** pateikiami jų pavadinimai, atskirti kableliais.

Laukai tie patys kaip skyriaus [Vieno ar kelių serverių registravimas](#register-one-or-several-servers) skirtuke **Agent deployment**, su vienu skirtumu: čia laukas **Target Server** matomas ir redaguojamas, nes kelių serverių režimas netaikomas. Visi laukai privalomi.

Pateikus pagrindinė lentelė užrakinama, kol vykdoma operacija, o periodinė apklausa (kas 5 sekundes) atnaujina diegimo būseną, kol diegimas baigiamas.

---

## Agento šalinimas

Įrankių juostos mygtukas **Remove Agent** atidaro agento pašalinimo iš pasirinktų serverių formą.

| Laukas | Aprašas |
|---|---|
| **Target Server** | Susiję serveriai, iš anksto įrašyti ir atskirti kableliais. |
| **Gateway** | Bastion Edge Gateway, naudojamas pašalinimui valdyti. |
| **Domain** | Administravimo paskyros autentifikavimo domenas. |
| **Username** | Paskyra, kuriai leidžiama pašalinti agentą iš serverio. |
| **Password** | Paskyros slaptažodis (paslėptas). |

Visi laukai privalomi.

---

## Serverio naikinimas

Įrankių juostos mygtukas **×** atidaro patvirtinimo langą. Įžanginis tekstas pritaikomas pagal pasirinkimą (vienas ar keli serveriai).

Siūlomos dvi nepriklausomos parinktys:

| Parinktis | Poveikis |
|---|---|
| **Delete Bastion agents** | Pažymėjus, naikinimo metu paveiktuose serveriuose vykdoma pašalinimo procedūra. Tada atidaromas pašalinimo langas (skyrius [Agento šalinimas](#agent-removal)), kuriame surenkami prieigos parametrai. |
| **Delete related applications** | Jei pažymėta, kartu panaikinamos ir šiems serveriams skirtos taikomosios programos. |

Pateikus ataskaitos lange apibendrinamas kiekvienos operacijos rezultatas.

> **Naikinimas nepašalinant agento**
>
> Jei pašalinimo žymės langelis nepažymėtas, serverio įrašas pašalinamas iš Bastion, tačiau agentas lieka įdiegtas kompiuteryje. Jį reikės pašalinti rankiniu būdu arba nauja operacija **Remove Agent**.

---

## Masinis taikomųjų programų kūrimas

Įrankių juostos mygtukas **New applications** atidaro grupinio taikomųjų programų pridėjimo formą be išankstinio registravimo veiksmo. Tai modulio **Applications** forma, apribota paslaugų tipais **RDP** ir **HTML5 RDP**.

Pateikus taikomoji programa sukuriama kiekviename pagrindiniame sąraše pasirinktame serveryje, taikant skyriuje [Vieno ar kelių serverių registravimas](#register-one-or-several-servers) aprašytą pavadinimų parametrizavimo mechanizmą (`{}` naudojimas serverio pavadinimui įterpti). Ataskaitos lange rezultatas rodomas eilutė po eilutės.
