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

# RDS servers

Modul **RDS servers** registruje v produkte Bastion servery Windows Remote Desktop Services, ktoré budú hostiť publikované aplikácie alebo vzdialené pracovné plochy. Z tejto obrazovky môže správca vyhľadať servery v adresári, zaregistrovať ich, nasadiť na ne agenta Bastion alebo ho z nich odobrať a hromadne vytvárať aplikácie, ktoré na tieto servery cielia.

Aplikácie, ktoré tieto servery sprístupňujú používateľom, sa deklarujú v module [Applications](https://docs.cyberelements.io/bastion/4.6/sk/Usage/AdminConsoleReference/Applications/) a sprístupňujú sa prostredníctvom [access contract](https://docs.cyberelements.io/bastion/4.6/sk/Usage/AdminConsoleReference/AccessContracts/).

> **Predpoklad: doména musí povoľovať správu serverov RDS**
>
> Na tejto obrazovke sa zobrazujú iba domény overovania typu **LDAP / Active Directory** so začiarknutou možnosťou **Allow RDS server management** — práve táto možnosť robí doménu spôsobilou a začiarkava sa v module [Authentication domain](https://docs.cyberelements.io/bastion/4.6/sk/Usage/AdminConsoleReference/AuthenticationDomain/). Iné typy domén (lokálny adresár, SAML, anonymná) sa nikdy nezobrazujú bez ohľadu na ich konfiguráciu.

---

## Zoznam serverov

Hlavná obrazovka zobrazuje stránkovaný zoznam už zaregistrovaných serverov RDS.

### Filtre a vyhľadávanie

| Prvok | Popis |
|---|---|
| **Domain** | Rozbaľovací zoznam spôsobilých domén LDAP. Na začiatok sa pridáva syntetická položka **All**, ktorá zobrazí všetky servery bez ohľadu na doménu. |
| **Pole vyhľadávania** | Filtruje uvedené servery podľa podreťazca. Vyhľadávanie sa spustí 700 ms po poslednom stlačení klávesu alebo okamžite klávesom `Enter`. Ovládací prvok na vymazanie (krížik) vyhľadávanie vynuluje. |
| **Stránkovanie** | Výber veľkosti stránky (`15`, `25` alebo `50`). |
| **Stĺpce tabuľky** | **Name**, **Host**, **LDAP domain**. |

Tabuľka podporuje viacnásobný výber. Kým sa nevráti žiadny server, zobrazuje sa správa o prázdnom stave.

### Akcie panela s nástrojmi

Tlačidlá panela s nástrojmi sú kontextové: tie, ktoré pôsobia na existujúce servery, zostávajú zakázané, kým nie je vybraný aspoň jeden riadok.

| Akcia | Dostupnosť | Účinok |
|---|---|---|
| **+** – popis **Register RDS servers** | Vždy k dispozícii | Otvorí okno registrácie s tromi kartami (pozrite časť [Registrácia jedného alebo viacerých serverov](#register-one-or-several-servers)). |
| **×** (Delete) | Výber ≥ 1 | Otvorí okno potvrdenia (pozrite časť [Odstránenie servera](#delete-a-server)). |
| **Deploy Agent** | Výber ≥ 1 | Otvorí formulár na nasadenie agenta Bastion na vybrané servery (pozrite kapitolu [Deploy Agent (priama akcia)](#deploy-agent-direct-action)). |
| **Remove Agent** | Výber ≥ 1 | Otvorí formulár na odinštalovanie agenta Bastion z vybraných serverov (pozrite kapitolu [Odobratie agenta](#agent-removal)). |
| **New applications** | Výber ≥ 1 | Otvorí formulár hromadného vytvorenia aplikácie, replikovanej pre každý vybraný server (pozrite časť [Hromadné vytváranie aplikácií](#bulk-application-creation)). |

---

## Registrácia jedného alebo viacerých serverov

Tlačidlo **+** otvorí modálne okno s **tromi kartami**. Karta **Server registration** je vždy aktívna. Ostatné dve sa aktivujú, len ak ich výber aspoň jedného servera robí relevantnými.

**Server registration**

> Karta zobrazuje dva panely vedľa seba. Vľavo zisťovanie serverov dostupných v adresári; vpravo zoznam serverov vybraných na túto registráciu.
>
> | Prvok | Popis |
> |---|---|
> | **Domain** | Cieľová doména LDAP. Obmedzí ľavý zoznam na servery tejto domény. |
> | **Pole vyhľadávania** | Filter podľa podreťazca. Spustí sa po 1200 ms nečinnosti alebo klávesom `Enter`. |
> | **Ľavý zoznam** | Servery RDS zistené v doméne (názov, doména, DNS). Už zaregistrované servery sa automaticky vylúčia. V dolnej časti sú k dispozícii tlačidlá **Select all** a **Refresh**. |
> | **Pravý zoznam** | Servery vybrané na túto registráciu. Presunutím myšou z ľavého zoznamu sa servery pridávajú; každú dlaždicu možno jednotlivo odobrať jej krížikom na zatvorenie. |
> | **Počítadlo** | Zobrazuje počet vybraných serverov voči povolenému maximu v tvare ***n* / 200 RDS servers**. |
>
> Pre každý server pridaný vpravo sa ponúkajú dve začiarkavacie políčka:
>
> | Začiarkavacie políčko | Účinok |
> |---|---|
> | **Deploy an agent** | Označí tento server na nasadenie agenta Bastion v rámci tej istej operácie. Aktivuje kartu **Agent deployment**. |
> | **Create applications** | Označí tento server na vytvorenie aplikácií definovaných na karte **New applications**. Aktivuje túto kartu. |
>
> Dve tlačidlá **Deploy an agent** a **Create applications**, umiestnené nad dlaždicami, naraz začiarknu alebo zrušia začiarknutie príslušného políčka na **všetkých** vybraných serveroch.
>
> > **Limit výberu**
> >
> > V jednej operácii registrácie možno spracovať najviac **200 serverov**. Každý pokus o pridanie serverov nad tento limit sa odmietne s upozornením.
>
> > **Nedostupné domény**
> >
> > Ak niektorá z dopytovaných domén neodpovedá, chybové hlásenie uvedie zlyhávajúce domény a počet vykonaných pokusov (`Error` pri okamžitom zlyhaní, `5 retries` po piatich pokusoch). Servery z dostupných domén sa napriek tomu zobrazia.

**Agent deployment**

> Karta je aktívna, len ak má aspoň jeden server v pravom zozname začiarknuté políčko **Agent deployment**. Všetky polia sú povinné.
>
> | Pole | Popis |
> |---|---|
> | **Target Server** | Server, na ktorý sa má agent nasadiť. **V režime viacerých serverov skryté a zakázané**: cieľ sa potom vypočíta z vybraných serverov. |
> | **Target drive** | Písmeno jednotky, na ktorú sa má agent nainštalovať. |
> | **Target directory** | Inštalačná cesta agenta na serveri. Znaky `"` a `'` sa odmietajú už pri zadávaní. |
> | **Gateway** | Server Edge Gateway produktu Bastion, ktorý riadi nasadenie. |
> | **Domain** | Doména overovania inštalačného účtu. |
> | **Username** | Účet s právom inštalovať softvér na cieľový server. |
> | **Password** | Heslo inštalačného účtu (maskované). |

**New applications**

> Karta je aktívna, len ak má aspoň jeden server v pravom zozname začiarknuté políčko **New applications**.
>
> Karta zobrazuje tabuľku **šablón aplikácií**, ktoré sa majú vytvoriť na každom vybranom serveri. Tri akcie:
>
> | Tlačidlo | Účinok |
> |---|---|
> | **+** – popis **New application template** | Otvorí formulár na pridanie aplikácie v skupinovom režime. Ponúkajú sa len typy služieb **RDP** a **HTML5 RDP**. |
> | **Edit** | Aktívne, keď je vybraný práve jeden riadok. |
> | **×** | Odoberie vybrané šablóny. |
>
> Stĺpce tabuľky:
>
> | Stĺpec | Obsah |
> |---|---|
> | **Name** | Názov šablóny s ikonou typu služby na začiatku. |
> | **Recording** | Vizuálny príznak možnosti nahrávania videa. |
> | **SSO / Remote application / Working directory** | Súhrn zvoleného režimu SSO (`SSO`, `No SSO`, `Ask password`, `Fixed SSO`), voliteľného aliasu, názvu vzdialenej aplikácie (RemoteApp) a spúšťacieho priečinka. |
>
> Názvy šablón musia byť v zozname **jedinečné**: duplikát sa odmietne s upozornením.
>
> > **Premenná v názve šablóny**
> >
> > Ak chcete pre každý server vygenerovať iný názov, použite v poli **Name** šablóny znaky `{` a `}`. Bez zložených zátvoriek sa názov servera pripojí na koniec názvu šablóny. So zloženými zátvorkami nahradí `{}`.
> >
> > - Šablóna `Application RDP` použitá na server `srv1` → `Application RDP srv1`
> > - Šablóna `Application {} RDP` použitá na server `srv1` → `Application srv1 RDP`

### Potvrdenie a zostava

Tlačidlo **Validate** je povolené, len ak:

- je v pravom zozname aspoň jeden server,
- karta **Agent deployment** je platná (ak sa vyžaduje),
- karta **New applications** obsahuje aspoň jednu šablónu (ak sa vyžaduje).

Po odoslaní sa otvorí okno **zostavy** s jednou kartou na každú operáciu (registrácia, nasadenie agenta, vytvorenie aplikácií). Každý riadok dostáva počas priebehu stav: *prebieha*, *úspech*, *všeobecná chyba*, *povolenie zamietnuté*, *agent už existuje* alebo *neznámy stav (žiadna odpoveď)*. Tlačidlo **Close** je povolené až po skončení všetkých operácií.

> **Sledovanie inštalácie agenta**
>
> Inštalácia agenta je asynchrónna, preto zostava každých 5 sekúnd dopytuje server, aby obnovila stav, kým je úloha označená ako `INPROGRESS`.

---

## Deploy Agent (priama akcia)

Tlačidlo **Deploy Agent** na paneli s nástrojmi priamo otvorí formulár nasadenia, vopred vyplnený servermi vybranými v hlavnom zozname – pole **Target Server** potom obsahuje ich názvy oddelené čiarkami.

Polia sú tie isté ako na karte **Agent deployment** v časti [Registrácia jedného alebo viacerých serverov](#register-one-or-several-servers), s jedným rozdielom: **Target Server** je tu viditeľné a upraviteľné, keďže režim viacerých serverov sa neuplatňuje. Všetky polia sú povinné.

Po odoslaní sa hlavná tabuľka počas operácie uzamkne a pravidelné dopytovanie (každých 5 sekúnd) obnovuje stav inštalácie až do dokončenia.

---

## Odobratie agenta

Tlačidlo **Remove Agent** na paneli s nástrojmi otvorí formulár na odinštalovanie agenta z vybraných serverov.

| Pole | Popis |
|---|---|
| **Target Server** | Príslušné servery, vopred vyplnené a oddelené čiarkami. |
| **Gateway** | Server Edge Gateway produktu Bastion, ktorý sa používa na riadenie odinštalovania. |
| **Domain** | Doména overovania správcovského účtu. |
| **Username** | Účet s právom odinštalovať agenta zo servera. |
| **Password** | Heslo účtu (maskované). |

Všetky polia sú povinné.

---

## Odstránenie servera

Tlačidlo **×** na paneli s nástrojmi otvorí okno potvrdenia. Úvodný text sa prispôsobí výberu (jeden server alebo viac serverov).

Ponúkajú sa dve nezávislé možnosti:

| Možnosť | Účinok |
|---|---|
| **Delete Bastion agents** | Ak je začiarknuté, pri odstraňovaní sa na príslušných serveroch spustí postup odinštalovania. Následne sa zobrazí okno odinštalovania (kapitola [Odobratie agenta](#agent-removal)) na zadanie parametrov prístupu. |
| **Delete related applications** | Ak je začiarknuté, súčasne sa odstránia aplikácie, ktoré cielia na tieto servery. |

Po odoslaní okno zostavy zhrnie výsledok každej operácie.

> **Odstránenie bez odobratia agenta**
>
> Ak nie je začiarknuté políčko odinštalovania, položka servera sa z produktu Bastion odoberie, ale agent zostane nainštalovaný v počítači. Bude ho potrebné odinštalovať manuálne alebo prostredníctvom novej operácie **Remove Agent**.

---

## Hromadné vytváranie aplikácií

Tlačidlo **New applications** na paneli s nástrojmi otvorí formulár na skupinové pridanie aplikácií bez predchádzajúceho kroku registrácie. Ide o formulár modulu **Applications**, obmedzený na typy služieb **RDP** a **HTML5 RDP**.

Po odoslaní sa aplikácia vytvorí na každom serveri vybranom v hlavnom zozname, pričom sa uplatní mechanizmus premenných v názve opísaný v časti [Registrácia jedného alebo viacerých serverov](#register-one-or-several-servers) (použitie `{}` na vloženie názvu servera). Okno zostavy zobrazuje výsledok riadok po riadku.
