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

# RDS servers

Modul **RDS servers** v Bastion registrira strežnike Windows Remote Desktop Services, ki bodo gostili objavljene aplikacije ali oddaljena namizja. Na tem zaslonu lahko skrbnik odkrije strežnike iz imenika, jih registrira, na njih uvede ali z njih odstrani agenta Bastion in množično ustvari aplikacije, ki ciljajo na te strežnike.

Aplikacije, ki te strežnike izpostavijo uporabnikom, se deklarirajo v modulu [Applications](https://docs.cyberelements.io/bastion/4.6/sl/Usage/AdminConsoleReference/Applications/) in so na voljo prek [access contract](https://docs.cyberelements.io/bastion/4.6/sl/Usage/AdminConsoleReference/AccessContracts/).

> **Predpogoj: domena mora dovoljevati upravljanje strežnikov RDS**
>
> Na tem zaslonu se prikažejo le domene za preverjanje pristnosti **LDAP / Active Directory** z označeno možnostjo **Allow RDS server management** – prav ta možnost naredi domeno primerno, označite pa jo v modulu [Authentication domain](https://docs.cyberelements.io/bastion/4.6/sl/Usage/AdminConsoleReference/AuthenticationDomain/). Druge vrste domen (lokalni imenik, SAML, anonimna) niso nikoli navedene, ne glede na njihovo konfiguracijo.

---

## Seznam strežnikov

Glavni zaslon prikazuje na strani razdeljen seznam že registriranih strežnikov RDS.

### Filtri in iskanje

| Element | Opis |
|---|---|
| **Domain** | Spustni seznam primernih domen LDAP. Na vrhu je dodan zbirni vnos **All**, ki prikaže vse strežnike ne glede na domeno. |
| **Iskalno polje** | Filtrira navedene strežnike po podnizu. Iskanje se sproži 700 ms po zadnjem pritisku tipke ali takoj s tipko `Enter`. Element za čiščenje (križec) ponastavi iskanje. |
| **Razdelitev na strani** | Izbirnik velikosti strani (`15`, `25` ali `50`). |
| **Stolpci tabele** | **Name**, **Host**, **LDAP domain**. |

Tabela podpira večkratno izbiro. Dokler ni vrnjen noben strežnik, je prikazano sporočilo o praznem stanju.

### Dejanja v orodni vrstici

Gumbi orodne vrstice so kontekstni: tisti, ki delujejo na obstoječih strežnikih, ostanejo onemogočeni, dokler ni izbrana vsaj ena vrstica.

| Dejanje | Razpoložljivost | Učinek |
|---|---|---|
| **+** — opis orodja **Register RDS servers** | Vedno na voljo | Odpre okno za registracijo s tremi zavihki (glejte poglavje [Registracija enega ali več strežnikov](#register-one-or-several-servers)). |
| **×** (Brisanje) | Izbor ≥ 1 | Odpre okno za potrditev (glejte poglavje [Brisanje strežnika](#delete-a-server)). |
| **Deploy Agent** | Izbor ≥ 1 | Odpre obrazec za uvedbo agenta Bastion na izbranih strežnikih (glejte poglavje [Deploy Agent (neposredno dejanje)](#deploy-agent-direct-action)). |
| **Remove Agent** | Izbor ≥ 1 | Odpre obrazec za odstranitev namestitve agenta Bastion z izbranih strežnikov (glejte poglavje [Odstranitev agenta](#agent-removal)). |
| **New applications** | Izbor ≥ 1 | Odpre obrazec za množično ustvarjanje aplikacije, ki se ponovi za vsak izbrani strežnik (glejte poglavje [Množično ustvarjanje aplikacij](#bulk-application-creation)). |

---

## Registracija enega ali več strežnikov

Gumb **+** odpre modalno okno s **tremi zavihki**. Zavihek **Server registration** je vedno aktiven. Druga dva postaneta aktivna le, če ju izbira vsaj enega strežnika naredi smiselna.

**Server registration**

> Zavihek prikazuje dve podokni drugo ob drugem. Na levi je odkrivanje strežnikov, ki so na voljo v imeniku; na desni je seznam strežnikov, izbranih za to registracijo.
>
> | Element | Opis |
> |---|---|
> | **Domain** | Ciljna domena LDAP. Levi seznam omeji na strežnike te domene. |
> | **Iskalno polje** | Filter po podnizu. Sproži se po 1200 ms nedejavnosti ali s tipko `Enter`. |
> | **Levi seznam** | Strežniki RDS, odkriti v domeni (ime, domena, DNS). Že registrirani strežniki so samodejno izključeni. Na dnu sta na voljo gumba **Select all** in **Refresh**. |
> | **Desni seznam** | Strežniki, izbrani za to registracijo. Z vlečenjem in spuščanjem z levega seznama dodate strežnike; vsako ploščico lahko posamično odstranite z njenim križcem za zapiranje. |
> | **Števec** | Prikazuje število izbranih strežnikov glede na največje dovoljeno število v obliki ***n* / 200 RDS servers**. |
>
> Za vsak strežnik, dodan na desni, sta na voljo dve potrditveni polji:
>
> | Potrditveno polje | Učinek |
> |---|---|
> | **Deploy an agent** | Ta strežnik v isti operaciji označi za uvedbo agenta Bastion. Aktivira zavihek **Agent deployment**. |
> | **Create applications** | Označi ta strežnik za ustvarjanje aplikacij, opredeljenih na zavihku **New applications**. Aktivira ta zavihek. |
>
> Gumba **Deploy an agent** in **Create applications** nad ploščicami naenkrat označita ali odznačita ustrezno potrditveno polje pri **vseh** izbranih strežnikih.
>
> > **Omejitev izbora**
> >
> > V eni operaciji registracije je mogoče obdelati največ **200 strežnikov**. Vsak poskus dodajanja strežnikov nad ta prag je zavrnjen z opozorilnim sporočilom.
>
> > **Nedosegljive domene**
> >
> > Če katera od poizvedovanih domen ne odgovori, sporočilo o napaki navede domene, ki niso uspele, in število izvedenih poskusov (`Error` pri takojšnjem neuspehu, `5 retries` po petih poskusih). Strežniki iz dosegljivih domen so kljub temu prikazani.

**Agent deployment**

> Zavihek je aktiven le, če je pri vsaj enem strežniku na desnem seznamu označeno potrditveno polje **Agent deployment**. Vsa polja so obvezna.
>
> | Polje | Opis |
> |---|---|
> | **Target Server** | Strežnik, na katerega se namesti agent. **Skrito in onemogočeno v načinu z več strežniki**: cilj se takrat izračuna iz izbranih strežnikov. |
> | **Target drive** | Črka pogona, na katerega se namesti agent. |
> | **Target directory** | Namestitvena pot agenta na strežniku. Znaka `"` in `'` sta zavrnjena že ob vnosu. |
> | **Gateway** | Strežnik Edge Gateway platforme Bastion, ki vodi uvedbo. |
> | **Domain** | Domena preverjanja pristnosti namestitvenega računa. |
> | **Username** | Račun, ki sme nameščati programsko opremo na ciljni strežnik. |
> | **Password** | Geslo namestitvenega računa (zakrito). |

**New applications**

> Zavihek je aktiven le, če je pri vsaj enem strežniku na desnem seznamu označeno potrditveno polje **New applications**.
>
> Zavihek prikazuje tabelo **predlog aplikacij**, ki se ustvarijo na vsakem izbranem strežniku. Tri dejanja:
>
> | Gumb | Učinek |
> |---|---|
> | **+** — opis orodja **New application template** | Odpre obrazec za dodajanje aplikacije v skupinskem načinu. Na voljo sta le vrsti storitev **RDP** in **HTML5 RDP**. |
> | **Edit** | Aktivno, ko je izbrana natanko ena vrstica. |
> | **×** | Odstrani izbrane predloge. |
>
> Stolpci tabele:
>
> | Stolpec | Vsebina |
> |---|---|
> | **Name** | Ime predloge, pred katerim je ikona vrste storitve. |
> | **Recording** | Vizualni indikator možnosti videosnemanja. |
> | **SSO / Remote application / Working directory** | Povzetek izbranega načina SSO (`SSO`, `No SSO`, `Ask password`, `Fixed SSO`), izbirnega vzdevka, imena oddaljene aplikacije (RemoteApp) in zagonske mape. |
>
> Imena predlog morajo biti na seznamu **enolična**: dvojnik je zavrnjen z opozorilom.
>
> > **Spremenljivka v imenu predloge**
> >
> > Če želite za vsak strežnik ustvariti drugo ime, v polju **Name** predloge uporabite znaka `{` in `}`. Brez zavitih oklepajev se ime strežnika doda na konec imena predloge. Z zavitimi oklepaji nadomesti `{}`.
> >
> > - Predloga `Application RDP`, uporabljena za strežnik `srv1` → `Application RDP srv1`
> > - Predloga `Application {} RDP`, uporabljena za strežnik `srv1` → `Application srv1 RDP`

### Potrditev in poročilo

Gumb **Validate** je omogočen le, če:

- je na desnem seznamu vsaj en strežnik,
- je zavihek **Agent deployment** veljaven (kadar je zahtevan),
- zavihek **New applications** vsebuje vsaj eno predlogo (kadar je zahtevan).

Po oddaji se odpre okno **poročila** z enim zavihkom za vsako operacijo (registracija, uvedba agenta, ustvarjanje aplikacij). Vsaka vrstica med izvajanjem prejme stanje: *v teku*, *uspeh*, *splošna napaka*, *dovoljenje zavrnjeno*, *agent je že prisoten* ali *neznano stanje (ni odgovora)*. Gumb **Close** je omogočen šele, ko se končajo vse operacije.

> **Spremljanje namestitve agenta**
>
> Namestitev agenta je asinhrona, zato poročilo vsakih 5 sekund poizveduje pri strežniku in osvežuje stanje, dokler je opravilo označeno z `INPROGRESS`.

---

## Deploy Agent (neposredno dejanje)

Gumb **Deploy Agent** v orodni vrstici neposredno odpre obrazec za uvedbo, vnaprej izpolnjen s strežniki, izbranimi na glavnem seznamu — polje **Target Server** takrat vsebuje njihova imena, ločena z vejicami.

Polja so enaka kot na zavihku **Agent deployment** iz poglavja [Registracija enega ali več strežnikov](#register-one-or-several-servers), z eno razliko: polje **Target Server** je tu vidno in ga je mogoče urejati, saj način z več strežniki ne velja. Vsa polja so obvezna.

Po oddaji je glavna tabela med izvajanjem operacije zaklenjena, redna poizvedba (vsakih 5 sekund) pa do konca osvežuje stanje namestitve.

---

## Odstranitev agenta

Gumb **Remove Agent** v orodni vrstici odpre obrazec za odstranitev agenta z izbranih strežnikov.

| Polje | Opis |
|---|---|
| **Target Server** | Zadevni strežniki, vnaprej izpolnjeni in ločeni z vejicami. |
| **Gateway** | Strežnik Edge Gateway platforme Bastion, ki se uporablja za vodenje odstranitve namestitve. |
| **Domain** | Domena preverjanja pristnosti skrbniškega računa. |
| **Username** | Račun, ki sme odstraniti agenta s strežnika. |
| **Password** | Geslo računa (zakrito). |

Vsa polja so obvezna.

---

## Brisanje strežnika

Gumb **×** v orodni vrstici odpre okno za potrditev. Uvodno besedilo se prilagodi izboru (en strežnik ali več strežnikov).

Na voljo sta dve neodvisni možnosti:

| Možnost | Učinek |
|---|---|
| **Delete Bastion agents** | Če je označeno, se postopek odstranitve namestitve ob brisanju izvede na zadevnih strežnikih. Nato se zaporedno odpre okno za odstranitev namestitve (poglavje [Odstranitev agenta](#agent-removal)), da se zberejo parametri dostopa. |
| **Delete related applications** | Če je označeno, se hkrati izbrišejo tudi aplikacije, ki ciljajo te strežnike. |

Po oddaji okno poročila povzame izid vsake operacije.

> **Brisanje brez odstranitve agenta**
>
> Če potrditveno polje za odstranitev namestitve ni označeno, se vnos strežnika odstrani iz Bastion, agent pa ostane nameščen v računalniku. Njegovo namestitev bo treba odstraniti ročno ali z novo operacijo **Remove Agent**.

---

## Množično ustvarjanje aplikacij

Gumb **New applications** v orodni vrstici odpre obrazec za skupinsko dodajanje aplikacij brez predhodnega koraka registracije. Gre za obrazec modula **Applications**, omejen na vrsti storitev **RDP** in **HTML5 RDP**.

Po oddaji se aplikacija ustvari na vsakem strežniku, izbranem na glavnem seznamu, pri čemer se uporabi mehanizem spremenljivke v imenu, opisan v poglavju [Registracija enega ali več strežnikov](#register-one-or-several-servers) (uporaba `{}` za vstavitev imena strežnika). Okno poročila prikaže rezultat po vrsticah.
