> Source: https://docs.cyberelements.io/bastion/4.6/de/Usage/AdminConsoleReference/WorkplaceAccessContracts/

# Access to Workplace contracts

Das Modul **Access to Workplace contracts** trägt die Verträge, die Benutzergruppen Zugriff auf die Anwendungen und Desktops gewähren, die der zugeordnete Systancia-Workplace-Server veröffentlicht. Ein Vertrag verbindet eine oder mehrere **Benutzergruppen** mit **einer Anwendung**, **einer Anwendungsgruppe** oder **einem Desktop**, mit einer Gültigkeitsdauer, einer maximalen Anzahl gleichzeitiger Instanzen, **Zugriffs- modi** und gegebenenfalls zeitlichen **Fenstern**.

Die Verträge werden von beiden Produkten gemeinsam genutzt: Eine in Bastion vorgenommene Änderung erscheint in Workplace, und umgekehrt.

> **Voraussetzung: Workplace-Zuordnung**
>
> Dieses Modul erscheint nur, wenn die **Workplace-Zuordnung** aktiv ist **und** auch die **Zusammenführung der Konsolen** ebenfalls.

## Vertragsliste

| Spalte | Beschreibung |
|---|---|
| **Type** | Symbol, das das Ziel des Vertrags bezeichnet. Ein farbiger Hintergrund kennzeichnet einen Vertrag mit Zeitfenstern. |
| **Application** | Name des Ziels, mit seinem Symbol — Anwendung, Anwendungsgruppe oder Desktop. |
| **Users group** | Erste begünstigte Gruppe; darüber hinaus wird ein Zähler **+ *n* groups** hinzugefügt. |
| **Beginning date** | Beginn der Gültigkeit. |
| **End Date** | Ende der Gültigkeit, oder **Unlimited**. |
| **Concurrent users** | Maximale Anzahl gleichzeitiger Instanzen, oder **Unlimited**. |
| **Access modes** | Vier Anzeigen: **Web**, **Desktop**, **VD** und **Launcher**. |
| **Systancia Gate** | Zwei Anzeigen: **Authorized** und **Restricted**. |

Verträge außerhalb ihrer Gültigkeitsdauer erscheinen **ausgegraut**. Solange kein Vertrag vorhanden ist, zeigt die Tabelle **No subscription to display** an, gefolgt von einer Erinnerung an die Bedingungen, die vor dem Erstellen eines Vertrags erfüllt sein müssen.

Eine **Legende** unter der Tabelle erläutert die Symbole: **Application group subscription**, **Application subscription**, **Desktop subscription** und **Contract with planning**.

### Aktionen der Werkzeugleiste

| Aktion | Verfügbarkeit | Wirkung |
|---|---|---|
| **+** — Infotext **New subscription** | Ein Ziel **und** eine Benutzergruppe müssen vorhanden sein | Öffnet das Formular (siehe Kapitel [Einen Vertrag hinzufügen](#add-a-contract)). |
| Änderungssymbol — Infotext **Properties** | Auswahl = 1 | Öffnet dasselbe Formular. Ein Doppelklick entspricht dem. |
| **×** — Infotext **Delete** | Auswahl = 1 | Fragt **Are you sure you want to remove this subscription?** |
| **Enable** *oder* **Disable** | Auswahl = 1, Vertrag innerhalb seiner Gültigkeitsdauer | ⚠ Die beiden Schaltflächen sind **nie gleichzeitig sichtbar**: es wird nur diejenige gezeigt, die dem Zustand des ausgewählten Vertrags entspricht. |

> **Warum die Schaltfläche + inaktiv bleiben kann**
>
> Es sind mindestens ein Ziel und eine Benutzergruppe erforderlich. Andernfalls erläutert die Konsole: **To create a subscription you need at least one application, applications group or desktop.**, oder **To create a subscription you need at least one users group.**

### Filter und Suche

Ein aufklappbares Fenster **Filters** bietet einen **Type** — **All**, **Application**, **Application group** oder **Desktop** — sowie eine **User group**. Daneben filtert das Suchfeld, dessen Platzhaltertext **Search** lautet, 700 ms nach dem letzten Tastenanschlag. Die Fußzeile der Tabelle bietet einen Selektor **Items per page:**, der auf `15`, `25` oder `50` eingestellt werden kann.

## Einen Vertrag hinzufügen

Die Schaltfläche **+** öffnet das Fenster **New Subscription**, mit zwei Registerkarten: **General Information** und **Authorized slots**.

### Registerkarte General Information

Der Kasten **Contract type** bietet drei Optionsfelder — verfügbar **nur beim Erstellen**:

| Option | Beschreibung |
|---|---|
| **for a group of applications** | In Workplace veröffentlichte Anwendungsgruppe. Inaktiv, wenn keine Gruppe vorhanden ist. Ist auf der Workplace-Seite die Rekursion aktiv, wird die Bezeichnung in Rot ergänzt: *(recursion is enabled on contracts publication)*. |
| **For an application** | **Standardmäßig gewählte Option.** |
| **For a desktop** | Desktop oder Desktopgruppe. |

Danach folgen die Felder:

| Feld | Beschreibung |
|---|---|
| **Application** | Pflichtfeld. Liste der Ziele des gewählten Typs; die Eingabe einiger Zeichen filtert sie. |
| **User group** | Eine doppelte Liste, mit Suche und einer Schaltfläche **Select All**. |
| **Access modes** | Vier Kontrollkästchen, **standardmäßig alle aktiviert**: **Web portal**, **Desktop**, **Virtual desktop** und **Launcher**. |
| **Access from Systancia Gate** | Zwei Kontrollkästchen, **standardmäßig nicht aktiviert**: **Outside publication authorized** und **Restrict access to compliant clients**. Das zweite bleibt **inaktiv**, bis das erste aktiviert ist. |
| **Subscription start date:** | Pflichtfeld. Standardmäßig heute. |
| **Subscription end date:** | Muss nach dem Anfangsdatum liegen oder ihm gleich sein. Das Kontrollkästchen **Unlimited** daneben hebt das Feld auf. |
| **Maximum number of simultaneous instances:** | Ganze Zahl, Minimum `1`. Das Kontrollkästchen **Unlimited** hebt sie auf; bei einem Desktop-Vertrag wird daraus **Unlimited (to the extent of available clones)**, und das Maximum ist durch die Kapazität des Desktops begrenzt. |

### Registerkarte Authorized slots

Die Registerkarte zeigt eine Wochentabelle — eine Zeile je Zeitfenster, die Stunden als Spalten — und drei Aktionen: **Add**, **Properties** (auch per Doppelklick) und **Delete**, letztere mit der Frage **Are you sure you want to remove this time slot?**

Das Fenster **Edit slot** besteht aus drei Teilen:

| Teil | Inhalt |
|---|---|
| Kontrollkästchen im oberen Bereich | **Impose the closure of the application when the access slots limit is reached** — **standardmäßig aktiviert**. |
| **Slot type** | Sechs sich ausschließende Optionsfelder: **Day of the week**, **Date**, **Day of the month**, **Day of a month**, **Month** und **Months**. Jedes schaltet seinen eigenen Selektor frei. |
| **Slots** | Zwei Felder, **Start** und **End**, im Format `hh:mm`, und eine Schaltfläche **Add**, die die Intervalle in einer Tabelle sammelt. |

| Meldung | Fall |
|---|---|
| **Bad time format! (hh:mm)** | Die eingegebene Uhrzeit hat nicht die erwartete Form. |
| **Error while adding slot: the given slot overlaps an already existing slot.** | Das neue Intervall überschneidet sich mit einem vorhandenen. |

> **Keine Zeitfenster für eine Desktopgruppe**
>
> Die Registerkarte **Authorized slots** gilt nicht für einen Vertrag, der eine Desktopgruppe abdeckt; die Registerkarte **General Information** erinnert mit einem Hinweis daran.

## Einen Vertrag ändern

Wählen Sie einen Vertrag aus und klicken Sie auf das Symbol **Properties** (oder doppelklicken Sie). Das Fenster **Edit Subscription** zeigt das Formular erneut, wobei **Contract type** nicht mehr bearbeitbar ist. Beim Speichern zeigt die Konsole **Subscription successfully updated.** — und **The new subscription properties have been successfully registered.** bei einer Erstellung.

## Einen Vertrag aktivieren oder deaktivieren

Die sichtbare Schaltfläche — **Enable** oder **Disable** je nach Zustand — wirkt auf die **Datumsangaben** des Vertrags: aktivieren setzt das Anfangsdatum auf heute zurück, deaktivieren setzt es auf den Tag nach dem Enddatum. Der Rest der Konfiguration bleibt unberührt.

## Einen Vertrag löschen

Wählen Sie einen Vertrag aus, klicken Sie auf **×** und bestätigen Sie. Bei einem Vertrag über eine **Anwendungsgruppe** mit aktiver Rekursion auf der Workplace-Seite wird eine Aktualisierungsaufgabe gestartet; die Tabelle lädt neu, wenn sie endet.
