Documentation
¶
Index ¶
- Constants
- Variables
- func CheckDomainAuth(username string, perDomain bool, allowedDomains []string) (loginName string, allowed bool)
- func GetPublicKey() []byte
- func NormalizeUsername(username string) string
- func ValidateLoginDomain(username, expectedDomain string) error
- func WrapIP(domain string) string
- type ContextData
- type FailingSASLServ
- type SASLAuth
- func (s *SASLAuth) AddProvider(m *config.Map, node config.Node) error
- func (s *SASLAuth) AuthPlain(username, password string) error
- func (s *SASLAuth) CreateSASL(mech string, remoteAddr net.Addr, ...) sasl.Server
- func (s *SASLAuth) IsRegistrationOpen() bool
- func (s *SASLAuth) IsTurnEnabled() bool
- func (s *SASLAuth) SASLMechanisms() []string
Constants ¶
const PublicKeyHex = "7cb0bcc1d8e91e51f631c9ad6025e8e6e0222a27c3eeaf8608cf1c8430a6c6b0"
PublicKeyHex is the Ed25519 public key used for verifying binary signatures. This is hardcoded into the binary and used by the upgrade/update commands.
Variables ¶
var ( ErrUnsupportedMech = errors.New("Unsupported SASL mechanism") ErrInvalidAuthCred = errors.New("auth: invalid credentials") )
Functions ¶
func CheckDomainAuth ¶
func NormalizeUsername ¶
func ValidateLoginDomain ¶ added in v0.20.0
ValidateLoginDomain checks that a username is in the format localpart@domain where domain exactly matches the expected domain (case-insensitive). This prevents JIT account creation for arbitrary usernames like:
- x@y@z (multiple @ signs)
- user@%5b1.2.3.4%5d (URL-encoded brackets)
- user@wrongdomain
- user@abcd (random domain)
The expectedDomain should already be in the canonical form, e.g. "[1.1.1.1]". The username is normalized before comparison (bare IPs get brackets added).
Types ¶
type ContextData ¶
type FailingSASLServ ¶
type FailingSASLServ struct{ Err error }
type SASLAuth ¶
type SASLAuth struct {
Log log.Logger
OnlyFirstID bool
EnableLogin bool
AuthMap module.Table
AuthNormalize authz.NormalizeFunc
Plain []module.PlainAuth
}
SASLAuth is a wrapper that initializes sasl.Server using authenticators that call maddy module objects.
It also handles username translation using auth_map and auth_map_normalize (AuthMap and AuthMapNormalize should be set).
It supports reporting of multiple authorization identities so multiple accounts can be associated with a single set of credentials.
func (*SASLAuth) AddProvider ¶
AddProvider adds the SASL authentication provider to its mapping by parsing the 'auth' configuration directive.
func (*SASLAuth) CreateSASL ¶
func (s *SASLAuth) CreateSASL(mech string, remoteAddr net.Addr, successCb func(identity string, data ContextData) error) sasl.Server
CreateSASL creates the sasl.Server instance for the corresponding mechanism.
Source Files
Directories