> Source: https://docs.cyberelements.io/bastion/4.6/sv/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/

# Konfigurera Windows Recording Agent

Windows-inspelningsagenten används av CyberElements Bastion för att lägga till nya funktioner för RDP-sessioner:

- Möjlighet att filtrera de TCP- och UDP-flöden som användaren har åtkomst till
- Möjlighet att utlösa sessionsinspelning för varje användare som ansluter till servern utan att gå via användarportalen eller Desktop-klienten (funktionen `direct access`)

Dessutom fångas ytterligare händelser under användarsessionerna:

- Fönster öppnas
- Fönster stängs
- Program startas
- Program stängs
- Urklippets innehåll
- Användaraktivitet

## Förutsättningar

> **Klientkompatibilitet**
>
> För att ta reda på om agenten är kompatibel med de olika operativsystemen Microsoft Windows, se [kompatibilitetsmatrisen](https://docs.cyberelements.io/bastion/4.6/sv/CompatibilityMatrix/).

Inspelningsagenten kräver några förutsättningar för att fungera korrekt. Några av dem gäller endast inspelningsfunktionen med agent för RDP- och HTML5 RDP-applikationer, medan andra gäller direktåtkomst med agent.

### Allmänna förutsättningar

Inspelningsagenten skickar tillbaka inspelningen av användarsessionen till CyberElements Bastion genom att ansluta till Edge Gateway på porten `TCP 8443`. Detta kräver att nätverksflödet mellan de två maskinerna är öppet.

För att skicka inspelningen tillbaka till Edge Gateway på ett säkert sätt upprättar inspelningsagenten en säker anslutning med denna via TLS. TLS bygger på användning av certifikat, och följande villkor måste vara uppfyllda för att anslutningen ska betraktas som tillförlitlig och säker:

- Serverns certifikat, i detta fall den aktuella Edge Gateway, får inte ha gått ut (senaste giltighetsdatum).
- Serverns certifikat, i detta fall den aktuella Edge Gateway, måste vara utfärdat av en certifikatutfärdare som erkänns som tillförlitlig av den maskin där inspelningsagenten är installerad.

  > **Ytterligare information**
  >
  > Servern där inspelningsagenten är installerad måste minst ha rotcertifikatutfärdaren (CA) för inspelningsserverns certifikat i sitt lokala arkiv över betrodda certifikatutfärdare.
  >
  > Det är därför nödvändigt att:
  >
  > 1. Hämta rot-CA för certifikatet från inspelningstjänsten på Edge Gateway.
  > 2. Ladda upp denna CA till servern där inspelningsagenten är installerad.
  > 3. Installera CA i certifikatarkivet ”Trusted Root Certification Authorities” på den lokala maskinen.
  >
  > > **Exempel med PowerShell**
  > >
  > > Du kan enkelt importera ett certifikat i formatet `.cer` via PowerShell.
  > > Öppna för detta en PowerShell-terminal som administratör för maskinen och kör följande kommando:
  > >
  > > ```
  > > 1
  > > ```
  > >
  > > Byt ut `<PATH_TO_CERT>` mot sökvägen till certifikatfilen.
  >
  > > **Exempel med PowerShell för Systancia-certifikatet utan att skicka filer**
  > >
  > > I det här exemplet installeras Systancias rot-CA, som används av de CyberElements Bastion-klienter som använder certifikat från Systancia.
  > >
  > > Det är också möjligt att importera certifikatet utan att behöva skicka eller ladda ned filen till maskinen där inspelningsagenten är installerad.
  > > Öppna för detta en PowerShell-terminal som administratör för maskinen och kör följande kommandon:
  > >
  > > ```
  > >  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
  > > ```
  > >
  > > För att använda den här metoden med en annan CA, ändra värdet på variabeln `base64Cert` till det base64-kodade certifikat du väljer.
- Serverns certifikat, i detta fall den aktuella Edge Gateway, får inte vara återkallat.
- Maskinen där inspelningsagenten är installerad måste kunna kontakta servern, i detta fall den aktuella Edge Gateway, med ett DNS-namn eller en IP-adress som täcks av serverns certifikat via dess Common Name (CN).

### Särskilda förutsättningar för RDP-applikationer med agent som används på en användararbetsstation med macOS eller Ubuntu

> **Varning**
>
> Följande förutsättningar behövs endast om användaren startar en RDP-applikation med agent och dennes arbetsstation inte är ett Windows-system (macOS eller Ubuntu).
>
> Om användarna av CyberElements Bastion har arbetsstationer som uteslutande kör Windows, eller annars uteslutande använder HTML5-RDP-applikationer, kan följande förutsättningar ignoreras.

Följande registernycklar krävs på målservern där inspelningsagenten är utrullad.

Först inaktiverar den första nyckeln listan över tillåtna startprogram ([Microsoft-dokument](https://learn.microsoft.com/en-us/windows-hardware/customize/desktop/unattend/microsoft-windows-terminalservices-publishing-wmiprovider-fdisabledallowlist)). Som standard tillåter en Windows-maskin endast `explorer.exe` som startprogram.

```
1
2
```

Om maskinen inte är en RDS-server rekommenderas det alltid att tillämpa följande registernyckel, så att inspelningsagenten kan öppnas som startprogram:

```
1
2
```

### Särskilda krav för direktåtkomst

> **Funktionen direktåtkomst**
>
> Funktionen för direkt åtkomst gör det möjligt att utlösa en inspelning av användarens session vid RDP- eller konsolåtkomst (fysisk anslutning till maskinen eller via hypervisorns konsolläge) som inte sker direkt via CyberElements Bastion.
>
> Om användaren har behörighet att komma åt servern spelas dennes session in. Om så inte är fallet kopplas användaren som standard bort.

För att inspelningsagenten ska kunna arbeta i läget direktåtkomst krävs ett x509-certifikat. Detta certifikat måste uppfylla följande krav:

- Certifikatet måste fortfarande vara giltigt (giltighetstiden har inte gått ut).
- Certifikatet måste vara av typen (fältet för utökad nyckelanvändning) `client authentication` (OID: 1.3.6.1.5.5.7.3.2).
- Certifikatet får inte vara återkallat.
- De begränsningar som följer av [OpenSSL security level 2](https://docs.openssl.org/3.0/man3/SSL_CTX_set_security_level/#default-callback-behaviour) innebär att:
    - Certifikatet måste ha en privat nyckel på minst 2048 bitar med krypteringsalgoritmerna RSA, DSA och DH; för nycklar med elliptiska kurvor (ECC) måste de vara minst 224 bitar.
    - Certifikatets signatur får inte vara MD5 eller SHA-1 (SHA-512 föredras).
- Inspelningsservern använder fältet `Common Name` (CN) för att identifiera certifikatet och därmed maskinen där en direkt inspelning utlöses. Detta fält måste vara ifyllt.

## Konfigurationer via registernycklar

Vissa globala inställningar finns i registernycklar och påverkar inspelningsagentens funktion både vid användning med applikationer och vid direktåtkomst.

```
1
2
3
```

**`DisconnectOnError`**

Definierar inspelningsagentens beteende när sessionsinspelaren stängs. Om värdet `0` anges (standardbeteende) stängs användarens session när inspelaren stängs. Om värdet `1` anges kopplas användarens session bort när inspelaren stängs.

**`SessionEndTimeout`**

Definition av tiden (i sekunder) för att stänga användarsessionen innan en tvingad avstängning av sessionen utförs. Som standard är parametern inställd på 10 sekunder.

## Konfiguration för drift med RDP- och HTML5-RDP-applikationer

I det här driftsättet ser utbytena mellan Mediation Controller, Edge Gateway och inspelningsagenten ut på följande sätt:

```mermaid
sequenceDiagram
    autonumber
    participant MED as Mediation Controller
    participant GW as Edge Gateway
    participant AGENT as RDP-server<br/>Inspelningsagent

    MED->>+GW: Sändning av inloggningsuppgifterna till <br/>RDP-servern med inloggningsuppgifterna <br/>för inspelningsagenten
    GW->>AGENT: Initiering av RDP-anslutningen
    GW->>-AGENT: Sändning av inloggningsuppgifterna till <br/>Edge Gatewayens inspelningstjänst
    AGENT->>+GW: Anslutning till inspelningstjänsten
    GW->>-AGENT: Sändning av nätverksfiltreringsinformationen
    Note over AGENT: Tillämpning av nätverks-<br/>begränsningarna på användaren
    loop Kontinuerlig inspelning av sessionen
        AGENT->>+GW: Kontinuerlig sändning av videoinspelningen <br/>+ sessionshändelser
        Note over GW: Kontinuerlig tillägg av videoinspelningen <br/>till den tillfälliga lagringskatalogen
        GW->>-MED: Sändning av de mottagna sessionshändelserna
        Note over MED: Registrering av händelserna <br/>i organisationens databas
    end
    break Slutet på sessionen
        AGENT->>GW: Sändning av informationen att <br/>användaren har avslutat sin RDP-session
        Note over GW: Videoinspelningen flyttas <br/>till arkivkatalogen
        GW->>MED: Anmälan av slutet på användarens session
        Note over MED: Användarens session växlar <br/>från live streaming till arkivet
    end
```

1. Mediation Controller tillhandahåller Edge Gateway anslutningsinformationen för mål-RDP-servern. Den lägger också till den anslutningsinformation som den har för att ansluta till inspelningstjänsten (FQDN för Edge Gateway).
2. Edge Gateway initierar anslutningen till RDP-servern.
3. Edge Gateway skickar anslutningsinformationen för sin inspelningstjänst till inspelningsagenten.
4. Inspelningsagenten initierar anslutningen till inspelningstjänsten.
5. När agenten är ansluten returnerar inspelningstjänsten listan över de nätverksflödesbegränsningar som ska tillämpas på sessionen. När de har mottagits tillämpar inspelningsagenten dem på användarens session.
6. Inspelningsagenten laddar kontinuerligt och i realtid upp videoinspelningen av användarens session och alla sessionshändelser (till exempel tangenttryckningar eller programstarter) till inspelningstjänsten. Inspelningstjänsten lagrar videoinspelningen i en tillfällig katalog.
7. Inspelningstjänsten rapporterar de olika sessionshändelserna till Mediation Controller, som sedan lagrar dem i organisationens databas.
8. När användarens RDP-session avslutas rapporterar inspelningsagenten informationen till inspelningstjänsten. Inspelningstjänsten flyttar därefter den inspelade videon till arkivkatalogen för användarinspelningar.
9. Inspelningstjänsten rapporterar slutet på användarens session till Mediation Controller. Sessionen syns därför inte längre i Live Streaming i Control Center utan går över till Archives.

Vid det här förloppet är det nödvändigt att inspelningsagenten får rätt anslutningsinformation för inspelningstjänsten i Edge Gateway. Informationen finns i inställningarna för Edge Gateway, i fältet `FQDN`: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_Gateway_Edit.png)

Ange i det här fältet ett DNS-namn som RDP-servrarna kan slå upp.

> **Viktigt**
>
> Det certifikat som är tilldelat inspelningstjänsten `Careserver` måste omfatta det namn som anges i fältet `FQDN`. Annars betraktar inspelningsagenten anslutningen som osäker och startar inte sessionsinspelningen.

## Konfiguration för drift med direktåtkomst

I det här driftsättet ser utbytena mellan Mediation Controller, Edge Gateway och inspelningsagenten ut på följande sätt:

```mermaid
sequenceDiagram
    autonumber
    participant MED as Mediation Controller
    participant GW as Edge Gateway
    participant AGENT as RDP-server<br/>Inspelningsagent

    Note over AGENT: Identifiering av en ny <br/>session som ska spelas in
    AGENT->>+GW: Anslutning till inspelningstjänsten
    GW->>-MED: Anmälan av en ny anslutning <br/>med direktåtkomst för användare X
    alt Om användare X har behörighet
        MED->>+GW: Sändning av informationen att användare X <br/>har behörighet att ansluta samt sändning <br/>av listan över nätverksfilter som ska tillämpas
        GW->>-AGENT: Sändning av nätverksfiltreringsinformationen <br/>och anslutningsbehörigheten <br/>för användare X
        Note over AGENT: Tillämpning av nätverks-<br/>begränsningarna på användare X
        loop Kontinuerlig inspelning av sessionen
            AGENT->>+GW: Kontinuerlig sändning av videoinspelningen <br/>+ sessionshändelser
            Note over GW: Kontinuerlig tillägg av videoinspelningen <br/>till den tillfälliga lagringskatalogen
            GW->>-MED: Sändning av de mottagna sessionshändelserna
            Note over MED: Registrering av händelserna <br/>i organisationens databas
        end
        break Slutet på sessionen
            AGENT->>GW: Sändning av informationen att <br/>användare X har avslutat sin RDP-session
            Note over GW: Videoinspelningen flyttas <br/>till arkivkatalogen.
            GW->>MED: Anmälan av slutet på användarens session
            Note over MED: Användarens session växlar <br/>från live streaming till arkivet
        end
    else If user X is not authorized
        MED->>+GW: Sändning av informationen att användare <br/>X inte har behörighet att logga in
        GW->>-AGENT: Sändning av meddelandet om <br/>nekad inloggning för användare X
        Note over AGENT: Loggar ut användare X
    end
```

1. Inspelningsagenten upptäcker en ny session och initierar en anslutning till inspelningstjänsten i en Edge Gateway.
2. Edge Gateway skickar anslutningsinformationen (användarnamn och CN för det certifikat som inspelningsagenten använder) till Mediation Controller. Mediation Controller svarar på två olika sätt beroende på hur åtkomsträttigheterna är konfigurerade.
3. Om användaren har rätt att ansluta till servern rapporterar Mediation Controller tillbaka till Edge Gateway den möjliga åtkomsten för den användaren och den nätverksfilterlista som ska tillämpas.
4. Edge Gateway returnerar informationen till inspelningsagenten. När den har mottagits tillämpar inspelningsagenten nätverksfiltren på användarens session.
5. Inspelningsagenten laddar kontinuerligt och i realtid upp videoinspelningen av användarens session och alla sessionshändelser (till exempel tangenttryckningar eller programstarter) till inspelningstjänsten. Inspelningstjänsten lagrar videoinspelningen i en tillfällig katalog.
6. Inspelningstjänsten rapporterar de olika sessionshändelserna till Mediation Controller, som sedan lagrar dem i organisationens databas.
7. När användarens RDP-session avslutas rapporterar inspelningsagenten informationen till inspelningstjänsten. Inspelningstjänsten flyttar därefter den inspelade videon till arkivkatalogen för användarinspelningar.
8. Inspelningstjänsten rapporterar slutet på användarens session till Mediation Controller. Sessionen syns därför inte längre i Live Streaming i Control Center utan går över till Archives.
9. Om användaren inte har rätt att ansluta till servern rapporterar Mediation Controller den ej auktoriserade åtkomsten för den användaren till Edge Gateway.
10. Edge Gateway vidarebefordrar informationen till inspelningsagenten, som kopplar bort användarens session.

### Registernycklar

Oavsett hur den installeras har inspelningsagenten alla komponenter som behövs för alla de driftsätt som är avsedda för den. För att fungera i direktåtkomstläge läser den därför följande registernycklar för att bestämma sin konfiguration:

```
1
2
3
4
```

**`MachineName`**

Namnet på det certifikat som inspelningsagenten använder för att ansluta till inspelningstjänsten i en Edge Gateway. Som standard, och om det inte är definierat, försöker agenten använda ett certifikat med maskinens namn.

**`LogOffOnFailure`**

Anger agentens beteende när den inte kan ansluta till en Edge Gateway eller när användaren inte har rätt att ansluta till maskinen. Vid `0` sker ingen bortkoppling, medan användaren kopplas bort vid `1` (standardbeteende).

**`RecordedSessions`**

Definition av de sessionstyper som omfattas av inspelning:

- `none` : ingen inspelning av direktåtkomster utförs (standardinställning).
- `remote` : varje RDP-åtkomst till maskinen utlöser en inspelning.
- `all` : RDP-åtkomster och konsolåtkomster (fysisk åtkomst till maskinen eller via hypervisorns konsolläge) utlöser inspelningen.

> **Vilka nyckelvärden krävs för direktåtkomst?**
>
> Det enda nyckelvärde som krävs för att aktivera direktåtkomstmekanismen är `RecordedSessions` med värdet `remote` eller `all`. Observera att nyckelvärdet `MachineName` också kan krävas beroende på miljön.

### Maskincertifikat

Inspelningsagenten försöker använda ett certifikat för autentisering mot inspelningstjänsten. Certifikatet måste ha installerats i datorns personliga certifikat.

Agenten använder det certifikat vars namn motsvarar nyckelvärdet `MachineName` (se [föregående kapitel](#registry-keys)); om det inte är definierat försöker den använda ett certifikat med maskinens namn.

### Deklaration av de Edge Gateways som agenten kan kontakta

Inspelningsagenten använder lokal information för att fastställa listan över Edge Gateway-servrar som ska kontaktas för att ladda upp inspelningarna av användarsessioner.

För att ändra listan över Edge Gateway-servrar som kan kontaktas måste du först stoppa tjänsten `CleanroomAgent`.

> **Varning!**
>
> Att stoppa tjänsten `CleanroomAgent` gör att inspelningen av pågående sessioner på servern avslutas, och nya sessioner som öppnas på servern spelas inte in.

Tjänsten kan stoppas via PowerShell (administratörsrättigheter krävs):

```
1
```

När tjänsten har stoppats ändrar eller skapar du följande fil `[RECORDING_AGENT_DIR]\gateways.xml`, där `[RECORDING_AGENT_DIR]` är inspelningsagentens installationskatalog. Med standardinstallationskatalogen måste filen finnas eller skapas på denna plats:

- CyberElements Bastion: `C:\Program Files (x86)\Systancia\Safe\gateways.xml`

Denna XML-fil består av en tagg `gateways` och lika många taggar `element` som det finns Edge Gateways som kan kontaktas.

> **Exempel**
>
> Om inspelningsagenten behöver kontakta en Edge Gateway med FQDN `edge-gateway-1.domain.local` ser XML-filen ut på följande sätt:
>
> ```
> 1
> 2
> 3
> 4
> ```
>
> Men om det fanns två Edge Gateways att kontakta, `edge-gateway-1.domain.local` och `edge-gateway-2.domain.local`, skulle filen se ut på följande sätt:
>
> ```
> 1
> 2
> 3
> 4
> 5
> ```

Starta om tjänsten `CleanroomAgent` när filen `gateways.xml` har ändrats korrekt:

```
1
```

## Konfigurera inspelningstjänsten för att autentisera certifikat från en PKI från tredje part

Som standard betraktar inspelningstjänsten endast certifikat som utfärdats av Systancias PKI som giltiga. För att använda certifikat från en annan certifikatutfärdare (CA) måste du följa stegen för att [lägga till en CA i Edge Gateways specifika katalog](https://docs.cyberelements.io/bastion/4.6/sv/Usage/Configuration/EdgeGateway/AddANewTrustedCertificationAuthority/#add-to-the-edge-gateway-specific-directory).

När CA-certifikatet eller CA-certifikaten finns på rätt plats återstår bara att starta om inspelningstjänsten, även här som superanvändaren `root`:

> **Varning!**
>
> En omstart av denna tjänst stoppar pågående sessioner och avbryter nästan alla av dem. Kör följande kommando endast när inga användarsessioner går via Edge Gateway, för att inte påverka användarna.

```
1
```

Efter omstarten av inspelningstjänsten kan du kontrollera att de nya CA:erna har beaktats korrekt genom att titta i tjänstens loggar:

```
1
```

De loggar som erhålls anger i slutet av raden namnen på de certifikatfiler som har lästs in av inspelningstjänsten.

> **Exempel**
>
> Efter att två CA:er med namnen `MY-CA-ROOT.pem` och `MY-INTERMEDIATE-CA.pem` har lagts till ser de erhållna loggarna ut så här (början av loggen har klippts bort men den innehåller bland annat datumet och maskinens namn):
>
> ```
> 1
> 2
> 3
> 4
> ```
