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

# SSH direct recording configurations

Das Modul **SSH direct recording configurations** verbindet eine Reihe von **Gateways** mit einer Reihe von SSH-**Maschinen** und grenzt damit den Umfang der Sitzungen ab, die im direkten Zugriff aufgezeichnet werden können. Es trägt außerdem die **Verteilung der Dienstinstanz**, ohne die ein Edge Gateway diese Aufzeichnungen nicht verarbeiten kann.

## Liste der Konfigurationen

| Spalte | Beschreibung |
|---|---|
| **Name** | Name der Konfiguration, dem ein Schlosssymbol vorangestellt ist. |
| **Gateways** | Anzahl der zugeordneten Edge Gateways. |
| **Machines** | Anzahl der zugeordneten SSH-Maschinen. |

Solange keine Konfiguration existiert, zeigt die Tabelle **No available settings** an. Das Suchfeld, dessen Platzhalter **Search** lautet, filtert die Liste 700 ms nach dem letzten Tastendruck oder unmittelbar mit `Enter`. Die Fußzeile der Tabelle bietet einen Selektor **Items per page:** mit `15`, `25` or `50`.

Der Pfeil am Zeilenanfang klappt die Konfiguration auf und listet ihre Edge Gateways und dann ihre Maschinen auf; ein Tooltip wiederholt dieselben Angaben in beschrifteter Form.

### Aktionen der Werkzeugleiste

| Aktion | Verfügbarkeit | Wirkung |
|---|---|---|
| **+** — Infotext **Add** | Immer | Öffnet das Formular zum Erstellen (siehe Kapitel [Eine Konfiguration hinzufügen](#add-a-configuration)). |
| Änderungssymbol — Infotext **Properties** | Auswahl = 1 | Öffnet dasselbe Formular, vorbelegt. |
| **×** — Infotext **Delete** | Auswahl ≥ 1 | Verlangt eine Bestätigung (siehe Kapitel [Eine Konfiguration löschen](#delete-a-configuration)). |
| **Deploy recording service instance** | **Immer** — es ist keine Auswahl erforderlich | Öffnet das Fenster für die Verteilung (siehe Kapitel [Eine Dienstinstanz für die Aufzeichnung verteilen](#deploy-a-recording-service-instance)). |

## Eine Konfiguration hinzufügen

Ein Klick auf **+** öffnet das Fenster **Add an SSH direct recording configuration**, das aus zwei gemeinsamen Feldern und **zwei Registerkarten** besteht.

| Feld | Beschreibung |
|---|---|
| **Name** | Pflichtfeld. Ein Wert, der nur aus Leerzeichen besteht, wird abgewiesen. |
| **Description** | Optional. |

Die Schaltfläche **Validate** bleibt deaktiviert, bis **mindestens eine Gateway** und **mindestens eine Maschine** ausgewählt wurden. Die Schaltflächen **Previous** und **Next** am unteren Rand des Fensters führen von einer Registerkarte zur nächsten.

**Edge Gateways**

> Zwei nebeneinander liegende Tabellen: links die verfügbaren Edge Gateways, rechts die ausgewählten. Die Auswahl erfolgt per Drag-and-drop, und unter jeder Tabelle befindet sich eine Schaltfläche **Select All**. Die rechte Tabelle fordert **Drop elements here.** auf, solange sie leer ist, und erinnert daran, dass zum Entfernen eines Elements ein Zurückziehen in die linke Liste genügt. Wenn keine Edge Gateway verfügbar ist, zeigt die linke Tabelle **No available gateways** an.

**Machines**

> Dieselbe Anordnung für die SSH-Maschinen, die aus dem Modul [SSH servers](https://docs.cyberelements.io/bastion/4.6/de/Usage/AdminConsoleReference/SshServers/) stammen. Ist keine deklariert, zeigt die linke Tabelle **No available machine** an.

## Eine Konfiguration ändern

Wählen Sie eine Zeile aus und klicken Sie auf das Symbol **Properties** (oder doppelklicken Sie). Das Fenster **Edit an SSH direct recording configuration** zeigt dasselbe Formular, mit den vorab geladenen aktuellen Auswahlen.

## Eine Konfiguration löschen

Wählen Sie eine oder mehrere Konfigurationen aus und klicken Sie auf **×**. Es wird eine Bestätigung verlangt, im Singular oder Plural je nach Auswahl.

## Eine Dienstinstanz für die Aufzeichnung verteilen

Ein Edge Gateway verarbeitet die direkte SSH-Aufzeichnung erst, wenn auf ihm eine dedizierte Dienstinstanz verteilt wurde. Die Schaltfläche **Deploy recording service instance** öffnet das Fenster **Deployment of a recording service instance**. Alle Felder sind Pflichtfelder, außer dem letzten.

| Feld | Beschreibung |
|---|---|
| **Gateway** | Ziel-Edge-Gateway. |
| **Service instance name** | Name, der der neuen Instanz gegeben werden soll. |
| **Listening address** | IP-Adresse, auf der die Instanz lauscht. Die Eingabe muss eine gültige IP-Adresse sein. |
| **Listening port** | Portnummer, zwischen `1` und `65536`. |
| **Gateway instance suffix** | Optional. Bleibt es leer, richtet sich die Verteilung an die Standardinstanz des Edge Gateway. |

Beim Absenden wird der Befehl an das Edge Gateway übermittelt.

| Ergebnis | Meldung |
|---|---|
| Erfolg | **Instance deployment succeeded** |
| Port bereits belegt | **Deployment failed because the port is already used**, unter dem Titel **Deployment error** |
| Anderer Fehler | **Deployment failed**, unter demselben Titel |
