Installazzjoni tal-komponent Edge Gateway Docker¶
Importazzjoni tal-immaġni Docker¶
Qabel ma tkun tista’ toħloq kontenitur Edge Gateway Docker, trid timporta l-immaġni Docker. Biex tagħmel dan, iftaħ shell li minnha jkollok disponibbli l-kmandi Docker, kif ukoll il-fajl cleanroom-gateway-4.6.1-33-v4.tgz. Mix-shell, ħaddem il-kmand li ġej, u aġġusta l-mogħdija għall-fajl TGZ jekk ma jkunx fil-folder kurrenti:
1 | |
Imbagħad iċċekkja li l-importazzjoni rnexxiet bil-kmand li ġej:
1 | |
L-output mistenni huwa kif ġej (l-ID SHA256 jista’ jvarja skont is-sistema operattiva li fuqha huwa installat Docker; l-eżempji huma minn Debian 13). Jekk dan ma jkunx il-każ, l-importazzjoni tkun falliet:
1 2 3 4 5 6 | |
Output sħiħ
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 | |
Konfigurazzjoni tal-kontenitur¶
Varjabbli tal-ambjent¶
Varjabbli għall-iskjerament permezz ta’ pairing¶
| Isem | Obbligatorju | Valur default | Kumment |
|---|---|---|---|
ENV_MEDIATION |
IVA | Użat għall-konnessjoni permezz ta’ pairing. Isem DNS jew indirizz IP għall-konnessjoni mal-interfaċċa web ta’ pjattaforma CyberElements Bastion. |
|
ENV_TOKEN |
IVA | Użat għall-konnessjoni permezz ta’ pairing. Indikazzjoni tat-token tal-pairing li għandu jintuża għall-konnessjoni mas-servizz Mediation Controller. |
|
ENV_NO_CHECK_CERT |
LE | false |
Użat għall-konnessjonijiet permezz ta’ pairing. Jekk il-verifika taċ-ċertifikat web tas-servizz Mediation Controller għandhiex tiġi diżattivata jew le; utli ma’ CyberElements Bastion meta l-aċċess isir permezz ta’ indirizz IP jew meta ċ-ċertifikat web mhuwiex ċertifikat rikonoxxut mill-awtoritajiet taċ-ċertifikazzjoni pubbliċi default. Valuri aċċettati: true jew false. |
Varjabbli għall-iskjerament manwali¶
| Isem | Obbligatorju | Valur default | Kumment |
|---|---|---|---|
ENV_GW_CERT_NAME |
IVA | Użat għall-konnessjoni b’konfigurazzjoni manwali. Isem il-fajl taċ-ċertifikat għall-konnessjoni mal-komponent SSL Router. |
|
ENV_GW_CERT_PASSWORD |
IVA | Użat għall-konnessjoni b’konfigurazzjoni manwali. Il-password tal-fajl taċ-ċertifikat għall-konnessjoni mal-komponent SSL Router. |
|
ENV_CARE_CERT_NAME |
LE | Valur ta’ ENV_GW_CERT_NAME |
Użat għall-konnessjoni b’konfigurazzjoni manwali. Isem il-fajl taċ-ċertifikat għas-servizz tar-reġistrazzjoni. |
ENV_CARE_CERT_PASSWORD |
LE | Valur ta’ ENV_GW_CERT_PASSWORD |
Użat għall-konnessjoni b’konfigurazzjoni manwali. Il-password tal-fajl taċ-ċertifikat tas-servizz tar-reġistrazzjoni. |
ENV_SSL_ROUTER_IP |
IVA | Użat għall-konnessjoni b’konfigurazzjoni manwali. L-indirizz IP jew l-isem DNS tal-komponent SSL Router li miegħu se jikkonnettja l-komponent Edge Gateway. |
|
ENV_SSL_ROUTER_PORT |
LE | 443 |
Użat għall-konnessjoni b’konfigurazzjoni manwali. Il-port fuq il-komponent SSL Router li miegħu se jikkonnettja l-komponent Edge Gateway. |
Varjabbli diversi¶
| Isem | Obbligatorju | Valur default | Kumment |
|---|---|---|---|
ENV_DISABLE_RSYSLOG |
LE | false |
Diżattivazzjoni tas-servizz rsyslog.Valuri aċċettati: true jew false. |
ENV_KERBEROS_CONFIG_ENABLE |
LE | false |
Jattiva s-settings ta’ Kerberos biex jippermetti lill-applikazzjonijiet RDP jawtentikaw ruħhom f’modalità mingħajr aġent bl-użu ta’ Kerberos. Valuri aċċettati: true jew false.Jekk false, il-varjabbli l-oħra ta’ Kerberos jiġu injorati. |
ENV_KERBEROS_DEFAULT_REALM |
IVA (jekk il-konfigurazzjoni ta’ Kerberos hija attivata) |
Isem ir-realm Kerberos. | |
ENV_KERBEROS_DEFAULT_DOMAIN |
IVA (jekk il-konfigurazzjoni ta’ Kerberos hija attivata) |
Isem id-dominju Kerberos. | |
ENV_KERBEROS_CONTROLLER_ADDRESS |
IVA (jekk il-konfigurazzjoni ta’ Kerberos hija attivata) |
L-indirizz tal-konnessjoni mal-kontrollur Kerberos. |
Volumi¶
| Volum | Kumment |
|---|---|
/etc/ipdiva/ |
Volum tal-konfigurazzjoni tal-komponent Edge Gateway. Nirrakkomandaw li jiġi mmuntat fuq volum bl-isem jew fuq is-sistema tal-fajls tal-kompjuter ospitanti. |
/opt/certificates/ |
Volum li fih iċ-ċertifikat jew iċ-ċertifikati tal-komponent Edge Gateway f’konfigurazzjoni mingħajr pairing. |
/var/lib/ipdiva/carerecord/archives/ |
Volum li fih l-arkivji grafiċi. Nirrakkomandaw li jiġi mmuntat fuq volum bl-isem jew fuq is-sistema tal-fajls tal-kompjuter ospitanti. |
/var/ipdiva/care/sshrecord/ |
Volum li fih l-arkivji SSH. Nirrakkomandaw li jiġi mmuntat fuq volum bl-isem jew fuq is-sistema tal-fajls tal-kompjuter ospitanti. |
/var/log/ |
Volum li fih ir-reġistri tal-komponent Edge Gateway. |
Portijiet¶
| Port | Kumment |
|---|---|
2222 (jew kwalunkwe port ieħor disponibbli magħżul mill-amministratur) |
Port tas-smigħ għas-servizz tal-aċċess dirett SSH/SFTP. |
3389 |
Port tas-smigħ għas-servizz tal-aċċess dirett RDP. |
8443 |
Port tas-smigħ għas-servizz tar-reġistrazzjoni, li għandu jiġi espost meta jintuża l-aġent tar-reġistrazzjoni għal Windows. |
Skjerament tal-komponent Edge Gateway Docker¶
Skjerament bil-pairing¶
Prerekwiżiti
Qabel ma tiskjera l-komponent Edge Gateway Docker, trid tikseb token tal-pairing.
L-iskjerament deskritt hawn taħt se juża l-volumi disponibbli kollha (ħlief /opt/certificates/, li mhuwiex utli f’dan il-kuntest) u se jesponi l-portijiet kollha.
Il-volumi se jiġu mmuntati fuq is-sistema tal-fajls tal-kompjuter ospitanti fil-post EDGE_GATEWAY_REP. F’dan il-post hemm is-sottofolders li ġejjin:
- config
- graphical_archives
- ssh_archives
- log
Tista’ tippersonalizza l-varjabbli għall-kmandi li ġejjin:
| Valur personalizzat | Varjabbli | Kumment |
|---|---|---|
DOCKER_NAME |
Isem il-kontenitur Docker. | |
EDGE_GATEWAY_REP |
Il-post fis-sistema tal-fajls fejn jiġu mmuntati l-volumi. | |
ENV_MEDIATION_VALUE |
Il-valur tal-varjabbli tal-ambjent ENV_MEDIATION. |
|
ENV_TOKEN_VALUE |
Il-valur tal-varjabbli tal-ambjent ENV_TOKEN. |
|
ENV_NO_CHECK_CERT_VALUE |
Il-valur tal-varjabbli tal-ambjent ENV_NO_CHECK_CERT. |
|
ENV_KERBEROS_CONFIG_ENABLE_VALUE |
Il-valur tal-varjabbli tal-ambjent ENV_KERBEROS_CONFIG_ENABLE. |
|
ENV_KERBEROS_DEFAULT_REALM_VALUE |
Il-valur tal-varjabbli tal-ambjent ENV_KERBEROS_DEFAULT_REALM. |
|
ENV_KERBEROS_DEFAULT_DOMAIN_VALUE |
Il-valur tal-varjabbli tal-ambjent ENV_KERBEROS_DEFAULT_DOMAIN. |
|
ENV_KERBEROS_CONTROLLER_ADDRESS_VALUE |
Il-valur tal-varjabbli tal-ambjent ENV_KERBEROS_CONTROLLER_ADDRESS. |
Oħloq is-siġra tal-folders meħtieġa għall-immuntar tal-volumi fuq is-sistema tal-fajls:
1 2 3 4 | |
1 | |
U fl-aħħar, ibda kontenitur ġdid:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 | |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 | |
Ir-reġistri tal-kontenitur jistgħu jiġu kkonsultati bil-kmand li ġej:
1 | |
Skjerament manwali¶
Prerekwiżiti
Qabel ma tiskjera l-komponent Edge Gateway Docker, irid ikollok iċ-ċertifikati meħtieġa għall-komponent Edge Gateway u għas-servizz tar-reġistrazzjoni.
Passwords viżibbli b’docker inspect
Il-varjabbli tal-ambjent ta’ kontenitur, inklużi l-passwords taċ-ċertifikati, jibqgħu jinqraw minn kull min huwa awtorizzat iħaddem docker inspect fuq is-server Docker. Għalhekk għandu jiġi ppreferut l-iskjerament bil-pairing, li ma juża l-ebda password ta’ ċertifikat.
L-iskjerament deskritt hawn taħt se juża l-volumi kollha disponibbli u jesponi l-portijiet kollha.
Il-volumi se jiġu mmuntati fis-sistema tal-fajls tal-kompjuter ospitanti fil-post MANUAL_REP. F’dan il-post hemm is-sottodirettorji li ġejjin:
- config
- graphical_archives
- ssh_archives
- log
- certificates
Tista’ tippersonalizza l-varjabbli għall-kmandi li ġejjin:
| Valur personalizzat | Varjabbli | Kumment |
|---|---|---|
MANUAL_NAME |
Isem il-kontenitur Docker. | |
MANUAL_REP |
Post fis-sistema tal-fajls fejn jiġu mmuntati l-volumi. | |
ENV_GW_CERT_NAME_VALUE |
Valur tal-varjabbli tal-ambjent ENV_GW_CERT_NAME. |
|
ENV_CARE_CERT_NAME_VALUE |
Valur tal-varjabbli tal-ambjent ENV_CARE_CERT_NAME. |
|
ENV_SSL_ROUTER_IP_VALUE |
Valur tal-varjabbli tal-ambjent ENV_SSL_ROUTER_IP. |
|
ENV_SSL_ROUTER_PORT_VALUE |
Valur tal-varjabbli tal-ambjent ENV_SSL_ROUTER_PORT. |
|
ENV_KERBEROS_CONFIG_ENABLE_MANUAL_VALUE |
Valur tal-varjabbli tal-ambjent ENV_KERBEROS_CONFIG_ENABLE. |
|
ENV_KERBEROS_DEFAULT_REALM_MANUAL_VALUE |
Valur tal-varjabbli tal-ambjent ENV_KERBEROS_DEFAULT_REALM. |
|
ENV_KERBEROS_DEFAULT_DOMAIN_MANUAL_VALUE |
Valur tal-varjabbli tal-ambjent ENV_KERBEROS_DEFAULT_DOMAIN. |
|
ENV_KERBEROS_CONTROLLER_ADDRESS_MANUAL_VALUE |
Valur tal-varjabbli tal-ambjent ENV_KERBEROS_CONTROLLER_ADDRESS. |
Oħloq is-siġra tal-folders meħtieġa għall-immuntar tal-volumi fuq is-sistema tal-fajls:
1 2 3 4 5 | |
1 | |
Imbagħad poġġi ċ-ċertifikati tal-komponent Edge Gateway u tas-servizz tar-reġistrazzjoni fil-folder MANUAL_REP/certificates.
Biex il-passwords taċ-ċertifikati ma jinżammux fl-istorja tax-shell, daħħalhom f’varjabbli tal-ambjent tas-sessjoni attwali (dak li tikteb ma jintweriex):
1 2 3 | |
1 2 | |
Fl-aħħar, ibda kontenitur ġdid:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 | |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 | |
Ladarba l-kontenitur ikun beda, neħħi dawn il-varjabbli mis-sessjoni:
1 | |
1 | |
Ir-reġistri tal-kontenitur jistgħu jiġu kkonsultati bil-kmand li ġej:
1 | |