> Source: https://docs.cyberelements.io/bastion/4.6/no/Installation/ClientAndAgent/AgentWindowsInstallation/

# Installasjon av Windows-opptaksagenten

Windows-opptaksagenten brukes av CyberElements Bastion for å legge til nye funksjoner for RDP-økter:

- Mulighet til å filtrere TCP- og UDP-strømmene som er tilgjengelige for brukeren
- Mulighet til å utløse øktopptak for enhver bruker som kobler seg til serveren uten å gå gjennom brukerportalen eller Desktop-klienten (funksjonen `direct access`)

I tillegg fanges det opp flere hendelser under brukerøktene:

- Åpning av vindu
- Lukking av vindu
- Oppstart av program
- Lukking av program
- Innhold i utklippstavlen
- Brukeraktivitet

## Forutsetninger

> **Kompatibilitet for klienten**
>
> Se [kompatibilitetsmatrisen](https://docs.cyberelements.io/bastion/4.6/no/CompatibilityMatrix/) for å finne ut om agenten er kompatibel med de forskjellige Microsoft Windows-operativsystemene.

Opptaksagenten krever noen forutsetninger for å fungere som den skal. Noen av dem gjelder bare opptaksfunksjonen med agent for RDP- og HTML5 RDP-applikasjoner, mens andre gjelder direkte tilgang med agent.

### Generelle forutsetninger

Opptaksagenten sender opptaket av brukerøkten tilbake til CyberElements Bastion ved å koble seg til Edge Gateway på port `TCP 8443`. Dette krever at nettverksflyten mellom de to maskinene er åpen.

For å sende opptaket sikkert tilbake til Edge Gateway oppretter opptaksagenten en sikker forbindelse med denne ved hjelp av TLS. TLS baserer seg på bruk av sertifikater, og følgende betingelser må være oppfylt for at forbindelsen skal anses som pålitelig og sikker:

- Sertifikatet til serveren, i dette tilfellen Edge Gateway, må ikke være utløpt (maksimal gyldighetsdato).
- Sertifikatet til serveren, i dette tilfellen Edge Gateway, må være utstedt av en sertifiseringsinstans som maskinen der opptaksagenten er installert, anerkjenner som pålitelig.

  > **Ytterligere informasjon**
  >
  > Serveren der opptaksagenten er installert, må som et minimum ha rotsertifiseringsinstansen (CA) for opptaksserverens sertifikat i sitt lokale lager for pålitelige sertifiseringsinstanser.
  >
  > Det er derfor nødvendig å:
  >
  > 1. Hente rot-CA-en for sertifikatet fra opptakstjenesten på Edge Gateway.
  > 2. Laste opp denne CA-en til serveren der opptaksagenten er installert.
  > 3. Installere CA-en i sertifikatlageret ”Trusted Root Certification Authorities” på den lokale maskinen.
  >
  > > **Eksempel med PowerShell**
  > >
  > > Du kan enkelt importere et sertifikat i formatet `.cer` via PowerShell.
  > > Åpne et PowerShell-terminalvindu som administrator for maskinen, og kjør følgende kommando:
  > >
  > > ```
  > > 1
  > > ```
  > >
  > > Erstatt `<PATH_TO_CERT>` med stien til sertifikatfilen.
  >
  > > **Eksempel med PowerShell for Systancia-sertifikatet uten å sende filer**
  > >
  > > I dette eksemplet installeres rot-CA-en fra Systancia, som brukes av CyberElements Bastion-klientene som benytter sertifikater levert av Systancia.
  > >
  > > Det er også mulig å importere sertifikatet uten å måtte sende eller laste ned filen til maskinen der opptaksagenten er installert.
  > > Åpne et PowerShell-terminalvindu som administrator for maskinen, og kjør følgende kommandoer:
  > >
  > > ```
  > >  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
  > > ```
  > >
  > > For å bruke denne metoden med en annen CA endrer du verdien av variabelen `base64Cert` til det base64-kodede sertifikatet du ønsker.
- Sertifikatet til serveren, i dette tilfellen Edge Gateway, må ikke være tilbakekalt.
- Maskinen der opptaksagenten er installert, må kunne nå serveren, i dette tilfellen Edge Gateway, med et DNS-navn eller en IP-adresse som dekkes av serversertifikatet gjennom Common Name (CN).

### Særskilte forutsetninger for RDP-applikasjoner med agent som brukes på en macOS- eller Ubuntu-arbeidsstasjon

> **Adadvarsel**
>
> Forutsetningene nedenfor er bare nødvendige hvis brukeren starter en RDP-applikasjon med agent og arbeidsstasjonen ikke kjører Windows (macOS eller Ubuntu).
>
> Hvis brukerne av CyberElements Bastion utelukkende har arbeidsstasjoner med Windows, eller ellers utelukkende bruker HTML5-RDP-applikasjoner, kan de følgende forutsetningene ignoreres.

Følgende registernøkler kreves på målserveren der opptaksagenten er rullet ut.

Først vil den første nøkkelen deaktivere listen over tillatte oppstartsprogrammer ([Microsoft-dokument](https://learn.microsoft.com/en-us/windows-hardware/customize/desktop/unattend/microsoft-windows-terminalservices-publishing-wmiprovider-fdisabledallowlist)). Som standard tillater en Windows-maskin bare `explorer.exe` som oppstartsprogram.

```
1
2
```

Hvis maskinen ikke er en RDS-server, anbefales det alltid å bruke følgende registernøkkel for at opptaksagenten skal kunne åpnes som oppstartsprogram:

```
1
2
```

### Særskilte krav for direkte tilgang

> **Funksjonen direkte tilgang**
>
> Funksjonen for direkte tilgang gjør det mulig å utløse et opptak av brukerens økt ved RDP- eller konsolltilgang (fysisk tilkobling til maskinen eller via konsollmodusen til hypervisoren) som ikke går direkte gjennom CyberElements Bastion.
>
> Hvis brukeren har tillatelse til å få tilgang til serveren, blir økten tatt opp. Hvis dette ikke er tilfelle, blir brukeren som standard koblet fra.

For at opptaksagenten skal kunne fungere i modus for direkte tilgang, kreves et x509-sertifikat. Dette sertifikatet må oppfylle følgende krav:

- Sertifikatet må fortsatt være gyldig (gyldighetsperioden er ikke utløpt).
- Sertifikatet må være av typen (feltet for avansert nøkkelbruk) `client authentication` (OID: 1.3.6.1.5.5.7.3.2).
- Sertifikatet må ikke være tilbakekalt.
- Begrensningene som følger av [OpenSSL sikkerhetsnivå 2](https://docs.openssl.org/3.0/man3/SSL_CTX_set_security_level/#default-callback-behaviour) innebærer at:
    - Sertifikatet må ha en privat nøkkel på minst 2048 bit med krypteringsalgoritmene RSA, DSA og DH; for nøkler med elliptiske kurver (ECC) må de være på minst 224 bit.
    - Signaturen til sertifikatet må ikke være MD5 eller SHA-1 (SHA-512 foretrekkes).
- Opptaksserveren bruker feltet `Common Name` (CN) for å identifisere sertifikatet og dermed maskinen der et direkte opptak utløses. Dette feltet må fylles ut.

## Manuell installasjon på en enkelt server

> **Administratorrettigheter kreves**
>
> Det kreves administratorrettigheter for å installere agenten.

Før du installerer agenten, må du laste den ned fra administrasjonskonsollet:

1. Gå til arbeidsområdet ”Configurations” med knappen øverst til venstre: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Open_Configurations_workspace_CLR.png)
2. Åpne flisen ”Toolbox” ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Configurations_Toolbox_tile_CLR.png)
3. Velg installasjonsprogrammet som passer for det ønskede operativsystemet, i den første fanen, ”Integration Tools” ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Configurations_Toolbox_clr_Integration_tools.png)

Når agenten er lastet ned, følger du disse trinnene:

1. Kjør installasjonsprogrammet `setup_CleanroomAgent.exe` på maskinen der du vil installere opptaksagenten.
2. Klikk på `Next` i det første vinduet: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Recording_Agent_1st_screen.png)
3. Godta bruksvilkårene: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Recording_Agent_2nd_screen.png)
4. På det tredje skjermbildet endrer du installasjonskatalogen for agenten om nødvendig: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Recording_Agent_3rd_screen.png)
5. **Det fjerde skjermbildet viser alternativene for å installere agenten i modus for direkte tilgang: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Recording_Agent_4th_screen.png)**

   **`Enable Direct Access`**

   Aktivering av agentens funksjon for direkte tilgang.

   **`Recorded Sessions`**

   Fritt felt som godtar tre ulike verdier for å definere når opptak av direkte tilgang skal utløses:

   **`Logoff On Failure`**

   Alternativ for å koble fra brukerens økt hvis opptaket ikke kan startes, blir avbrutt, eller brukeren ikke har autorisasjon til å koble seg til maskinen.

   > **Anbefaling**
   >
   > Ved førstegangsinstallasjoner, eller hvis det er usikkert om forutsetningene er oppfylt, er det best å la dette alternativet være umerket. Ellers vil nye tilkoblinger til serveren umiddelbart koble fra brukeren hvis det er et problem med forutsetningene eller innstillingene (avhengig av innstillingene for `Recorded Sessions`).

   > **Informasjon**
   >
   > Funksjonen for direkte tilgang kan også aktiveres etter installasjonen. Se i så fall [innstillingene for agentens registernøkler](https://docs.cyberelements.io/bastion/4.6/no/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/#registry-keys).
    - `none`: det utføres ingen opptak av direkte tilgang.
    - `remote`: all RDP-tilgang til maskinen utløser opptaket.
    - `all`: både RDP-tilgang og konsolltilgang (fysisk tilgang til maskinen eller via hypervisorens konsollmodus) utløser opptaket.
6. Til slutt, på det femte skjermbildet, starter installasjonen etter at du har klikket på knappen `Install`: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Recording_Agent_5th_screen.png)

Etter installasjonen krever agenten ytterligere konfigurasjon: [Konfigurer agenten](https://docs.cyberelements.io/bastion/4.6/no/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/)

## Utrulling fra administrasjonskonsollet

> **Administratorrettigheter kreves**
>
> Det kreves administratorrettigheter på målmaskinen for å installere agenten.

> **Ytterligere forutsetning**
>
> Agenten rulles ut på målmaskinen ved hjelp av protokollen `SMB`. Flyten `SMB` (TCP 445) må derfor være åpen mellom Edge Gateway og denne målserveren.

### Utrulling på en enkelt server

Agenten kan rulles ut enkeltvis fra to steder i administrasjonskonsollet. Slik kan den forhåndskonfigureres for to typer virkemåte:

1. Bruk med RDP- og HTML5-RDP-applikasjoner: forbered agenten slik at den kan ta opp øktene til brukere som kjører RDP- og HTML5-RDP-applikasjoner.
2. Bruk i modus for direkte tilgang: forbered agenten slik at den, i tillegg til den forrige virkemåten, kan ta opp øktene til brukere som kobler seg direkte til RDP-serveren.

#### For bruk med RDP- og HTML5-RDP-applikasjoner

Når en RDP- eller HTML5-RDP-applikasjon er konfigurert for å fungere med agenten, låser valg av applikasjonen opp muligheten for å rulle ut agenten: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_DeployRecordingAgent_ApplicationMenu.png)

Etter at du har klikket på knappen for utrulling av agenten, vises et nytt vindu som ber om følgende opplysninger: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_DeployRecordingAgent_ApplicationDeploy.png)

**`Target server`**

IP-adresse eller DNS-navn til målserveren der opptaksagenten skal rulles ut. Som standard bruker dette feltet opplysningene fra serveren som er angitt i RDP- eller HTML5-RDP-applikasjonen.

**`Target drive`**

Bokstaven til Windows-disken der agenten rulles ut. Vanligvis er dette bokstaven `C`, som brukes til å rulle ut agenten på disken `C:\`.

**`Target directory`**

Banen til installasjonskatalogen for agenten; hvis den ikke finnes, opprettes den. Standardplasseringen for agenten CyberElements Bastion er `Program Files (x86)\Systancia\Safe`.

**`Gateway`**

Angi hvilken Edge Gateway som skal brukes til utrulling av agenten.

**`Domain`**

Navnet på domenet der administrasjonskontoen som brukes til å installere agenten, ligger.

**`Username`**

Navnet på administratorkontoen som skal brukes til å installere agenten. Denne kontoen må kunne installere programmer på målserveren.

**`Password`**

Passordet til administratorkontoen.

Når alle opplysningene er lagt inn, kan utrullingen av agenten startes. Et siste vindu viser om utrullingen av agenten på målserveren var vellykket eller ikke.

Ytterligere innstillinger kan fortsatt være nødvendige. Se følgende avsnitt: [Konfigurer agenten](https://docs.cyberelements.io/bastion/4.6/no/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/)

#### For bruk i modus for direkte tilgang + RDP- og HTML5-RDP-applikasjoner

Fra **Machine management** på skjermen for direkte tilgang gjør en knapp det mulig å rulle ut agenten: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_DeployRecordingAgent_DirectAccessMenu.png)

Etter at du har klikket på knappen for utrulling av agenten, vises et nytt vindu som ber om følgende opplysninger: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_DeployRecordingAgent_DirectAccessDeploy.png)

**`Target server`**

IP-adresse eller DNS-navn til målserveren der opptaksagenten skal rulles ut. Som standard bruker dette feltet opplysningene fra serveren som er angitt i RDP- eller HTML5-RDP-applikasjonen.

**`Target drive`**

Bokstaven til Windows-disken der agenten rulles ut. Vanligvis er dette bokstaven `C`, som brukes til å rulle ut agenten på disken `C:\`.

**`Target directory`**

Banen til installasjonskatalogen for agenten; hvis den ikke finnes, opprettes den. Standardplasseringen for agenten CyberElements Bastion er `Program Files (x86)\Systancia\Safe`.

**`Gateway`**

Angi hvilken Edge Gateway som skal brukes til utrulling av agenten.

**`Domain`**

Navnet på domenet der administrasjonskontoen som brukes til å installere agenten, ligger.

**`Username`**

Navnet på administratorkontoen som skal brukes til å installere agenten. Denne kontoen må kunne installere programmer på målserveren.

**`Password`**

Passordet til administratorkontoen.

**`Sessions to record`**

Definisjon av konteksten der et øktopptak skal finne sted:

1. `Record remote sessions (RDS) only`: bare RDP-fjerntilganger blir tatt opp.
2. `Record all sessions`: både RDP-fjernøkter og økter i konsollmodus (fysisk tilgang til maskinen eller via hypervisorens konsollmodus) blir tatt opp.
3. `Record no sessions`: ingen direkte tilkobling til serveren fører til øktopptak; agenten kan likevel brukes for tilgang via RDP- og HTML5-RDP-applikasjoner.

**`Use a different certificate than the target`**

Alternativ for å definere navnet på sertifikatet som agenten bruker til å autentisere seg mot Edge Gateway. Hvis det ikke er definert, søker agenten etter et sertifikat med navnet til serveren.

**`Close the session if no gateway could be contacted`**

Alternativ for å koble fra og logge ut brukeren (avhengig av innstillingene for **Sessions to record**) hvis Edge Gateway ikke er tilgjengelig, eller hvis brukeren ikke har autorisasjon til å koble seg til serveren.

> **Anbefaling**
>
> Ved førstegangsinstallasjoner, eller hvis det er usikkert om forutsetningene er oppfylt, er det best å la dette alternativet være umerket. Ellers vil nye tilkoblinger til serveren umiddelbart koble fra brukeren hvis det er et problem med forutsetningene eller innstillingene (avhengig av innstillingene for `Sessions to record`).

Når alle opplysningene er lagt inn, kan utrullingen av agenten startes. Et siste vindu viser om utrullingen av agenten på målserveren var vellykket eller ikke.

Ytterligere innstillinger kan fortsatt være nødvendige. Se følgende avsnitt: [Konfigurer agenten](https://docs.cyberelements.io/bastion/4.6/no/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/)

### Utrulling på flere servere

> **Informasjon**
>
> Denne metoden gjør det bare mulig å rulle ut opptaksagenten for bruk med RDP- og HTML5-RDP-applikasjoner. For at agenten skal fungere i modus for direkte tilgang, må [konfigurasjonen](https://docs.cyberelements.io/bastion/4.6/no/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/#configuration-for-direct-access-operation) rulles ut på annen måte (for eksempel via GPO).

> **Ytterligere forutsetning**
>
> Utrulling på flere servere er bare mulig på maskiner som tilhører et AD-domene, som selv er konfigurert i `Authentication Domains` i CyberElements Bastion med alternativet `Allow RDS Server Management` aktivert.

Fra `Management of RDS servers` legger du til én eller flere nye RDS-servere: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_RDSServerManagement_AddSerever.png)

Søk opp og legg til serverne som opptaksagenten skal rulles ut på, ved å dra og slippe dem til panelet til høyre. Velg alternativet `Deploy an agent`: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_RDSServerManagement_DeployRecordingAgent.png)

Konfigurer opplysningene for utrulling av agenten: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYE_RDSServerManagement_ConfigureRecordingAgent.png)

**`Target drive`**

Bokstaven til Windows-disken der agenten rulles ut. Vanligvis er dette bokstaven `C`, som brukes til å rulle ut agenten på disken `C:\`.

**`Target directory`**

Banen til installasjonskatalogen for agenten; hvis den ikke finnes, opprettes den. Standardplasseringen for agenten CyberElements Bastion er `Program Files (x86)\Systancia\Safe`.

**`Gateway`**

Angi hvilken Edge Gateway som skal brukes til utrulling av agenten.

**`Domain`**

Navnet på domenet der administrasjonskontoen som brukes til å installere agenten, ligger.

**`Username`**

Navnet på administratorkontoen som skal brukes til å installere agenten. Denne kontoen må kunne installere programmer på målserveren.

**`Password`**

Passordet til administratorkontoen.

Ytterligere innstillinger kan fortsatt være nødvendige. Se følgende avsnitt: [Konfigurer agenten](https://docs.cyberelements.io/bastion/4.6/no/Usage/Configuration/ConfigurationOfWindowsRecordingAgent/)
