integer/array mfa.get(object parameters)
El método permite recuperar métodos MFA según los parámetros dados.
Este método solo está disponible para el tipo de usuario Super admin. Los permisos para llamar al método pueden ser revocados en la configuración del rol de usuario. Consulte Roles de usuario para obtener más información.
(object)
Parámetros que definen la salida deseada.
El método admite los siguientes parámetros.
Parámetro | Tipo | Descripción |
---|---|---|
mfaids | ID/array | Devolver solo los métodos MFA con los IDs indicados. |
selectUsrgrps | query | Devuelve una propiedad usrgrps con los grupos de usuarios asociados a los métodos MFA.Admite count . |
filter | object | Devuelve solo aquellos resultados que coincidan exactamente con el filtro dado. Acepta un objeto, donde las claves son nombres de propiedades y los valores son un único valor o un array de valores con los que comparar. Admite las propiedades: mfaid - ID del método MFA;type - Tipo del método MFA. |
sortfield | string/array | Ordena el resultado por las propiedades indicadas. Valores posibles: name . |
search | object | Devuelve resultados que coincidan con el patrón dado (no distingue mayúsculas/minúsculas). Acepta un objeto, donde las claves son nombres de propiedades y los valores son cadenas a buscar. Si no se dan opciones adicionales, esto realizará una búsqueda LIKE "%…%" .Propiedades admitidas: name . |
countOutput | boolean | Estos parámetros se describen en el comentario de referencia. |
excludeSearch | boolean | |
limit | integer | |
output | query | |
preservekeys | boolean | |
searchByAny | boolean | |
searchWildcardsEnabled | boolean | |
sortorder | string/array | |
startSearch | boolean |
(integer/array)
Devuelve:
countOutput
.Recuperar todos los métodos MFA con "Zabbix" en su nombre.
{
"jsonrpc": "2.0",
"method": "mfa.get",
"params": {
"output": "extend",
"search": {
"name": "Zabbix"
}
},
"id": 1
}
Respuesta:
{
"jsonrpc": "2.0",
"result": [
{
"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
}
CMfa::get() en ui/include/classes/api/services/CMfa.php.