silverstripe / silverstripe-activedirectory

     * @param array $attributes List of specific AD attributes to return. Empty array means return everything.

     * @return array

     */

    public function getGroupByGUID($guid, $attributes = array())

    {

        $searchLocations = $this->config()->groups_search_locations ?: array(null);

        foreach ($searchLocations as $searchLocation) {

            $records = $this->gateway->getGroupByGUID($guid, $searchLocation, Zend\Ldap\Ldap::SEARCH_SCOPE_SUB, $attributes);

            if ($records) {

                return $records[0];

            }

        }

    }

    /**

     * Get a particular AD group's data given a DN.

     * @param array $attributes List of specific AD attributes to return. Empty array means return everything.

     * @return array

     */

    public function getGroupByDN($dn, $attributes = array())

    {

        $searchLocations = $this->config()->groups_search_locations ?: array(null);

        foreach ($searchLocations as $searchLocation) {

            $records = $this->gateway->getGroupByDN($dn, $searchLocation, Zend\Ldap\Ldap::SEARCH_SCOPE_SUB, $attributes);

            if ($records) {

                return $records[0];

            }

        }

    }

    /**

     * Return all AD users in configured search locations, including all users in nested groups.

     * @param array $attributes List of specific AD attributes to return. Empty array means return everything.

     * @return array

     */

    public function getUserByGUID($guid, $attributes = array())

    {

        $searchLocations = $this->config()->users_search_locations ?: array(null);

        foreach ($searchLocations as $searchLocation) {

            $records = $this->gateway->getUserByGUID($guid, $searchLocation, Zend\Ldap\Ldap::SEARCH_SCOPE_SUB, $attributes);

            if ($records) {

                return $records[0];

            }

        }

    }

    /**

     * Get a specific AD user's data given a DN.

     *

     * @return array

     */

    public function getUserByDN($dn, $attributes = array())

    {

        $searchLocations = $this->config()->users_search_locations ?: array(null);

        foreach ($searchLocations as $searchLocation) {

            $records = $this->gateway->getUserByDN($dn, $searchLocation, Zend\Ldap\Ldap::SEARCH_SCOPE_SUB, $attributes);

            if ($records) {

                return $records[0];

            }

        }

    }

    /**

     * Get a specific user's data given an email.

     * @param array $attributes List of specific AD attributes to return. Empty array means return everything.

     * @return array

     */

    public function getUserByEmail($email, $attributes = array())

    {

        $searchLocations = $this->config()->users_search_locations ?: array(null);

        foreach ($searchLocations as $searchLocation) {

            $records = $this->gateway->getUserByEmail($email, $searchLocation, Zend\Ldap\Ldap::SEARCH_SCOPE_SUB, $attributes);

            if ($records) {

                return $records[0];

            }

        }

    }

    /**

     * Get a specific user's data given a username.

     * @param array $attributes List of specific AD attributes to return. Empty array means return everything.

     * @return array

     */

    public function getUserByUsername($username, $attributes = array())

    {

        $searchLocations = $this->config()->users_search_locations ?: array(null);

        foreach ($searchLocations as $searchLocation) {

            $records = $this->gateway->getUserByUsername($username, $searchLocation, Zend\Ldap\Ldap::SEARCH_SCOPE_SUB, $attributes);

            if ($records) {

                return $records[0];

            }

        }

    }

    /**

     * Get a username for an email.