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:

docker load --input cleanroom-gateway-4.6.1-33-v4.tgz

Zatim sljedećom naredbom provjerite je li uvoz uspio:

docker inspect --type=image cleanroom-gateway:4.6.1-33-v4

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:

[
    {
        "Id": "sha256:c63645a09181bc3b83958bedf2eb3d7ea5fbbc2526126edb660a519b93338974",
        "RepoTags": [
            "cleanroom-gateway:4.6.1-33-v4"
        ],

Potpuni izlaz

[
    {
        "Id": "sha256:c63645a09181bc3b83958bedf2eb3d7ea5fbbc2526126edb660a519b93338974",
        "RepoTags": [
            "cleanroom-gateway:4.6.1-33-v4"
        ],
        "RepoDigests": [
            "cleanroom-gateway@sha256:fd96104ea219a05216c90c71c39b761083c989cbab8ef1f388cac09015bd54a3"
        ],
        "Comment": "buildkit.dockerfile.v0",
        "Created": "2026-02-17T16:21:12.399890264+01:00",
        "Config": {
            "User": "root",
            "ExposedPorts": {
                "9080/tcp": {}
            },
            "Env": [
                "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
                "DEBIAN_FRONTEND=noninteractive",
                "IMAGE_BUILD_DATE=20260217T161839",
                "IMAGE_BUILD_VERSION=4.6.1-33-v4",
                "IMAGE_IPDIPC=IPC-54826,IPC-53702,IPC-55425"
            ],
            "Entrypoint": [
                "/entrypoint.sh"
            ],
            "Volumes": {
                "/etc/ipdiva/": {},
                "/var/log/": {}
            },
            "Labels": {
                "maintainer": "contact@systancia.com",
                "org.label-schema.build-date": "20260217T161839",
                "org.label-schema.description": "Systancia Cleanroom Gateway",
                "org.label-schema.name": "Systancia Cleanroom 4.6.1-33-v4 Gateway",
                "org.label-schema.url": "http://systancia.com/",
                "org.label-schema.vendor": "Systancia",
                "version": "4.6.1-33-v4"
            },
            "Healthcheck": {
                "Test": [
                    "CMD-SHELL",
                    "/usr/lib/nagios/plugins/IPdivaSensorGateway -a isConnected -g 127.0.0.1:9080"
                ],
                "Interval": 300000000000,
                "Timeout": 10000000000,
                "Retries": 3
            }
        },
        "Architecture": "amd64",
        "Os": "linux",
        "Size": 1248982227,
        "GraphDriver": {
            "Data": {
                "LowerDir": "/var/lib/docker/overlay2/5a32af4bf30239320f2d4f04e9dde6e448d138d0e00dbcd0aa07ff859518bfd5/diff:/var/lib/docker/overlay2/da3ceed2e06933403d5e2b503f654efe58afd3067562d4991615cc79109f5000/diff:/var/lib/docker/overlay2/022f1b9fc82a6210ac50a7bf20705651a5a6bd2bfcdd8ca4993778870c4f04ce/diff:/var/lib/docker/overlay2/7675c3cb606871d89d593c5b40746256a109640e03d4846ee49392792f94c29b/diff:/var/lib/docker/overlay2/a0bc243e1069486711b74a39142def4596f99b21d00d286a2bd6212cf8902401/diff:/var/lib/docker/overlay2/fe91732a9355873a0d60ec041ea365567f0fbc963173c9428ab896b591fcb460/diff:/var/lib/docker/overlay2/d4af0110a3ab43120dea8c19e35b7552ad8f8d993d556c34143ecb3c4bd7e670/diff:/var/lib/docker/overlay2/399d72a9751679283e1435dffa5ea7b5abc07f264987815be3846e8e617cf031/diff:/var/lib/docker/overlay2/5c1723a91777858469dc540b3a91738f4b6fc6c0a3cc6686d48b4cb85a9c0400/diff:/var/lib/docker/overlay2/60b4e962507a658aa32be63de9cea55df0a45459b2f3549b3eef3443b35519b9/diff:/var/lib/docker/overlay2/9ff870b850857af52af3de1939f1abd129e96a91d608f3b8f68e0cbcd09eb181/diff",
                "MergedDir": "/var/lib/docker/overlay2/48efe7a9b5e8c4e24a395024dd0876c942b03a52ea161df553d5ee566505c4a8/merged",
                "UpperDir": "/var/lib/docker/overlay2/48efe7a9b5e8c4e24a395024dd0876c942b03a52ea161df553d5ee566505c4a8/diff",
                "WorkDir": "/var/lib/docker/overlay2/48efe7a9b5e8c4e24a395024dd0876c942b03a52ea161df553d5ee566505c4a8/work"
            },
            "Name": "overlay2"
        },
        "RootFS": {
            "Type": "layers",
            "Layers": [
                "sha256:51e78f04fd47b324ef2558bbed0cb5bc0d6d8e5ca3c56d5b98b91866a88f37bb",
                "sha256:3bb2b94a7a30506f2a91d55a04aa0e90a487b3a321d2e1df4f97dfbcfe32cfc0",
                "sha256:deb44bbc3e3d6990e142dc66532aeace714d6c191f1ede7a0f6fd8dcd7e751d3",
                "sha256:e61e4e2f89a04cb7bed974b2c8f510dd72d76e4bf998a000d082fc33bf29947e",
                "sha256:96b1236ab0e31d36a0d0fd17878770d969a11c8d4d33f8cacac568d0b0d76324",
                "sha256:989a4d7dbba1836ad30f58ca73f3101b21b80929f732d5ebdc87a69939b8cf6d",
                "sha256:1f2b05f37aceed6edd80cbe798657a7eb8fce3c7383df8d40d9fdeb273867a9d",
                "sha256:63aa193be3dc44af0057719f79991745e40d8b522a2aa49743dd04fe81b6a637",
                "sha256:02dcea7c2ed886996c81bd6980516420b90e2cdd930dc805388bcd5c7e14b5b3",
                "sha256:1f8c0ab2de5021d138baa67506b22d4d21750a23d0e9278a152daa2e7e953bff",
                "sha256:3601c2e047e3c5019a5e45fb23b478154beb6188761e31aeddb4326bfe16f81c",
                "sha256:20963ed8264d1ceaeb3680375c9c3df4045aa17af258957f3fa83f6224e62138"
            ]
        },
        "Metadata": {
            "LastTagTime": "0001-01-01T00:00:00Z"
        }
    }
]

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.

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 ENV_MEDIATION.
	ENV_TOKEN_VALUE	Vrijednost varijable okruženja ENV_TOKEN.
	ENV_NO_CHECK_CERT_VALUE	Vrijednost varijable okruženja ENV_NO_CHECK_CERT.
	ENV_KERBEROS_CONFIG_ENABLE_VALUE	Vrijednost varijable okruženja ENV_KERBEROS_CONFIG_ENABLE.
	ENV_KERBEROS_DEFAULT_REALM_VALUE	Vrijednost varijable okruženja ENV_KERBEROS_DEFAULT_REALM.
	ENV_KERBEROS_DEFAULT_DOMAIN_VALUE	Vrijednost varijable okruženja ENV_KERBEROS_DEFAULT_DOMAIN.
	ENV_KERBEROS_CONTROLLER_ADDRESS_VALUE	Vrijednost varijable okruženja ENV_KERBEROS_CONTROLLER_ADDRESS.

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

BashPowerShell

mkdir -p EDGE_GATEWAY_REP/config
mkdir EDGE_GATEWAY_REP/graphical_archives
mkdir EDGE_GATEWAY_REP/ssh_archives
mkdir EDGE_GATEWAY_REP/log

New-Item -ItemType Directory -Force -Path "EDGE_GATEWAY_REP\config", "EDGE_GATEWAY_REP\graphical_archives", "EDGE_GATEWAY_REP\ssh_archives", "EDGE_GATEWAY_REP\log"

Na kraju pokrenite novi spremnik:

BashPowerShell

docker run -d --restart unless-stopped --name "DOCKER_NAME" \
-e ENV_MEDIATION="ENV_MEDIATION_VALUE" \
-e ENV_TOKEN="ENV_TOKEN_VALUE" \
-e ENV_NO_CHECK_CERT="ENV_NO_CHECK_CERT_VALUE" \
-e ENV_KERBEROS_CONFIG_ENABLE="ENV_KERBEROS_CONFIG_ENABLE_VALUE" \
-e ENV_KERBEROS_DEFAULT_REALM="ENV_KERBEROS_DEFAULT_REALM_VALUE" \
-e ENV_KERBEROS_DEFAULT_DOMAIN="ENV_KERBEROS_DEFAULT_DOMAIN_VALUE" \
-e ENV_KERBEROS_CONTROLLER_ADDRESS="ENV_KERBEROS_CONTROLLER_ADDRESS_VALUE" \
-v "EDGE_GATEWAY_REP/config/:/etc/ipdiva/:rw" \
-v "EDGE_GATEWAY_REP/graphical_archives/:/var/lib/ipdiva/carerecord/archives/:rw" \
-v "EDGE_GATEWAY_REP/ssh_archives/:/var/ipdiva/care/sshrecord/:rw" \
-v "EDGE_GATEWAY_REP/log/:/var/log/:rw" \
-p 2222:2222 \
-p 3389:3389 \
-p 8443:8443 \
cleanroom-gateway:4.6.1-33-v4

docker run -d --restart unless-stopped --name "DOCKER_NAME" `
-e "ENV_MEDIATION=ENV_MEDIATION_VALUE" `
-e "ENV_TOKEN=ENV_TOKEN_VALUE" `
-e "ENV_NO_CHECK_CERT=ENV_NO_CHECK_CERT_VALUE" `
-e "ENV_KERBEROS_CONFIG_ENABLE=ENV_KERBEROS_CONFIG_ENABLE_VALUE" `
-e "ENV_KERBEROS_DEFAULT_REALM=ENV_KERBEROS_DEFAULT_REALM_VALUE" `
-e "ENV_KERBEROS_DEFAULT_DOMAIN=ENV_KERBEROS_DEFAULT_DOMAIN_VALUE" `
-e "ENV_KERBEROS_CONTROLLER_ADDRESS=ENV_KERBEROS_CONTROLLER_ADDRESS_VALUE" `
-v "EDGE_GATEWAY_REP\config:/etc/ipdiva/:rw" `
-v "EDGE_GATEWAY_REP\graphical_archives:/var/lib/ipdiva/carerecord/archives/:rw" `
-v "EDGE_GATEWAY_REP\ssh_archives:/var/ipdiva/care/sshrecord/:rw" `
-v "EDGE_GATEWAY_REP\log:/var/log/:rw" `
-p 2222:2222 `
-p 3389:3389 `
-p 8443:8443 `
cleanroom-gateway:4.6.1-33-v4

Zapisnike spremnika možete prikazati sljedećom naredbom:

docker logs -f DOCKER_NAME

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, 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 ENV_GW_CERT_NAME.
	ENV_CARE_CERT_NAME_VALUE	Vrijednost varijable okruženja ENV_CARE_CERT_NAME.
	ENV_SSL_ROUTER_IP_VALUE	Vrijednost varijable okruženja ENV_SSL_ROUTER_IP.
	ENV_SSL_ROUTER_PORT_VALUE	Vrijednost varijable okruženja ENV_SSL_ROUTER_PORT.
	ENV_KERBEROS_CONFIG_ENABLE_MANUAL_VALUE	Vrijednost varijable okruženja ENV_KERBEROS_CONFIG_ENABLE.
	ENV_KERBEROS_DEFAULT_REALM_MANUAL_VALUE	Vrijednost varijable okruženja ENV_KERBEROS_DEFAULT_REALM.
	ENV_KERBEROS_DEFAULT_DOMAIN_MANUAL_VALUE	Vrijednost varijable okruženja ENV_KERBEROS_DEFAULT_DOMAIN.
	ENV_KERBEROS_CONTROLLER_ADDRESS_MANUAL_VALUE	Vrijednost varijable okruženja ENV_KERBEROS_CONTROLLER_ADDRESS.

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

BashPowerShell

mkdir -p MANUAL_REP/config
mkdir MANUAL_REP/graphical_archives
mkdir MANUAL_REP/ssh_archives
mkdir MANUAL_REP/log
mkdir MANUAL_REP/certificates

New-Item -ItemType Directory -Force -Path "MANUAL_REP\config", "MANUAL_REP\graphical_archives", "MANUAL_REP\ssh_archives", "MANUAL_REP\log", "MANUAL_REP\certificates"

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):

BashPowerShell

read -rsp "Edge Gateway certificate password: " ENV_GW_CERT_PASSWORD; echo
read -rsp "Recording service certificate password: " ENV_CARE_CERT_PASSWORD; echo
export ENV_GW_CERT_PASSWORD ENV_CARE_CERT_PASSWORD

$env:ENV_GW_CERT_PASSWORD = [Net.NetworkCredential]::new('', (Read-Host -AsSecureString "Edge Gateway certificate password")).Password
$env:ENV_CARE_CERT_PASSWORD = [Net.NetworkCredential]::new('', (Read-Host -AsSecureString "Recording service certificate password")).Password

Na kraju pokrenite novi spremnik:

BashPowerShell

docker run -d --restart unless-stopped --name "MANUAL_NAME" \
-e ENV_GW_CERT_NAME="ENV_GW_CERT_NAME_VALUE" \
-e ENV_GW_CERT_PASSWORD \
-e ENV_CARE_CERT_NAME="ENV_CARE_CERT_NAME_VALUE" \
-e ENV_CARE_CERT_PASSWORD \
-e ENV_SSL_ROUTER_IP="ENV_SSL_ROUTER_IP_VALUE" \
-e ENV_SSL_ROUTER_PORT="ENV_SSL_ROUTER_PORT_VALUE" \
-e ENV_KERBEROS_CONFIG_ENABLE="ENV_KERBEROS_CONFIG_ENABLE_MANUAL_VALUE" \
-e ENV_KERBEROS_DEFAULT_REALM="ENV_KERBEROS_DEFAULT_REALM_MANUAL_VALUE" \
-e ENV_KERBEROS_DEFAULT_DOMAIN="ENV_KERBEROS_DEFAULT_DOMAIN_MANUAL_VALUE" \
-e ENV_KERBEROS_CONTROLLER_ADDRESS="ENV_KERBEROS_CONTROLLER_ADDRESS_MANUAL_VALUE" \
-v "MANUAL_REP/config/:/etc/ipdiva/:rw" \
-v "MANUAL_REP/graphical_archives/:/var/lib/ipdiva/carerecord/archives/:rw" \
-v "MANUAL_REP/ssh_archives/:/var/ipdiva/care/sshrecord/:rw" \
-v "MANUAL_REP/log/:/var/log/:rw" \
-v "MANUAL_REP/certificates/:/opt/certificates/:ro" \
-p 2222:2222 \
-p 3389:3389 \
-p 8443:8443 \
cleanroom-gateway:4.6.1-33-v4

docker run -d --restart unless-stopped --name "MANUAL_NAME" `
-e "ENV_GW_CERT_NAME=ENV_GW_CERT_NAME_VALUE" `
-e ENV_GW_CERT_PASSWORD `
-e "ENV_CARE_CERT_NAME=ENV_CARE_CERT_NAME_VALUE" `
-e ENV_CARE_CERT_PASSWORD `
-e "ENV_SSL_ROUTER_IP=ENV_SSL_ROUTER_IP_VALUE" `
-e "ENV_SSL_ROUTER_PORT=ENV_SSL_ROUTER_PORT_VALUE" `
-e "ENV_KERBEROS_CONFIG_ENABLE=ENV_KERBEROS_CONFIG_ENABLE_MANUAL_VALUE" `
-e "ENV_KERBEROS_DEFAULT_REALM=ENV_KERBEROS_DEFAULT_REALM_MANUAL_VALUE" `
-e "ENV_KERBEROS_DEFAULT_DOMAIN=ENV_KERBEROS_DEFAULT_DOMAIN_MANUAL_VALUE" `
-e "ENV_KERBEROS_CONTROLLER_ADDRESS=ENV_KERBEROS_CONTROLLER_ADDRESS_MANUAL_VALUE" `
-v "MANUAL_REP\config:/etc/ipdiva/:rw" `
-v "MANUAL_REP\graphical_archives:/var/lib/ipdiva/carerecord/archives/:rw" `
-v "MANUAL_REP\ssh_archives:/var/ipdiva/care/sshrecord/:rw" `
-v "MANUAL_REP\log:/var/log/:rw" `
-v "MANUAL_REP\certificates:/opt/certificates/:ro" `
-p 2222:2222 `
-p 3389:3389 `
-p 8443:8443 `
cleanroom-gateway:4.6.1-33-v4

Nakon pokretanja spremnika uklonite te varijable iz sesije:

BashPowerShell

unset ENV_GW_CERT_PASSWORD ENV_CARE_CERT_PASSWORD

Remove-Item Env:ENV_GW_CERT_PASSWORD, Env:ENV_CARE_CERT_PASSWORD

Zapisnike spremnika možete prikazati sljedećom naredbom:

docker logs -f MANUAL_NAME