[comment]: # ({bd1d3801-e25d0b8e})
# mfa.get

[comment]: # ({/bd1d3801-e25d0b8e})

[comment]: # ({5967f82a-32584e90})
### Descrizione

`integer/array mfa.get(object parameters)`

Il metodo consente di recuperare i metodi MFA in base ai parametri specificati.

::: noteclassic
Questo metodo è disponibile solo per gli utenti di tipo *Super admin*.
I permessi per chiamare il metodo possono essere revocati nelle impostazioni del ruolo utente.
Consultare [Ruoli utente](/manual/web_interface/frontend_sections/users/user_roles) per ulteriori informazioni.
:::

[comment]: # ({/5967f82a-32584e90})

[comment]: # ({92d432f9-b64d62fe})
### Parametri

`(object)` Parametri che definiscono l'output desiderato.

Il metodo supporta i seguenti parametri.

|Parameter|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|mfaids|ID/array|Restituisce solo i metodi MFA con gli ID specificati.|
|selectUsrgrps|query|Restituisce una proprietà `usrgrps` con i [gruppi utente](/manual/api/reference/usergroup/object) associati ai metodi MFA.<br><br>Supporta `count`.|
|filter|object|Restituisce solo i risultati che corrispondono esattamente al filtro specificato.<br><br>Accetta un oggetto, in cui le chiavi sono nomi di proprietà e i valori sono un singolo valore o un array di valori da confrontare.<br><br>Supporta le proprietà:<br>`mfaid` - ID del metodo MFA;<br>`type` - Tipo del metodo MFA.|
|sortfield|string/array|Ordina il risultato in base alle proprietà specificate.<br><br>Valori possibili: `name`.|
|search|object|Restituisce i risultati che corrispondono al pattern specificato (senza distinzione tra maiuscole e minuscole).<br><br>Accetta un oggetto, in cui le chiavi sono nomi di proprietà e i valori sono stringhe da cercare. Se non vengono fornite opzioni aggiuntive, verrà eseguita una ricerca `LIKE "%…%"`.<br><br>Proprietà supportate: `name`.|
|countOutput|boolean|Questi parametri sono descritti nella [reference commentary](/manual/api/reference_commentary#common-get-method-parameters).|
|excludeSearch|boolean|^|
|limit|integer|^|
|output|query|^|
|preservekeys|boolean|^|
|searchByAny|boolean|^|
|searchWildcardsEnabled|boolean|^|
|sortorder|string/array|^|
|startSearch|boolean|^|

[comment]: # ({/92d432f9-b64d62fe})

[comment]: # ({07ca11ca-be3c5307})
### Valori restituiti

`(intero/array)` Restituisce:

- un array di oggetti;
- il conteggio degli oggetti recuperati, se è stato utilizzato il parametro `countOutput`.

[comment]: # ({/07ca11ca-be3c5307})

[comment]: # ({b41637d2-21e802b7})
### Esempi

[comment]: # ({/b41637d2-21e802b7})

[comment]: # ({b539b291-a4c952d8})
#### Ricercare metodi MFA per nome

Recupera tutti i metodi MFA con "Zabbix" nel nome.

[Richiesta](/manual/api#performing-requests):

```json
{
"jsonrpc": "2.0",
"method": "mfa.get",
"params": {
"output": "extend",
"search": {
"name": "Zabbix"
}
},
"id": 1
}
```

Risposta:

```json
{
"jsonrpc": "2.0",
"risultato": [
{
"mfaid": "1",
"type": "1",
"name": "Zabbix TOTP 1",
"hash_function": "1",
"code_length": "6",
"api_hostname": "",
"clientid": ""
},
{
"mfaid": "2",
"type": "1",
"name": "Zabbix TOTP 2",
"hash_function": "3",
"code_length": "8",
"api_hostname": "",
"clientid": ""
}
],
"id": 1
}
```

[comment]: # ({/b539b291-a4c952d8})

[comment]: # ({35eefc20-fdffee34})
### Sorgente

CMfa::get() in *ui/include/classes/api/services/CMfa.php*.

[comment]: # ({/35eefc20-fdffee34})