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

# OTP Token Generators

Modul **OTP Token Generators** deklaruje generátory **jednorázových hesel** nabízené uživatelům při ověřování. Každá položka vybírá **OTP Type** — kanál doručení a poskytovatele — a vyplňuje nastavení připojení k odpovídající službě.

Tato stránka je určena správci, který připravuje infrastrukturu OTP organizace. Aby se token skutečně používal při přihlášení, je ho pak nutné přidružit k [authentication domain](https://docs.cyberelements.io/bastion/4.6/cs/Usage/AdminConsoleReference/AuthenticationDomain/).

---

## Seznam tokenů OTP

Modul se otevře stránkovanou tabulkou deklarovaných tokenů.

| Sloupec | Popis |
|---|---|
| **Name** | Název tokenu, před nímž je zobrazena ikona OTP. |
| **Type** | Typ OTP zvolený při vytvoření. |
| **Description** | Volný popis zadaný při vytvoření. |

Akce na panelu nástrojů:

| Akce | Popis |
|---|---|
| **+** (Add) | Otevře okno **Add OTP token**. |
| **Edit** | Otevře okno **Edit OTP token** pro vybraný token, také po dvojím kliknutí. Aktivní při výběru jedné položky. |
| **×** (Delete) | Po potvrzení odstraní vybrané tokeny. Vícenásobný výběr je podporován. |
| **Search** | Filtruje podle podřetězce. |
| **Pagination** | 15, 25 nebo 50 řádků na stránku. |

---

## 21 dostupných typů OTP

Seznam **OTP Type**, jehož nápověda zní *Choose an OTP manager*, nabízí 21 položek. Jejich popisek uvádí kanál a poté poskytovatele: `SMTP` znamená SMS předanou operátorovi **e-mailem**, `HTTP` nebo `HTTPS` SMS předanou **webovým voláním**.

| OTP Type | Kanál | Sekce nastavení |
|---|---|---|
| **OTP - email** | E-mail | *Mail subject* |
| **TOTP (Google authenticator, FreeOTP, ...)** | Ověřovací aplikace | viz karta **TOTP** |
| **OTP - Radius** | Server Radius | viz karta **Radius** |
| **OTP - SMS (SMTP: OVH)** | SMS e-mailem | viz karta **SMS e-mailem** |
| **OTP - SMS (SMTP: Orange)** | SMS e-mailem | žádné specifické pole |
| **OTP - SMS (SMTP: SFR)** | SMS e-mailem | viz karta **SMS e-mailem** |
| **OTP - SMS (SMTP: esendex)** | SMS e-mailem | viz karta **SMS e-mailem** |
| **OTP - SMS (SMTP: LeSMS)** | SMS e-mailem | viz karta **SMS e-mailem** |
| **OTP - SMS (SMTP: smsenvoi)** | SMS e-mailem | viz karta **SMS e-mailem** |
| **OTP - SMS (SMTP: Clever SMS)** | SMS e-mailem | viz karta **SMS e-mailem** |
| **OTP - SMS (HTTP: OVH)** | SMS webovým voláním | viz karta **SMS webovým voláním** |
| **OTP - SMS (HTTPS: Orange)** | SMS webovým voláním | viz karta **SMS webovým voláním** |
| **OTP - SMS (HTTPS: Orange Light CEO)** | SMS webovým voláním | viz karta **SMS webovým voláním** |
| **OTP - SMS (HTTPS: SFR)** | SMS webovým voláním | viz karta **SMS webovým voláním** |
| **OTP - SMS (HTTPS: esendex)** | SMS webovým voláním | viz karta **SMS webovým voláním** |
| **OTP - SMS (HTTP(s): smsenvoi)** | SMS webovým voláním | viz karta **SMS webovým voláním** |
| **OTP - SMS (HTTP: SmsBox)** | SMS webovým voláním | viz karta **SMS webovým voláním** |
| **OTP - SMS (HTTP: LeSMS)** | SMS webovým voláním | viz karta **SMS webovým voláním** |
| **OTP - SMS (HTTPS: CallR)** | SMS webovým voláním | viz karta **SMS webovým voláním** |
| **OTP - SMS (HTTP: envoyerSMS)** | SMS webovým voláním | viz karta **SMS webovým voláním** |
| **OTP - SMS (HTTPS: MiPih)** | SMS webovým voláním | viz karta **SMS webovým voláním** |

> **Typ určuje, které sekce se zobrazí**
>
> Výběr typu přestaví formulář: zobrazí se sekce příslušného poskytovatele a ostatní zmizí. Zbytek se řídí třemi pravidly:
>
> - **obecný** blok (sekce [Obecný blok](#generic-block)) se zobrazuje u **všech typů kromě TOTP a Radius**;
> - blok **Authentication through a site** (sekce [Směrování přes site](#routing-through-a-site)) se zobrazuje u typů s **webovým voláním** a u **Radius**;
> - blok **doručení e-mailem** (sekce [Doručení e-mailem](#email-delivery)) se zobrazuje u typů s **e-mailem** a u **TOTP**.

---

## Přidání tokenu OTP

### Společná pole

| Pole | Popis |
|---|---|
| **OTP Type** | Povinné. Viz sekce [21 dostupných typů OTP](#the-21-available-otp-types). **Po uložení ho nelze změnit.** |
| **Name** | Povinné, nejvýše 50 znaků. Povolené znaky: písmena bez diakritiky, číslice, `é`, `è`, `à`, `ô`, `â`, závorky, mezera, `-`, `/`, `.` a `_`. |
| **Description** | Volný text. |

### Obecný blok

Zobrazuje se u všech typů **kromě TOTP a Radius**, které svůj kód vytvářejí jinak.

| Pole | Popis |
|---|---|
| **OTP usable characters** | Abeceda, ze které se kód losuje. Ve výchozím nastavení `abcdefghijklmnopqrstuvwxyz`, minimálně 5 znaků. |
| **OTP Length** | Počet znaků kódu. Minimálně 4, výchozí hodnota 8. |
| **Validity period of a token (seconds)** | Minimálně 15, výchozí hodnota 900. |
| **Number of sent authentication tokens** | Čítač pouze pro čtení. Tlačítko **Reset** jej vynuluje na straně serveru. |
| **Message before the OTP** | Text, který ve zprávě předchází kódu. Ve výchozím nastavení *Your password is:*. Pole existuje dvakrát se stejným popiskem: jednou pro typy s **e-mailem**, jednou pro všechny ostatní; zobrazí se jen to, které odpovídá zvolenému typu. |

### Směrování přes site

| Pole | Popis |
|---|---|
| **Authentication through a site** | Ve výchozím nastavení zaškrtnuto. Volání k poskytovateli pak odcházejí z daného site. |
| *(seznam site)* | Povinné, pokud je zaškrtávací políčko zaškrtnuto. |

### Doručení e-mailem

| Pole | Popis |
|---|---|
| **SMTP sender** | Adresa odesílatele, ověřovaná jako e-mailová adresa. Toto pole se nezobrazuje u typu **OTP - SMS (SMTP: smsenvoi)**. |
| **SMTP server** | Povinné. Server deklarovaný v modulu [SMTP servers](https://docs.cyberelements.io/bastion/4.6/cs/Usage/AdminConsoleReference/SmtpServers/). |

> **U TOTP jsou tato dvě pole zpočátku neaktivní**
>
> U typu **TOTP** zůstávají pole **SMTP sender** a **SMTP server** **zakázaná**, dokud není zaškrtnuta možnost **Send generated keys by e-mail**. Jejich vyplnění tedy není předpokladem: odemyká je právě tato možnost.

### Nastavení specifická pro typ

**TOTP**

> | Pole | Popis |
> |---|---|
> | **Expiration Time** | Doba platnosti kódu v sekundách. Ve výchozím nastavení 30. |
> | **Number of digits** | Délka kódu. Seznam nabízí pouze hodnotu **6**. |
> | **Key size (bits)** | **64**, **32** nebo **16**. Ve výchozím nastavení 32. |
> | **Read the secret key in a user attribute (LDAP domain)** | Tajný klíč se místo generování načte z atributu účtu. Odemkne následující pole. |
> | **User attribute containing the secret key** | Název atributu. Ve výchozím nastavení `secretKey`. |
> | **Display a QR Code on the user portal** | Uživatel zaregistruje svou aplikaci vyfotografováním QR kódu. |
> | **Send generated keys by e-mail** | Klíč se odešle e-mailem. Odemkne dvě následující pole a také sekci [Doručení e-mailem](#email-delivery). |
> | **Message before the OTP** | Text zprávy, kterou se klíč doručuje. |
> | **Mail subject** | Předmět této zprávy. |
>
> > **Jedno vyloučení, ne tři**
> >
> > Zaškrtnutím možnosti **Display a QR Code on the user portal** nebo **Send generated keys by e-mail** se zruší zaškrtnutí čtení z atributu uživatele a toto čtení se **zakáže** — klíč nemůže být zároveň určen adresářem a vygenerován platformou. **QR kód a doručení e-mailem však lze ponechat současně**: jde o dva způsoby předání téhož vygenerovaného klíče.

**Radius**

> Tento typ nahrazuje dřívější token SecurID: konzola jej nyní zobrazuje jako **OTP - Radius**.
>
> | Pole | Popis |
> |---|---|
> | **Server** | Povinné. Hlavní server Radius. |
> | **Secondary server** | Záložní server. Volitelné. |
> | **Port** | Povinné. Ve výchozím nastavení 1812. |
> | **Timeout (seconds)** | Povinné. Doba čekání na odpověď. Ve výchozím nastavení 10. |
> | **Retries number** | Povinné. Ve výchozím nastavení 2. |
> | **Shared secret** | Povinné. Tajný klíč sdílený se serverem Radius. |
> | **Push mode** | Uživatel potvrdí přihlášení ve své aplikaci, místo aby zadával kód. |
> | **NAS IP address** | Povinné, v přísném formátu IPv4. Adresa deklarovaná na straně serveru Radius. |

**SMS e-mailem**

> | Typ | Vlastní pole |
> |---|---|
> | **OTP - SMS (SMTP: OVH)** | **SMS Account**, **SMS ID**, **Password**, **SMS sender** (s předponou `+33`), **SMS Class** (0 až 3, ve výchozím nastavení 1). |
> | **OTP - SMS (SMTP: Orange)** | Žádné vlastní pole: platí pouze obecný blok a blok doručení e-mailem. |
> | **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`, výchozí `STANDARD`, `PREMIUM`, `CONCATENE`), **Sender name (PREMIUM)**, **Get a response** (ve výchozím nastavení zaškrtnuto). |
> | **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í dvě možnosti se vzájemně vylučují: zaškrtnutí čísla v příjemci odemkne doménu a zakáže ID klienta. |

**SMS webovým voláním**

> | Typ | Vlastní pole |
> |---|---|
> | **OTP - SMS (HTTP: OVH)** | **Service Name**, **ID**, **Application Key**, **Application secret key**, **Consumption Key**, **Priority** (**Very low**, **Low**, výchozí **Normal**, **High**), **No stop clause** (ve výchozím nastavení zaškrtnuto), **OVH Account Sender**, **Phone Prefix** (ve výchozím nastavení 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`, výchozí `STANDARD`, `PREMIUM`, `CONCATENE`), **Sender name (PREMIUM)**, **White label (optional)**, **Use SSL** (ve výchozím nastavení zaškrtnuto). |
> | **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**. |

Kliknutím na **Validate** uložte.

---

## Úprava tokenu OTP

Vyberte token a klikněte na ikonu **Properties** nebo na řádek dvakrát klikněte. Okno **Edit OTP token** nabízí stejná pole, přičemž **OTP Type** je **pouze pro čtení**: změna kanálu znamená vytvoření jiného tokenu.

---

## Odstranění tokenu OTP

Vyberte jeden nebo více tokenů a klikněte na tlačítko **×**. Vyžaduje se potvrzení. Vícenásobný výběr je podporován.

> **Před odstraněním zkontrolujte domény**
>
> Odstranění tokenu neodpojí domény ověřování, které ho používají. Nejprve zkontrolujte odpovídající konfigurace.
