> Source: https://docs.cyberelements.io/bastion/4.6/sv/Usage/AdminConsoleReference/Gateways/

# Gateways Management

Modulen **Gateways** listar de Edge Gateways (gateways utan HTML5) som deklarerats på plattformen och gör det möjligt att lägga till en, ändra dess konfiguration (certifikat, lagringssökvägar för inspelningarna, pairing) eller ta bort den. Denna sida riktar sig till en administratör eller integratör som hanterar beståndet av Edge Gateways, deras pairing med Mediation Controller och insamlingen av video- och SSH-inspelningar.

För att kunna användas i en session måste en Edge Gateway vara kopplad till minst ett [site](https://docs.cyberelements.io/bastion/4.6/sv/Usage/AdminConsoleReference/Sites/). Registreringen i ett site görs från modulen **Sites**, inte från denna.

> **Relaterade handledningar**
>
> - [Skapa en pairing-token för en Edge Gateway](https://docs.cyberelements.io/bastion/4.6/sv/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/)
> - [Skapa en Edge Gateway](https://docs.cyberelements.io/bastion/4.6/sv/Usage/Configuration/AdminConsole/CreateEdgeGateway/)

---

## Lista över Edge Gateways

Modulen öppnas med en paginerad tabell över de deklarerade Edge Gateways.

| Kolumn | Beskrivning |
|---|---|
| **Name** | Namn på Edge Gateway, föregånget av en ikon som speglar dess anslutningstillstånd (online, offline, väntar på pairing). |
| **Description** | Fri beskrivning som angetts vid skapandet. |
| **Sites** | Siter som Edge Gateway är kopplad till. |
| **Type** | **With recording** om Edge Gateway stöder sessionsinspelning, annars **Basic**. |
| **Version** | Version av Edge Gateway. När det finns en master- och en backup-instans visas båda versionerna på två rader. |

Åtgärder som finns i verktygsfältet:

| Åtgärd | Beskrivning |
|---|---|
| **+** (Lägg till) | Öppnar fönstret **Add Gateway**. |
| **Edit** | Öppnar fönstret **Edit Gateway** för den valda Edge Gateway. Utlöses även av ett dubbelklick. |
| **×** (Ta bort) | Tar bort de valda Edge Gateways efter bekräftelse. Flerval stöds. |
| **Download recording certificate** | Laddar ner inspelningsauktoritetens certifikat för den valda Edge Gateway. Aktiverad endast om Edge Gateway är **online**. |
| **Search** | Filtrerar på en delsträng i namnet, 700 ms efter den senaste tangenttryckningen (eller omedelbart med `Enter`). |
| **Pagination** | 15, 25 eller 50 rader per sida. |

---

## Lägga till en Edge Gateway

Knappen **+** öppnar fönstret **Add Gateway**.

### Allmän information

| Fält | Beskrivning |
|---|---|
| **Name** | Obligatoriskt, högst 50 tecken. Tillåtna tecken: bokstäver utan accent, siffror, `é`, `è`, `à`, `ô`, `â`, parenteser, blanksteg, `-`, `/`, `.` och `_`. |
| **Description** | Fri text. |
| **FQDN** | Fullständigt kvalificerat namn på maskinen som är värd för Edge Gateway. Det måste motsvara CN i certifikatet för Edge Gateway, annars nekas pairing (se avsnittet [Felmeddelanden vid sparande](#error-messages-on-saving)). |
| **Archives** | Lokal väg där Edge Gateway arkiverar RDP-videoinspelningarna. Förifylld med `/var/lib/ipdiva/carerecord/archives`. |
| **Archives SSH** | Lokal väg där Edge Gateway arkiverar SSH-inspelningarna. Förifylld med `/var/ipdiva/care/sshrecord`. |

De tre fälten **FQDN**, **Archives** och **Archives SSH** rör endast Edge Gateways med inspelning: de är dolda på en Edge Gateway som inte stöder det.

### Paring Token

Kryssrutan **Create a pairing token** visar avsnittet **Paring Token**, som är dolt som standard.

| Fält | Beskrivning |
|---|---|
| **SSL certificate** | Certifikat för gatewayen som ska laddas upp. En listruta anger det förväntade formatet — `pkcs12` (standard) eller `pem` — och filväljaren godtar därefter bara den motsvarande filändelsen, `.p12` eller `.pem`. |
| **Certificate or private key password** | Passfras för certifikatet för Edge Gateway, i tillämpliga fall. |
| **Import a Careserver certificate** | När den är markerad visas certifikatet för inspelningsservern: samma tre element (format, fil, lösenord). |
| **Pairing key validity period** | Datum och klockslag efter vilka token inte längre kan användas. Standard: idag + 7 dagar, i formatet `DD/MM/YYYY HH:MM`. |
| **IP authorized to use the token** | Publik IP-adress som Edge Gateway får utföra pairing från. Det är adressen så som Mediation Controller ser den: bakom en NAT anger du den publika adressen. |

> **De två sista fälten låses upp av certifikatet**
>
> **Pairing key validity period** och **IP authorized to use the token** förblir **inaktiva** så länge ingen giltig certifikatfil har valts. En fil vars filändelse inte motsvarar det valda formatet lämnar dem därför inaktiva — till dess att en fil som uppfyller kraven tillhandahålls.

Knappen **Validate** sparar Edge Gateway. Om sparandet skapar en pairing token öppnas ett fönster **Paring Token**, som visar nyckeln och anger att den **ska användas vid installationen av gatewayen**. Det stängs med **Close**: nyckeln måste kopieras från fönstret.

---

## Ändra en Edge Gateway

Välj en Edge Gateway i listan och klicka på ikonen **Properties** (eller dubbelklicka på raden). Fönstret **Edit Gateway** är förifyllt med den aktuella konfigurationen och uppgifterna om det länkade certifikatet.

Fälten är desamma som vid skapandet, med följande regler:

- **Name** förblir redigerbart;
- **FQDN**, **Archives** och **Archives SSH** döljs om Edge Gateway inte stöder inspelning, och är **inaktiverade** så länge den inte är online;
- **Pairing key validity period** och **IP authorized to use the token** kan endast ändras på en Edge Gateway som **väntar på pairing**;
- ett fält **Authentication Token**, skrivskyddat, visas på en Edge Gateway som väntar på pairing.

> **Ändra arkivvägarna**
>
> Att ändra **Archives** eller **Archives SSH** gör de tidigare inspelningarna oåtkomliga från konsolen. En bekräftelse begärs innan ändringen tillämpas, och ett fel på Edge Gateway-sidan rapporteras med **An error occured during the update of storage paths.**

---

## Ta bort en Edge Gateway

Välj en eller flera Edge Gateways och klicka på knappen **×**. En bekräftelse begärs. Flerval stöds.

| Meddelande | Orsak |
|---|---|
| **The following gateway is currently being used:** | Edge Gateway är kopplad till ett eller flera siter. Den måste kopplas bort innan den tas bort. De berörda namnen följer efter meddelandet, och det finns en pluralvariant för borttagning av flera. |
| **Deletion failed for the following gateway:** | Borttagningen misslyckades på Edge Gateway-sidan. Namnen med fel följer efter meddelandet. |

---

## Felmeddelanden vid sparande

| Meddelande | Orsak |
|---|---|
| **This gateway already exists.** | Det finns redan en Edge Gateway med detta namn. |
| **Invalid Name** | Servern avvisade det inskickade namnet. |
| **The CN of the Edge Gateway certificate sent does not match the expected CN** | Certifikatet för Edge Gateway bär inte det förväntade CN. Meddelandet anger det funna och det förväntade CN. |
| **The CN of the Careserver certificate sent does not match the expected CN** | Samma fall för inspelningsserverns certifikat. |
| **Invalid certificate or private key password** | Den angivna lösenfrasen öppnar inte certifikatet. |
| **Unable to contact the pairing system, please check its configuration** | Pairing-tjänsten svarade inte. |
| **The given gateway is unreachable.** | Edge Gateway svarar inte; åtgärden avbryts. |
| **The gateway management service is unreachable** | Tjänsten som styr Edge Gateways svarade inte. |
