RussellLuo / dappy

Basic LDAP Authenticator for Go 🔓🔑

Basic LDAP client for Go

LDAP is complicated. Many times, all you really need to do is authenticate users with it. This package boils down LDAP functionality to User Authentication, that's it.

Thanks to https://github.com/go-ldap/ldap

$ go get -u github.com/RussellLuo/dappy

Example:

package main

import (
	"log"

	"github.com/RussellLuo/dappy"
)

func main() {
	// Create a client
	client, err := dappy.New(dappy.Config{
		Host:   "ldap.example.com:389",
		ROAdmin: dappy.User{Name: "cn=read-only-admin,dc=example,dc=com", Pass: "password"},
		BaseDN: "ou=People,dc=example,dc=com",
	})
	if err != nil {
		panic(err)
	}

	// The username and password to be authenticated
	username := "tesla"
	password := "password"

	// Do the authentication
	if err := client.Auth(username, password); err != nil {
		if err == dappy.ErrUserNotFound || err == dappy.ErrInvalidPassword {
			log.Printf("Failed due to: %v\n", err)
			return
		}
		panic(err)
	}
	log.Println("Success!")

	// Search attributes by a filter expression
	attrs, err := client.SearchAttrs("(uid=te*)", "displayName")
	if err != nil {
		panic(err)
	}
	for _, attr := range attrs {
		log.Printf("name: %s, values: %#v\n", attr.Name, attr.Values)
	}
}