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

# Installatie van de Edge Gateway Docker

## Het Docker-image importeren

Voordat u een Edge Gateway Docker-container kunt aanmaken, moet u het Docker-image importeren. Open daarvoor een shell waarin de Docker-opdrachten en het bestand `cleanroom-gateway-4.6.1-33-v4.tgz` voor u beschikbaar zijn. Voer vanuit de shell de volgende opdracht uit en pas het pad naar het `TGZ`-bestand aan als het zich niet in de huidige map bevindt:

```
1
```

Controleer daarna met de volgende opdracht of de import is gelukt:

```
1
```

De verwachte uitvoer is de volgende (de SHA256-id kan verschillen naargelang het besturingssysteem waarop Docker is geïnstalleerd; de voorbeelden komen van Debian 13). Als dit niet het geval is, is de import mislukt:

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

> **Volledige uitvoer**
>
> ```
>  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
> ```

## Configuratie van de container

### Omgevingsvariabelen

#### Variabelen voor de implementatie via pairing

| Naam | Verplicht | Standaardwaarde | Opmerking |
|---|---|---|---|
| `ENV_MEDIATION` | JA |  | Wordt gebruikt voor de verbinding via pairing. DNS-naam of IP-adres voor de verbinding met de webinterface van een CyberElements Bastion-platform. |
| `ENV_TOKEN` | JA |  | Wordt gebruikt voor de verbinding via pairing. Geeft het pairing-token aan dat voor de verbinding met de Mediation Controller moet worden gebruikt. |
| `ENV_NO_CHECK_CERT` | NEE | `false` | Wordt gebruikt voor de verbindingen via pairing. Schakelt de controle van het webcertificaat van de Mediation Controller al dan niet uit; nuttig bij CyberElements Bastion wanneer de toegang via een IP-adres verloopt of wanneer het webcertificaat geen certificaat is dat door de standaard openbare certificeringsinstanties wordt erkend. Toegestane waarden: `true` of `false`. |

#### Variabelen voor de handmatige implementatie

| Naam | Verplicht | Standaardwaarde | Opmerking |
|---|---|---|---|
| `ENV_GW_CERT_NAME` | JA |  | Wordt gebruikt voor de verbinding met handmatige configuratie. Naam van het certificaatbestand voor de verbinding met de SSL Router. |
| `ENV_GW_CERT_PASSWORD` | JA |  | Wordt gebruikt voor de verbinding met handmatige configuratie. Wachtwoord van het certificaatbestand voor de verbinding met de SSL Router. |
| `ENV_CARE_CERT_NAME` | NEE | Waarde van `ENV_GW_CERT_NAME` | Wordt gebruikt voor de verbinding met handmatige configuratie. Naam van het certificaatbestand van de opnameservice. |
| `ENV_CARE_CERT_PASSWORD` | NEE | Waarde van `ENV_GW_CERT_PASSWORD` | Wordt gebruikt voor de verbinding met handmatige configuratie. Wachtwoord van het certificaatbestand van de opnameservice. |
| `ENV_SSL_ROUTER_IP` | JA |  | Wordt gebruikt voor de verbinding met handmatige configuratie. IP-adres of DNS-naam van de SSL Router waarmee de Edge Gateway verbinding maakt. |
| `ENV_SSL_ROUTER_PORT` | NEE | `443` | Wordt gebruikt voor de verbinding met handmatige configuratie. Poort van de SSL Router waarmee de Edge Gateway verbinding maakt. |

#### Diverse variabelen

| Naam | Verplicht | Standaardwaarde | Opmerking |
|---|---|---|---|
| `ENV_DISABLE_RSYSLOG` | NEE | `false` | Uitschakeling van de service `rsyslog`. Toegestane waarden: `true` of `false`. |
| `ENV_KERBEROS_CONFIG_ENABLE` | NEE | `false` | Schakelt de Kerberos-configuratie in zodat RDP-applicaties zich in de modus zonder agent via Kerberos kunnen authenticeren. Toegestane waarden: `true` of `false`. Bij `false` worden de overige Kerberos-variabelen genegeerd. |
| `ENV_KERBEROS_DEFAULT_REALM` | JA (als de Kerberos-configuratie is ingeschakeld) |  | Naam van het Kerberos-realm. |
| `ENV_KERBEROS_DEFAULT_DOMAIN` | JA (als de Kerberos-configuratie is ingeschakeld) |  | Naam van het Kerberos-domein. |
| `ENV_KERBEROS_CONTROLLER_ADDRESS` | JA (als de Kerberos-configuratie is ingeschakeld) |  | Verbindingsadres van de Kerberos-controller. |

### Volumes

| Volume | Opmerking |
|---|---|
| `/etc/ipdiva/` | Configuratievolume van de Edge Gateway. Wij raden aan het te mounten op een benoemd volume of op het bestandssysteem van de hostmachine. |
| `/opt/certificates/` | Volume dat het certificaat of de certificaten van de Edge Gateway bevat in een configuratie zonder pairing. |
| `/var/lib/ipdiva/carerecord/archives/` | Volume dat de grafische archieven bevat. Wij raden aan het te mounten op een benoemd volume of op het bestandssysteem van de hostmachine. |
| `/var/ipdiva/care/sshrecord/` | Volume dat de SSH-archieven bevat. Wij raden aan het te mounten op een benoemd volume of op het bestandssysteem van de hostmachine. |
| `/var/log/` | Volume dat de logs van de Edge Gateway bevat. |

### Poorten

| Poort | Opmerking |
|---|---|
| `2222` (of elke andere beschikbare poort die de beheerder kiest) | Luisterpoort van de service voor directe SSH/SFTP-toegang. |
| `3389` | Luisterpoort van de service voor directe RDP-toegang. |
| `8443` | Luisterpoort van de opnameservice, die beschikbaar moet worden gemaakt wanneer de Windows-opname-agent wordt gebruikt. |

## Implementatie van de Edge Gateway Docker

### Implementatie met pairing

> **Voorwaarden**
>
> Voordat u de Edge Gateway Docker implementeert, moet u [een pairing-token verkrijgen](https://docs.cyberelements.io/bastion/4.6/nl/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/).

De hieronder beschreven implementatie gebruikt alle beschikbare volumes (behalve `/opt/certificates/`, dat in deze context niet nuttig is) en stelt alle poorten beschikbaar.
De volumes worden gemount in het bestandssysteem van de hostmachine op de locatie `EDGE_GATEWAY_REP`. Binnen deze locatie bevinden zich de volgende submappen:

- config
- graphical_archives
- ssh_archives
- log

U kunt de variabelen van de volgende opdrachten aanpassen:

| Aangepaste waarde | Variabele | Opmerking |
|---|---|---|
|  | `DOCKER_NAME` | Naam van de Docker-container. |
|  | `EDGE_GATEWAY_REP` | Locatie in het bestandssysteem waar de volumes worden gemount. |
|  | `ENV_MEDIATION_VALUE` | Waarde van de [omgevingsvariabele](#environment-variables) `ENV_MEDIATION`. |
|  | `ENV_TOKEN_VALUE` | Waarde van de [omgevingsvariabele](#environment-variables) `ENV_TOKEN`. |
|  | `ENV_NO_CHECK_CERT_VALUE` | Waarde van de [omgevingsvariabele](#environment-variables) `ENV_NO_CHECK_CERT`. |
|  | `ENV_KERBEROS_CONFIG_ENABLE_VALUE` | Waarde van de [omgevingsvariabele](#environment-variables) `ENV_KERBEROS_CONFIG_ENABLE`. |
|  | `ENV_KERBEROS_DEFAULT_REALM_VALUE` | Waarde van de [omgevingsvariabele](#environment-variables) `ENV_KERBEROS_DEFAULT_REALM`. |
|  | `ENV_KERBEROS_DEFAULT_DOMAIN_VALUE` | Waarde van de [omgevingsvariabele](#environment-variables) `ENV_KERBEROS_DEFAULT_DOMAIN`. |
|  | `ENV_KERBEROS_CONTROLLER_ADDRESS_VALUE` | Waarde van de [omgevingsvariabele](#environment-variables) `ENV_KERBEROS_CONTROLLER_ADDRESS`. |

Maak de mappenstructuur aan die nodig is om de volumes in het bestandssysteem te mounten:

**Bash**

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

**PowerShell**

> ```
> 1
> ```

En start ten slotte een nieuwe 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
> ```

De logs van de container kunnen met de volgende opdracht worden bekeken:

```
1
```

### Handmatige implementatie

> **Voorwaarden**
>
> Voordat u de Edge Gateway Docker implementeert, moet u over de vereiste certificaten voor de Edge Gateway en voor de opnameservice beschikken.

> **Wachtwoorden zichtbaar met `docker inspect`**
>
> De omgevingsvariabelen van een container, inclusief de certificaatwachtwoorden, blijven leesbaar voor iedereen die `docker inspect` mag uitvoeren op de Docker-server. De voorkeur gaat daarom uit naar de [implementatie met pairing](#deployment-with-pairing), die geen certificaatwachtwoord gebruikt.

De hieronder beschreven implementatie gebruikt alle beschikbare volumes en stelt alle poorten beschikbaar.
De volumes worden gemount in het bestandssysteem van de hostmachine op de locatie `MANUAL_REP`. Binnen deze locatie bevinden zich de volgende submappen:

- config
- graphical_archives
- ssh_archives
- log
- certificates

U kunt de variabelen van de volgende opdrachten aanpassen:

| Aangepaste waarde | Variabele | Opmerking |
|---|---|---|
|  | `MANUAL_NAME` | Naam van de Docker-container. |
|  | `MANUAL_REP` | Locatie in het bestandssysteem waar de volumes worden gemount. |
|  | `ENV_GW_CERT_NAME_VALUE` | Waarde van de [omgevingsvariabele](#environment-variables) `ENV_GW_CERT_NAME`. |
|  | `ENV_CARE_CERT_NAME_VALUE` | Waarde van de [omgevingsvariabele](#environment-variables) `ENV_CARE_CERT_NAME`. |
|  | `ENV_SSL_ROUTER_IP_VALUE` | Waarde van de [omgevingsvariabele](#environment-variables) `ENV_SSL_ROUTER_IP`. |
|  | `ENV_SSL_ROUTER_PORT_VALUE` | Waarde van de [omgevingsvariabele](#environment-variables) `ENV_SSL_ROUTER_PORT`. |
|  | `ENV_KERBEROS_CONFIG_ENABLE_MANUAL_VALUE` | Waarde van de [omgevingsvariabele](#environment-variables) `ENV_KERBEROS_CONFIG_ENABLE`. |
|  | `ENV_KERBEROS_DEFAULT_REALM_MANUAL_VALUE` | Waarde van de [omgevingsvariabele](#environment-variables) `ENV_KERBEROS_DEFAULT_REALM`. |
|  | `ENV_KERBEROS_DEFAULT_DOMAIN_MANUAL_VALUE` | Waarde van de [omgevingsvariabele](#environment-variables) `ENV_KERBEROS_DEFAULT_DOMAIN`. |
|  | `ENV_KERBEROS_CONTROLLER_ADDRESS_MANUAL_VALUE` | Waarde van de [omgevingsvariabele](#environment-variables) `ENV_KERBEROS_CONTROLLER_ADDRESS`. |

Maak de mappenstructuur aan die nodig is om de volumes in het bestandssysteem te mounten:

**Bash**

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

**PowerShell**

> ```
> 1
> ```

Plaats daarna de certificaten voor de Edge Gateway en voor de opnameservice in `MANUAL_REP/certificates`.

Voer de certificaatwachtwoorden in omgevingsvariabelen van de huidige sessie in, zodat ze niet in de shell-geschiedenis worden bewaard (de invoer wordt niet weergegeven):

**Bash**

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

**PowerShell**

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

Start ten slotte een nieuwe 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
> ```

Verwijder deze variabelen uit de sessie zodra de container is gestart:

**Bash**

> ```
> 1
> ```

**PowerShell**

> ```
> 1
> ```

De logs van de container kunnen met de volgende opdracht worden bekeken:

```
1
```
