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

# Gateways Management

Das Modul **Gateways** listet die auf der Plattform deklarierten Edge Gateways (Gateways ohne HTML5) auf und ermöglicht es, eines hinzuzufügen, seine Konfiguration zu ändern (Zertifikat, Speicherpfade der Aufzeichnungen, Pairing) oder es zu entfernen. Diese Seite richtet sich an einen Administrator oder Integrator, der den Bestand an Edge Gateways, ihr Pairing mit dem Mediation Controller und die Erfassung der Video- und SSH-Aufzeichnungen verwaltet.

Damit ein Edge Gateway in einer Sitzung nutzbar ist, muss sie mindestens einer [Site](https://docs.cyberelements.io/bastion/4.6/de/Usage/AdminConsoleReference/Sites/) zugeordnet sein. Die Aufnahme in eine Site erfolgt über das Modul **Sites**, nicht über dieses.

> **Verwandte Tutorials**
>
> - [Ein Pairing-Token für ein Edge Gateway erstellen](https://docs.cyberelements.io/bastion/4.6/de/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/)
> - [Ein Edge Gateway erstellen](https://docs.cyberelements.io/bastion/4.6/de/Usage/Configuration/AdminConsole/CreateEdgeGateway/)

---

## Liste der Edge Gateways

Das Modul öffnet sich mit einem paginierten Raster der deklarierten Edge Gateways.

| Spalte | Beschreibung |
|---|---|
| **Name** | Name des Edge Gateway, dem ein Symbol vorangestellt ist, das ihren Verbindungsstatus widerspiegelt (online, offline, Pairing ausstehend). |
| **Description** | Freie Beschreibung, die bei der Erstellung eingegeben wurde. |
| **Sites** | Sites, denen das Edge Gateway zugeordnet ist. |
| **Type** | **With recording**, wenn das Edge Gateway die Sitzungsaufzeichnung unterstützt, andernfalls **Basic**. |
| **Version** | Version des Edge Gateway. Wenn eine Master- und eine Backup-Instanz vorhanden sind, werden beide Versionen in zwei Zeilen angezeigt. |

In der Symbolleiste verfügbare Aktionen:

| Aktion | Beschreibung |
|---|---|
| **+** (Hinzufügen) | Öffnet das Fenster **Add Gateway**. |
| **Edit** | Öffnet das Fenster **Edit Gateway** für die ausgewählte Edge Gateway. Wird auch durch einen Doppelklick ausgelöst. |
| **×** (Löschen) | Löscht die ausgewählten Edge Gateways nach Bestätigung. Mehrfachauswahl ist möglich. |
| **Download recording certificate** | Lädt das Zertifikat der Aufzeichnungsinstanz der ausgewählten Edge Gateway herunter. Nur aktiviert, wenn das Edge Gateway **online** ist. |
| **Search** | Filtert nach einem Teilstring des Namens, 700 ms nach dem letzten Tastendruck (oder sofort mit `Enter`). |
| **Pagination** | 15, 25 oder 50 Zeilen pro Seite. |

---

## Ein Edge Gateway hinzufügen

Die Schaltfläche **+** öffnet das Fenster **Add Gateway**.

### Allgemeine Informationen

| Feld | Beschreibung |
|---|---|
| **Name** | Pflichtfeld, höchstens 50 Zeichen. Erlaubte Zeichen: Buchstaben ohne Akzent, Ziffern, `é`, `è`, `à`, `ô`, `â`, Klammern, Leerzeichen, `-`, `/`, `.` und `_`. |
| **Description** | Freier Text. |
| **FQDN** | Vollqualifizierter Name der Maschine, die das Edge Gateway hostet. Er muss mit dem CN des Zertifikats des Edge Gateway übereinstimmen, andernfalls wird das Pairing abgelehnt (siehe Abschnitt [Fehlermeldungen beim Speichern](#error-messages-on-saving)). |
| **Archives** | Lokaler Pfad, unter dem das Edge Gateway die RDP-Videoaufzeichnungen archiviert. Vorbelegt mit `/var/lib/ipdiva/carerecord/archives`. |
| **Archives SSH** | Lokaler Pfad, unter dem das Edge Gateway die SSH-Aufzeichnungen archiviert. Vorbelegt mit `/var/ipdiva/care/sshrecord`. |

Die drei Felder **FQDN**, **Archives** und **Archives SSH** betreffen nur Edge Gateways mit Aufzeichnung: Sie sind bei einem Edge Gateway ausgeblendet, das sie nicht unterstützt.

### Paring Token

Das Kontrollkästchen **Create a pairing token** zeigt den standardmäßig ausgeblendeten Abschnitt **Paring Token** an.

| Feld | Beschreibung |
|---|---|
| **SSL certificate** | Zertifikat des Gateway, das hochgeladen werden muss. Eine Dropdown-Liste legt das erwartete Format fest — `pkcs12` (Standard) oder `pem` — und die Dateiauswahl akzeptiert dann nur die entsprechende Erweiterung, `.p12` oder `.pem`. |
| **Certificate or private key password** | Passphrase des Zertifikats des Edge Gateway, sofern zutreffend. |
| **Import a Careserver certificate** | Bei Markierung wird das Zertifikat des Aufzeichnungsservers angezeigt: dieselben drei Elemente (Format, Datei, Kennwort). |
| **Pairing key validity period** | Datum und Uhrzeit, ab denen das Token nicht mehr verwendet werden kann. Standard: heute + 7 Tage, im Format `TT/MM/JJJJ HH:MM`. |
| **IP authorized to use the token** | Öffentliche IP-Adresse, von der aus das Edge Gateway das Pairing durchführen darf. Es handelt sich um die Adresse, wie der Mediation Controller sie sieht: hinter einem NAT geben Sie die öffentliche Adresse ein. |

> **Die letzten beiden Felder werden durch das Zertifikat freigegeben**
>
> **Pairing key validity period** und **IP authorized to use the token** bleiben **inaktiv**, solange keine gültige Zertifikatsdatei ausgewählt wurde. Eine Datei, deren Erweiterung nicht dem gewählten Format entspricht, lässt sie daher inaktiv — bis eine konforme Datei bereitgestellt wird.

Die Schaltfläche **Validate** speichert das Edge Gateway. Erzeugt das Speichern ein Pairing-Token, öffnet sich ein Fenster **Paring Token**, das den Schlüssel anzeigt und angibt, dass er **bei der Installation des Gateway zu verwenden** ist. Es wird mit **Close** geschlossen: Der Schlüssel muss aus dem Fenster kopiert werden.

---

## Ein Edge Gateway bearbeiten

Wählen Sie ein Edge Gateway in der Liste aus und klicken Sie auf das Symbol **Properties** (oder doppelklicken Sie auf die Zeile). Das Fenster **Edit Gateway** ist mit der aktuellen Konfiguration und den Daten des verknüpften Zertifikats vorbelegt.

Die Felder sind dieselben wie beim Erstellen, mit den folgenden Regeln:

- der **Name** bleibt bearbeitbar;
- **FQDN**, **Archives** und **Archives SSH** werden ausgeblendet, wenn das Edge Gateway keine Aufzeichnung unterstützt, und sind **deaktiviert**, solange sie nicht online ist;
- **Pairing key validity period** und **IP authorized to use the token** können nur bei einem Edge Gateway geändert werden, bei der das **Pairing aussteht**;
- ein Feld **Authentication Token**, nur lesbar, erscheint bei einem Edge Gateway, das auf das Pairing wartet.

> **Ändern der Archivpfade**
>
> Das Ändern von **Archives** oder **Archives SSH** macht die früheren Aufzeichnungen von der Konsole aus unerreichbar. Vor dem Anwenden der Änderung wird eine Bestätigung angefordert, und ein Fehler auf Seiten des Edge Gateway wird mit **An error occured during the update of storage paths.** gemeldet.

---

## Ein Edge Gateway löschen

Wählen Sie eine oder mehrere Edge Gateways aus und klicken Sie auf die Schaltfläche **×**. Es wird eine Bestätigung angefordert. Mehrfachauswahl ist möglich.

| Meldung | Ursache |
|---|---|
| **The following gateway is currently being used:** | Das Edge Gateway ist einer oder mehreren Sites zugeordnet. Es muss vor dem Löschen davon getrennt werden. Die betroffenen Namen folgen der Meldung, und für ein mehrfaches Löschen existiert eine Pluralvariante. |
| **Deletion failed for the following gateway:** | Das Löschen ist auf Seiten des Edge Gateway fehlgeschlagen. Die fehlerhaften Namen folgen der Meldung. |

---

## Fehlermeldungen beim Speichern

| Meldung | Ursache |
|---|---|
| **This gateway already exists.** | Es gibt bereits ein Edge Gateway mit diesem Namen. |
| **Invalid Name** | Der Server hat den übermittelten Namen abgewiesen. |
| **The CN of the Edge Gateway certificate sent does not match the expected CN** | Das Zertifikat des Edge Gateway trägt nicht den erwarteten CN. Die Meldung nennt den gefundenen und den erwarteten CN. |
| **The CN of the Careserver certificate sent does not match the expected CN** | Derselbe Fall für das Zertifikat des Aufzeichnungsservers. |
| **Invalid certificate or private key password** | Die angegebene Passphrase öffnet das Zertifikat nicht. |
| **Unable to contact the pairing system, please check its configuration** | Der Pairing-Dienst hat nicht geantwortet. |
| **The given gateway is unreachable.** | Das Edge Gateway antwortet nicht; der Vorgang wird abgebrochen. |
| **The gateway management service is unreachable** | Der Dienst, der die Edge Gateways steuert, hat nicht geantwortet. |
