The highest tagged major version is
README
¶
Simple Active Directory Authentication for Go.
The API is considered stable.
Installing
go get gopkg.in/korylprince/go-ad-auth.v1
Dependencies:
If you have any issues or questions, email the email address below, or open an issue at: https://github.com/korylprince/go-ad-auth/issues
Usage
godoc gopkg.in/korylprince/go-ad-auth.v1
Or read the source. It's pretty simple and readable.
Example:
config := &auth.Config{
Server: "ad.example.com",
Port: 389,
BaseDN: "OU=Users,DC=example,DC=com",
Security: auth.SecurityNone,
Debug: false,
}
status, err := auth.Login("kory.prince", "Super$ecret", "Domain Admins", config)
//status is true if "Super$ecret" is the password for user "kory.prince" and that user is in the "Domain Admins" group.
Copyright Information
All other code is Copyright 2018 Kory Prince (korylprince at gmail dot com.)
This code is licensed under the same license go is licensed under (with slight modification.) If you'd like another license please email me.
Documentation
¶
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func Login ¶
Login will check if the given username and password authenticate correctly with server given by config. username can be in the sAMAccountName or userPrincipalName format. If group is not an empty string then Login will verify that the user is in the Active Directory Group with the Common Name group. error will be non-nil if some sort of server error occurred.
Types ¶
type Config ¶
type Config struct {
Server string
Port int
BaseDN string
Security SecurityType
TLSConfig *tls.Config
Debug bool //debug messages are written to stdout
}
Config contains settings for connecting to an Active Directory server
type ConfigError ¶
type ConfigError string
ConfigError is an error resulting from a bad Config
func (ConfigError) Error ¶
func (c ConfigError) Error() string
type SecurityType ¶
type SecurityType int
SecurityType specifies how to connect to an Active Directory server
const ( SecurityNone SecurityType = iota SecurityTLS SecurityStartTLS )
Security will default to SecurityNone if not given.
Source Files