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

# OTP Token Generators

Modul **OTP Token Generators** deklaruje generátory **jednorazových hesiel** ponúkané používateľom pri overovaní. Každá položka vyberá **OTP Type** – kanál doručenia a poskytovateľa – a vypĺňa nastavenia pripojenia k príslušnej službe.

Táto stránka je určená správcovi, ktorý pripravuje infraštruktúru OTP organizácie. Aby sa token pri prihlásení skutočne používal, musí byť následne priradený k [authentication domain](https://docs.cyberelements.io/bastion/4.6/sk/Usage/AdminConsoleReference/AuthenticationDomain/).

---

## Zoznam tokenov OTP

Modul sa otvorí so stránkovanou tabuľkou deklarovaných tokenov.

| Stĺpec | Popis |
|---|---|
| **Name** | Názov tokenu, pred ktorým je ikona OTP. |
| **Type** | Typ OTP vybraný pri vytváraní. |
| **Description** | Voľný popis zadaný pri vytvorení. |

Akcie na paneli s nástrojmi:

| Akcia | Popis |
|---|---|
| **+** (Add) | Otvorí okno **Add OTP token**. |
| **Edit** | Otvorí okno **Edit OTP token** pre vybraný token, a to aj dvojitým kliknutím. Dostupné pri výbere jednej položky. |
| **×** (Delete) | Po potvrdení odstráni vybrané tokeny. Podporuje sa viacnásobný výber. |
| **Search** | Filtruje podľa podreťazca. |
| **Pagination** | 15, 25 alebo 50 riadkov na stránku. |

---

## 21 dostupných typov OTP

Zoznam **OTP Type**, ktorého nápoveda znie *Choose an OTP manager*, ponúka 21 položiek. Ich označenie uvádza kanál a potom poskytovateľa: `SMTP` znamená SMS odovzdanú operátorovi **e-mailom**, `HTTP` alebo `HTTPS` SMS odovzdanú **webovým volaním**.

| OTP Type | Kanál | Oddiel nastavení |
|---|---|---|
| **OTP - email** | E-mail | *Mail subject* |
| **TOTP (Google authenticator, FreeOTP, ...)** | Overovacia aplikácia | pozrite kartu **TOTP** |
| **OTP - Radius** | Server Radius | pozrite kartu **Radius** |
| **OTP - SMS (SMTP: OVH)** | SMS e-mailom | pozrite kartu **SMS e-mailom** |
| **OTP - SMS (SMTP: Orange)** | SMS e-mailom | žiadne osobitné pole |
| **OTP - SMS (SMTP: SFR)** | SMS e-mailom | pozrite kartu **SMS e-mailom** |
| **OTP - SMS (SMTP: esendex)** | SMS e-mailom | pozrite kartu **SMS e-mailom** |
| **OTP - SMS (SMTP: LeSMS)** | SMS e-mailom | pozrite kartu **SMS e-mailom** |
| **OTP - SMS (SMTP: smsenvoi)** | SMS e-mailom | pozrite kartu **SMS e-mailom** |
| **OTP - SMS (SMTP: Clever SMS)** | SMS e-mailom | pozrite kartu **SMS e-mailom** |
| **OTP - SMS (HTTP: OVH)** | SMS webovým volaním | pozrite kartu **SMS webovým volaním** |
| **OTP - SMS (HTTPS: Orange)** | SMS webovým volaním | pozrite kartu **SMS webovým volaním** |
| **OTP - SMS (HTTPS: Orange Light CEO)** | SMS webovým volaním | pozrite kartu **SMS webovým volaním** |
| **OTP - SMS (HTTPS: SFR)** | SMS webovým volaním | pozrite kartu **SMS webovým volaním** |
| **OTP - SMS (HTTPS: esendex)** | SMS webovým volaním | pozrite kartu **SMS webovým volaním** |
| **OTP - SMS (HTTP(s): smsenvoi)** | SMS webovým volaním | pozrite kartu **SMS webovým volaním** |
| **OTP - SMS (HTTP: SmsBox)** | SMS webovým volaním | pozrite kartu **SMS webovým volaním** |
| **OTP - SMS (HTTP: LeSMS)** | SMS webovým volaním | pozrite kartu **SMS webovým volaním** |
| **OTP - SMS (HTTPS: CallR)** | SMS webovým volaním | pozrite kartu **SMS webovým volaním** |
| **OTP - SMS (HTTP: envoyerSMS)** | SMS webovým volaním | pozrite kartu **SMS webovým volaním** |
| **OTP - SMS (HTTPS: MiPih)** | SMS webovým volaním | pozrite kartu **SMS webovým volaním** |

> **Typ určuje, ktoré oddiely sa zobrazia**
>
> Výber typu prestaví formulár: zobrazí sa oddiel príslušného poskytovateľa a ostatné zmiznú. Zvyšok riadia tri pravidlá:
>
> - **všeobecný** blok (časť [Všeobecný blok](#generic-block)) sa zobrazuje pre **všetky typy okrem TOTP a Radius**;
> - blok **Authentication through a site** (časť [Smerovanie cez site](#routing-through-a-site)) sa zobrazuje pre typy s **webovým volaním** a pre **Radius**;
> - blok **doručenia e-mailom** (časť [Doručenie e-mailom](#email-delivery)) sa zobrazuje pre typy s **e-mailom** a pre **TOTP**.

---

## Pridanie tokenu OTP

### Spoločné polia

| Pole | Popis |
|---|---|
| **OTP Type** | Povinné. Pozrite časť [21 dostupných typov OTP](#the-21-available-otp-types). **Po uložení sa nedá zmeniť.** |
| **Name** | Povinné, najviac 50 znakov. Povolené znaky: písmená bez diakritiky, číslice, `é`, `è`, `à`, `ô`, `â`, zátvorky, medzera, `-`, `/`, `.` a `_`. |
| **Description** | Voľný text. |

### Všeobecný blok

Zobrazuje sa pre všetky typy **okrem TOTP a Radius**, ktoré generujú svoj kód inak.

| Pole | Popis |
|---|---|
| **OTP usable characters** | Abeceda, z ktorej sa náhodne vyberá kód. Predvolene `abcdefghijklmnopqrstuvwxyz`, minimálne 5 znakov. |
| **OTP Length** | Počet znakov kódu. Minimálne 4, predvolene 8. |
| **Validity period of a token (seconds)** | Minimálne 15, predvolene 900. |
| **Number of sent authentication tokens** | Počítadlo len na čítanie. Tlačidlo **Reset** ho vynuluje na strane servera. |
| **Message before the OTP** | Text, ktorý v správe predchádza kód. Predvolene *Your password is:*. Pole existuje dvakrát s rovnakým označením: jedno pre typy s **e-mailom**, druhé pre všetky ostatné; zobrazí sa len to, ktoré zodpovedá zvolenému typu. |

### Smerovanie cez site

| Pole | Popis |
|---|---|
| **Authentication through a site** | Predvolene začiarknuté. Volania poskytovateľa budú odchádzať z daného site. |
| *(zoznam site)* | Povinné, ak je začiarkavacie políčko začiarknuté. |

### Doručenie e-mailom

| Pole | Popis |
|---|---|
| **SMTP sender** | Adresa odosielateľa, kontrolovaná ako e-mailová adresa. Toto pole sa pri type **OTP - SMS (SMTP: smsenvoi)** nezobrazuje. |
| **SMTP server** | Povinné. Server deklarovaný v module [SMTP servers](https://docs.cyberelements.io/bastion/4.6/sk/Usage/AdminConsoleReference/SmtpServers/). |

> **Pri TOTP sú tieto dve polia najprv neaktívne**
>
> Pri type **TOTP** zostávajú polia **SMTP sender** a **SMTP server** **zakázané**, kým sa nezačiarkne možnosť **Send generated keys by e-mail**. Ich vyplnenie preto nie je predpokladom: odomkne ich práve táto možnosť.

### Nastavenia špecifické pre typ

**TOTP**

> | Pole | Popis |
> |---|---|
> | **Expiration Time** | Doba platnosti kódu v sekundách. Predvolene 30. |
> | **Number of digits** | Dĺžka kódu. Zoznam ponúka iba hodnotu **6**. |
> | **Key size (bits)** | **64**, **32** alebo **16**. Predvolene 32. |
> | **Read the secret key in a user attribute (LDAP domain)** | Tajný kľúč sa namiesto generovania načíta z atribútu účtu. Odomkne nasledujúce pole. |
> | **User attribute containing the secret key** | Názov atribútu. Predvolene `secretKey`. |
> | **Display a QR Code on the user portal** | Používateľ zaregistruje svoju aplikáciu odfotografovaním QR kódu. |
> | **Send generated keys by e-mail** | Kľúč sa odošle e-mailom. Odomkne dve nasledujúce polia, ako aj časť [Doručenie e-mailom](#email-delivery). |
> | **Message before the OTP** | Text správy, ktorou sa doručuje kľúč. |
> | **Mail subject** | Predmet tejto správy. |
>
> > **Jedno vylúčenie, nie tri**
> >
> > Začiarknutie možnosti **Display a QR Code on the user portal** alebo **Send generated keys by e-mail** zruší začiarknutie a **zakáže** načítanie z atribútu používateľa – kľúč nemôže byť zároveň vnútený adresárom a vygenerovaný platformou. **QR kód a doručenie e-mailom však možno ponechať spolu**: sú to dva spôsoby odovzdania toho istého vygenerovaného kľúča.

**Radius**

> Tento typ nahrádza bývalý token SecurID: konzola ho teraz zobrazuje ako **OTP - Radius**.
>
> | Pole | Popis |
> |---|---|
> | **Server** | Povinné. Hlavný server Radius. |
> | **Secondary server** | Záložný server. Voliteľné. |
> | **Port** | Povinné. Predvolene 1812. |
> | **Timeout (seconds)** | Povinné. Čas čakania na odpoveď. Predvolene 10. |
> | **Retries number** | Povinné. Predvolene 2. |
> | **Shared secret** | Povinné. Tajný kľúč zdieľaný so serverom Radius. |
> | **Push mode** | Používateľ namiesto zadania kódu potvrdí prihlásenie vo svojej aplikácii. |
> | **NAS IP address** | Povinné, v striktnom formáte IPv4. Adresa deklarovaná na strane servera Radius. |

**SMS e-mailom**

> | Typ | Vlastné polia |
> |---|---|
> | **OTP - SMS (SMTP: OVH)** | **SMS Account**, **SMS ID**, **Password**, **SMS sender** (s predponou `+33`), **SMS Class** (0 až 3, predvolene 1). |
> | **OTP - SMS (SMTP: Orange)** | Žiadne vlastné pole: platí len všeobecný blok a blok doručenia e-mailom. |
> | **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`, predvolene `STANDARD`, `PREMIUM`, `CONCATENE`), **Sender name (PREMIUM)**, **Get a response** (predvolene začiarknuté). |
> | **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**. ⓘ Posledné dve sa navzájom vylučujú: začiarknutie čísla v príjemcovi odomkne doménu a zakáže ID klienta. |

**SMS webovým volaním**

> | Typ | Vlastné polia |
> |---|---|
> | **OTP - SMS (HTTP: OVH)** | **Service Name**, **ID**, **Application Key**, **Application secret key**, **Consumption Key**, **Priority** (**Very low**, **Low**, predvolene **Normal**, **High**), **No stop clause** (predvolene začiarknuté), **OVH Account Sender**, **Phone Prefix** (predvolene 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`, predvolene `STANDARD`, `PREMIUM`, `CONCATENE`), **Sender name (PREMIUM)**, **White label (optional)**, **Use SSL** (predvolene začiarknuté). |
> | **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**. |

Uložte kliknutím na **Validate**.

---

## Úprava tokenu OTP

Vyberte token a kliknite na ikonu **Properties** alebo dvakrát kliknite na riadok. Okno **Edit OTP token** ponúka rovnaké polia, pričom **OTP Type** je **len na čítanie**: zmena kanála znamená vytvorenie iného tokenu.

---

## Odstránenie tokenu OTP

Vyberte jeden alebo viac tokenov a kliknite na tlačidlo **×**. Vyžaduje sa potvrdenie. Podporuje sa viacnásobný výber.

> **Pred odstránením skontrolujte domény**
>
> Odstránenie tokenu neodpojí domény overovania, ktoré ho používajú. Najprv skontrolujte príslušné konfigurácie.
