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

# RDS servers

De module **RDS servers** registreert in Bastion de Windows Remote Desktop Services-servers die de gepubliceerde applicaties of de externe desktops zullen hosten. Vanuit dit scherm kan de beheerder servers in een directory ontdekken, ze registreren, er de Bastion-agent op implementeren of verwijderen en in bulk applicaties aanmaken die op die servers zijn gericht.

De applicaties die deze servers aan de gebruikers beschikbaar stellen, worden gedeclareerd in de module [Applications](https://docs.cyberelements.io/bastion/4.6/nl/Usage/AdminConsoleReference/Applications/) en beschikbaar gemaakt via een [access contract](https://docs.cyberelements.io/bastion/4.6/nl/Usage/AdminConsoleReference/AccessContracts/).

> **Voorwaarde: het domein moet het beheer van RDS-servers toestaan**
>
> In dit scherm verschijnen alleen authenticatiedomeinen van het type **LDAP / Active Directory** waarvoor de optie **Allow RDS server management** is aangevinkt — die optie maakt een domein in aanmerking komend, en ze wordt aangevinkt in de module [Authentication domain](https://docs.cyberelements.io/bastion/4.6/nl/Usage/AdminConsoleReference/AuthenticationDomain/). Andere typen domeinen (lokale directory, SAML, anoniem) worden nooit opgesomd, wat hun configuratie ook is.

---

## Lijst met servers

Het hoofdscherm toont de gepagineerde lijst met RDS-servers die al zijn geregistreerd.

### Filters en zoeken

| Element | Beschrijving |
|---|---|
| **Domain** | Vervolgkeuzelijst met de in aanmerking komende LDAP-domeinen. Bovenaan wordt een samenvattende vermelding **All** toegevoegd om alle servers weer te geven, ongeacht het domein. |
| **Zoekveld** | Filtert de opgesomde servers op deeltekenreeks. Het zoeken wordt 700 ms na de laatste toetsaanslag uitgevoerd, of onmiddellijk met `Enter`. De wis-trigger (kruisje) wist de zoekopdracht. |
| **Pagination** | Keuze van de paginagrootte (`15`, `25` of `50`). |
| **Kolommen van de tabel** | **Name**, **Host**, **LDAP domain**. |

De tabel ondersteunt meervoudige selectie. Zolang er geen server wordt teruggegeven, wordt een melding over de lege toestand weergegeven.

### Acties van de werkbalk

De knoppen van de werkbalk zijn contextafhankelijk: die welke op bestaande servers werken, blijven uitgeschakeld totdat minstens één rij is geselecteerd.

| Actie | Beschikbaarheid | Effect |
|---|---|---|
| **+** — tooltip **Register RDS servers** | Altijd beschikbaar | Opent het registratievenster met drie tabbladen (zie hoofdstuk [Een of meer servers registreren](#register-one-or-several-servers)). |
| **×** (Verwijderen) | Selectie ≥ 1 | Opent het bevestigingsvenster (zie hoofdstuk [Een server verwijderen](#delete-a-server)). |
| **Deploy Agent** | Selectie ≥ 1 | Opent het formulier om de Bastion-agent op de geselecteerde servers te implementeren (zie hoofdstuk [Deploy Agent (directe actie)](#deploy-agent-direct-action)). |
| **Remove Agent** | Selectie ≥ 1 | Opent het formulier om de Bastion-agent van de geselecteerde servers te verwijderen (zie hoofdstuk [Verwijderen van de agent](#agent-removal)). |
| **New applications** | Selectie ≥ 1 | Opent het formulier voor het in bulk aanmaken van een applicatie, die voor elke geselecteerde server wordt aangemaakt (zie hoofdstuk [Applicaties in bulk aanmaken](#bulk-application-creation)). |

---

## Een of meer servers registreren

De knop **+** opent een modaal venster met **drie tabbladen**. Het tabblad **Server registration** is altijd actief. De twee andere worden alleen actief als de selectie van minstens één server ze relevant maakt.

**Server registration**

> Het tabblad toont twee panelen naast elkaar. Links het opzoeken van de servers die in de directory beschikbaar zijn; rechts de lijst met servers die voor deze registratie zijn gekozen.
>
> | Element | Beschrijving |
> |---|---|
> | **Domain** | LDAP-doeldomein. Beperkt de linkerlijst tot de servers van dat domein. |
> | **Zoekveld** | Filter op deeltekenreeks. Wordt na 1200 ms van inactiviteit of met `Enter` uitgevoerd. |
> | **Linkerlijst** | RDS-servers die in het domein zijn gevonden (naam, domein, DNS). Al geregistreerde servers worden automatisch uitgesloten. De knoppen **Select all** en **Refresh** staan onderaan ter beschikking. |
> | **Rechterlijst** | Servers die voor deze registratie zijn gekozen. Slepen en neerzetten vanuit de linkerlijst voegt servers toe; elke tegel kan afzonderlijk worden verwijderd met het sluitkruisje. |
> | **Teller** | Geeft het aantal geselecteerde servers weer tegenover het toegestane maximum, als ***n* / 200 RDS servers**. |
>
> Voor elke server die rechts wordt toegevoegd, worden twee selectievakjes aangeboden:
>
> | Selectievakje | Effect |
> |---|---|
> | **Deploy an agent** | Markeert deze server voor de implementatie van de Bastion-agent in dezelfde bewerking. Activeert het tabblad **Agent deployment**. |
> | **Create applications** | Markeert deze server voor het aanmaken van de applicaties die in het tabblad **New applications** zijn gedefinieerd. Activeert dat tabblad. |
>
> Twee knoppen **Deploy an agent** en **Create applications**, die boven de tegels staan, vinken het bijbehorende selectievakje op **alle** geselecteerde servers in één keer aan of uit.
>
> > **Grens van de selectie**
> >
> > In één enkele registratiebewerking kunnen ten hoogste **200 servers** worden verwerkt. Elke poging om boven die grens servers toe te voegen, wordt met een waarschuwing geweigerd.
>
> > **Onbereikbare domeinen**
> >
> > Als een van de ondervraagde domeinen niet antwoordt, somt een foutmelding de mislukte domeinen op en het aantal uitgevoerde pogingen (`Error` bij een onmiddellijke mislukking, `5 retries` na vijf pogingen). De servers van de bereikbare domeinen worden toch weergegeven.

**Agent deployment**

> Tabblad dat alleen actief is als bij minstens één server in de rechterlijst het selectievakje **Agent deployment** is aangevinkt. Alle velden zijn verplicht.
>
> | Veld | Beschrijving |
> |---|---|
> | **Target Server** | Server waarop de agent moet worden geïnstalleerd. **Verborgen en uitgeschakeld in de modus met meerdere servers**: het doel wordt dan uit de geselecteerde servers berekend. |
> | **Target drive** | Letter van het station waarop de agent wordt geïnstalleerd. |
> | **Target directory** | Installatiepad van de agent op de server. De tekens `"` en `'` worden bij het invoeren geweigerd. |
> | **Gateway** | Edge Gateway van Bastion die de implementatie bestuurt. |
> | **Domain** | Authenticatiedomein van het installatieaccount. |
> | **Username** | Account dat software op de doelserver mag installeren. |
> | **Password** | Wachtwoord van het installatieaccount (gemaskeerd). |

**New applications**

> Tabblad dat alleen actief is als bij minstens één server in de rechterlijst het selectievakje **New applications** is aangevinkt.
>
> Het tabblad toont een tabel met **applicatiesjablonen** die op elke geselecteerde server moeten worden aangemaakt. Drie acties:
>
> | Knop | Effect |
> |---|---|
> | **+** — tooltip **New application template** | Opent het formulier om een applicatie toe te voegen in de gegroepeerde modus. Alleen de servicetypen **RDP** en **HTML5 RDP** worden aangeboden. |
> | **Edit** | Actief wanneer precies één rij is geselecteerd. |
> | **×** | Verwijdert de geselecteerde sjablonen. |
>
> Kolommen van de tabel:
>
> | Kolom | Inhoud |
> |---|---|
> | **Name** | Naam van het sjabloon, voorafgegaan door het pictogram van het servicetype. |
> | **Recording** | Visuele markering van de optie voor video-opname. |
> | **SSO / Remote application / Working directory** | Samenvatting van de gekozen SSO-modus (`SSO`, `No SSO`, `Ask password`, `Fixed SSO`), van de optionele alias, van de naam van de externe applicatie (RemoteApp) en van de startmap. |
>
> Namen van sjablonen moeten in de lijst **uniek** zijn: een duplicaat wordt met een waarschuwing geweigerd.
>
> > **Variabilisering van de naam van het sjabloon**
> >
> > Gebruik de tekens `{` en `}` in het veld **Name** van het sjabloon om per server een andere naam te genereren. Zonder accolades wordt de naam van de server aan het einde van de naam van het sjabloon toegevoegd. Met accolades vervangt hij de `{}`.
> >
> > - Sjabloon `Application RDP` toegepast op server `srv1` → `Application RDP srv1`
> > - Sjabloon `Application {} RDP` toegepast op server `srv1` → `Application srv1 RDP`

### Validatie en rapport

De knop **Validate** is alleen ingeschakeld als:

- er minstens één server in de rechterlijst staat,
- het tabblad **Agent deployment** geldig is (wanneer dat vereist is),
- het tabblad **New applications** minstens één sjabloon bevat (wanneer dat vereist is).

Bij het verzenden opent een venster met het **rapport**, met één tabblad per bewerking (registratie, implementatie van de agent, aanmaken van de applicaties). Elke rij krijgt in de loop van de bewerking een status: *in uitvoering*, *gelukt*, *algemene fout*, *toegang geweigerd*, *agent al aanwezig* of *onbekende status (geen antwoord)*. De knop **Close** wordt pas ingeschakeld zodra alle bewerkingen zijn afgerond.

> **Opvolging van de installatie van de agent**
>
> De installatie van de agent verloopt asynchroon; het rapport ondervraagt de server daarom elke 5 seconden om de status te vernieuwen zolang de taak als `INPROGRESS` is gemarkeerd.

---

## Deploy Agent (directe actie)

De knop **Deploy Agent** in de werkbalk opent het implementatieformulier rechtstreeks, voorgevuld met de servers die in de hoofdlijst zijn geselecteerd — het veld **Target Server** bevat dan hun namen, door komma's gescheiden.

De velden zijn die van het tabblad **Agent deployment** in hoofdstuk [Een of meer servers registreren](#register-one-or-several-servers), met één verschil: **Target Server** is daar zichtbaar en bewerkbaar, aangezien de modus met meerdere servers niet van toepassing is. Alle velden zijn verplicht.

Bij het verzenden wordt de hoofdtabel voor de duur van de bewerking vergrendeld en vernieuwt een periodieke ondervraging (elke 5 seconden) de installatiestatus tot de bewerking is afgerond.

---

## Verwijderen van de agent

De knop **Remove Agent** in de werkbalk opent het formulier om de agent op de geselecteerde servers te verwijderen.

| Veld | Beschrijving |
|---|---|
| **Target Server** | Betrokken servers, voorgevuld en door komma's gescheiden. |
| **Gateway** | Edge Gateway van Bastion die wordt gebruikt om de verwijdering te besturen. |
| **Domain** | Authenticatiedomein van het beheeraccount. |
| **Username** | Account dat de agent op de server mag verwijderen. |
| **Password** | Wachtwoord van het account (gemaskeerd). |

Alle velden zijn verplicht.

---

## Een server verwijderen

De knop **×** in de werkbalk opent een bevestigingsvenster. De inleidende tekst past zich aan de selectie aan (één enkele server of meerdere servers).

Er worden twee onderling onafhankelijke opties aangeboden:

| Optie | Effect |
|---|---|
| **Delete Bastion agents** | Indien aangevinkt, wordt de verwijderprocedure op het moment van verwijderen op de betrokken servers uitgevoerd. Het venster voor verwijdering (hoofdstuk [Verwijderen van de agent](#agent-removal)) wordt dan aaneengeschakeld om de toegangsparameters te verzamelen. |
| **Delete related applications** | Als dit is aangevinkt, worden de applicaties die op deze servers zijn gericht, gelijktijdig verwijderd. |

Bij het verzenden vat een rapportvenster de uitkomst van elke bewerking samen.

> **Verwijderen zonder de agent te verwijderen**
>
> Als het selectievakje voor verwijdering niet is aangevinkt, wordt de vermelding van de server uit Bastion verwijderd, maar blijft de agent op de machine geïnstalleerd. Hij moet dan handmatig of via een nieuwe bewerking **Remove Agent** worden verwijderd.

---

## Applicaties in bulk aanmaken

De knop **New applications** in de werkbalk opent het formulier om applicaties gegroepeerd toe te voegen, zonder voorafgaande registratiestap. Het formulier is dat van de module **Applications**, beperkt tot de servicetypen **RDP** en **HTML5 RDP**.

Bij het verzenden wordt de applicatie aangemaakt op elke server die in de hoofdlijst is geselecteerd, waarbij het mechanisme voor de variabilisering van de namen wordt toegepast dat in hoofdstuk [Een of meer servers registreren](#register-one-or-several-servers) is beschreven (gebruik van `{}` om de naam van de server in te voegen). Het rapportvenster toont het resultaat rij per rij.
