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

# OTP Token Generators

Модулът **OTP Token Generators** декларира генераторите на **еднократни пароли**, предлагани на потребителите при удостоверяване. Всеки запис избира **OTP Type** — канала за доставка и доставчика — и попълва настройките за връзка със съответната услуга.

Тази страница е предназначена за администратор, който подготвя инфраструктурата за OTP на организацията. За да се използва действително даден маркер при влизане, той трябва след това да бъде свързан с [authentication domain](https://docs.cyberelements.io/bastion/4.6/bg/Usage/AdminConsoleReference/AuthenticationDomain/).

---

## Списък с OTP маркери

Модулът се отваря с таблица със страници на декларираните маркери.

| Колона | Описание |
|---|---|
| **Name** | Име на маркера, предшествано от иконата OTP. |
| **Type** | Тип OTP, избран при създаването. |
| **Description** | Свободно описание, въведено при създаването. |

Действия в лентата с инструменти:

| Действие | Описание |
|---|---|
| **+** (Add) | Отваря прозореца **Add OTP token**. |
| **Edit** | Отваря прозореца **Edit OTP token** за избрания маркер, също и при двукратно щракване. Активен при единичен избор. |
| **×** (Delete) | Изтрива избраните маркери след потвърждение. Поддържа се множествен избор. |
| **Search** | Филтрира по подниз. |
| **Pagination** | 15, 25 или 50 реда на страница. |

---

## Наличните 21 типа OTP

Списъкът **OTP Type**, чиято подсказка гласи *Choose an OTP manager*, предлага 21 записа. Етикетът им посочва канала, а след това доставчика: `SMTP` означава SMS, предаван на оператора **по имейл**, а `HTTP` или `HTTPS` — SMS, предаван **чрез уеб извикване**.

| OTP Type | Канал | Секция с настройки |
|---|---|---|
| **OTP - email** | Имейл | *Mail subject* |
| **TOTP (Google authenticator, FreeOTP, ...)** | Приложение за удостоверяване | вижте раздела **TOTP** |
| **OTP - Radius** | Сървър Radius | вижте раздела **Radius** |
| **OTP - SMS (SMTP: OVH)** | SMS по имейл | вижте раздела **SMS по имейл** |
| **OTP - SMS (SMTP: Orange)** | SMS по имейл | няма специфично поле |
| **OTP - SMS (SMTP: SFR)** | SMS по имейл | вижте раздела **SMS по имейл** |
| **OTP - SMS (SMTP: esendex)** | SMS по имейл | вижте раздела **SMS по имейл** |
| **OTP - SMS (SMTP: LeSMS)** | SMS по имейл | вижте раздела **SMS по имейл** |
| **OTP - SMS (SMTP: smsenvoi)** | SMS по имейл | вижте раздела **SMS по имейл** |
| **OTP - SMS (SMTP: Clever SMS)** | SMS по имейл | вижте раздела **SMS по имейл** |
| **OTP - SMS (HTTP: OVH)** | SMS чрез уеб извикване | вижте раздела **SMS чрез уеб извикване** |
| **OTP - SMS (HTTPS: Orange)** | SMS чрез уеб извикване | вижте раздела **SMS чрез уеб извикване** |
| **OTP - SMS (HTTPS: Orange Light CEO)** | SMS чрез уеб извикване | вижте раздела **SMS чрез уеб извикване** |
| **OTP - SMS (HTTPS: SFR)** | SMS чрез уеб извикване | вижте раздела **SMS чрез уеб извикване** |
| **OTP - SMS (HTTPS: esendex)** | SMS чрез уеб извикване | вижте раздела **SMS чрез уеб извикване** |
| **OTP - SMS (HTTP(s): smsenvoi)** | SMS чрез уеб извикване | вижте раздела **SMS чрез уеб извикване** |
| **OTP - SMS (HTTP: SmsBox)** | SMS чрез уеб извикване | вижте раздела **SMS чрез уеб извикване** |
| **OTP - SMS (HTTP: LeSMS)** | SMS чрез уеб извикване | вижте раздела **SMS чрез уеб извикване** |
| **OTP - SMS (HTTPS: CallR)** | SMS чрез уеб извикване | вижте раздела **SMS чрез уеб извикване** |
| **OTP - SMS (HTTP: envoyerSMS)** | SMS чрез уеб извикване | вижте раздела **SMS чрез уеб извикване** |
| **OTP - SMS (HTTPS: MiPih)** | SMS чрез уеб извикване | вижте раздела **SMS чрез уеб извикване** |

> **Типът определя кои секции се показват**
>
> Изборът на тип преустройва формуляра: появява се секцията на съответния доставчик, а другите изчезват. Останалото се определя от три правила:
>
> - **общият** блок (част [Общ блок](#generic-block)) се показва за **всички типове с изключение на TOTP и Radius**;
> - блокът **Authentication through a site** (част [Маршрутизиране през сайт](#routing-through-a-site)) се показва за типовете с **уеб извикване** и за **Radius**;
> - блокът за **доставка по имейл** (част [Доставка по имейл](#email-delivery)) се показва за типовете с **имейл** и за **TOTP**.

---

## Добавяне на OTP маркер

### Общи полета

| Поле | Описание |
|---|---|
| **OTP Type** | Задължително. Вижте частта [Наличните 21 типа OTP](#the-21-available-otp-types). **Не може да се променя след записване.** |
| **Name** | Задължително, най-много 50 знака. Разрешени знаци: букви без диакритични знаци, цифри, `é`, `è`, `à`, `ô`, `â`, скоби, интервал, `-`, `/`, `.` и `_`. |
| **Description** | Свободен текст. |

### Общ блок

Показва се за всички типове **с изключение на TOTP и Radius**, които генерират кода си по различен начин.

| Поле | Описание |
|---|---|
| **OTP usable characters** | Азбука, от която се генерира кодът. `abcdefghijklmnopqrstuvwxyz` по подразбиране, минимум 5 знака. |
| **OTP Length** | Брой знаци на кода. Минимум 4, по подразбиране 8. |
| **Validity period of a token (seconds)** | Минимум 15, по подразбиране 900. |
| **Number of sent authentication tokens** | Брояч само за четене. Бутонът **Reset** го нулира от страна на сървъра. |
| **Message before the OTP** | Текст, който предшества кода в съобщението. *Your password is:* по подразбиране. Полето съществува два пъти с един и същ етикет: едно за типовете с **имейл** и едно за всички останали; показва се само това, което съответства на избрания тип. |

### Маршрутизиране през сайт

| Поле | Описание |
|---|---|
| **Authentication through a site** | Отметнато по подразбиране. Извикванията към доставчика излизат от даден сайт. |
| *(списък със сайтове)* | Задължително, ако квадратчето за отметка е отметнато. |

### Доставка по имейл

| Поле | Описание |
|---|---|
| **SMTP sender** | Адрес на подателя, проверяван като имейл адрес. Това поле не се показва за типа **OTP - SMS (SMTP: smsenvoi)**. |
| **SMTP server** | Задължително. Сървър, деклариран в модула [SMTP servers](https://docs.cyberelements.io/bastion/4.6/bg/Usage/AdminConsoleReference/SmtpServers/). |

> **При TOTP тези две полета първоначално са неактивни**
>
> При типа **TOTP** полетата **SMTP sender** и **SMTP server** остават **деактивирани**, докато не бъде отметната опцията **Send generated keys by e-mail**. Следователно попълването им не е предварително изискване: именно тази опция ги отключва.

### Специфични за типа настройки

**TOTP**

> | Поле | Описание |
> |---|---|
> | **Expiration Time** | Срок на валидност на кода в секунди. 30 по подразбиране. |
> | **Number of digits** | Дължина на кода. Списъкът предлага само стойността **6**. |
> | **Key size (bits)** | **64**, **32** или **16**. 32 по подразбиране. |
> | **Read the secret key in a user attribute (LDAP domain)** | Тайният ключ се чете от атрибут на акаунта, вместо да бъде генериран. Отключва следващото поле. |
> | **User attribute containing the secret key** | Име на атрибута. `secretKey` по подразбиране. |
> | **Display a QR Code on the user portal** | Потребителят регистрира приложението си, като снима QR код. |
> | **Send generated keys by e-mail** | Ключът се изпраща по имейл. Отключва следващите две полета, както и частта [Доставка по имейл](#email-delivery). |
> | **Message before the OTP** | Текст на съобщението, с което се доставя ключът. |
> | **Mail subject** | Тема на това съобщение. |
>
> > **Едно изключване, а не три**
> >
> > Отметването на **Display a QR Code on the user portal** или **Send generated keys by e-mail** премахва отметката и **деактивира** четенето от потребителски атрибут — ключът не може едновременно да бъде наложен от директорията и генериран от платформата. **QR кодът и доставката по имейл обаче могат да се запазят заедно**: те са два начина за предаване на един и същ генериран ключ.

**Radius**

> Именно този тип заменя предишния маркер SecurID: конзолата вече го показва като **OTP - Radius**.
>
> | Поле | Описание |
> |---|---|
> | **Server** | Задължително. Основен сървър Radius. |
> | **Secondary server** | Резервен сървър. Незадължително. |
> | **Port** | Задължително. 1812 по подразбиране. |
> | **Timeout (seconds)** | Задължително. Време за изчакване на отговор. 10 по подразбиране. |
> | **Retries number** | Задължително. 2 по подразбиране. |
> | **Shared secret** | Задължително. Таен ключ, споделен със сървъра Radius. |
> | **Push mode** | Потребителят потвърждава влизането от приложението си, вместо да въвежда код. |
> | **NAS IP address** | Задължително, в строг формат IPv4. Адрес, деклариран от страна на сървъра Radius. |

**SMS по имейл**

> | Тип | Собствени полета |
> |---|---|
> | **OTP - SMS (SMTP: OVH)** | **SMS Account**, **SMS ID**, **Password**, **SMS sender** (с префикс `+33`), **SMS Class** (от 0 до 3, 1 по подразбиране). |
> | **OTP - SMS (SMTP: Orange)** | Няма собствено поле: прилагат се само общият блок и блокът за доставка по имейл. |
> | **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`, `STANDARD` по подразбиране, `PREMIUM`, `CONCATENE`), **Sender name (PREMIUM)**, **Get a response** (отметнато по подразбиране). |
> | **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**. ⓘ Последните две се изключват взаимно: отметването на номера в получателя отключва домейна и деактивира идентификатора на клиента. |

**SMS чрез уеб извикване**

> | Тип | Собствени полета |
> |---|---|
> | **OTP - SMS (HTTP: OVH)** | **Service Name**, **ID**, **Application Key**, **Application secret key**, **Consumption Key**, **Priority** (**Very low**, **Low**, **Normal** по подразбиране, **High**), **No stop clause** (отметнато по подразбиране), **OVH Account Sender**, **Phone Prefix** (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`, `STANDARD` по подразбиране, `PREMIUM`, `CONCATENE`), **Sender name (PREMIUM)**, **White label (optional)**, **Use SSL** (отметнато по подразбиране). |
> | **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**. |

Щракнете върху **Validate**, за да запишете.

---

## Редактиране на OTP маркер

Изберете маркер и щракнете върху иконата **Properties** или щракнете двукратно върху реда. Прозорецът **Edit OTP token** предлага същите полета, като **OTP Type** става **само за четене**: смяната на канала означава създаване на друг маркер.

---

## Изтриване на OTP маркер

Изберете един или няколко маркера и щракнете върху бутона **×**. Изисква се потвърждение. Поддържа се множествен избор.

> **Проверете домейните преди изтриване**
>
> Изтриването на маркер не отделя домейните за удостоверяване, които го използват. Първо проверете съответните конфигурации.
