> Source: https://docs.cyberelements.io/bastion/4.6/mt/Integration/MFA/GoogleAuthenticatorIntegration/

# Konfigurazzjoni tal-awtentikazzjoni b’żewġ fatturi ma’ Google Authenticator

## Oħloq token TOTP ġdid fil-konsol tal-amministrazzjoni

Iftaħ il-modulu OTP Token Generator minn kont ta’ amministratur:

![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYEIntMFAGA_1.png)

Żid token TOTP ġdid u agħżel `TOTP (Google authenticator, FreeOTP, ...)`:

![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYEIntMFAGA_2.png)

Imbagħad ikkonfigura t-token TOTP tiegħek:

- Iddefinixxi isem. Innota li dan l-isem jintwera lill-utent f’Google Authenticator jekk jintgħażel il-metodu tal-irreġistrar bil-QR Code.
- L-oqsma `Expiration Time` u `Number of Digits` jiddependu fuq il-ġeneratur TOTP. Għal Google Authenticator, dawn il-valuri jridu jiġu ssettjati għal `30` sekonda u `6` ċifri, rispettivament.
- Il-qasam `Key size (bits)` huwa ssettjat għal `32` b’mod default, li huwa l-valur rakkomandat, għalkemm huma possibbli wkoll settings ta’ `16` jew `64` bit.

Hemm żewġ metodi għall-ħażna taċ-ċwievet TOTP:

1. (Metodu rakkomandat) Ħażna taċ-ċavetta f’CyberElements Bastion; jistgħu jintużaw 3 modalitajiet ta’ tħaddim:

   > **Eżempju**
   >
   > Hawn eżempju ta’ konfigurazzjoni ta’ token TOTP:
   >
   > ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYEIntMFAGA_3.png)
   >
   > F’dan l-eżempju, iċ-ċavetta sigrieta se tinħażen f’CyberElements Bastion u se tintwera lill-utent meta jidħol għall-ewwel darba, b’QR code biex jiskennjah f’Google Authenticator.
    1. Billi timmarka l-għażla `Display a QR Code on the user portal`, meta l-utent jawtentika ruħu għall-ewwel darba, jingħata QR Code biex jiskennjah b’Google Authenticator ħalli jirreġistra t-TOTP tiegħu. Imbagħad ikollu jivvalida t-TOTP irreġistrat.
    2. Flimkien mal-għażla preċedenti jew mingħajrha, iċ-ċavetta TOTP tista’ tintbagħat bl-email lill-utent, li mbagħad ikollu jagħmel irreġistrar manwali:
       ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYEIntMFAGA_APP_1.png) ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYEIntMFAGA_APP_2.png)
    3. Jekk l-ebda għażla ma tkun attivata, l-amministraturi jkunu responsabbli biex jimportaw manwalment iċ-ċwievet TOTP u jikkomunikawhom lill-utenti.
2. Ħażna taċ-ċavetta f’attribut tal-utent: ikollok bżonn tispeċifika l-isem tal-attribut (sensittiv għall-ittri kbar u żgħar) li se jkun fih iċ-ċavetta TOTP.

   > **Twissija!**
   >
   > Dan il-metodu huwa kompatibbli biss għall-utenti li jappartjenu għal dominju LDAP.
   >
   > Barra minn hekk, peress li l-aċċess ta’ CyberElements Bastion għas-server LDAP huwa għall-qari biss, huwa l-amministratur li jrid jimla l-kontenut tal-attribut ikkonfigurat biċ-ċavetta TOTP tal-utent.
   > Għalhekk dan il-metodu ma jistax jiġi kkonfigurat bl-għażliet li juru ċ-ċavetta TOTP permezz ta’ QR code jew li jibagħtu ċ-ċavetta bl-email.

## Attivazzjoni tat-TOTP fuq dominju ta’ awtentikazzjoni

Fid-dominji tal-awtentikazzjoni, editja d-dominju li għalih trid tattiva l-MFA TOTP: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYEIntMFAGA_4.png)

Imbagħad attiva l-MFA TOTP għal dan id-dominju. Il-ħin tal-iskadenza jħallik tiddefinixxi jekk l-utent ikollux idaħħal it-TOTP tiegħu f’kull awtentikazzjoni (valur `0`) jew wara ċertu numru ta’ sigħat jew jiem: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYEIntMFAGA_5.png)

## Importa manwalment iċ-ċwievet TOTP

**Iċ-ċavetta TOTP hija bbażata fuq l-istandard base 32 tal-RFC3548.**

Għalhekk:

- Il-karattri appoġġjati huma dawk tal-RFC3548: l-ittri minn A sa Z u n-numri minn 2 sa 7
- Iċ-ċavetta għandu jkun fiha biss ittri kbar
- Iċ-ċavetta għandu jkun fiha 32 karattru (jekk ikun ikkonfigurat hekk fit-token TOTP)

> **Eżempju**
>
> AHGXZFGCNWOD2X7YT6KI5JMXCUYKDN6P

L-importazzjoni hija bbażata fuq fajl CSV b’żewġ kolonni:

```
1
```

L-ewwel kolonna għandu jkun fiha l-isem tal-utent u t-tieni kolonna għandu jkun fiha ċ-ċavetta TOTP assoċjata.

> **Parir**
>
> Jekk tiġi speċifikata ċavetta vojta, iċ-ċavetta tal-utent terġa’ tiġi ssettjata u tiġi ġġenerata waħda ġdida l-ħin li jmiss li jidħol.

> **Eżempju**
>
> Biex ikollok l-assoċjazzjoni bejn l-utent u ċ-ċavetta TOTP li ġejja (it-tielet utent għandu ċ-ċavetta TOTP tiegħu ssettjata mill-ġdid):
>
> - `user1` / `AHGXZFGCNWOD2X7YT6KI5JMXCUYKDN6P`
> - `user2` / `PIHYCEG2374V76523EVXAMZOUT36F3FG`
> - `user3` /
>
> Il-fajl CSV irid ikun fih:
>
> ```
> 1
> 2
> 3
> 4
> ```

Ladarba l-fajl CSV ikun ġie ppreparat, irid jiġi importat għal dominju u token TOTP speċifiċi: ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYEIntMFAGA_6.png) ![](https://docs.cyberelements.io/bastion/4.6/img/cyberelements/CYEIntMFAGA_7.png)
