ldap

Documentation

Index

• Constants
• func GetDefaultAttributes() []string
• func IsCodeError() bool
• func SetTimeout(dialerTimeout, dialerKeepAlive time.Duration)
• type Config
  • func NewConfig() *Config
  • func (cnf Config) BaseDN() string
  • func (cnf Config) Clone() *Config
  • func (cnf Config) PatternFilterGroup() string
  • func (cnf Config) PatternFilterUser() string
  • func (cnf Config) ServerAddr(withTls bool) string
  • func (cnf Config) Validate() errors.Error
• type HelperLDAP
  • func NewLDAP(ctx context.Context, cnf *Config, attributes []string) (*HelperLDAP, errors.Error)
  • func (lc *HelperLDAP) AuthUser(username, password string) errors.Error
  • func (lc *HelperLDAP) Check() errors.Error
  • func (lc *HelperLDAP) Close()
  • func (lc *HelperLDAP) Connect() errors.Error
  • func (lc *HelperLDAP) ForceTLSMode(tlsMode TLSMode, tlsConfig *tls.Config)
  • func (lc *HelperLDAP) GroupInfo(groupname string) (map[string]interface{}, errors.Error)
  • func (lc HelperLDAP) ParseEntries(entry string) map[string][]string
  • func (lc *HelperLDAP) SetCredentials(user, pass string)
  • func (lc *HelperLDAP) UserInfo(username string) (map[string]string, errors.Error)
  • func (lc *HelperLDAP) UserIsInGroup(username string, groupname []string) (bool, errors.Error)
  • func (lc *HelperLDAP) UserMemberOf(username string) ([]string, errors.Error)
  • func (lc *HelperLDAP) UsersOfGroup(groupname string) ([]string, errors.Error)
• type TLSMode
  • func (m TLSMode) String() string

Constants

const (
	ErrorEmptyParams errors.CodeError = iota + errors.MIN_PKG_LDAP
	ErrorLDAPContext
	ErrorLDAPServerConfig
	ErrorLDAPServerConnection
	ErrorLDAPServerDial
	ErrorLDAPServerDialClosing
	ErrorLDAPServerTLS
	ErrorLDAPServerStartTLS
	ErrorLDAPBind
	ErrorLDAPSearch
	ErrorLDAPUserNotUniq
	ErrorLDAPUserNotFound
	ErrorLDAPInvalidDN
	ErrorLDAPInvalidUID
	ErrorLDAPAttributeNotFound
	ErrorLDAPAttributeEmpty
	ErrorLDAPValidatorError
	ErrorLDAPGroupNotFound
)

Functions

func GetDefaultAttributes

func GetDefaultAttributes() []string

func IsCodeError

func IsCodeError() bool

func SetTimeout

func SetTimeout(dialerTimeout, dialerKeepAlive time.Duration)

Types

type Config

type Config struct {
	Uri         string `cloud:"uri" mapstructure:"uri" json:"uri" yaml:"uri" toml:"uri" validate:"fqdn,required"`
	PortLdap    int    `` /* 144-byte string literal not displayed */
	Portldaps   int    `` /* 143-byte string literal not displayed */
	Basedn      string `cloud:"basedn" mapstructure:"basedn" json:"basedn" yaml:"basedn" toml:"basedn" validate:"printascii,omitempty"`
	FilterGroup string `` /* 139-byte string literal not displayed */
	FilterUser  string `` /* 134-byte string literal not displayed */
}

func NewConfig

func NewConfig() *Config

func (Config) BaseDN

func (cnf Config) BaseDN() string

func (Config) Clone

func (cnf Config) Clone() *Config

func (Config) PatternFilterGroup

func (cnf Config) PatternFilterGroup() string

func (Config) PatternFilterUser

func (cnf Config) PatternFilterUser() string

func (Config) ServerAddr

func (cnf Config) ServerAddr(withTls bool) string

func (Config) Validate

func (cnf Config) Validate() errors.Error

type HelperLDAP

type HelperLDAP struct {
	Attributes []string
	// contains filtered or unexported fields
}

HelperLDAP struct use to manage connection to server and request it.

func NewLDAP

func NewLDAP(ctx context.Context, cnf *Config, attributes []string) (*HelperLDAP, errors.Error)

NewLDAP build a new LDAP helper based on config struct given.

func (*HelperLDAP) AuthUser

func (lc *HelperLDAP) AuthUser(username, password string) errors.Error

AuthUser used to test bind given user uid and password.

func (*HelperLDAP) Check

func (lc *HelperLDAP) Check() errors.Error

Check used to check if connection success (without any bind).

func (*HelperLDAP) Close

func (lc *HelperLDAP) Close()

Close used to close connection object.

func (*HelperLDAP) Connect

func (lc *HelperLDAP) Connect() errors.Error

Connect used to connect and bind to server.

func (*HelperLDAP) ForceTLSMode

func (lc *HelperLDAP) ForceTLSMode(tlsMode TLSMode, tlsConfig *tls.Config)

ForceTLSMode used to force tls mode and defined tls condition.

func (*HelperLDAP) GroupInfo

func (lc *HelperLDAP) GroupInfo(groupname string) (map[string]interface{}, errors.Error)

GroupInfo used to retrieve the information of a given group cn.

func (HelperLDAP) ParseEntries

func (lc HelperLDAP) ParseEntries(entry string) map[string][]string

ParseEntries used to clean attributes of an object class.

func (*HelperLDAP) SetCredentials

func (lc *HelperLDAP) SetCredentials(user, pass string)

SetCredentials used to defined the BindDN and password for connection.

func (*HelperLDAP) UserInfo

func (lc *HelperLDAP) UserInfo(username string) (map[string]string, errors.Error)

UserInfo used to retrieve the information of a given username.

func (*HelperLDAP) UserIsInGroup

func (lc *HelperLDAP) UserIsInGroup(username string, groupname []string) (bool, errors.Error)

UserIsInGroup used to check if a given username is a group member of a list of reference group name.

func (*HelperLDAP) UserMemberOf

func (lc *HelperLDAP) UserMemberOf(username string) ([]string, errors.Error)

UserMemberOf returns the group list of a given user.

func (*HelperLDAP) UsersOfGroup

func (lc *HelperLDAP) UsersOfGroup(groupname string) ([]string, errors.Error)

UsersOfGroup used to retrieve the member list of a given group name.

type TLSMode

type TLSMode uint8

const (

	//TLSModeNone no tls connection.
	TLSMODE_NONE TLSMode = iota + 1
	//TLSModeTLS strict tls connection.
	TLSMODE_TLS
	//TLSModeStartTLS starttls connection (tls into a no tls connection).
	TLSMODE_STARTTLS
)

func (TLSMode) String

func (m TLSMode) String() string