> Source: https://docs.cyberelements.io/bastion/4.6/sl/Usage/AdminConsoleReference/OtpTokenGenerators/

# OTP Token Generators

Modul **OTP Token Generators** opredeljuje generatorje **enkratnih gesel**, ki so uporabnikom na voljo pri preverjanju pristnosti. Vsak vnos izbere **OTP Type** — kanal dostave in ponudnika — in izpolni nastavitve povezave z ustrezno storitvijo.

Ta stran je namenjena skrbniku, ki pripravlja infrastrukturo OTP organizacije. Da bi se token dejansko uporabljal pri prijavi, ga je treba nato povezati z [authentication domain](https://docs.cyberelements.io/bastion/4.6/sl/Usage/AdminConsoleReference/AuthenticationDomain/).

---

## Seznam tokenov OTP

Modul se odpre s tabelo opredeljenih tokenov, razdeljeno na strani.

| Stolpec | Opis |
|---|---|
| **Name** | Ime tokena, pred katerim je ikona OTP. |
| **Type** | Vrsta OTP, izbrana ob ustvarjanju. |
| **Description** | Prosti opis, vnesen ob ustvarjanju. |

Dejanja v orodni vrstici:

| Dejanje | Opis |
|---|---|
| **+** (Add) | Odpre okno **Add OTP token**. |
| **Edit** | Odpre okno **Edit OTP token** za izbrani token, tudi z dvoklikom. Omogočeno, ko je izbran en sam token. |
| **×** (Delete) | Po potrditvi izbriše izbrane tokene. Podprta je večkratna izbira. |
| **Search** | Filtrira po podnizu. |
| **Pagination** | 15, 25 ali 50 vrstic na stran. |

---

## 21 razpoložljivih vrst OTP

Seznam **OTP Type**, katerega namig se glasi *Choose an OTP manager*, ponuja 21 vnosov. Njihovo ime navaja kanal in nato ponudnika: `SMTP` pomeni SMS, ki se operaterju preda **po e-pošti**, `HTTP` ali `HTTPS` pa SMS, ki se preda **s spletnim klicem**.

| OTP Type | Kanal | Razdelek nastavitev |
|---|---|---|
| **OTP - email** | E-pošta | *Mail subject* |
| **TOTP (Google authenticator, FreeOTP, ...)** | Aplikacija za preverjanje pristnosti | glejte zavihek **TOTP** |
| **OTP - Radius** | Strežnik Radius | glejte zavihek **Radius** |
| **OTP - SMS (SMTP: OVH)** | SMS po e-pošti | glejte zavihek **SMS po e-pošti** |
| **OTP - SMS (SMTP: Orange)** | SMS po e-pošti | ni posebnega polja |
| **OTP - SMS (SMTP: SFR)** | SMS po e-pošti | glejte zavihek **SMS po e-pošti** |
| **OTP - SMS (SMTP: esendex)** | SMS po e-pošti | glejte zavihek **SMS po e-pošti** |
| **OTP - SMS (SMTP: LeSMS)** | SMS po e-pošti | glejte zavihek **SMS po e-pošti** |
| **OTP - SMS (SMTP: smsenvoi)** | SMS po e-pošti | glejte zavihek **SMS po e-pošti** |
| **OTP - SMS (SMTP: Clever SMS)** | SMS po e-pošti | glejte zavihek **SMS po e-pošti** |
| **OTP - SMS (HTTP: OVH)** | SMS s spletnim klicem | glejte zavihek **SMS s spletnim klicem** |
| **OTP - SMS (HTTPS: Orange)** | SMS s spletnim klicem | glejte zavihek **SMS s spletnim klicem** |
| **OTP - SMS (HTTPS: Orange Light CEO)** | SMS s spletnim klicem | glejte zavihek **SMS s spletnim klicem** |
| **OTP - SMS (HTTPS: SFR)** | SMS s spletnim klicem | glejte zavihek **SMS s spletnim klicem** |
| **OTP - SMS (HTTPS: esendex)** | SMS s spletnim klicem | glejte zavihek **SMS s spletnim klicem** |
| **OTP - SMS (HTTP(s): smsenvoi)** | SMS s spletnim klicem | glejte zavihek **SMS s spletnim klicem** |
| **OTP - SMS (HTTP: SmsBox)** | SMS s spletnim klicem | glejte zavihek **SMS s spletnim klicem** |
| **OTP - SMS (HTTP: LeSMS)** | SMS s spletnim klicem | glejte zavihek **SMS s spletnim klicem** |
| **OTP - SMS (HTTPS: CallR)** | SMS s spletnim klicem | glejte zavihek **SMS s spletnim klicem** |
| **OTP - SMS (HTTP: envoyerSMS)** | SMS s spletnim klicem | glejte zavihek **SMS s spletnim klicem** |
| **OTP - SMS (HTTPS: MiPih)** | SMS s spletnim klicem | glejte zavihek **SMS s spletnim klicem** |

> **Vrsta določa, kateri razdelki se prikažejo**
>
> Izbira vrste preoblikuje obrazec: prikaže se razdelek izbranega ponudnika, drugi pa izginejo. Za vse ostalo veljajo tri pravila:
>
> - **splošni** blok (poglavje [Splošni blok](#generic-block)) se prikaže za **vse vrste razen TOTP in Radius**;
> - blok **Authentication through a site** (poglavje [Usmerjanje prek site](#routing-through-a-site)) se prikaže za vrste s **spletnim klicem** in za **Radius**;
> - blok **dostave po e-pošti** (poglavje [Dostava po e-pošti](#email-delivery)) se prikaže za vrste z **e-pošto** in za **TOTP**.

---

## Dodajanje tokena OTP

### Skupna polja

| Polje | Opis |
|---|---|
| **OTP Type** | Obvezno. Glejte poglavje [21 razpoložljivih vrst OTP](#the-21-available-otp-types). **Po shranjevanju ga ni več mogoče spremeniti.** |
| **Name** | Obvezno, največ 50 znakov. Dovoljeni znaki: črke brez naglasov, števke, `é`, `è`, `à`, `ô`, `â`, oklepaji, presledek, `-`, `/`, `.` in `_`. |
| **Description** | Prosto besedilo. |

### Splošni blok

Prikaže se za vse vrste **razen TOTP in Radius**, ki kodo ustvarita drugače.

| Polje | Opis |
|---|---|
| **OTP usable characters** | Abeceda, iz katere se naključno izbere koda. Privzeto `abcdefghijklmnopqrstuvwxyz`, najmanj 5 znakov. |
| **OTP Length** | Število znakov kode. Najmanj 4, privzeto 8. |
| **Validity period of a token (seconds)** | Najmanj 15, privzeto 900. |
| **Number of sent authentication tokens** | Števec samo za branje. Gumb **Reset** ga na strani strežnika ponastavi na nič. |
| **Message before the OTP** | Besedilo pred kodo v sporočilu. Privzeto *Your password is:*. Polje obstaja dvakrat z istim napisom: eno za vrste z **e-pošto**, drugo za vse ostale; prikaže se le tisto, ki ustreza izbrani vrsti. |

### Usmerjanje prek site

| Polje | Opis |
|---|---|
| **Authentication through a site** | Privzeto označeno. Klici ponudniku tako izhajajo iz določenega site. |
| *(seznam site)* | Obvezno, če je potrditveno polje označeno. |

### Dostava po e-pošti

| Polje | Opis |
|---|---|
| **SMTP sender** | Naslov pošiljatelja, preverjen kot e-poštni naslov. To polje se ne prikaže za vrsto **OTP - SMS (SMTP: smsenvoi)**. |
| **SMTP server** | Obvezno. Strežnik, opredeljen v modulu [SMTP servers](https://docs.cyberelements.io/bastion/4.6/sl/Usage/AdminConsoleReference/SmtpServers/). |

> **Pri vrsti TOTP sta ti dve polji sprva neaktivni**
>
> Pri vrsti **TOTP** ostaneta polji **SMTP sender** in **SMTP server** **onemogočeni**, dokler ni označena možnost **Send generated keys by e-mail**. Njuna izpolnitev torej ni predpogoj: odklene ju šele ta možnost.

### Nastavitve, specifične za vrsto

**TOTP**

> | Polje | Opis |
> |---|---|
> | **Expiration Time** | Obdobje veljavnosti kode v sekundah. Privzeto 30. |
> | **Number of digits** | Dolžina kode. Seznam ponuja le vrednost **6**. |
> | **Key size (bits)** | **64**, **32** ali **16**. Privzeto 32. |
> | **Read the secret key in a user attribute (LDAP domain)** | Skrivni ključ se prebere iz atributa računa, namesto da bi bil ustvarjen. Odklene naslednje polje. |
> | **User attribute containing the secret key** | Ime atributa. Privzeto `secretKey`. |
> | **Display a QR Code on the user portal** | Uporabnik svojo aplikacijo registrira tako, da fotografira kodo QR. |
> | **Send generated keys by e-mail** | Ključ se pošlje po e-pošti. Odklene naslednji dve polji ter poglavje [Dostava po e-pošti](#email-delivery). |
> | **Message before the OTP** | Besedilo sporočila, s katerim se dostavi ključ. |
> | **Mail subject** | Zadeva tega sporočila. |
>
> > **Ena izključitev, ne tri**
> >
> > Če označite **Display a QR Code on the user portal** ali **Send generated keys by e-mail**, se branje iz atributa uporabnika odznači in **onemogoči** — ključa ni mogoče hkrati vsiliti iz imenika in ustvariti na platformi. **Kodo QR in dostavo po e-pošti pa je mogoče ohraniti skupaj**: to sta dva načina predaje istega ustvarjenega ključa.

**Radius**

> Ta vrsta nadomešča nekdanji token SecurID: konzola jo zdaj prikazuje kot **OTP - Radius**.
>
> | Polje | Opis |
> |---|---|
> | **Server** | Obvezno. Glavni strežnik Radius. |
> | **Secondary server** | Rezervni strežnik. Izbirno. |
> | **Port** | Obvezno. Privzeto 1812. |
> | **Timeout (seconds)** | Obvezno. Čas čakanja na odgovor. Privzeto 10. |
> | **Retries number** | Obvezno. Privzeto 2. |
> | **Shared secret** | Obvezno. Skrivnost, skupna s strežnikom Radius. |
> | **Push mode** | Uporabnik prijavo potrdi v svoji aplikaciji, namesto da bi vnesel kodo. |
> | **NAS IP address** | Obvezno, v strogi obliki IPv4. Naslov, opredeljen na strani strežnika Radius. |

**SMS po e-pošti**

> | Vrsta | Lastna polja |
> |---|---|
> | **OTP - SMS (SMTP: OVH)** | **SMS Account**, **SMS ID**, **Password**, **SMS sender** (s predpono `+33`), **SMS Class** (od 0 do 3, privzeto 1). |
> | **OTP - SMS (SMTP: Orange)** | Brez lastnih polj: veljata le splošni blok in blok dostave po e-pošti. |
> | **OTP - SMS (SMTP: SFR)** | **Destination email address**, **Service ID**, **Space ID**, **Broadcast name**, **Script ID**, **Call schedule ID**, **Maximum number of simultaneous contacts**, **Priority**, **Customized ID**, **Multimedia type**. |
> | **OTP - SMS (SMTP: esendex)** | **Account ID**, **Account Password**, **Account Reference**. |
> | **OTP - SMS (SMTP: LeSMS)** | **Password**. |
> | **OTP - SMS (SMTP: smsenvoi)** | **Account ID**, **API Key**, **SMS Type** (`LOWCOST`, privzeto `STANDARD`, `PREMIUM`, `CONCATENE`), **Sender name (PREMIUM)**, **Get a response** (privzeto označeno). |
> | **OTP - SMS (SMTP: Clever SMS)** | **Start TLS**, **Put the number in the recipient of the email**, **Client ID**, **Modify the domain in the email recipient**. ⓘ Zadnji dve polji se medsebojno izključujeta: označitev številke v prejemniku odklene domeno in onemogoči ID odjemalca. |

**SMS s spletnim klicem**

> | Vrsta | Lastna polja |
> |---|---|
> | **OTP - SMS (HTTP: OVH)** | **Service Name**, **ID**, **Application Key**, **Application secret key**, **Consumption Key**, **Priority** (**Very low**, **Low**, privzeto **Normal**, **High**), **No stop clause** (privzeto označeno), **OVH Account Sender**, **Phone Prefix** (privzeto 33). |
> | **OTP - SMS (HTTPS: Orange)** | **ID client**, **ID**, **Account Password**. |
> | **OTP - SMS (HTTPS: Orange Light CEO)** | **Authentication Token**, **From**, **Label of diffusion**, **Allow the usage of special characters**. |
> | **OTP - SMS (HTTPS: SFR)** | **Service ID**, **Service Password**, **Space ID**. |
> | **OTP - SMS (HTTPS: esendex)** | **Account Reference**, **ID**, **Password**. |
> | **OTP - SMS (HTTP(s): smsenvoi)** | **Account ID**, **API Key**, **SMS Type** (`LOWCOST`, privzeto `STANDARD`, `PREMIUM`, `CONCATENE`), **Sender name (PREMIUM)**, **White label (optional)**, **Use SSL** (privzeto označeno). |
> | **OTP - SMS (HTTP: SmsBox)** | **ID**, **Password**. |
> | **OTP - SMS (HTTP: LeSMS)** | **ID**, **Password**. |
> | **OTP - SMS (HTTPS: CallR)** | **ID**, **Password**, **Flash Message**, **Sender**. |
> | **OTP - SMS (HTTP: envoyerSMS)** | **API Key**. |
> | **OTP - SMS (HTTPS: MiPih)** | **Establishment ID**, **Application code**, **Function code**. |

Kliknite **Validate**, da shranite.

---

## Urejanje tokena OTP

Izberite token in kliknite ikono **Properties** ali dvokliknite vrstico. Okno **Edit OTP token** ponuja ista polja, pri čemer je **OTP Type** zdaj **samo za branje**: za spremembo kanala morate ustvariti nov token.

---

## Brisanje tokena OTP

Izberite enega ali več tokenov in kliknite gumb **×**. Zahtevana je potrditev. Podprta je večkratna izbira.

> **Pred brisanjem preverite domene**
>
> Brisanje tokena ne odklopi domen za preverjanje pristnosti, ki ga uporabljajo. Najprej preverite ustrezne konfiguracije.
