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

# OTP Token Generators

Moodulis **OTP Token Generators** deklareeritakse **ühekordse parooli** generaatorid, mida kasutajatele autentimisel pakutakse. Iga kirje puhul valitakse **OTP Type** — edastuskanal ja pakkuja — ning täidetakse vastava teenuse ühendussätted.

See leht on mõeldud administraatorile, kes valmistab ette organisatsiooni OTP-taristut. Et tokenit sisselogimisel tegelikult kasutataks, tuleb see seejärel siduda [authentication domain](https://docs.cyberelements.io/bastion/4.6/et/Usage/AdminConsoleReference/AuthenticationDomain/) domeeniga.

---

## OTP-tokenite loend

Moodul avaneb deklareeritud tokenite lehekülgedeks jaotatud tabeliga.

| Veerg | Kirjeldus |
|---|---|
| **Name** | Tokeni nimi, mille ees on OTP-ikoon. |
| **Type** | Loomisel valitud OTP-tüüp. |
| **Description** | Loomisel sisestatud vaba kirjeldus. |

Tööriistariba toimingud:

| Toiming | Kirjeldus |
|---|---|
| **+** (Lisa) | Avab akna **Add OTP token**. |
| **Edit** | Avab valitud tokeni jaoks akna **Edit OTP token**, ka topeltklõpsuga. Saadaval, kui on valitud üks kirje. |
| **×** (Kustuta) | Kustutab valitud tokenid pärast kinnitust. Mitmikvalik on toetatud. |
| **Search** | Filtreerib alamstringi järgi. |
| **Pagination** | 15, 25 või 50 rida lehel. |

---

## 21 saadaolevat OTP-tüüpi

Loend **OTP Type**, mille vihjetekst on *Choose an OTP manager*, pakub 21 kirjet. Nende nimes on esmalt kanal ja seejärel pakkuja: `SMTP` tähendab SMS-i, mis antakse operaatorile üle **e-postiga**, `HTTP` või `HTTPS` SMS-i, mis antakse üle **veebikutsega**.

| OTP Type | Kanal | Sätete jaotis |
|---|---|---|
| **OTP - email** | E-post | *Mail subject* |
| **TOTP (Google authenticator, FreeOTP, ...)** | Autentimisrakendus | vt vahekaarti **TOTP** |
| **OTP - Radius** | Radius-server | vt vahekaarti **Radius** |
| **OTP - SMS (SMTP: OVH)** | SMS e-postiga | vt vahekaarti **SMS by email** |
| **OTP - SMS (SMTP: Orange)** | SMS e-postiga | eraldi väli puudub |
| **OTP - SMS (SMTP: SFR)** | SMS e-postiga | vt vahekaarti **SMS by email** |
| **OTP - SMS (SMTP: esendex)** | SMS e-postiga | vt vahekaarti **SMS by email** |
| **OTP - SMS (SMTP: LeSMS)** | SMS e-postiga | vt vahekaarti **SMS by email** |
| **OTP - SMS (SMTP: smsenvoi)** | SMS e-postiga | vt vahekaarti **SMS by email** |
| **OTP - SMS (SMTP: Clever SMS)** | SMS e-postiga | vt vahekaarti **SMS by email** |
| **OTP - SMS (HTTP: OVH)** | SMS veebikutsega | vt vahekaarti **SMS by web call** |
| **OTP - SMS (HTTPS: Orange)** | SMS veebikutsega | vt vahekaarti **SMS by web call** |
| **OTP - SMS (HTTPS: Orange Light CEO)** | SMS veebikutsega | vt vahekaarti **SMS by web call** |
| **OTP - SMS (HTTPS: SFR)** | SMS veebikutsega | vt vahekaarti **SMS by web call** |
| **OTP - SMS (HTTPS: esendex)** | SMS veebikutsega | vt vahekaarti **SMS by web call** |
| **OTP - SMS (HTTP(s): smsenvoi)** | SMS veebikutsega | vt vahekaarti **SMS by web call** |
| **OTP - SMS (HTTP: SmsBox)** | SMS veebikutsega | vt vahekaarti **SMS by web call** |
| **OTP - SMS (HTTP: LeSMS)** | SMS veebikutsega | vt vahekaarti **SMS by web call** |
| **OTP - SMS (HTTPS: CallR)** | SMS veebikutsega | vt vahekaarti **SMS by web call** |
| **OTP - SMS (HTTP: envoyerSMS)** | SMS veebikutsega | vt vahekaarti **SMS by web call** |
| **OTP - SMS (HTTPS: MiPih)** | SMS veebikutsega | vt vahekaarti **SMS by web call** |

> **Tüüp määrab, millised jaotised kuvatakse**
>
> Tüübi valimine koostab vormi uuesti: kuvatakse pakkuja oma jaotis ja ülejäänud kaovad. Muu osa määravad kolm reeglit:
>
> - **üldine** plokk (peatükk [Üldine plokk](#generic-block)) kuvatakse **kõigi tüüpide puhul, välja arvatud TOTP ja Radius**;
> - plokk **Authentication through a site** (peatükk [Suunamine site'i kaudu](#routing-through-a-site)) kuvatakse **veebikutse** tüüpide ja tüübi **Radius** puhul;
> - **e-posti edastuse** plokk (peatükk [E-posti edastus](#email-delivery)) kuvatakse **e-posti** tüüpide ja tüübi **TOTP** puhul.

---

## OTP-tokeni lisamine

### Ühised väljad

| Väli | Kirjeldus |
|---|---|
| **OTP Type** | Kohustuslik. Vt peatükki [21 saadaolevat OTP-tüüpi](#the-21-available-otp-types). **Pärast salvestamist ei saa muuta.** |
| **Name** | Kohustuslik, kuni 50 märki. Lubatud märgid: rõhumärgita tähed, numbrid, `é`, `è`, `à`, `ô`, `â`, sulud, tühik, `-`, `/`, `.` ja `_`. |
| **Description** | Vaba tekst. |

### Üldine plokk

Kuvatakse kõigi tüüpide puhul, **välja arvatud TOTP ja Radius**, mis loovad oma koodi teisiti.

| Väli | Kirjeldus |
|---|---|
| **OTP usable characters** | Tähestik, millest kood moodustatakse. Vaikimisi `abcdefghijklmnopqrstuvwxyz`, vähemalt 5 märki. |
| **OTP Length** | Koodi märkide arv. Vähemalt 4, vaikimisi 8. |
| **Validity period of a token (seconds)** | Vähemalt 15, vaikimisi 900. |
| **Number of sent authentication tokens** | Kirjutuskaitstud loendur. Nupp **Reset** nullib selle serveri poolel. |
| **Message before the OTP** | Tekst, mis on sõnumis koodi ees. Vaikimisi *Your password is:*. Väli on olemas kaks korda sama nimega: üks **e-posti** tüüpide jaoks, teine kõigi ülejäänute jaoks; kuvatakse ainult valitud tüübile vastav väli. |

### Suunamine site'i kaudu

| Väli | Kirjeldus |
|---|---|
| **Authentication through a site** | Vaikimisi märgitud. Pakkujale tehtavad kutsed lähtuvad kindlast site'ist. |
| *(site'ide loend)* | Kohustuslik, kui märkeruut on märgitud. |

### E-posti edastus

| Väli | Kirjeldus |
|---|---|
| **SMTP sender** | Saatja aadress, mida kontrollitakse e-posti aadressina. Seda välja ei kuvata tüübi **OTP - SMS (SMTP: smsenvoi)** puhul. |
| **SMTP server** | Kohustuslik. Moodulis [SMTP servers](https://docs.cyberelements.io/bastion/4.6/et/Usage/AdminConsoleReference/SmtpServers/) deklareeritud server. |

> **TOTP puhul on need kaks välja algselt passiivsed**
>
> Tüübi **TOTP** korral jäävad väljad **SMTP sender** ja **SMTP server** **välja lülitatuks**, kuni suvand **Send generated keys by e-mail** on märgitud. Nende täitmine ei ole seega eeltingimus: just see suvand muudab need kasutatavaks.

### Tüübipõhised sätted

**TOTP**

> | Väli | Kirjeldus |
> |---|---|
> | **Expiration Time** | Koodi kehtivusaeg sekundites. Vaikimisi 30. |
> | **Number of digits** | Koodi pikkus. Loend pakub ainult väärtust **6**. |
> | **Key size (bits)** | **64**, **32** või **16**. Vaikimisi 32. |
> | **Read the secret key in a user attribute (LDAP domain)** | Salavõti loetakse konto atribuudist, selle asemel et see genereerida. Muudab järgmise välja kasutatavaks. |
> | **User attribute containing the secret key** | Atribuudi nimi. Vaikimisi `secretKey`. |
> | **Display a QR Code on the user portal** | Kasutaja registreerib oma rakenduse QR-koodi pildistades. |
> | **Send generated keys by e-mail** | Võti saadetakse e-postiga. Muudab kasutatavaks kaks järgmist välja ning peatüki [E-posti edastus](#email-delivery). |
> | **Message before the OTP** | Võtme edastamise sõnumi tekst. |
> | **Mail subject** | Selle sõnumi teema. |
>
> > **Üks välistus, mitte kolm**
> >
> > Suvandi **Display a QR Code on the user portal** või **Send generated keys by e-mail** märkimine tühjendab kasutaja atribuudist lugemise märkeruudu ja **lülitab selle välja** — võtit ei saa korraga määrata kataloog ja genereerida platvorm. **QR-koodi ja e-posti edastuse saab aga koos alles jätta**: need on kaks viisi sama genereeritud võtme üleandmiseks.

**Radius**

> See tüüp asendab endist SecurID-tokenit: konsool kuvab seda nüüd nimega **OTP - Radius**.
>
> | Väli | Kirjeldus |
> |---|---|
> | **Server** | Kohustuslik. Peamine Radius-server. |
> | **Secondary server** | Varuserver. Valikuline. |
> | **Port** | Kohustuslik. Vaikimisi 1812. |
> | **Timeout (seconds)** | Kohustuslik. Vastuse ooteaeg. Vaikimisi 10. |
> | **Retries number** | Kohustuslik. Vaikimisi 2. |
> | **Shared secret** | Kohustuslik. Radius-serveriga jagatud saladus. |
> | **Push mode** | Kasutaja kinnitab sisselogimise oma rakenduses, selle asemel et koodi sisestada. |
> | **NAS IP address** | Kohustuslik, rangelt IPv4-vormingus. Radius-serveri poolel deklareeritud aadress. |

**SMS by email**

> | Tüüp | Oma väljad |
> |---|---|
> | **OTP - SMS (SMTP: OVH)** | **SMS Account**, **SMS ID**, **Password**, **SMS sender** (eesliitega `+33`), **SMS Class** (0 kuni 3, vaikimisi 1). |
> | **OTP - SMS (SMTP: Orange)** | Oma väljad puuduvad: kehtivad ainult üldine plokk ja e-posti edastuse plokk. |
> | **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`, vaikimisi `STANDARD`, `PREMIUM`, `CONCATENE`), **Sender name (PREMIUM)**, **Get a response** (vaikimisi märgitud). |
> | **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**. ⓘ Kaks viimast välistavad teineteist: kui märgite numbri lisamise adressaati, muutub domeen kasutatavaks ja kliendi ID lülitub välja. |

**SMS by web call**

> | Tüüp | Oma väljad |
> |---|---|
> | **OTP - SMS (HTTP: OVH)** | **Service Name**, **ID**, **Application Key**, **Application secret key**, **Consumption Key**, **Priority** (**Very low**, **Low**, vaikimisi **Normal**, **High**), **No stop clause** (vaikimisi märgitud), **OVH Account Sender**, **Phone Prefix** (vaikimisi 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`, vaikimisi `STANDARD`, `PREMIUM`, `CONCATENE`), **Sender name (PREMIUM)**, **White label (optional)**, **Use SSL** (vaikimisi märgitud). |
> | **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**. |

Salvestamiseks klõpsake **Validate**.

---

## OTP-tokeni redigeerimine

Valige token ja klõpsake ikooni **Properties** või topeltklõpsake rida. Aknas **Edit OTP token** on samad väljad, kuid **OTP Type** muutub **kirjutuskaitstuks**: kanali muutmiseks tuleb luua uus token.

---

## OTP-tokeni kustutamine

Valige üks või mitu tokenit ja klõpsake nuppu **×**. Küsitakse kinnitust. Mitmikvalik on toetatud.

> **Enne kustutamist kontrollige domeene**
>
> Tokeni kustutamine ei ühenda lahti seda kasutavaid autentimisdomeene. Kontrollige esmalt vastavaid konfiguratsioone.
