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

# RDS servers

Modul **RDS servers** registruje v Bastion servery služby Windows Remote Desktop Services, které budou hostovat publikované aplikace nebo vzdálené plochy. Z této obrazovky může správce vyhledat servery v adresáři, zaregistrovat je, nasadit na ně agenta Bastion nebo ho z nich odebrat a hromadně vytvářet aplikace, které na tyto servery cílí.

Aplikace, které tyto servery zpřístupňují uživatelům, se deklarují v modulu [Applications](https://docs.cyberelements.io/bastion/4.6/cs/Usage/AdminConsoleReference/Applications/) a zpřístupňují se prostřednictvím [access contract](https://docs.cyberelements.io/bastion/4.6/cs/Usage/AdminConsoleReference/AccessContracts/).

> **Předpoklad: doména musí umožňovat správu serverů RDS**
>
> Na této obrazovce se zobrazují pouze domény ověřování typu **LDAP / Active Directory** se zaškrtnutou možností **Allow RDS server management** — právě tato možnost činí doménu způsobilou a zaškrtává se v modulu [Authentication domain](https://docs.cyberelements.io/bastion/4.6/cs/Usage/AdminConsoleReference/AuthenticationDomain/). Ostatní typy domén (místní adresář, SAML, anonymní) se nikdy nezobrazují, bez ohledu na jejich konfiguraci.

---

## Seznam serverů

Hlavní obrazovka zobrazuje stránkovaný seznam již registrovaných serverů RDS.

### Filtry a hledání

| Prvek | Popis |
|---|---|
| **Domain** | Rozevírací seznam způsobilých domén LDAP. Nahoře je přidána souhrnná položka **All**, která zobrazí všechny servery bez ohledu na doménu. |
| **Pole hledání** | Filtruje uvedené servery podle podřetězce. Hledání se spustí 700 ms po posledním stisknutí klávesy nebo okamžitě klávesou `Enter`. Ovládací prvek pro vymazání (křížek) hledání resetuje. |
| **Stránkování** | Výběr velikosti stránky (`15`, `25` nebo `50`). |
| **Sloupce tabulky** | **Name**, **Host**, **LDAP domain**. |

Tabulka podporuje vícenásobný výběr. Dokud se nevrátí žádný server, zobrazuje se zpráva o prázdném stavu.

### Akce panelu nástrojů

Tlačítka panelu nástrojů jsou kontextová: ta, která pracují s existujícími servery, zůstávají zakázaná, dokud není vybrán alespoň jeden řádek.

| Akce | Dostupnost | Účinek |
|---|---|---|
| **+** — popis **Register RDS servers** | Vždy k dispozici | Otevře okno registrace se třemi kartami (viz kapitola [Registrace jednoho nebo několika serverů](#register-one-or-several-servers)). |
| **×** (Delete) | Výběr ≥ 1 | Otevře okno potvrzení (viz kapitola [Odstranění serveru](#delete-a-server)). |
| **Deploy Agent** | Výběr ≥ 1 | Otevře formulář pro nasazení agenta Bastion na vybrané servery (viz kapitola [Deploy Agent (přímá akce)](#deploy-agent-direct-action)). |
| **Remove Agent** | Výběr ≥ 1 | Otevře formulář pro odinstalaci agenta Bastion z vybraných serverů (viz kapitola [Odebrání agenta](#agent-removal)). |
| **New applications** | Výběr ≥ 1 | Otevře formulář pro hromadné vytvoření aplikace, replikované pro každý vybraný server (viz kapitola [Hromadné vytváření aplikací](#bulk-application-creation)). |

---

## Registrace jednoho nebo několika serverů

Tlačítko **+** otevře modální okno se **třemi kartami**. Karta **Server registration** je vždy aktivní. Zbylé dvě se aktivují pouze tehdy, když je výběr alespoň jednoho serveru učiní relevantními.

**Server registration**

> Karta zobrazuje dva panely vedle sebe. Vlevo zjišťování serverů dostupných v adresáři; vpravo seznam serverů vybraných pro tuto registraci.
>
> | Prvek | Popis |
> |---|---|
> | **Domain** | Cílová doména LDAP. Omezí levý seznam na servery této domény. |
> | **Pole hledání** | Filtr podle podřetězce. Spustí se po 1200 ms nečinnosti nebo klávesou `Enter`. |
> | **Levý seznam** | Servery RDS zjištěné v doméně (název, doména, DNS). Již registrované servery jsou automaticky vyloučeny. Dole jsou k dispozici tlačítka **Select all** a **Refresh**. |
> | **Pravý seznam** | Servery zvolené pro tuto registraci. Přetažením z levého seznamu se servery přidají; každou dlaždici lze jednotlivě odebrat jejím zavíracím křížkem. |
> | **Čítač** | Zobrazuje počet vybraných serverů vzhledem k nejvyššímu přípustnému počtu ve tvaru ***n* / 200 RDS servers**. |
>
> Pro každý server přidaný vpravo se nabízejí dvě zaškrtávací políčka:
>
> | Zaškrtávací políčko | Účinek |
> |---|---|
> | **Deploy an agent** | Označí tento server pro nasazení agenta Bastion v rámci téže operace. Aktivuje kartu **Agent deployment**. |
> | **Create applications** | Označí tento server pro vytvoření aplikací definovaných na kartě **New applications**. Aktivuje tuto kartu. |
>
> Dvě tlačítka **Deploy an agent** a **Create applications**, umístěná nad dlaždicemi, najednou zaškrtnou nebo zruší zaškrtnutí odpovídajícího políčka u **všech** vybraných serverů.
>
> > **Omezení výběru**
> >
> > V jedné operaci registrace lze zpracovat nejvýše **200 serverů**. Každý pokus přidat servery nad tento limit je odmítnut s upozorněním.
>
> > **Nedostupné domény**
> >
> > Pokud některá z dotazovaných domén neodpovídá, chybová zpráva uvede selhávající domény a počet provedených pokusů (`Error` při okamžitém selhání, `5 retries` po pěti pokusech). Servery z dostupných domén se přesto zobrazí.

**Agent deployment**

> Karta je aktivní pouze tehdy, když má alespoň jeden server v pravém seznamu zaškrtnuté políčko **Agent deployment**. Všechna pole jsou povinná.
>
> | Pole | Popis |
> |---|---|
> | **Target Server** | Server, na který se má agent nasadit. **V režimu více serverů skryto a zakázáno**: cíl se pak určí z vybraných serverů. |
> | **Target drive** | Písmeno jednotky, na kterou se má agent nainstalovat. |
> | **Target directory** | Instalační cesta agenta na serveru. Znaky `"` a `'` jsou při zadávání odmítnuty. |
> | **Gateway** | Server Edge Gateway produktu Bastion, který řídí nasazení. |
> | **Domain** | Doména ověřování instalačního účtu. |
> | **Username** | Účet, který má oprávnění instalovat software na cílový server. |
> | **Password** | Heslo instalačního účtu (maskované). |

**New applications**

> Karta je aktivní pouze tehdy, když má alespoň jeden server v pravém seznamu zaškrtnuté políčko **New applications**.
>
> Karta zobrazuje tabulku **šablon aplikací**, které se mají vytvořit na každém vybraném serveru. Tři akce:
>
> | Tlačítko | Účinek |
> |---|---|
> | **+** — popis **New application template** | Otevře formulář pro přidání aplikace ve skupinovém režimu. Nabízejí se pouze typy služeb **RDP** a **HTML5 RDP**. |
> | **Edit** | Aktivní, pokud je vybrán právě jeden řádek. |
> | **×** | Odebere vybrané šablony. |
>
> Sloupce tabulky:
>
> | Sloupec | Obsah |
> |---|---|
> | **Name** | Název šablony, před nímž je ikona typu služby. |
> | **Recording** | Vizuální příznak možnosti nahrávání videa. |
> | **SSO / Remote application / Working directory** | Souhrn zvoleného režimu SSO (`SSO`, `No SSO`, `Ask password`, `Fixed SSO`), volitelného aliasu, názvu vzdálené aplikace (RemoteApp) a adresáře spuštění. |
>
> Názvy šablon musí být v seznamu **jedinečné**: duplicitní název je odmítnut s upozorněním.
>
> > **Proměnná v názvu šablony**
> >
> > Chcete-li pro každý server vygenerovat jiný název, použijte v poli **Name** šablony znaky `{` a `}`. Bez složených závorek se název serveru připojí na konec názvu šablony. Se složenými závorkami nahradí `{}`.
> >
> > - Šablona `Application RDP` použitá na server `srv1` → `Application RDP srv1`
> > - Šablona `Application {} RDP` použitá na server `srv1` → `Application srv1 RDP`

### Potvrzení a sestava

Tlačítko **Validate** je povoleno pouze tehdy, když:

- v pravém seznamu je alespoň jeden server,
- karta **Agent deployment** je platná (pokud je vyžadována),
- karta **New applications** obsahuje alespoň jednu šablonu (pokud je vyžadována).

Po odeslání se otevře okno **sestavy** s jednou kartou pro každou operaci (registrace, nasazení agenta, vytvoření aplikací). Každý řádek v průběhu postupně získá stav: *probíhá*, *úspěch*, *obecná chyba*, *oprávnění odepřeno*, *agent již existuje* nebo *neznámý stav (žádná odpověď)*. Tlačítko **Close** se povolí až po dokončení všech operací.

> **Sledování instalace agenta**
>
> Instalace agenta je asynchronní, a proto sestava každých 5 sekund dotazuje server a obnovuje stav, dokud je úloha označena jako `INPROGRESS`.

---

## Deploy Agent (přímá akce)

Tlačítko **Deploy Agent** na panelu nástrojů otevře formulář nasazení přímo, předvyplněný servery vybranými v hlavním seznamu — pole **Target Server** pak obsahuje jejich názvy oddělené čárkami.

Pole jsou stejná jako na kartě **Agent deployment** v kapitole [Registrace jednoho nebo několika serverů](#register-one-or-several-servers), s jedním rozdílem: **Target Server** je zde viditelné a upravitelné, protože režim více serverů se neuplatňuje. Všechna pole jsou povinná.

Po odeslání se hlavní tabulka po dobu operace uzamkne a pravidelné dotazování (každých 5 sekund) obnovuje stav instalace až do jejího dokončení.

---

## Odebrání agenta

Tlačítko **Remove Agent** na panelu nástrojů otevře formulář pro odinstalaci agenta z vybraných serverů.

| Pole | Popis |
|---|---|
| **Target Server** | Dotčené servery, předvyplněné a oddělené čárkami. |
| **Gateway** | Server Edge Gateway produktu Bastion, který se používá k řízení odinstalace. |
| **Domain** | Doména ověřování účtu správce. |
| **Username** | Účet, který má oprávnění odinstalovat agenta na serveru. |
| **Password** | Heslo účtu (maskované). |

Všechna pole jsou povinná.

---

## Odstranění serveru

Tlačítko **×** na panelu nástrojů otevře okno potvrzení. Úvodní text se přizpůsobí výběru (jeden server nebo několik serverů).

Nabízejí se dvě nezávislé možnosti:

| Možnost | Účinek |
|---|---|
| **Delete Bastion agents** | Pokud je zaškrtnuto, spustí se při odstranění na dotčených serverech postup odinstalace. Poté navazuje okno odinstalace (kapitola [Odebrání agenta](#agent-removal)), které shromáždí parametry přístupu. |
| **Delete related applications** | Pokud je zaškrtnuto, odstraní se současně i aplikace, které na tyto servery cílí. |

Po odeslání okno sestavy shrne výsledek každé operace.

> **Odstranění bez odebrání agenta**
>
> Pokud zaškrtávací políčko odinstalace není zaškrtnuté, záznam serveru se z Bastion odebere, ale agent zůstane na počítači nainstalovaný. Bude nutné ho odinstalovat ručně nebo novou operací **Remove Agent**.

---

## Hromadné vytváření aplikací

Tlačítko **New applications** na panelu nástrojů otevře formulář pro skupinové přidání aplikací bez předchozího kroku registrace. Jde o formulář modulu **Applications**, omezený na typy služeb **RDP** a **HTML5 RDP**.

Po odeslání se aplikace vytvoří na každém serveru vybraném v hlavním seznamu s použitím mechanismu proměnné v názvu popsaného v kapitole [Registrace jednoho nebo několika serverů](#register-one-or-several-servers) (použití `{}` pro vložení názvu serveru). Okno sestavy zobrazí výsledek řádek po řádku.
