Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

auth

package module

Go to main page

Versions in this module

v2

v2.1.2

Apr 22, 2026

Changes in this version

type Opts

+ AllowedRedirectHosts token.AllowedHosts

+ ErrorHandler middleware.ErrorHandlerFunc

type Service

+ func (s *Service) AddMicrosoftProvider(cid, csecret, tenant string)

v2.1.1

Dec 22, 2025

v2.1.0

Dec 4, 2025

v2.0.0

Mar 23, 2025

Changes in this version

+ type Client struct

+ Cid string

+ Csecret string

+ type Opts struct

+ AdminPasswd string

+ AudSecrets bool

+ AudienceReader token.Audience

+ AvatarResizeLimit int

+ AvatarRoutePath string

+ AvatarStore avatar.Store

+ BasicAuthChecker middleware.BasicAuthFunc

+ ClaimsUpd token.ClaimsUpdater

+ CookieDuration time.Duration

+ DisableIAT bool

+ DisableXSRF bool

+ Issuer string

+ JWTCookieDomain string

+ JWTCookieName string

+ JWTHeaderKey string

+ JWTQuery string

+ Logger logger.L

+ RefreshCache middleware.RefreshCache

+ SameSiteCookie http.SameSite

+ SecretReader token.Secret

+ SecureCookies bool

+ SendJWTHeader bool

+ TokenDuration time.Duration

+ URL string

+ UseGravatar bool

+ Validator token.Validator

+ XSRFCookieName string

+ XSRFHeaderKey string

+ XSRFIgnoreMethods []string

+ type Service struct

+ func NewService(opts Opts) (res *Service)

+ func (s *Service) AddAppleProvider(appleConfig provider.AppleConfig, ...) error

+ func (s *Service) AddCustomHandler(p provider.Provider)

+ func (s *Service) AddCustomProvider(name string, client Client, copts provider.CustomHandlerOpt)

+ func (s *Service) AddDevProvider(host string, port int)

+ func (s *Service) AddDirectProvider(name string, credChecker provider.CredChecker)

+ func (s *Service) AddDirectProviderWithUserIDFunc(name string, credChecker provider.CredChecker, ufn provider.UserIDFunc)

+ func (s *Service) AddProvider(name, cid, csecret string)

+ func (s *Service) AddProviderWithUserAttributes(name, cid, csecret string, userAttributes provider.UserAttributes)

+ func (s *Service) AddVerifProvider(name, msgTmpl string, sender provider.Sender)

+ func (s *Service) AvatarProxy() *avatar.Proxy

+ func (s *Service) DevAuth() (*provider.DevAuthServer, error)

+ func (s *Service) Handlers() (authHandler, avatarHandler http.Handler)

+ func (s *Service) Middleware() middleware.Authenticator

+ func (s *Service) Provider(name string) (provider.Service, error)

+ func (s *Service) Providers() []provider.Service

+ func (s *Service) TokenService() *token.Service

Other modules containing this package

github.com/go-pkgz/auth