userdirectory.get

Descripción

integer/array userdirectory.get(object parameters)

El método permite recuperar directorios de usuarios según los parámetros dados.

Este método solo está disponible para los tipos de usuarios Superadministrador.

Parámetros

(objeto) Parámetros que definen la salida deseada.

El método admite los siguientes parámetros.

Parámetro Tipo Descripción
userdirectoryids ID/array Devolver solo los directorios de usuario con los IDs indicados.
selectUsrgrps consulta Devuelve una propiedad usrgrps con los grupos de usuarios asociados a un directorio de usuario.

Admite count.
selectProvisionMedia consulta Devuelve una propiedad provision_media con las asignaciones de tipos de medio asociadas a un directorio de usuario.
selectProvisionGroups consulta Devuelve una propiedad provision_groups con las asignaciones de grupos de aprovisionamiento asociadas a un directorio de usuario.
sortfield string/array Ordena el resultado por las propiedades indicadas.

Valores posibles: name.
filter objeto 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.

Admite las propiedades: userdirectoryid, idp_type, provision_status.
search objeto 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, description.

El directorio de usuario de tipo SAML tendrá un valor vacío tanto para las propiedades name como description. Ambas propiedades pueden modificarse con la operación userdirectory.update.
countOutput booleano Estos parámetros se describen en el comentario de referencia.
excludeSearch booleano
limit entero
output consulta
preservekeys booleano
searchByAny booleano
searchWildcardsEnabled booleano
sortorder string/array
startSearch booleano

Valores de retorno

(entero/matriz) Devuelve:

  • una matriz de objetos;
  • el recuento de objetos recuperados, si el parámetro countOutput ha sido usado.

Ejemplos

Recuperar directorios de usuarios

Recupere todos los directorios de usuarios con propiedades adicionales que muestran asignaciones de tipos de medios y asignaciones de grupos de aprovisionamiento asociadas con cada directorio de usuarios.

Solicitud:

{
           "jsonrpc": "2.0",
           "método": "directoriodeusuario.get",
           "parámetros": {
               "salida": "extender",
               "selectProvisionMedia": "extender",
               "selectProvisionGroups": "extender"
           },
           "identificación": 1
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "resultado": [
              {
                   "userdirectoryid": "1",
                   "idp_type": "2",
                   "nombre": "",
                   "provision_status": "1",
                   "descripción": "",
                   "group_name": "grupos",
                   "user_username": "",
                   "usuario_apellido": "",
                   "idp_entityid": "http://example.com/simplesaml/saml2/idp/metadata.php",
                   "sso_url": "http://example.com/simplesaml/saml2/idp/SSOService.php",
                   "slo_url": "",
                   "username_attribute": "uid",
                   "sp_entityid": "zabbix",
                   "nameid_format": "",
                   "sign_messages": "0",
                   "sign_assertions": "0",
                   "sign_authn_requests": "0",
                   "sign_logout_requests": "0",
                   "sign_logout_responses": "0",
                   "encrypt_nameid": "0",
                   "encrypt_assertions": "0",
                   "scim_status": "1",
                   "provision_media": [
                       {
                           "userdirectory_mediaid": "1",
                           "nombre": "ejemplo.com",
                           "mediatypeid": "1",
                           "atributo": "[email protected]",
                           "activo": "0",
                           "gravedad": "63",
                           "período": "1-7,00:00-24:00"
                       }
                   ],
                   "grupos_aprovisionamiento": [
                       {
                           "nombre": "*",
                           "roleid": "1",
                           "Grupos de Usuarios": [
                               {
                                   "usrgrpid": "13"
                               }
                           ]
                       }
                   ]
               },
               {
                   "userdirectoryid": "2",
                   "idp_type": "1",
                   "nombre": "servidor AD",
                   "provision_status": "1",
                   "descripción": "",
                   "host": "host.ejemplo.com",
                   "puerto": "389",
                   "base_dn": "DC=zbx,DC=local",
                   "search_attribute": "sAMAccountName",
                   "bind_dn": "CN=Admin,OU=Usuarios,OU=Zabbix,DC=zbx,DC=local",
                   "start_tls": "0",
                   "Filtro de búsqueda": "",
                   "group_basedn": "OU=Zabbix,DC=zbx,DC=local",
                   "nombre_grupo": "CN",
                   "group_member": "miembro",
                   "group_filter": "(%{groupattr}=CN=%{ref},OU=Usuarios,OU=Zabbix,DC=zbx,DC=local)",
                   "membresía de grupo": "",
                   "user_username": "nombre dado",
                   "user_lastname": "sn",
                   "user_ref_attr": "CN",
                   "provision_media": [
                       {
                           "userdirectory_mediaid": "2",
                           "nombre": "ejemplo.com",
                           "mediatypeid": "1",
                           "atributo": "[email protected]",
                           "activo": "0",
                           "gravedad": "63",
                           "período": "1-7,00:00-24:00"
                       }
                   ],
                   "grupos_aprovisionamiento": [
                       {
                           "nombre": "*",
                           "roleid": "4",
                           "Grupos de Usuarios": [
                               {
                                   "usrgrpid": "8"
                               }
                           ]
                       },
                       {
                           "nombre": "Administradores de Zabbix",
                           "roleid": "2",
                           "Grupos de Usuarios": [
                               {
                                   "usrgrpid": "7"
                               },
                               {
                                   "usrgrpid": "8"
                               }
                           ]
                       }
                   ]
               },
               {
                   "userdirectoryid": "3",
                   "idp_type": "1",
                   "nombre": "Servidor API LDAP nº 1",
                   "provision_status": "0",
                   "descripción": "",
                   "host": "ldap://local.ldap",
                   "puerto": "389",
                   "base_dn": "ou=Usuarios,dc=ejemplo,dc=org",
                   "search_attribute": "uid",
                   "bind_dn": "cn=ldap_search,dc=ejemplo,dc=org",
                   "start_tls": "1",
                   "Filtro de búsqueda": "",
                   "group_basedn": "",
                   "Nombre del grupo": "",
                   "miembro del grupo": "",
                   "filtro_grupo": "",
                   "membresía de grupo": "",
                   "user_username": "",
                   "usuario_apellido": "",
                   "user_ref_attr": "",
                   "provision_media": [],
                   "grupos_aprovisionamiento": []
               }
           ],
           "identificación": 1
       }

Ver también

Fuente

CUserDirectory::get() en ui/include/classes/api/services/CUserDirectory.php.