Autenticación en el servidor LDAP

# ldap_bind

(PHP 4, PHP 5, PHP 7, PHP 8)

ldap_bind — Autenticación en el servidor LDAP

### Descripción

function ldap_bind(LDAP\Connection `$ldap`, ?string `$dn` = `null`, #[\SensitiveParameter]?string `$password` = `null`): bool

Autenticación en el servidor LDAP con el RDN y la contraseña especificados.

### Parámetros

`ldap`

  Una instancia de LDAP\Connection, devuelta por ldap_connect().

`dn`

`password`

Si `password` no está especificado o está vacío, se intenta una autenticación anónima. `dn` también puede dejarse vacío para una conexión anónima. Esto está definido en https://tools.ietf.org/html/rfc2251#section-4.2.2

### Valores devueltos

Esta función retorna `true` en caso de éxito o `false` si ocurre un error.

### Historial de cambios

Versión | Descripción
--- | ---
8.1.0 | El parámetro `ldap` ahora espera una instancia de LDAP\Connection; anteriormente, se esperaba un resource `ldap link` válido.

### Ejemplos

Ejemplo #1 Autenticación con LDAP

    <?php

    // Elementos de autenticación LDAP
    $ldaprdn  = 'uname';     // DN o RDN LDAP
    $ldappass = 'password';  // Contraseña asociada

    // Conexión al servidor LDAP
    $ldapconn = ldap_connect("ldap://ldap.example.com")
        or die("No es posible conectarse al servidor LDAP.");

    if ($ldapconn) {

        // Conexión al servidor LDAP
        $ldapbind = ldap_bind($ldapconn, $ldaprdn, $ldappass);

        // Verificación de la autenticación
        if ($ldapbind) {
            echo "Conexión LDAP exitosa...";
        } else {
            echo "Conexión LDAP fallida...";
        }

    }

    ?>

Ejemplo #2 Conexión anónima a un servidor LDAP

    <?php

    // Conexión anónima a un servidor LDAP

    // Conexión al servidor LDAP
    $ldapconn = ldap_connect("ldap://ldap.example.com")
        or die("No es posible conectarse al servidor LDAP.");

    if ($ldapconn) {

        // Autenticación anónima
        $ldapbind = ldap_bind($ldapconn);

        if ($ldapbind) {
            echo "Conexión LDAP anónima exitosa...";
        } else {
            echo "Conexión LDAP anónima fallida...";
        }

    }

    ?>

### Ver también

- ldap_bind_ext() - Vincula un directorio LDAP
- ldap_unbind() - Desconecta de un servidor LDAP

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open