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

# Access to Workplace contracts

Moduł **Access to Workplace contracts** zawiera kontrakty przyznające grupom użytkowników dostęp do aplikacji i pulpitów publikowanych przez powiązany serwer Systancia Workplace. Jedna kontrakt wiąże jedną lub kilka **grup użytkowników** z **jedną aplikacją**, **jedną grupą aplikacji** lub **jednym pulpitem**, z okresem ważności, maksymalną liczbą jednoczesnych instancji, **trybami dostępu** oraz, w stosownych przypadkach, **przedziałami** czasowymi.

Kontrakty są współdzielone przez oba produkty: zmiana wprowadzona w Bastion jest widoczna w Workplace, a odwrotnie.

> **Wymaganie wstępne: powiązanie z Workplace**
>
> Ten moduł pojawia się tylko wtedy, gdy **powiązanie z Workplace** jest aktywne **i** gdy aktywne jest również **scalanie konsol** jest również aktywne.

## Lista kontraktów

| Kolumna | Opis |
|---|---|
| **Type** | Ikona oznaczająca cel kontraktu. Kolorowe tło oznacza kontrakt z przedziałami czasowymi. |
| **Application** | Nazwa celu, wraz z jego ikoną — aplikacja, grupa aplikacji lub pulpit. |
| **Users group** | Pierwsza uprawniona grupa; powyżej tego dodawany jest licznik **+ *n* groups**. |
| **Beginning date** | Początek ważności. |
| **End Date** | Koniec ważności lub **Unlimited**. |
| **Concurrent users** | Maksymalna liczba jednoczesnych instancji lub **Unlimited**. |
| **Access modes** | Cztery wskaźniki: **Web**, **Desktop**, **VD** i **Launcher**. |
| **Systancia Gate** | Dwa wskaźniki: **Authorized** i **Restricted**. |

Kontrakty poza okresem ważności są wyświetlane **na szaro**. Dopóki nie istnieje żaden kontrakt, tabela wyświetla **No subscription to display**, po czym następuje przypomnienie warunków, które trzeba spełnić przed utworzeniem kontraktu.

**Legenda** pod tabelą objaśnia ikony: **Application group subscription**, **Application subscription**, **Desktop subscription** i **Contract with planning**.

### Akcje paska narzędzi

| Akcja | Dostępność | Działanie |
|---|---|---|
| **+** — podpowiedź **New subscription** | Musi istnieć cel **i** grupa użytkowników | Otwiera formularz (zobacz rozdział [Dodawanie kontraktu](#add-a-contract)). |
| Ikona edycji — podpowiedź **Properties** | Zaznaczenie = 1 | Otwiera ten sam formularz. Dwukrotne kliknięcie jest równoważne. |
| **×** — podpowiedź **Delete** | Zaznaczenie = 1 | Pyta **Are you sure you want to remove this subscription?** |
| **Enable** *lub* **Disable** | Zaznaczenie = 1, kontrakt w okresie ważności | ⚠ Oba przyciski **nigdy nie są widoczne jednocześnie**: pokazywany jest tylko ten, który odpowiada stanowi wybranego kontraktu. |

> **Dlaczego przycisk + może pozostać nieaktywny**
>
> Potrzebne są co najmniej jeden cel i jedna grupa użytkowników. W przeciwnym razie konsola wyjaśnia: **To create a subscription you need at least one application, applications group or desktop.**, lub **To create a subscription you need at least one users group.**

### Filtry i wyszukiwanie

Zwijany panel **Filters** udostępnia **Type** — **All**, **Application**, **Application group** lub **Desktop** — oraz **User group**. Obok pole wyszukiwania, którego tekstem zastępczym jest **Search**, filtruje 700 ms po ostatnim naciśnięciu klawisza. Stopka tabeli udostępnia selektor **Items per page:** ustawiony na `15`, `25` lub `50`.

## Dodawanie kontraktu

Przycisk **+** otwiera okno **New Subscription**, z dwiema kartami: **General Information** i **Authorized slots**.

### Karta General Information

Ramka **Contract type** udostępnia trzy przyciski opcji — dostępne **tylko przy tworzeniu**:

| Opcja | Opis |
|---|---|
| **for a group of applications** | Grupa aplikacji publikowana w Workplace. Nieaktywne, gdy nie istnieje żadna grupa. Gdy po stronie Workplace aktywna jest rekursja, etykieta jest uzupełniana na czerwono: *(recursion is enabled on contracts publication)*. |
| **For an application** | **Opcja wybrana domyślnie.** |
| **For a desktop** | Pulpit lub grupa pulpitów. |

Następnie pojawiają się pola:

| Pole | Opis |
|---|---|
| **Application** | Pole obowiązkowe. Lista celów wybranego typu; wpisanie kilku znaków ją filtruje. |
| **User group** | Podwójna lista, z wyszukiwaniem i przyciskiem **Select All**. |
| **Access modes** | Cztery pola wyboru, **wszystkie domyślnie zaznaczone**: **Web portal**, **Desktop**, **Virtual desktop** i **Launcher**. |
| **Access from Systancia Gate** | Dwa pola wyboru, **domyślnie niezaznaczone**: **Outside publication authorized** i **Restrict access to compliant clients**. Drugie pozostaje **nieaktywne**, dopóki pierwsze nie zostanie zaznaczone. |
| **Subscription start date:** | Pole obowiązkowe. Domyślnie dzisiejsza data. |
| **Subscription end date:** | Musi być późniejsza niż data początkowa lub jej równa. Pole wyboru **Unlimited** obok neutralizuje to pole. |
| **Maximum number of simultaneous instances:** | Liczba całkowita, minimum `1`. Pole wyboru **Unlimited** ją neutralizuje; w kontrakcie na pulpit staje się ono **Unlimited (to the extent of available clones)**, a maksimum jest ograniczone pojemnością pulpitu. |

### Karta Authorized slots

Karta pokazuje tygodniową tabelę — jeden wiersz na przedział, godziny jako kolumny — oraz trzy akcje: **Add**, **Properties** (również przez dwukrotne kliknięcie) i **Delete**, przy czym ta ostatnia pyta **Are you sure you want to remove this time slot?**

Okno **Edit slot** składa się z trzech części:

| Część | Treść |
|---|---|
| Pole wyboru w górnej części | **Impose the closure of the application when the access slots limit is reached** — **domyślnie zaznaczone**. |
| **Slot type** | Sześć wykluczających się przycisków opcji: **Day of the week**, **Date**, **Day of the month**, **Day of a month**, **Month** i **Months**. Każdy odblokowuje własny selektor. |
| **Slots** | Dwa pola, **Start** i **End**, w formacie `hh:mm`, oraz przycisk **Add** gromadzący przedziały w tabeli. |

| Komunikat | Przypadek |
|---|---|
| **Bad time format! (hh:mm)** | Wprowadzona godzina nie ma oczekiwanej postaci. |
| **Error while adding slot: the given slot overlaps an already existing slot.** | Nowy przedział nakłada się na istniejący. |

> **Brak przedziałów dla grupy pulpitów**
>
> Karta **Authorized slots** nie dotyczy kontraktu obejmującego grupę pulpitów; karta **General Information** przypomina o tym za pomocą ostrzeżenia.

## Zmiana kontraktu

Wybierz kontrakt, a następnie kliknij ikonę **Properties** (lub kliknij dwukrotnie). Okno **Edit Subscription** ponownie wyświetla formularz, w którym **Contract type** nie jest już edytowalny. Przy zapisie konsola wyświetla **Subscription successfully updated.** — a **The new subscription properties have been successfully registered.** przy tworzeniu.

## Włączanie lub wyłączanie kontraktu

Widoczny przycisk — **Enable** lub **Disable** w zależności od stanu — działa na **daty** kontraktu: włączenie przywraca datę początkową na dzisiejszą, wyłączenie przenosi ją na dzień po dacie końcowej. Reszta konfiguracji pozostaje nietknięta.

## Usunięcie kontraktu

Wybierz kontrakt, a następnie kliknij **×** i potwierdź. W przypadku kontraktu na **grupę aplikacji** z aktywną rekursją po stronie Workplace uruchamiane jest zadanie aktualizacji; tabela odświeża się, gdy się ono zakończy.
