Table of Contents
userdirectory.test
Descripción
object userdirectory.test(array userDirectory)
Este método permite probar la configuración de conexión del directorio de usuarios.
Este método también permite probar qué datos configurados coinciden con la configuración del directorio de usuarios para el aprovisionamiento de usuarios (por ejemplo, qué rol de usuario, grupos de usuarios, medios de usuario se asignarán al usuario). Para este tipo de prueba, la solicitud de API debe realizarse para un directorio de usuarios que tenga provision_status establecido como habilitado.
Este método solo está disponible para el tipo de usuario Super admin.
Parámetros
(objeto) Propiedades del directorio de usuarios.
Dado que la API userdirectory.get no devuelve el campo bind_password, se debe proporcionar userdirectoryid y/o bind_password.
Además de las propiedades estándar del directorio de usuarios, el método acepta los siguientes parámetros.
| Parámetro | Tipo | Descripción |
|---|---|---|
| test_username | string | Nombre de usuario para probar en el directorio de usuarios. |
| test_password | string | Contraseña asociada al nombre de usuario para probar en el directorio de usuarios. |
Valores de retorno
(bool) Devuelve verdadero en caso de éxito.
Ejemplos
Probar el directorio de usuarios para un usuario existente
Probar el directorio de usuarios "3" para "user1".
{
"jsonrpc": "2.0",
"method": "userdirectory.test",
"params": {
"userdirectoryid": "3",
"host": "127.0.0.1",
"port": "389",
"base_dn": "ou=Users,dc=example,dc=org",
"search_attribute": "uid",
"bind_dn": "cn=ldap_search,dc=example,dc=org",
"bind_password": "password",
"test_username": "user1",
"test_password": "password"
},
"id": 1
}Respuesta:
Probar el directorio de usuarios para un usuario inexistente
Probar el directorio de usuarios "3" para el "user2" inexistente.
{
"jsonrpc": "2.0",
"method": "userdirectory.test",
"params": {
"userdirectoryid": "3",
"host": "127.0.0.1",
"port": "389",
"base_dn": "ou=Users,dc=example,dc=org",
"search_attribute": "uid",
"bind_dn": "cn=ldap_search,dc=example,dc=org",
"test_username": "user2",
"test_password": "password"
},
"id": 1
}Respuesta:
{
"jsonrpc": "2.0",
"error": {
"code": -32500,
"message": "Application error.",
"data": "Incorrect user name or password or account is temporarily blocked."
},
"id": 1
}Probar el directorio de usuarios para el aprovisionamiento de usuarios
Probar el directorio de usuarios "3" para ver qué datos configurados coinciden con la configuración del directorio de usuarios para el aprovisionamiento de "user3" (por ejemplo, qué rol de usuario, grupos de usuarios, medios de usuario se asignarán al usuario).
{
"jsonrpc": "2.0",
"method": "userdirectory.test",
"params": {
"userdirectoryid": "2",
"host": "host.example.com",
"port": "389",
"base_dn": "DC=zbx,DC=local",
"search_attribute": "sAMAccountName",
"bind_dn": "CN=Admin,OU=Users,OU=Zabbix,DC=zbx,DC=local",
"test_username": "user3",
"test_password": "password"
},
"id": 1
}Respuesta:
{
"jsonrpc": "2.0",
"result": {
"username": "user3",
"name": "John",
"surname": "Doe",
"medias": [],
"usrgrps": [
{
"usrgrpid": "8"
},
{
"usrgrpid": "7"
}
],
"roleid": "2",
"userdirectoryid": "2"
},
"id": 1
}Origen
CUserDirectory::test() en ui/include/classes/api/services/CUserDirectory.php.