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

# Gateways Management

**Gateways** -moduuli luettelee alustalla ilmoitetut Edge Gateway -palvelimet (muut kuin HTML5-gatewayt) ja mahdollistaa uuden lisäämisen, sen määrityksen muuttamisen (sertifikaatti, tallenteiden tallennuspolut, pairing) tai sen poistamisen. Tämä sivu on tarkoitettu järjestelmänvalvojalle tai integroijalle, joka hallinnoi Edge Gateway -kantaa, sen pairingia Mediation Controller -palvelimen kanssa sekä video- ja SSH-tallenteiden keräämistä.

Jotta Edge Gateway -palvelinta voi käyttää istunnossa, se on liitettävä vähintään yhteen [site-kohdeon](https://docs.cyberelements.io/bastion/4.6/fi/Usage/AdminConsoleReference/Sites/). Liittäminen site-kohdeon tehdään **Sites** -moduulissa, ei tässä.

> **Aiheeseen liittyvät ohjeet**
>
> - [Pairing-tokenin luominen Edge Gateway -palvelimelle](https://docs.cyberelements.io/bastion/4.6/fi/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/)
> - [Luo Edge Gateway](https://docs.cyberelements.io/bastion/4.6/fi/Usage/Configuration/AdminConsole/CreateEdgeGateway/)

---

## Edge Gateway -palvelinten luettelo

Moduuli avautuu sivutettuun taulukkoon määritellyistä Edge Gateway -palvelimista.

| Sarake | Kuvaus |
|---|---|
| **Name** | Edge Gateway -palvelimen nimi, jonka edessä on sen yhteystilaa kuvaava kuvake (verkossa, ei verkossa, odottaa pairingia). |
| **Description** | Luonnin yhteydessä kirjoitettu vapaa kuvaus. |
| **Sites** | Site-kohteet, joihin Edge Gateway -palvelin on liitetty. |
| **Type** | **With recording**, jos Edge Gateway -palvelin tukee istuntotallennusta, muuten **Basic**. |
| **Version** | Edge Gateway -palvelimen versio. Kun on olemassa sekä master- että backup-instanssi, kummankin versio näytetään kahdella rivillä. |

Työkalupalkissa käytettävissä olevat toiminnot:

| Toiminto | Kuvaus |
|---|---|
| **+** (Lisää) | Avaa **Add Gateway** -ikkunan. |
| **Edit** | Avaa **Edit Gateway** -ikkunan valitulle Edge Gateway -palvelimelle. Käynnistyy myös kaksoisnapsautuksella. |
| **×** (Poista) | Poistaa valitut Edge Gateway -palvelimet vahvistuksen jälkeen. Monivalinta on tuettu. |
| **Download recording certificate** | Lataa valitun Edge Gateway -palvelimen tallennuksen varmentajan sertifikaatin. Käytettävissä vain, jos Edge Gateway -palvelin on **verkossa**. |
| **Search** | Suodattaa nimen osamerkkijonon perusteella 700 ms viimeisen näppäinpainalluksen jälkeen (tai heti `Enter` -näppäimellä). |
| **Pagination** | 15, 25 tai 50 riviä sivulla. |

---

## Edge Gateway -palvelimen lisääminen

**+**-painike avaa **Add Gateway** -ikkunan.

### Yleiset tiedot

| Kenttä | Kuvaus |
|---|---|
| **Name** | Pakollinen, enintään 50 merkkiä. Sallitut merkit: aksentittomat kirjaimet, numerot, `é`, `è`, `à`, `ô`, `â`, sulkeet, välilyönti, `-`, `/`, `.` ja `_`. |
| **Description** | Vapaa teksti. |
| **FQDN** | Edge Gateway -palvelinta isännöivän koneen täydellinen nimi. Sen on vastattava Edge Gateway -palvelimen sertifikaatin CN-kenttää, muuten pairing evätään (katso osio [Virheilmoitukset tallennuksen yhteydessä](#error-messages-on-saving)). |
| **Archives** | Paikallinen polku, johon Edge Gateway -palvelin arkistoi RDP-videotallennukset. Esitäytetty arvolla `/var/lib/ipdiva/carerecord/archives`. |
| **Archives SSH** | Paikallinen polku, johon Edge Gateway -palvelin arkistoi SSH-tallennukset. Esitäytetty arvolla `/var/ipdiva/care/sshrecord`. |

Kolme kenttää **FQDN**, **Archives** ja **Archives SSH** koskevat vain tallennuksella varustettuja Edge Gateway -palvelimia: ne on piilotettu Edge Gateway -palvelimella, joka ei tue tallennusta.

### Paring Token

**Create a pairing token** -valintaruutu tuo näkyviin **Paring Token** -osion, joka on oletuksena piilotettu.

| Kenttä | Kuvaus |
|---|---|
| **SSL certificate** | Ladattava gateway-sertifikaatti. Pudotusvalikko määrittää odotetun muodon — `pkcs12` (oletus) tai `pem` — ja tiedostonvalitsin hyväksyy tämän jälkeen vain vastaavan tiedostopäätteen, `.p12` tai `.pem`. |
| **Certificate or private key password** | Edge Gateway -sertifikaatin salasanalause, jos sellainen on. |
| **Import a Careserver certificate** | Kun valittu, tuo näkyviin tallennuspalvelimen sertifikaatin: samat kolme elementtiä (muoto, tiedosto, salasana). |
| **Pairing key validity period** | Päivämäärä ja kellonaika, joiden jälkeen tokenia ei voi enää käyttää. Oletus: tänään + 7 päivää, muodossa `DD/MM/YYYY HH:MM`. |
| **IP authorized to use the token** | Julkinen IP-osoite, josta Edge Gateway -palvelin saa suorittaa pairingin. Kyseessä on osoite sellaisena kuin Mediation Controller -palvelin sen näkee: NAT:n takana anna julkinen osoite. |

> **Sertifikaatti avaa kaksi viimeistä kenttää**
>
> **Pairing key validity period** ja **IP authorized to use the token** pysyvät **passiivisina** niin kauan kuin kelvollista sertifikaattitiedostoa ei ole valittu. Tiedosto, jonka pääte ei vastaa valittua muotoa, jättää ne siis passiivisiksi — kunnes vaatimusten mukainen tiedosto on annettu.

**Validate**-painike tallentaa Edge Gateway -palvelimen. Jos tallennus tuottaa pairing-tokenin, avautuu **Paring Token** -ikkuna, joka näyttää avaimen ja ilmoittaa, että se on **käytettävä gateway-palvelimen asennuksessa**. Se suljetaan **Close**-painikkeella: avain on kopioitava ikkunasta.

---

## Edge Gateway -palvelimen muokkaaminen

Valitse Edge Gateway luettelosta ja napsauta **Properties**-kuvaketta (tai kaksoisnapsauta riviä). **Edit Gateway** -ikkuna on esitäytetty nykyisillä asetuksilla ja liitetyn sertifikaatin tiedoilla.

Kentät ovat samat kuin luonnissa, seuraavin säännöin:

- **Name** on edelleen muokattavissa;
- **FQDN**, **Archives** ja **Archives SSH** piilotetaan, jos Edge Gateway -palvelin ei tue tallennusta, ja ne ovat **käytöstä poistettuina** niin kauan kuin se ei ole verkossa;
- **Pairing key validity period** ja **IP authorized to use the token** voi muuttaa vain Edge Gateway -palvelimella, joka **odottaa pairingia**;
- Edge Gateway -palvelimella, joka odottaa pairingia, näkyy vain luettava **Authentication Token** -kenttä.

> **Arkistopolkujen muuttaminen**
>
> **Archives** - tai **Archives SSH** -polun muuttaminen tekee aiemmat tallennukset saavuttamattomiksi konsolista. Ennen muutoksen soveltamista pyydetään vahvistus, ja Edge Gateway -palvelimen puolella tapahtuvasta virheestä ilmoitetaan viestillä **An error occured during the update of storage paths.**

---

## Edge Gateway -palvelimen poistaminen

Valitse yksi tai useampi Edge Gateway -palvelin ja napsauta **×** -painiketta. Vahvistusta pyydetään. Monivalinta on tuettu.

| Ilmoitus | Aiheuttaja |
|---|---|
| **The following gateway is currently being used:** | Edge Gateway -palvelin on liitetty yhteen tai useampaan site-kohdeon. Se on irrotettava ennen poistamista. Kyseiset nimet seuraavat ilmoitusta, ja monikkomuoto on olemassa usean kohteen poistoa varten. |
| **Deletion failed for the following gateway:** | Poistaminen epäonnistui Edge Gateway -palvelimen puolella. Virheelliset nimet seuraavat ilmoitusta. |

---

## Virheilmoitukset tallennuksen yhteydessä

| Ilmoitus | Aiheuttaja |
|---|---|
| **This gateway already exists.** | Edge Gateway -palvelimella on jo tämä nimi. |
| **Invalid Name** | Palvelin hylkäsi lähetetyn nimen. |
| **The CN of the Edge Gateway certificate sent does not match the expected CN** | Edge Gateway -palvelimen sertifikaatissa ei ole odotettua CN-arvoa. Ilmoitus kertoo löydetyn ja odotetun CN-arvon. |
| **The CN of the Careserver certificate sent does not match the expected CN** | Sama tapaus tallennuspalvelimen sertifikaatille. |
| **Invalid certificate or private key password** | Annettu salalause ei avaa sertifikaattia. |
| **Unable to contact the pairing system, please check its configuration** | Pairing-palvelu ei vastannut. |
| **The given gateway is unreachable.** | Edge Gateway -palvelin ei vastaa; toimenpide keskeytetään. |
| **The gateway management service is unreachable** | Edge Gateway -palvelimia ohjaava palvelu ei vastannut. |
