[comment]: # translation:outdated

[comment]: # ({33b90954-f9e8f670})
# userdirectory.create

[comment]: # ({/33b90954-f9e8f670})

[comment]: # ({618f9eb8-b5ff62ed})
### Descrizione

`object userdirectory.create(object/array userDirectory)`

Questo metodo consente di creare nuove directory utenti.

::: noteclassic
Questo metodo è disponibile solo per il tipo di utente *Super admin*.
:::

[comment]: # ({/618f9eb8-b5ff62ed})

[comment]: # ({9d471e91-d99c84a0})
### Parametri

`(object/array)` Directory utente da creare.

Il metodo accetta directory utente con le [proprietà standard della directory utente](object#userdirectory).

[comment]: # ({/9d471e91-d99c84a0})

[comment]: # ({b44a6c25-cd9247c6})
### Valori restituiti

`(object)` Restituisce un oggetto contenente gli ID delle directory utente create nella proprietà `userdirectoryids`.
L'ordine degli ID restituiti corrisponde all'ordine delle directory utente passate.

[comment]: # ({/b44a6c25-cd9247c6})

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

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

[comment]: # ({e1bcfdf7-36cc6d5c})
##### Creazione di una directory utenti

Creare una directory utenti per autenticare gli utenti con StartTLS tramite LDAP.
Si noti che, per autenticare gli utenti tramite LDAP, [l'autenticazione LDAP](/manual/api/reference/authentication/object#authentication-object) deve essere abilitata.

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

```json
{
    "jsonrpc": "2.0",
    "method": "userdirectory.create",
    "params": {
        "idp_type": "1",
        "name": "LDAP API server #1",
        "host": "ldap://local.ldap",
        "port": "389",
        "base_dn": "ou=Users,dc=example,dc=org",
        "bind_dn": "cn=ldap_search,dc=example,dc=org",
        "bind_password": "ldapsecretpassword",
        "search_attribute": "uid",
        "start_tls": "1"
    },
    "id": 1
}
```

Risposta:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "userdirectoryids": [
            "3"
        ]
    },
    "id": 1
}
```

[comment]: # ({/e1bcfdf7-36cc6d5c})

[comment]: # ({3b0bb38e-f354f485})
##### Creazione di una directory utenti (provisioning JIT abilitato)

Creare una directory utenti per autenticare gli utenti tramite LDAP (con provisioning JIT abilitato).
Si noti che, per autenticare gli utenti tramite LDAP, [l'autenticazione LDAP](/manual/api/reference/authentication/object#authentication-object) deve essere abilitata.

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

```json
{
    "jsonrpc": "2.0",
    "method": "userdirectory.create",
    "params": {
            "idp_type": "1",
            "name": "AD server",
            "provision_status": "1",
            "description": "",
            "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",
            "start_tls": "0",
            "search_filter": "",
            "group_basedn": "OU=Zabbix,DC=zbx,DC=local",
            "group_name": "CN",
            "group_member": "member",
            "group_filter": "(%{groupattr}=CN=%{ref},OU=Users,OU=Zabbix,DC=zbx,DC=local)",
            "group_membership": "",
            "user_username": "givenName",
            "user_lastname": "sn",
            "user_ref_attr": "CN",
            "provision_media": [
                {
                    "name": "example.com",
                    "mediatypeid": "1",
                    "attribute": "user@example.com"
                }
            ],
            "provision_groups": [
                {
                    "name": "*",
                    "roleid": "4",
                    "user_groups": [
                        {
                            "usrgrpid": "8"
                        }
                    ]
                },
                {
                    "name": "Zabbix administrators",
                    "roleid": "2",
                    "user_groups": [
                        {
                            "usrgrpid": "7"
                        },
                        {
                            "usrgrpid": "8"
                        }
                    ]
                }
            ]
        },
    "id": 1
}
```

Risposta:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "userdirectoryids": [
            "2"
        ]
    },
    "id": 1
}
```

[comment]: # ({/3b0bb38e-f354f485})

[comment]: # ({594536b5-8d17a3f4})
### Fonte

CUserDirectory::create() in *ui/include/classes/api/services/CUserDirectory.php*.

[comment]: # ({/594536b5-8d17a3f4})