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

# Instalacija komponente Edge Gateway Docker

## Uvoz slike Docker

Prije nego što možete stvoriti spremnik Docker Edge Gateway, morate uvesti sliku Docker. Za to pokrenite ljusku iz koje su vam dostupne naredbe Docker, kao i datoteka `cleanroom-gateway-4.6.1-33-v4.tgz`. Iz ljuske pokrenite sljedeću naredbu, prilagodivši put do datoteke `TGZ` ako se ona ne nalazi u trenutačnom direktoriju:

```
1
```

Zatim sljedećom naredbom provjerite je li uvoz uspio:

```
1
```

Očekivani izlaz je sljedeći (ID SHA256 može se razlikovati ovisno o operacijskom sustavu na kojem je instaliran Docker; primjeri su iz sustava Debian 13). Ako nije tako, uvoz nije uspio:

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

> **Potpuni izlaz**
>
> ```
>  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
> ```

## Konfiguracija spremnika

### Varijable okruženja

#### Varijable za implementaciju putem pairinga

| Naziv | Obavezno | Zadana vrijednost | Komentar |
|---|---|---|---|
| `ENV_MEDIATION` | DA |  | Koristi se za povezivanje putem pairinga. DNS naziv ili IP adresa za povezivanje s web-sučeljem platforme CyberElements Bastion. |
| `ENV_TOKEN` | DA |  | Koristi se za povezivanje putem pairinga. Navodi token pairinga koji se koristi za povezivanje s uslugom Mediation Controller. |
| `ENV_NO_CHECK_CERT` | NE | `false` | Koristi se za povezivanje putem pairinga. Određuje treba li onemogućiti provjeru web-certifikata usluge Mediation Controller; korisno uz CyberElements Bastion pri pristupu putem IP adrese ili kada web-certifikat nije certifikat koji prepoznaju zadana javna certifikacijska tijela. Prihvaćene vrijednosti: `true` ili `false`. |

#### Varijable za ručnu implementaciju

| Naziv | Obavezno | Zadana vrijednost | Komentar |
|---|---|---|---|
| `ENV_GW_CERT_NAME` | DA |  | Koristi se za povezivanje s ručnom konfiguracijom. Naziv datoteke certifikata za povezivanje s komponentom SSL Router. |
| `ENV_GW_CERT_PASSWORD` | DA |  | Koristi se za povezivanje s ručnom konfiguracijom. Lozinka datoteke certifikata za povezivanje s komponentom SSL Router. |
| `ENV_CARE_CERT_NAME` | NE | Vrijednost varijable `ENV_GW_CERT_NAME` | Koristi se za povezivanje s ručnom konfiguracijom. Naziv datoteke certifikata za uslugu snimanja. |
| `ENV_CARE_CERT_PASSWORD` | NE | Vrijednost varijable `ENV_GW_CERT_PASSWORD` | Koristi se za povezivanje s ručnom konfiguracijom. Lozinka datoteke certifikata za uslugu snimanja. |
| `ENV_SSL_ROUTER_IP` | DA |  | Koristi se za povezivanje s ručnom konfiguracijom. IP adresa ili naziv DNS komponente SSL Router na koju će se povezati komponenta Edge Gateway. |
| `ENV_SSL_ROUTER_PORT` | NE | `443` | Koristi se za povezivanje s ručnom konfiguracijom. Priključak komponente SSL Router na koji će se povezati komponenta Edge Gateway. |

#### Razne varijable

| Naziv | Obavezno | Zadana vrijednost | Komentar |
|---|---|---|---|
| `ENV_DISABLE_RSYSLOG` | NE | `false` | Deaktivacija usluge `rsyslog`. Prihvaćene vrijednosti: `true` ili `false`. |
| `ENV_KERBEROS_CONFIG_ENABLE` | NE | `false` | Omogućuje postavke protokola Kerberos kako bi se aplikacije RDP mogle autentificirati u načinu bez agenta pomoću protokola Kerberos. Prihvaćene vrijednosti: `true` ili `false`. Ako je vrijednost `false`, ostale varijable protokola Kerberos zanemaruju se. |
| `ENV_KERBEROS_DEFAULT_REALM` | DA (ako je konfiguracija protokola Kerberos omogućena) |  | Naziv područja Kerberos. |
| `ENV_KERBEROS_DEFAULT_DOMAIN` | DA (ako je konfiguracija protokola Kerberos omogućena) |  | Naziv domene Kerberos. |
| `ENV_KERBEROS_CONTROLLER_ADDRESS` | DA (ako je konfiguracija protokola Kerberos omogućena) |  | Adresa za povezivanje s kontrolerom Kerberos. |

### Volumeni

| Volumen | Komentar |
|---|---|
| `/etc/ipdiva/` | Konfiguracijski volumen komponente Edge Gateway. Preporučujemo da ga montirate na imenovani volumen ili na datotečni sustav hosta. |
| `/opt/certificates/` | Volumen koji sadrži certifikat ili certifikate komponente Edge Gateway u konfiguraciji bez pairinga. |
| `/var/lib/ipdiva/carerecord/archives/` | Volumen koji sadrži grafičke arhive. Preporučujemo da ga montirate na imenovani volumen ili na datotečni sustav hosta. |
| `/var/ipdiva/care/sshrecord/` | Volumen koji sadrži arhive SSH. Preporučujemo da ga montirate na imenovani volumen ili na datotečni sustav hosta. |
| `/var/log/` | Volumen koji sadrži zapisnike komponente Edge Gateway. |

### Priključci

| Priključak | Komentar |
|---|---|
| `2222` (ili bilo koji drugi dostupni priključak koji odabere administrator) | Priključak za osluškivanje usluge izravnog pristupa SSH/SFTP. |
| `3389` | Priključak za osluškivanje usluge izravnog pristupa RDP. |
| `8443` | Priključak za osluškivanje usluge snimanja, koji treba izložiti pri korištenju agenta za snimanje za Windows. |

## Implementacija komponente Edge Gateway Docker

### Implementacija s pairingom

> **Preduvjeti**
>
> Prije implementacije komponente Edge Gateway Docker morate [nabaviti token pairinga](https://docs.cyberelements.io/bastion/4.6/hr/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/).

Implementacija opisana u nastavku koristit će sve dostupne volumene (osim volumena `/opt/certificates/`, koji u ovom kontekstu nije koristan) i izložiti sve priključke.
Volumeni će se montirati na datotečni sustav hosta na lokaciji `EDGE_GATEWAY_REP`. Unutar te lokacije nalaze se sljedeći poddirektoriji:

- config
- graphical_archives
- ssh_archives
- log

Varijable za sljedeće naredbe možete prilagoditi:

| Prilagođena vrijednost | Varijabla | Komentar |
|---|---|---|
|  | `DOCKER_NAME` | Naziv spremnika Docker. |
|  | `EDGE_GATEWAY_REP` | Lokacija u datotečnom sustavu na koju se montiraju volumeni. |
|  | `ENV_MEDIATION_VALUE` | Vrijednost [varijable okruženja](#environment-variables) `ENV_MEDIATION`. |
|  | `ENV_TOKEN_VALUE` | Vrijednost [varijable okruženja](#environment-variables) `ENV_TOKEN`. |
|  | `ENV_NO_CHECK_CERT_VALUE` | Vrijednost [varijable okruženja](#environment-variables) `ENV_NO_CHECK_CERT`. |
|  | `ENV_KERBEROS_CONFIG_ENABLE_VALUE` | Vrijednost [varijable okruženja](#environment-variables) `ENV_KERBEROS_CONFIG_ENABLE`. |
|  | `ENV_KERBEROS_DEFAULT_REALM_VALUE` | Vrijednost [varijable okruženja](#environment-variables) `ENV_KERBEROS_DEFAULT_REALM`. |
|  | `ENV_KERBEROS_DEFAULT_DOMAIN_VALUE` | Vrijednost [varijable okruženja](#environment-variables) `ENV_KERBEROS_DEFAULT_DOMAIN`. |
|  | `ENV_KERBEROS_CONTROLLER_ADDRESS_VALUE` | Vrijednost [varijable okruženja](#environment-variables) `ENV_KERBEROS_CONTROLLER_ADDRESS`. |

Izradite stablo direktorija potrebno za montiranje volumena na datotečni sustav:

**Bash**

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

**PowerShell**

> ```
> 1
> ```

Na kraju pokrenite novi spremnik:

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

Zapisnike spremnika možete prikazati sljedećom naredbom:

```
1
```

### Ručna implementacija

> **Preduvjeti**
>
> Prije implementacije komponente Edge Gateway za Docker morate imati potrebne certifikate za komponentu Edge Gateway i za uslugu snimanja.

> **Lozinke vidljive naredbom `docker inspect`**
>
> Varijable okruženja spremnika, uključujući lozinke certifikata, ostaju čitljive svakome kome je dopušteno pokretati `docker inspect` na Docker poslužitelju. Stoga je bolje odabrati [implementaciju s pairingom](#deployment-with-pairing), koja ne koristi lozinku certifikata.

Implementacija opisana u nastavku koristit će sve dostupne volumene i izložiti sve priključke.
Volumeni će se montirati u datotečni sustav računala hosta na lokaciji `MANUAL_REP`. Na toj se lokaciji nalaze sljedeće podmape:

- config
- graphical_archives
- ssh_archives
- log
- certificates

Varijable za sljedeće naredbe možete prilagoditi:

| Prilagođena vrijednost | Varijabla | Komentar |
|---|---|---|
|  | `MANUAL_NAME` | Naziv Docker spremnika. |
|  | `MANUAL_REP` | Lokacija u datotečnom sustavu na koju se montiraju volumeni. |
|  | `ENV_GW_CERT_NAME_VALUE` | Vrijednost [varijable okruženja](#environment-variables) `ENV_GW_CERT_NAME`. |
|  | `ENV_CARE_CERT_NAME_VALUE` | Vrijednost [varijable okruženja](#environment-variables) `ENV_CARE_CERT_NAME`. |
|  | `ENV_SSL_ROUTER_IP_VALUE` | Vrijednost [varijable okruženja](#environment-variables) `ENV_SSL_ROUTER_IP`. |
|  | `ENV_SSL_ROUTER_PORT_VALUE` | Vrijednost [varijable okruženja](#environment-variables) `ENV_SSL_ROUTER_PORT`. |
|  | `ENV_KERBEROS_CONFIG_ENABLE_MANUAL_VALUE` | Vrijednost [varijable okruženja](#environment-variables) `ENV_KERBEROS_CONFIG_ENABLE`. |
|  | `ENV_KERBEROS_DEFAULT_REALM_MANUAL_VALUE` | Vrijednost [varijable okruženja](#environment-variables) `ENV_KERBEROS_DEFAULT_REALM`. |
|  | `ENV_KERBEROS_DEFAULT_DOMAIN_MANUAL_VALUE` | Vrijednost [varijable okruženja](#environment-variables) `ENV_KERBEROS_DEFAULT_DOMAIN`. |
|  | `ENV_KERBEROS_CONTROLLER_ADDRESS_MANUAL_VALUE` | Vrijednost [varijable okruženja](#environment-variables) `ENV_KERBEROS_CONTROLLER_ADDRESS`. |

Izradite stablo direktorija potrebno za montiranje volumena na datotečni sustav:

**Bash**

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

**PowerShell**

> ```
> 1
> ```

Zatim postavite certifikate za komponentu Edge Gateway i za uslugu snimanja u `MANUAL_REP/certificates`.

Kako lozinke certifikata ne bi ostale u povijesti ljuske, unesite ih u varijable okruženja trenutačne sesije (unos se ne prikazuje):

**Bash**

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

**PowerShell**

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

Na kraju pokrenite novi spremnik:

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

Nakon pokretanja spremnika uklonite te varijable iz sesije:

**Bash**

> ```
> 1
> ```

**PowerShell**

> ```
> 1
> ```

Zapisnike spremnika možete prikazati sljedećom naredbom:

```
1
```
