> Source: https://docs.cyberelements.io/bastion/4.6/de/Installation/Docker/EdgeGateway/

# Installation des Edge Gateway Docker

## Import des Docker-Abbilds

Bevor Sie einen Container Edge Gateway Docker erstellen können, müssen Sie das Docker-Abbild importieren. Öffnen Sie dazu eine Shell, in der Ihnen die Docker-Befehle sowie die Datei `cleanroom-gateway-4.6.1-33-v4.tgz` zur Verfügung stehen. Führen Sie aus der Shell den folgenden Befehl aus und passen Sie den Pfad zur Datei `TGZ` an, wenn sie sich nicht im aktuellen Verzeichnis befindet:

```
1
```

Prüfen Sie anschließend mit dem folgenden Befehl, ob der Import erfolgreich war:

```
1
```

Die erwartete Ausgabe ist die folgende (die SHA256-Kennung kann je nach Betriebssystem abweichen, auf dem Docker installiert ist; die Beispiele stammen von Debian 13). Ist dies nicht der Fall, ist der Import fehlgeschlagen:

```
1
2
3
4
5
6
```

> **Vollständige Ausgabe**
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> 22
> 23
> 24
> 25
> 26
> 27
> 28
> 29
> 30
> 31
> 32
> 33
> 34
> 35
> 36
> 37
> 38
> 39
> 40
> 41
> 42
> 43
> 44
> 45
> 46
> 47
> 48
> 49
> 50
> 51
> 52
> 53
> 54
> 55
> 56
> 57
> 58
> 59
> 60
> 61
> 62
> 63
> 64
> 65
> 66
> 67
> 68
> 69
> 70
> 71
> 72
> 73
> 74
> 75
> 76
> 77
> 78
> 79
> 80
> 81
> 82
> 83
> ```

## Konfiguration des Containers

### Umgebungsvariablen

#### Variablen für die Bereitstellung durch Pairing

| Name | Pflicht | Standardwert | Kommentar |
|---|---|---|---|
| `ENV_MEDIATION` | JA |  | Wird für die Verbindung durch Pairing verwendet. DNS-Name oder IP-Adresse für die Verbindung mit der Weboberfläche einer Plattform CyberElements Bastion. |
| `ENV_TOKEN` | JA |  | Wird für die Verbindung durch Pairing verwendet. Gibt das Pairing-Token an, das für die Verbindung mit dem Mediation Controller zu verwenden ist. |
| `ENV_NO_CHECK_CERT` | NEIN | `false` | Wird für die Verbindungen durch Pairing verwendet. Deaktiviert die Prüfung des Webzertifikats des Mediation Controller oder nicht; nützlich bei CyberElements Bastion, wenn der Zugriff über die IP-Adresse erfolgt oder wenn das Webzertifikat kein von den öffentlichen Standardzertifizierungsstellen anerkanntes Zertifikat ist. Akzeptierte Werte: `true` oder `false`. |

#### Variablen für die manuelle Bereitstellung

| Name | Pflicht | Standardwert | Kommentar |
|---|---|---|---|
| `ENV_GW_CERT_NAME` | JA |  | Wird für die Verbindung mit manueller Konfiguration verwendet. Name der Zertifikatsdatei für die Verbindung mit dem SSL Router. |
| `ENV_GW_CERT_PASSWORD` | JA |  | Wird für die Verbindung mit manueller Konfiguration verwendet. Passwort der Zertifikatsdatei für die Verbindung mit dem SSL Router. |
| `ENV_CARE_CERT_NAME` | NEIN | Wert von `ENV_GW_CERT_NAME` | Wird für die Verbindung mit manueller Konfiguration verwendet. Name der Zertifikatsdatei des Aufzeichnungsdienstes. |
| `ENV_CARE_CERT_PASSWORD` | NEIN | Wert von `ENV_GW_CERT_PASSWORD` | Wird für die Verbindung mit manueller Konfiguration verwendet. Passwort der Zertifikatsdatei des Aufzeichnungsdienstes. |
| `ENV_SSL_ROUTER_IP` | JA |  | Wird für die Verbindung mit manueller Konfiguration verwendet. IP-Adresse oder DNS-Name des SSL Router, mit dem sich das Edge Gateway verbindet. |
| `ENV_SSL_ROUTER_PORT` | NEIN | `443` | Wird für die Verbindung mit manueller Konfiguration verwendet. Port des SSL Router, mit dem sich das Edge Gateway verbindet. |

#### Verschiedene Variablen

| Name | Pflicht | Standardwert | Kommentar |
|---|---|---|---|
| `ENV_DISABLE_RSYSLOG` | NEIN | `false` | Deaktivierung des Dienstes `rsyslog`. Zulässige Werte: `true` oder `false`. |
| `ENV_KERBEROS_CONFIG_ENABLE` | NEIN | `false` | Aktiviert die Kerberos-Konfiguration, damit sich RDP-Anwendungen im Modus ohne Agent über Kerberos authentifizieren können. Zulässige Werte: `true` oder `false`. Bei `false` werden die übrigen Kerberos-Variablen ignoriert. |
| `ENV_KERBEROS_DEFAULT_REALM` | JA (wenn die Kerberos-Konfiguration aktiviert ist) |  | Name des Kerberos-Realms. |
| `ENV_KERBEROS_DEFAULT_DOMAIN` | JA (wenn die Kerberos-Konfiguration aktiviert ist) |  | Name der Kerberos-Domäne. |
| `ENV_KERBEROS_CONTROLLER_ADDRESS` | JA (wenn die Kerberos-Konfiguration aktiviert ist) |  | Verbindungsadresse zum Kerberos-Controller. |

### Volumes

| Volume | Kommentar |
|---|---|
| `/etc/ipdiva/` | Konfigurationsvolume des Edge Gateway. Wir empfehlen, es in ein benanntes Volume oder in das Dateisystem der Hostmaschine einzuhängen. |
| `/opt/certificates/` | Volume, das das oder die Zertifikate des Edge Gateway in einer Konfiguration ohne Pairing enthält. |
| `/var/lib/ipdiva/carerecord/archives/` | Volume, das die grafischen Archive enthält. Wir empfehlen, es in ein benanntes Volume oder in das Dateisystem der Hostmaschine einzuhängen. |
| `/var/ipdiva/care/sshrecord/` | Volume, das die SSH-Archive enthält. Wir empfehlen, es in ein benanntes Volume oder in das Dateisystem der Hostmaschine einzuhängen. |
| `/var/log/` | Volume, das die Protokolle des Edge Gateway enthält. |

### Ports

| Port | Kommentar |
|---|---|
| `2222` (oder jeder andere vom Administrator gewählte verfügbare Port) | Lauschender Port des Dienstes für den direkten SSH/SFTP-Zugriff. |
| `3389` | Lauschender Port des Dienstes für den direkten RDP-Zugriff. |
| `8443` | Lauschender Port des Aufzeichnungsdienstes, der bei Verwendung des Windows-Aufzeichnungsagenten verfügbar zu machen ist. |

## Bereitstellung des Edge Gateway Docker

### Bereitstellung mit Pairing

> **Voraussetzungen**
>
> Bevor Sie das Edge Gateway Docker bereitstellen, müssen Sie [ein Pairing-Token beziehen](https://docs.cyberelements.io/bastion/4.6/de/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/).

Die nachstehend beschriebene Bereitstellung verwendet alle verfügbaren Volumes (außer `/opt/certificates/`, das in diesem Zusammenhang nicht von Nutzen ist) und macht alle Ports verfügbar.
Die Volumes werden im Dateisystem der Hostmaschine am Ort `EDGE_GATEWAY_REP` eingehängt. Innerhalb dieses Ortes befinden sich die folgenden Unterverzeichnisse:

- config
- graphical_archives
- ssh_archives
- log

Sie können die Variablen der folgenden Befehle anpassen:

| Angepasster Wert | Variable | Kommentar |
|---|---|---|
|  | `DOCKER_NAME` | Name des Docker-Containers. |
|  | `EDGE_GATEWAY_REP` | Ort im Dateisystem, an dem die Volumes eingehängt werden. |
|  | `ENV_MEDIATION_VALUE` | Wert der [Umgebungsvariablen](#environment-variables) `ENV_MEDIATION`. |
|  | `ENV_TOKEN_VALUE` | Wert der [Umgebungsvariablen](#environment-variables) `ENV_TOKEN`. |
|  | `ENV_NO_CHECK_CERT_VALUE` | Wert der [Umgebungsvariablen](#environment-variables) `ENV_NO_CHECK_CERT`. |
|  | `ENV_KERBEROS_CONFIG_ENABLE_VALUE` | Wert der [Umgebungsvariablen](#environment-variables) `ENV_KERBEROS_CONFIG_ENABLE`. |
|  | `ENV_KERBEROS_DEFAULT_REALM_VALUE` | Wert der [Umgebungsvariablen](#environment-variables) `ENV_KERBEROS_DEFAULT_REALM`. |
|  | `ENV_KERBEROS_DEFAULT_DOMAIN_VALUE` | Wert der [Umgebungsvariablen](#environment-variables) `ENV_KERBEROS_DEFAULT_DOMAIN`. |
|  | `ENV_KERBEROS_CONTROLLER_ADDRESS_VALUE` | Wert der [Umgebungsvariablen](#environment-variables) `ENV_KERBEROS_CONTROLLER_ADDRESS`. |

Legen Sie die für das Einhängen der Volumes erforderliche Verzeichnisstruktur im Dateisystem an:

**Bash**

> ```
> 1
> 2
> 3
> 4
> ```

**PowerShell**

> ```
> 1
> ```

Und starten Sie zuletzt einen neuen Container:

**Bash**

> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> ```

**PowerShell**

> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> ```

Die Protokolle des Containers lassen sich mit dem folgenden Befehl einsehen:

```
1
```

### Manuelle Bereitstellung

> **Voraussetzungen**
>
> Bevor Sie das Edge Gateway Docker bereitstellen, müssen Sie über die erforderlichen Zertifikate für das Edge Gateway und für den Aufzeichnungsdienst verfügen.

> **Mit `docker inspect` sichtbare Passwörter**
>
> Die Umgebungsvariablen eines Containers, einschließlich der Zertifikatspasswörter, bleiben für jeden lesbar, der `docker inspect` auf dem Docker-Server ausführen darf. Die [Bereitstellung mit Pairing](#deployment-with-pairing), die kein Zertifikatspasswort verwendet, ist daher vorzuziehen.

Die nachstehend beschriebene Bereitstellung verwendet alle verfügbaren Volumes und macht alle Ports verfügbar.
Die Volumes werden im Dateisystem der Hostmaschine am Ort `MANUAL_REP` eingehängt. Innerhalb dieses Ortes befinden sich die folgenden Unterverzeichnisse:

- config
- graphical_archives
- ssh_archives
- log
- certificates

Sie können die Variablen der folgenden Befehle anpassen:

| Angepasster Wert | Variable | Kommentar |
|---|---|---|
|  | `MANUAL_NAME` | Name des Docker-Containers. |
|  | `MANUAL_REP` | Ort im Dateisystem, an dem die Volumes eingehängt werden. |
|  | `ENV_GW_CERT_NAME_VALUE` | Wert der [Umgebungsvariablen](#environment-variables) `ENV_GW_CERT_NAME`. |
|  | `ENV_CARE_CERT_NAME_VALUE` | Wert der [Umgebungsvariablen](#environment-variables) `ENV_CARE_CERT_NAME`. |
|  | `ENV_SSL_ROUTER_IP_VALUE` | Wert der [Umgebungsvariablen](#environment-variables) `ENV_SSL_ROUTER_IP`. |
|  | `ENV_SSL_ROUTER_PORT_VALUE` | Wert der [Umgebungsvariablen](#environment-variables) `ENV_SSL_ROUTER_PORT`. |
|  | `ENV_KERBEROS_CONFIG_ENABLE_MANUAL_VALUE` | Wert der [Umgebungsvariablen](#environment-variables) `ENV_KERBEROS_CONFIG_ENABLE`. |
|  | `ENV_KERBEROS_DEFAULT_REALM_MANUAL_VALUE` | Wert der [Umgebungsvariablen](#environment-variables) `ENV_KERBEROS_DEFAULT_REALM`. |
|  | `ENV_KERBEROS_DEFAULT_DOMAIN_MANUAL_VALUE` | Wert der [Umgebungsvariablen](#environment-variables) `ENV_KERBEROS_DEFAULT_DOMAIN`. |
|  | `ENV_KERBEROS_CONTROLLER_ADDRESS_MANUAL_VALUE` | Wert der [Umgebungsvariablen](#environment-variables) `ENV_KERBEROS_CONTROLLER_ADDRESS`. |

Legen Sie die für das Einhängen der Volumes erforderliche Verzeichnisstruktur im Dateisystem an:

**Bash**

> ```
> 1
> 2
> 3
> 4
> 5
> ```

**PowerShell**

> ```
> 1
> ```

Legen Sie anschließend die Zertifikate für das Edge Gateway und für den Aufzeichnungsdienst in `MANUAL_REP/certificates` ab.

Damit die Zertifikatspasswörter nicht im Shell-Verlauf gespeichert werden, geben Sie sie in Umgebungsvariablen der aktuellen Sitzung ein (die Eingabe wird nicht angezeigt):

**Bash**

> ```
> 1
> 2
> 3
> ```

**PowerShell**

> ```
> 1
> 2
> ```

Starten Sie zuletzt einen neuen Container:

**Bash**

> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> ```

**PowerShell**

> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> ```

Sobald der Container gestartet ist, entfernen Sie diese Variablen aus der Sitzung:

**Bash**

> ```
> 1
> ```

**PowerShell**

> ```
> 1
> ```

Die Protokolle des Containers lassen sich mit dem folgenden Befehl einsehen:

```
1
```
