Aqbeż għall-kontenut

Konfigurazzjoni tal-aġent tar-reġistrazzjoni għal Windows

L-aġent tar-reġistrazzjoni għal Windows jintuża minn CyberElements biex iżid funzjonalitajiet ġodda għas-sessjonijiet RDP:

  • Possibbiltà li jiġu ffiltrati l-flussi TCP u UDP aċċessibbli għall-utent
  • Possibbiltà li tiġi skattata r-reġistrazzjoni tas-sessjoni għal kwalunkwe utent li jikkonnettja mas-server mingħajr ma jgħaddi mill-portal tal-utent jew mill-klijent Desktop (funzjonalità direct access)

Barra minn hekk, jinqabdu avvenimenti addizzjonali waqt is-sessjonijiet tal-utenti:

  • Ftuħ ta’ twieqi
  • Għeluq ta’ twieqi
  • Tnedija ta’ programmi
  • Għeluq ta’ programmi
  • Kontenut tal-clipboard
  • Attività tal-utent

Prerekwiżiti

Kompatibbiltà tal-klijent

Biex tkun taf jekk l-aġent huwiex kompatibbli mas-sistemi operattivi differenti ta’ Microsoft Windows, ara il-matriċi tal-kompatibbiltà.

L-aġent tar-reġistrazzjoni jeħtieġ xi prerekwiżiti biex jaħdem sew. Xi wħud minnhom huma maħsuba biss għall-funzjonalità tar-reġistrazzjoni bbażata fuq aġent għall-applikazzjonijiet RDP u HTML5 RDP, filwaqt li oħrajn jikkonċernaw l-aċċess dirett ibbażat fuq aġent.

Prerekwiżiti ġenerali

L-aġent tar-reġistrazzjoni jibgħat ir-reġistrazzjoni tas-sessjoni tal-utent lura lil CyberElements billi jikkonnettja mal-komponent Edge Gateway fuq il-port TCP 8443. Dan jeħtieġ li l-fluss tan-netwerk bejn iż-żewġ kompjuters ikun miftuħ.

Biex jibgħat ir-reġistrazzjoni lura lill-komponent Edge Gateway b’mod sigur, l-aġent tar-reġistrazzjoni jistabbilixxi konnessjoni sigura miegħu permezz ta’ TLS. TLS jiddependi fuq l-użu ta’ ċertifikati, u r-restrizzjonijiet li ġejjin għandhom jiġu vvalidati biex il-konnessjoni titqies affidabbli u sigura:

  • Iċ-ċertifikat tas-server, f’dan il-każ il-komponent Edge Gateway, m’għandux ikun skada (data massima ta’ validità).
  • Iċ-ċertifikat tas-server, f’dan il-każ il-komponent Edge Gateway, għandu jkun maħruġ minn awtorità taċ-ċertifikazzjoni rikonoxxuta bħala affidabbli mill-kompjuter li fuqu huwa installat l-aġent tar-reġistrazzjoni.

    Informazzjoni addizzjonali

    Is-server li fuqu huwa installat l-aġent tar-reġistrazzjoni għandu jkollu, bħala minimu, l-awtorità taċ-ċertifikazzjoni (CA) għerq taċ-ċertifikat tas-server tar-reġistrazzjoni fil-ħażna lokali tiegħu tal-awtoritajiet taċ-ċertifikazzjoni affidabbli.

    Għalhekk huwa meħtieġ:

    1. Ikseb is-CA għerq taċ-ċertifikat mis-servizz tar-reġistrazzjoni fuq il-komponent Edge Gateway.
    2. Tella’ din is-CA fuq is-server fejn huwa installat l-aġent tar-reġistrazzjoni.
    3. Installa s-CA fil-ħażna taċ-ċertifikati “Trusted Root Certification Authorities” fuq il-kompjuter lokali.
    Eżempju b’PowerShell

    Tista’ timporta faċilment ċertifikat fil-format .cer permezz ta’ PowerShell.
    Biex tagħmel dan, iftaħ terminal PowerShell bħala l-amministratur tal-kompjuter u eżegwixxi l-kmand li ġej:

    1
    Import-Certificate -FilePath "<PAHT_TO_CERT>" -CertStoreLocation "Cert:\LocalMachine\Root"
    
    Ibdel <PATH_TO_CERT> bil-mogħdija lejn il-fajl taċ-ċertifikat.

    Eżempju b’PowerShell għaċ-ċertifikat ta’ Systancia mingħajr ma tibgħat fajls

    Dan l-eżempju jinvolvi l-installazzjoni tas-CA għerq ta’ Systancia, li tintuża b’mod default fuq CyberElements.

    Huwa possibbli wkoll li timporta ċ-ċertifikat mingħajr ma jkollok tibgħat/tniżżel il-fajl fuq il-kompjuter fejn huwa installat l-aġent tar-reġistrazzjoni.
    Biex tagħmel dan, iftaħ terminal PowerShell bħala l-amministratur tal-kompjuter u eżegwixxi l-kmandi li ġejjin:

     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
    # Systancia Root certificate
    $base64Cert = "MIIFIDCCBAigAwIBAgIBADANBgkqhkiG9w0BAQUFADCBjTELMAkGA1UEBhMCRlIx
    FDASBgNVBAoTC0lQZGl2YSBSb290MR0wGwYDVQQLExRJUGRpdmEgU2VjdXJpdHkg
    RGVwdDEqMCgGA1UEAxMhSVBkaXZhIFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5
    MR0wGwYJKoZIhvcNAQkBFg5wa2lAaXBkaXZhLmNvbTAeFw0wNTA4MjIxNTAwMzla
    Fw0zMDA4MjIxNTAwMzlaMIGNMQswCQYDVQQGEwJGUjEUMBIGA1UEChMLSVBkaXZh
    IFJvb3QxHTAbBgNVBAsTFElQZGl2YSBTZWN1cml0eSBEZXB0MSowKAYDVQQDEyFJ
    UGRpdmEgUm9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkxHTAbBgkqhkiG9w0BCQEW
    DnBraUBpcGRpdmEuY29tMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA
    ua59tx+RkIPZbGaSwkV0w5fuPBpY3sbLTk/eR2uN7j9zMu0pq38LfibCVsNGlifh
    GfT5CEbrNL7KvlEVY/It1QluYxNgknlcBP1roJG/xHNcUNmbvCFYLy9N3Nd0J/gC
    Vd8tdB4exqyKEoNuqX18rLpSJJOUZdQCeGdF9r+w6vmHdRMeVS44qIiBPv9Bxzgf
    GXBxAlSqfuDDJ3eZEMsWF/kJrbm4Uhav2ACl5qjHgSSTKMoGoEWOJNkB7Mq/khxc
    TnixIpM2s1rpEfhIetPo4BHsyKv7wqWrS6ouwu5AbzT5t3UqaN77CLqcZJGQ3vC0
    IGKBuEcwigd7W6qkX1/XMwIDAQABo4IBhzCCAYMwDwYDVR0TAQH/BAUwAwEB/zAd
    BgNVHQ4EFgQU+lu7XBGohR2DKD+D+abZEODRHjkwgboGA1UdIwSBsjCBr4AU+lu7
    XBGohR2DKD+D+abZEODRHjmhgZOkgZAwgY0xCzAJBgNVBAYTAkZSMRQwEgYDVQQK
    EwtJUGRpdmEgUm9vdDEdMBsGA1UECxMUSVBkaXZhIFNlY3VyaXR5IERlcHQxKjAo
    BgNVBAMTIUlQZGl2YSBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eTEdMBsGCSqG
    SIb3DQEJARYOcGtpQGlwZGl2YS5jb22CAQAwCwYDVR0PBAQDAgEGMBkGA1UdEQQS
    MBCBDnBraUBpcGRpdmEuY29tMBkGA1UdEgQSMBCBDnBraUBpcGRpdmEuY29tMBEG
    CWCGSAGG+EIBAQQEAwIABzA+BglghkgBhvhCAQ0EMRYvSVBkaXZhIFJvb3QgQ2Vy
    dGlmaWNhdGlvbiBBdXRob3JpdHkgQ2VydGlmaWNhdGUwDQYJKoZIhvcNAQEFBQAD
    ggEBACaAgBQK7TATXieb9OdKm+l7/GpePo8f2bRKnkqeRS+HXBKYkvqVJdbJnhJm
    YPOdmhr9ATzt+488tQREAGzqPCp5eiVExPgvomNeG77X57KqbgCA1F7zGJqjP1FL
    771FIWvFXp80ReM/zhcM+MY3sa5LADgOEl5NhoMNHT8AhLKwZ81j5nuwxyG9ICCN
    5GjwgsnK/agmum4+RKeybIWuC/JTsSnu5OImXsmrlUiakp2l+VsZ1rRRNRNUlSbg
    Q3T8kj5ajB0lv2I0kj4fN9wDxzdHEn7nEAmv0t6Y5Te0g/VK3VWhuqeLStaahgip
    hmOVxbu5Ijfug5/3Eemep34NsYk="
    
    # Convert the certificate and store it in memory
    $certBytes = [Convert]::FromBase64String($base64Cert)
    
    # Create a certificate object
    $cert = New-Object System.Security.Cryptography.X509Certificates.X509Certificate2
    $cert.Import($certBytes)
    
    # Open the trusted root certificate store on the local machine and add the Systancia root certificate
    $store = New-Object System.Security.Cryptography.X509Certificates.X509Store("Root", "LocalMachine")
    $store.Open([System.Security.Cryptography.X509Certificates.OpenFlags]::ReadWrite)
    $store.Add($cert)
    $store.Close()
    

    Biex tuża dan il-metodu ma’ CA oħra, ibdel il-valur tal-varjabbli base64Cert għaċ-ċertifikat tal-għażla tiegħek ikkodifikat f’base 64.

  • Iċ-ċertifikat tas-server, f’dan il-każ il-komponent Edge Gateway, m’għandux ikun revokat.

  • Il-kompjuter li fuqu huwa installat l-aġent tar-reġistrazzjoni għandu jkun jista’ jikkuntattja s-server, f’dan il-każ il-komponent Edge Gateway, b’isem DNS jew indirizz IP kopert miċ-ċertifikat tas-server permezz tal-Common Name (CN) tiegħu.

Prerekwiżiti speċifiċi għall-applikazzjonijiet RDP b’aġenti użati fuq stazzjon tax-xogħol tal-utent macOS jew Ubuntu

Twissija

Il-prerekwiżiti li ġejjin huma meħtieġa biss jekk l-utent iniedi applikazzjoni RDP b’aġent u l-istazzjon tax-xogħol tiegħu ma jkunx Windows (macOS jew Ubuntu).

Jekk l-utenti ta’ CyberElements għandhom stazzjonijiet tax-xogħol li jħaddmu esklussivament Windows jew, jekk le, jużaw esklussivament applikazzjonijiet HTML5 RDP, il-prerekwiżiti li ġejjin jistgħu jiġu injorati.

Iċ-ċwievet tar-reġistru li ġejjin huma meħtieġa fuq is-server fil-mira fejn huwa skjerat l-aġent tar-reġistrazzjoni.

L-ewwel nett, l-ewwel ċavetta se tiddiżattiva l-lista tal-programmi tal-bidu awtorizzati (dokument ta’ Microsoft). B’mod default, kompjuter Windows jippermetti biss explorer.exe bħala programm tal-bidu.

1
2
[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Terminal Server\TSAppAllowList]
"fDisabledAllowList"=dword:00000001

Jekk il-kompjuter mhuwiex server RDS, l-applikazzjoni taċ-ċavetta tar-reġistru li ġejja hija dejjem rakkomandata sabiex l-aġent tar-reġistrazzjoni jkun jista’ jinfetaħ bħala programm tal-bidu:

1
2
[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server]
"HonorLegacySettings"=dword:00000001

Rekwiżiti speċifiċi għall-aċċess dirett

Funzjonalità tal-aċċess dirett

Il-funzjonalità tal-aċċess dirett tagħtik il-possibbiltà li tiskatta reġistrazzjoni tas-sessjoni tal-utent għal aċċess RDP jew għal aċċess bil-konsol (konnessjoni fiżika mal-kompjuter jew permezz tal-modalità konsol tal-ipervisur) li ma jgħaddix direttament minn CyberElements.

Jekk l-utent ikollu permess biex jaċċessa s-server, is-sessjoni tiegħu tiġi rreġistrata. Jekk dan ma jkunx il-każ, b’mod default l-utent jiġi skonnettjat.

Biex l-aġent tar-reġistrazzjoni jaħdem fil-modalità tal-aċċess dirett, huwa meħtieġ ċertifikat x509. Dan iċ-ċertifikat għandu jissodisfa r-rekwiżiti li ġejjin:

  • Iċ-ċertifikat għandu jkun għadu validu (il-perjodu ta’ validità ma jkunx skada).
  • Iċ-ċertifikat għandu jkun tat-tip (qasam tal-użu avvanzat taċ-ċavetta) client authentication (OID: 1.3.6.1.5.5.7.3.2).
  • Iċ-ċertifikat m’għandux ikun revokat.
  • Ir-restrizzjonijiet tal-livell ta’ sigurtà 2 ta’ OpenSSL jimplikaw li:
    • Iċ-ċertifikat għandu jkollu ċavetta privata ta’ mill-inqas 2048 bit biċ-ċifri RSA, DSA u DH; għaċ-ċwievet b’kurva ellittika (ECC), dawn għandhom ikunu ta’ mill-inqas 224 bit.
    • Il-firma taċ-ċertifikat m’għandhiex tkun MD5 jew SHA-1 (SHA-512 huwa ppreferut).
  • Is-server tar-reġistrazzjoni se juża l-qasam Common Name (CN) biex jidentifika ċ-ċertifikat u għalhekk il-kompjuter fejn tiġi skattata reġistrazzjoni diretta. Dan il-qasam għandu jimtela.

Konfigurazzjonijiet permezz taċ-ċwievet tar-reġistru

Xi settings globali huma disponibbli fiċ-ċwievet tar-reġistru biex jaffettwaw it-tħaddim tal-aġent tar-reġistrazzjoni kemm meta jintuża mal-applikazzjonijiet kif ukoll fl-aċċess dirett.

1
2
3
[HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\IpdivaSafe]
"DisconnectOnError"=dword:00000000
"SessionEndTimeout"=dword:0000000a
DisconnectOnError

Jiddefinixxi l-imġiba tal-aġent tar-reġistrazzjoni meta jingħalaq ir-reġistratur tas-sessjoni. Jekk jiġi speċifikat il-valur 0 (imġiba default), meta jingħalaq ir-reġistratur, is-sessjoni tal-utent tingħalaq. Jekk jiġi speċifikat il-valur 1, is-sessjoni tal-utent tiġi skonnettjata meta jingħalaq ir-reġistratur.

SessionEndTimeout

Definizzjoni taż-żmien (f’sekondi) għall-għeluq tas-sessjoni tal-utent qabel ma jsir għeluq sfurzat tas-sessjoni. B’mod default, dan il-parametru huwa ssettjat għal 10 sekondi.

Konfigurazzjoni għat-tħaddim mal-applikazzjonijiet RDP u HTML5 RDP

Kuntest SaaS

Fid-dijagrammi ta’ hawn taħt, “Mediation Controller” jirrappreżenta s-servizz cloud ta’ CyberElements immaniġġjat minn CyberElements. Il-fluss tar-reġistrazzjoni huwa arkitetturalment identiku fil-modalità SaaS.

F’din il-modalità tat-tħaddim, l-iskambji bejn il-komponent Mediation Controller, il-komponent Edge Gateway u l-aġent tar-reġistrazzjoni huma kif ġej:

sequenceDiagram
    autonumber
    participant MED as Mediation Controller
    participant GW as Edge Gateway
    participant AGENT as Server RDP<br/>Aġent tar-reġistrazzjoni

    MED->>+GW: Bgħit tal-informazzjoni tal-login <br/>tas-server RDP flimkien mal-informazzjoni tal-login <br/>tal-aġent tar-reġistrazzjoni
    GW->>AGENT: Inizjalizzazzjoni tal-konnessjoni RDP
    GW->>-AGENT: Bgħit tal-informazzjoni tal-login lis-<br/>servizz tar-reġistrazzjoni tal-Edge Gateway
    AGENT->>+GW: Konnessjoni mas-servizz tar-reġistrazzjoni
    GW->>-AGENT: Bgħit ta’ informazzjoni dwar il-filtrazzjoni tan-netwerk
    Note over AGENT: Applikazzjoni ta’ restrizzjonijiet <br/>tan-netwerk fuq l-utent
    loop Reġistrazzjoni kontinwa tas-sessjoni
        AGENT->>+GW: Bgħit kontinwu tar-reġistrazzjoni tal-vidjo <br/>+ avvenimenti tas-sessjoni
        Note over GW: Żieda kontinwa tar-reġistrazzjoni tal-vidjo <br/>fid-direttorju tal-ħażna temporanja
        GW->>-MED: Bgħit tal-avvenimenti tas-sessjoni riċevuti
        Note over MED: Reġistrazzjoni tal-avvenimenti <br/>fid-database tal-organizzazzjoni
    end 
    break Tmiem tas-sessjoni
        AGENT->>GW: Bgħit ta’ informazzjoni li <br/>l-utent temm is-sessjoni RDP tiegħu
        Note over GW: Ir-reġistrazzjoni tal-vidjo tiġi mċaqalqa <br/>għad-direttorju tal-arkivju
        GW->>MED: Indikazzjoni tat-tmiem tas-sessjoni tal-utent
        Note over MED: Is-sessjoni tal-utent tgħaddi <br/>mix-xandir dirett għall-arkivju
    end
Hold "Ctrl" to enable pan & zoom
  1. Il-komponent Mediation Controller jipprovdi lill-komponent Edge Gateway l-informazzjoni tal-konnessjoni għas-server RDP fil-mira. Jinkludi wkoll l-informazzjoni tal-konnessjoni li għandu għall-konnessjoni mas-servizz tar-reġistrazzjoni (l-FQDN tal-komponent Edge Gateway).
  2. Il-komponent Edge Gateway jibda l-konnessjoni mas-server RDP.
  3. Il-komponent Edge Gateway jibgħat l-informazzjoni tal-konnessjoni għas-servizz tar-reġistrazzjoni tiegħu lill-aġent tar-reġistrazzjoni.
  4. L-aġent tar-reġistrazzjoni jibda l-konnessjoni mas-servizz tar-reġistrazzjoni.
  5. Ladarba l-aġent ikun konness, is-servizz tar-reġistrazzjoni jirritorna l-lista tar-restrizzjonijiet tal-fluss tan-netwerk li għandhom jiġu applikati għas-sessjoni. Ladarba jirċevihom, l-aġent tar-reġistrazzjoni japplikahom għas-sessjoni tal-utent.
  6. L-aġent tar-reġistrazzjoni jtella’ kontinwament u f’ħin reali r-reġistrazzjoni bil-vidjo tas-sessjoni tal-utent u l-avvenimenti kollha tas-sessjoni (eż. il-pressjonijiet tat-tasti jew it-tnedija ta’ programmi) lis-servizz tar-reġistrazzjoni. Is-servizz tar-reġistrazzjoni jaħżen ir-reġistrazzjoni bil-vidjo f’folder temporanju.
  7. Is-servizz tar-reġistrazzjoni jirrapporta l-avvenimenti varji tas-sessjoni lill-komponent Mediation Controller, li mbagħad jaħżinhom fil-bażi tad-data tal-organizzazzjoni.
  8. Meta tintemm is-sessjoni RDP tal-utent, l-aġent tar-reġistrazzjoni jirrapporta l-informazzjoni lis-servizz tar-reġistrazzjoni. Is-servizz tar-reġistrazzjoni mbagħad iċaqlaq il-vidjo rreġistrat għall-folder tal-arkivju tar-reġistrazzjonijiet tal-utenti.
  9. Is-servizz tar-reġistrazzjoni jirrapporta t-tmiem tas-sessjoni tal-utent lill-komponent Mediation Controller. Għalhekk is-sessjoni ma tibqax viżibbli fit-taqsima Live Streaming tal-modulu Control Center iżda tgħaddi għat-taqsima Archives.

B’din is-sekwenza, huwa essenzjali li l-aġent tar-reġistrazzjoni jirċievi l-informazzjoni tal-konnessjoni korretta għas-servizz tar-reġistrazzjoni tal-komponent Edge Gateway. Din l-informazzjoni tinsab fis-settings tal-komponent Edge Gateway fil-qasam FQDN:

F’dan il-qasam, daħħal isem DNS li s-servers RDP ikunu jistgħu jirriżolvu.

Importanti

Iċ-ċertifikat assenjat lis-servizz tar-reġistrazzjoni Careserver irid ikopri l-isem speċifikat fil-qasam FQDN. Inkella, l-aġent tar-reġistrazzjoni jqis il-konnessjoni bħala mhux sigura u ma jniedix ir-reġistrazzjoni tas-sessjoni.

Konfigurazzjoni għat-tħaddim bl-aċċess dirett

Kuntest SaaS

Fid-dijagrammi ta’ hawn taħt, “Mediation Controller” jirrappreżenta s-servizz cloud ta’ CyberElements immaniġġjat minn CyberElements. Il-fluss tal-aċċess dirett huwa arkitetturalment identiku fil-modalità SaaS.

F’din il-modalità tat-tħaddim, l-iskambji bejn il-komponent Mediation Controller, il-komponent Edge Gateway u l-aġent tar-reġistrazzjoni huma kif ġej:

sequenceDiagram
    autonumber
    participant MED as Mediation Controller
    participant GW as Edge Gateway
    participant AGENT as Server RDP<br/>Aġent tar-reġistrazzjoni

    Note over AGENT: Skoperta ta’ sessjoni <br/>ġdida li għandha tiġi rreġistrata
    AGENT->>+GW: Konnessjoni mas-servizz tar-reġistrazzjoni
    GW->>-MED: Indikazzjoni ta’ konnessjoni ġdida <br/>b’aċċess dirett għall-utent X
    alt Jekk l-utent X huwa awtorizzat
        MED->>+GW: Bgħit ta’ informazzjoni li l-utent X <br/>huwa awtorizzat jikkonnettja u bgħit <br/>tal-lista tal-filtri tan-netwerk li għandhom jiġu applikati
        GW->>-AGENT: Bgħit ta’ informazzjoni dwar il-filtrazzjoni tan-netwerk <br/>u l-awtorizzazzjoni tal-konnessjoni <br/>għall-utent X
        Note over AGENT: Applikazzjoni ta’ restrizzjonijiet <br/>tan-netwerk fuq l-utent X
        loop Reġistrazzjoni kontinwa tas-sessjoni
            AGENT->>+GW: Bgħit kontinwu tar-reġistrazzjoni tal-vidjo <br/>+ avvenimenti tas-sessjoni
            Note over GW: Żieda kontinwa tar-reġistrazzjoni tal-vidjo <br/>fid-direttorju tal-ħażna temporanja
            GW->>-MED: Bgħit tal-avvenimenti tas-sessjoni riċevuti
            Note over MED: Reġistrazzjoni tal-avvenimenti <br/>fid-database tal-organizzazzjoni
        end 
        break Tmiem tas-sessjoni
            AGENT->>GW: Bgħit ta’ informazzjoni li <br/>l-utent X temm is-sessjoni RDP tiegħu
            Note over GW: Ir-reġistrazzjoni tal-vidjo tiġi mċaqalqa <br/>għad-direttorju tal-arkivju.
            GW->>MED: Indikazzjoni tat-tmiem tas-sessjoni tal-utent
            Note over MED: Is-sessjoni tal-utent tgħaddi <br/>mix-xandir dirett għall-arkivju
        end
    else If user X is not authorized
        MED->>+GW: Bgħit ta’ informazzjoni li l-utent <br/>X mhuwiex awtorizzat jagħmel login
        GW->>-AGENT: Bgħit ta’ notifika dwar <br/>iċ-ċaħda tal-login tal-utent X
        Note over AGENT: Logout tal-utent X
    end
Hold "Ctrl" to enable pan & zoom
  1. Sessjoni ġdida tiġi skoperta mill-aġent tar-reġistrazzjoni, li jibda konnessjoni mas-servizz tar-reġistrazzjoni ta’ komponent Edge Gateway.
  2. Il-komponent Edge Gateway jibgħat l-informazzjoni tal-konnessjoni (l-isem tal-utent u l-isem komuni (CN) taċ-ċertifikat użat mill-aġent tar-reġistrazzjoni) lill-komponent Mediation Controller. Il-komponent Mediation Controller iwieġeb b’żewġ modi differenti skont is-settings tad-drittijiet tal-aċċess.
  3. Jekk l-utent ikun awtorizzat jikkonnettja mas-server, il-komponent Mediation Controller jirrapporta lura lill-komponent Edge Gateway l-aċċess possibbli għal dan l-utent u l-lista tal-filtri tan-netwerk li għandhom jiġu applikati.
  4. Il-komponent Edge Gateway jirritorna din l-informazzjoni lill-aġent tar-reġistrazzjoni. Ladarba jirċeviha, l-aġent tar-reġistrazzjoni japplika l-filtri tan-netwerk għas-sessjoni tal-utent.
  5. L-aġent tar-reġistrazzjoni jtella’ kontinwament u f’ħin reali r-reġistrazzjoni bil-vidjo tas-sessjoni tal-utent u l-avvenimenti kollha tas-sessjoni (eż. il-pressjonijiet tat-tasti jew it-tnedija ta’ programmi) lis-servizz tar-reġistrazzjoni. Is-servizz tar-reġistrazzjoni jaħżen ir-reġistrazzjoni bil-vidjo f’folder temporanju.
  6. Is-servizz tar-reġistrazzjoni jirrapporta l-avvenimenti varji tas-sessjoni lill-komponent Mediation Controller, li mbagħad jaħżinhom fil-bażi tad-data tal-organizzazzjoni.
  7. Meta tintemm is-sessjoni RDP tal-utent, l-aġent tar-reġistrazzjoni jirrapporta l-informazzjoni lis-servizz tar-reġistrazzjoni. Is-servizz tar-reġistrazzjoni mbagħad iċaqlaq il-vidjo rreġistrat għall-folder tal-arkivju tar-reġistrazzjonijiet tal-utenti.
  8. Is-servizz tar-reġistrazzjoni jirrapporta t-tmiem tas-sessjoni tal-utent lill-komponent Mediation Controller. Għalhekk is-sessjoni ma tibqax viżibbli fit-taqsima Live Streaming tal-modulu Control Center iżda tgħaddi għat-taqsima Archives.
  9. Jekk l-utent ma jkunx awtorizzat jikkonnettja mas-server, il-komponent Mediation Controller jirrapporta lill-komponent Edge Gateway l-aċċess mhux awtorizzat għal dak l-utent.
  10. Il-komponent Edge Gateway jgħaddi l-informazzjoni lill-aġent tar-reġistrazzjoni, li jiskonnettja s-sessjoni tal-utent.

Ċwievet tar-reġistru

Irrispettivament minn kif ikun installat, l-aġent tar-reġistrazzjoni għandu l-komponenti kollha meħtieġa għall-modalitajiet kollha tat-tħaddim previsti tiegħu. Għalhekk, sabiex jaħdem fil-modalità tal-aċċess dirett, jaqra ċ-ċwievet tar-reġistru li ġejjin biex jiddetermina l-konfigurazzjoni tiegħu:

1
2
3
4
[HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\IpdivaSafe]
"MachineName"="my-rdp-server.domain.local"
"LogOffOnFailure"=dword:00000001
"RecordedSessions"="none"
MachineName

L-isem taċ-ċertifikat li l-aġent tar-reġistrazzjoni se juża biex jikkonnettja mas-servizz tar-reġistrazzjoni ta’ komponent Edge Gateway. B’mod default, u jekk ma jkunx definit, l-aġent jipprova juża ċertifikat bl-isem tal-kompjuter.

LogOffOnFailure

Indikazzjoni tal-imġiba tal-aġent meta ma jkunx jista’ jikkonnettja ma’ komponent Edge Gateway jew jekk l-utent ma jkunx awtorizzat jikkonnettja mal-kompjuter. Bil-valur 0, ma sseħħ l-ebda skonnessjoni, filwaqt li bil-valur 1 l-utent jiġi skonnettjat (imġiba default).

RecordedSessions

Definizzjoni tat-tipi ta’ sessjonijiet soġġetti għar-reġistrazzjoni:

  • none : ma ssir l-ebda reġistrazzjoni tal-aċċess dirett (setting default).
  • remote : kull aċċess RDP għall-kompjuter iniedi reġistrazzjoni.
  • all : l-aċċess RDP u l-aċċess mill-konsol (aċċess fiżiku għall-kompjuter jew mill-modalità tal-konsol tal-ipervisur) iniedu r-reġistrazzjoni.

Liema valuri taċ-ċwievet huma meħtieġa għall-aċċess dirett?

L-uniku valur taċ-ċavetta meħtieġ biex jiġi attivat il-mekkaniżmu tal-aċċess dirett huwa RecordedSessions bil-valur remote jew all. Innota li skont l-ambjent, jista’ jkun meħtieġ ukoll il-valur taċ-ċavetta MachineName.

Ċertifikat tal-kompjuter

L-aġent tar-reġistrazzjoni se jipprova juża ċertifikat għall-awtentikazzjoni mas-servizz tar-reġistrazzjoni. Dan iċ-ċertifikat irid ikun ġie installat fiċ-ċertifikati personali tal-kompjuter.

L-aġent se juża ċ-ċertifikat li l-isem tiegħu jikkorrispondi għall-valur taċ-ċavetta MachineName (ara l-kapitolu ta’ qabel) u jekk dan ma jkunx definit, jipprova juża ċertifikat bl-isem tal-kompjuter.

Dikjarazzjoni tal-komponenti Edge Gateway li l-aġent jista’ jikkuntattja

L-aġent tar-reġistrazzjoni juża informazzjoni lokali biex jiddetermina l-lista tas-servers Edge Gateway li għandu jikkuntattja sabiex itella’ r-reġistrazzjonijiet tas-sessjonijiet tal-utenti.

Biex timmodifika l-lista tas-servers Edge Gateway li jistgħu jiġu kkuntattjati, l-ewwel trid twaqqaf is-servizz CleanroomAgent.

Twissija!

Il-waqfien tas-servizz CleanroomAgent iwassal biex tintemm ir-reġistrazzjoni tas-sessjonijiet attwali fuq is-server, u kull sessjoni ġdida miftuħa fuq is-server ma tiġix irreġistrata.

Is-servizz jista’ jitwaqqaf permezz ta’ PowerShell (huma meħtieġa d-drittijiet tal-amministratur):

1
Stop-Service CleanroomAgent

Wara li twaqqaf is-servizz, immodifika jew oħloq il-fajl [RECORDING_AGENT_DIR]\gateways.xml li ġej, fejn [RECORDING_AGENT_DIR] huwa l-folder tal-installazzjoni tal-aġent tar-reġistrazzjoni. Bil-folder tal-installazzjoni default, il-fajl irid ikun preżenti jew jinħoloq f’dan il-post:

  • CyberElements: C:\Program Files (x86)\Systancia\cyberelements\gateways.xml

Dan il-fajl XML jikkonsisti f’tikketta gateways u f’daqstant tikketti element daqs kemm hemm komponenti Edge Gateway li jistgħu jiġu kkuntattjati.

Eżempju

Jekk l-aġent tar-reġistrazzjoni jkollu bżonn jikkuntattja komponent Edge Gateway bl-FQDN edge-gateway-1.domain.local, il-fajl XML ikun kif ġej:

1
2
3
4
<?xml version="1.0"?>
<gateways>
    <element>edge-gateway-1.domain.local</element>
</gateways>

Iżda jekk ikun hemm żewġ komponenti Edge Gateway x’jikkuntattja, edge-gateway-1.domain.local u edge-gateway-2.domain.local, il-fajl ikun kif ġej:

1
2
3
4
5
<?xml version="1.0"?>
<gateways>
    <element>edge-gateway-1.domain.local</element>
    <element>edge-gateway-2.domain.local</element>
</gateways>

Wara li timmodifika l-fajl gateways.xml b’mod korrett, erġa’ ibda s-servizz CleanroomAgent:

1
Start-Service CleanroomAgent

Konfigurazzjoni tas-servizz tar-reġistrazzjoni biex jawtentika ċ-ċertifikati minn PKI ta’ parti terza

B’mod default, is-servizz tar-reġistrazzjoni jqis validi biss iċ-ċertifikati maħruġa mill-PKI ta’ Systancia. Sabiex tuża ċertifikati minn awtorità taċ-ċertifikazzjoni (CA) oħra, trid issegwi l-passi deskritti fi Żieda ta’ CA mal-folder speċifiku tal-komponent Edge Gateway.

Ladarba ċ-ċertifikati CA jkunu fil-post it-tajjeb, ma jibqa’ xejn ħlief li terġa’ tibda s-servizz tar-reġistrazzjoni, għal darb’oħra bħala superutent root:

Twissija!

Il-bidu mill-ġdid ta’ dan is-servizz iwaqqaf is-sessjonijiet attwali u jtemm kważi kollha. Eżegwixxi l-kmand li ġej biss meta ebda sessjoni tal-utenti ma tkun għaddejja mill-komponent Edge Gateway, sabiex ma jkunx hemm impatt fuq l-utenti.

1
systemctl restart ipdivacarerecord

Wara li terġa’ tibda s-servizz tar-reġistrazzjoni, tista’ tiċċekkja li l-awtoritajiet taċ-ċertifikazzjoni (CA) l-ġodda ġew ikkunsidrati b’mod korrett billi tikkonsulta r-reġistri tas-servizz:

1
journalctl -xeu ipdivacarerecord -g loadCaDir -S today

Ir-reġistri miksuba jindikaw fit-tarf tal-linja l-ismijiet tal-fajls taċ-ċertifikati li ġew mgħobbija mis-servizz tar-reġistrazzjoni.

Eżempju

Wara ż-żieda ta’ żewġ awtoritajiet taċ-ċertifikazzjoni bl-ismijiet MY-CA-ROOT.pem u MY-INTERMEDIATE-CA.pem, ir-reġistri miksuba jidhru hekk (il-bidu tar-reġistru ġie maqtugħ iżda fih, fost affarijiet oħra, id-data u l-isem tal-kompjuter):

1
2
3
4
TRACE tls.TLS.Context.loadCaDir load ca file: MY-CA-ROOT.pem
TRACE tls.TLS.Context.loadCaDir load ca file: MY-INTERMEDIATE-CA.pem
TRACE tls.TLS.Context.loadCaDir load ca file: oldIPdiva_-928617624.pem
TRACE tls.TLS.Context.loadCaDir load ca file: newIPdiva_1957857431.pem