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

# Gateways Management

Moduł **Gateways** wypisuje serwery Edge Gateway (gateway bez HTML5) zadeklarowane na platformie i pozwala dodać jeden, zmienić jego konfigurację (certyfikat, ścieżki przechowywania nagrań, pairing) lub go usunąć. Ta strona jest przeznaczona dla administratora lub integratora zarządzającego parkiem serwerów Edge Gateway, ich pairingiem z Mediation Controller oraz zbieraniem nagrań wideo i SSH.

Aby Edge Gateway był użyteczny w sesji, musi być przypisany do co najmniej jednego [site](https://docs.cyberelements.io/bastion/4.6/pl/Usage/AdminConsoleReference/Sites/). Włączenie do site odbywa się z modułu **Sites**, a nie z tego modułu.

> **Powiązane samouczki**
>
> - [Utworzenie tokena pairing dla Edge Gateway](https://docs.cyberelements.io/bastion/4.6/pl/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/)
> - [Utwórz Edge Gateway](https://docs.cyberelements.io/bastion/4.6/pl/Usage/Configuration/AdminConsole/CreateEdgeGateway/)

---

## Lista serwerów Edge Gateway

Moduł otwiera się na podzielonej na strony tabeli zadeklarowanych serwerów Edge Gateway.

| Kolumna | Opis |
|---|---|
| **Name** | Nazwa Edge Gateway, poprzedzona ikoną odzwierciedlającą jego stan połączenia (online, offline, oczekiwanie na pairing). |
| **Description** | Swobodny opis wprowadzony przy tworzeniu. |
| **Sites** | Site, do których przypisany jest Edge Gateway. |
| **Type** | **With recording**, jeśli Edge Gateway obsługuje nagrywanie sesji, w przeciwnym razie **Basic**. |
| **Version** | Wersja Edge Gateway. Gdy istnieje instancja główna i zapasowa, obie wersje są wyświetlane w dwóch wierszach. |

Akcje dostępne na pasku narzędzi:

| Akcja | Opis |
|---|---|
| **+** (Add) | Otwiera okno **Add Gateway**. |
| **Edit** | Otwiera okno **Edit Gateway** dla wybranego Edge Gateway. Wywoływane także dwukrotnym kliknięciem. |
| **×** (Delete) | Usuwa wybrane serwery Edge Gateway po potwierdzeniu. Obsługiwany jest wybór wielokrotny. |
| **Download recording certificate** | Pobiera certyfikat urzędu nagrywania wybranego Edge Gateway. Aktywne tylko wtedy, gdy Edge Gateway jest **online**. |
| **Search** | Filtruje według podciągu nazwy, 700 ms po ostatnim naciśnięciu klawisza (lub natychmiast klawiszem `Enter`). |
| **Pagination** | 15, 25 lub 50 wierszy na stronę. |

---

## Dodawanie Edge Gateway

Przycisk **+** otwiera okno **Add Gateway**.

### Informacje ogólne

| Pole | Opis |
|---|---|
| **Name** | Pole obowiązkowe, najwyżej 50 znaków. Dozwolone znaki: litery bez znaków diakrytycznych, cyfry, `é`, `è`, `à`, `ô`, `â`, nawiasy, spacja, `-`, `/`, `.` i `_`. |
| **Description** | Tekst swobodny. |
| **FQDN** | W pełni kwalifikowana nazwa maszyny hostującej Edge Gateway. Musi odpowiadać CN certyfikatu Edge Gateway, w przeciwnym razie pairing jest odrzucany (zobacz sekcję [Komunikaty o błędach przy zapisie](#error-messages-on-saving)). |
| **Archives** | Lokalna ścieżka, w której Edge Gateway archiwizuje nagrania wideo RDP. Wstępnie wypełniona wartością `/var/lib/ipdiva/carerecord/archives`. |
| **Archives SSH** | Lokalna ścieżka, w której Edge Gateway archiwizuje nagrania SSH. Wstępnie wypełniona wartością `/var/ipdiva/care/sshrecord`. |

Trzy pola **FQDN**, **Archives** i **Archives SSH** dotyczą tylko serwerów Edge Gateway z nagrywaniem: na Edge Gateway, który go nie obsługuje, są ukryte.

### Paring Token

Pole wyboru **Create a pairing token** odsłania sekcję **Paring Token**, domyślnie ukrytą.

| Pole | Opis |
|---|---|
| **SSL certificate** | Certyfikat gateway do przesłania. Lista rozwijana ustala oczekiwany format — `pkcs12` (domyślnie) lub `pem` — a selektor plików akceptuje wtedy tylko odpowiednie rozszerzenie, `.p12` lub `.pem`. |
| **Certificate or private key password** | Fraza hasła certyfikatu Edge Gateway, jeśli dotyczy. |
| **Import a Careserver certificate** | Po zaznaczeniu odsłania certyfikat serwera nagrywania: te same trzy elementy (format, plik, hasło). |
| **Pairing key validity period** | Data i godzina, po których tokena nie można już użyć. Domyślnie: dziś + 7 dni, w formacie `DD/MM/YYYY HH:MM`. |
| **IP authorized to use the token** | Publiczny adres IP, z którego Edge Gateway może wykonać pairing. Chodzi o adres widziany przez Mediation Controller: za NAT-em wprowadź adres publiczny. |

> **Dwa ostatnie pola odblokowuje certyfikat**
>
> **Pairing key validity period** i **IP authorized to use the token** pozostają **nieaktywne**, dopóki nie zostanie wybrany prawidłowy plik certyfikatu. Plik, którego rozszerzenie nie odpowiada wybranemu formatowi, pozostawia je więc nieaktywne — aż do dostarczenia pliku zgodnego.

Przycisk **Validate** zapisuje Edge Gateway. Jeśli zapis wygeneruje token pairingu, otwiera się okno **Paring Token**, które wyświetla klucz i informuje, że jest on **do użycia przy instalacji gateway**. Zamyka się je przyciskiem **Close**: klucz trzeba skopiować z okna.

---

## Edycja Edge Gateway

Wybierz Edge Gateway z listy i kliknij ikonę **Properties** (albo kliknij dwukrotnie wiersz). Okno **Edit Gateway** jest wstępnie wypełnione bieżącymi ustawieniami i danymi powiązanego certyfikatu.

Pola są takie same jak przy tworzeniu, z następującymi zasadami:

- **Name** pozostaje edytowalna;
- **FQDN**, **Archives** i **Archives SSH** są ukryte, jeśli Edge Gateway nie obsługuje nagrywania, i **nieaktywne**, dopóki nie jest online;
- **Pairing key validity period** i **IP authorized to use the token** można zmienić tylko na Edge Gateway **oczekującym na pairing**;
- pole **Authentication Token**, tylko do odczytu, pojawia się na Edge Gateway oczekującym na pairing.

> **Zmiana ścieżek archiwów**
>
> Zmiana **Archives** lub **Archives SSH** powoduje, że wcześniejsze nagrania stają się nieosiągalne z konsoli. Przed zastosowaniem zmiany wymagane jest potwierdzenie, a niepowodzenie po stronie Edge Gateway jest zgłaszane komunikatem **An error occured during the update of storage paths.**

---

## Usuwanie Edge Gateway

Wybierz jeden lub kilka serwerów Edge Gateway i kliknij przycisk **×**. Wymagane jest potwierdzenie. Obsługiwany jest wybór wielokrotny.

| Komunikat | Powód |
|---|---|
| **The following gateway is currently being used:** | Edge Gateway jest przypisany do jednego lub kilku site. Przed usunięciem należy go odłączyć. Po komunikacie następują nazwy, o które chodzi, a dla usunięcia wielokrotnego istnieje wariant w liczbie mnogiej. |
| **Deletion failed for the following gateway:** | Usunięcie zakończyło się niepowodzeniem po stronie Edge Gateway. Po komunikacie następują nazwy z błędem. |

---

## Komunikaty o błędach przy zapisie

| Komunikat | Powód |
|---|---|
| **This gateway already exists.** | Edge Gateway o tej nazwie już istnieje. |
| **Invalid Name** | Serwer odrzucił przesłaną nazwę. |
| **The CN of the Edge Gateway certificate sent does not match the expected CN** | Certyfikat Edge Gateway nie nosi oczekiwanego CN. Komunikat podaje CN znaleziony i oczekiwany. |
| **The CN of the Careserver certificate sent does not match the expected CN** | Ten sam przypadek dla certyfikatu serwera nagrywania. |
| **Invalid certificate or private key password** | Podane hasło nie otwiera certyfikatu. |
| **Unable to contact the pairing system, please check its configuration** | Usługa pairingu nie odpowiedziała. |
| **The given gateway is unreachable.** | Edge Gateway nie odpowiada; operacja jest przerywana. |
| **The gateway management service is unreachable** | Usługa sterująca serwerami Edge Gateway nie odpowiedziała. |
