Help us shape the future of Go! Take the 2026 Go Developer Survey

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
- API
  
  Reference documentation for the pkg.go.dev API
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.3.1

Oct 11, 2026

v2.3.0

Aug 26, 2026

v2.2.0

Aug 19, 2026

v2.1.7

Aug 19, 2026

v2.1.6

Jul 25, 2026

Changes in this version

type Service

+ func (s *Service) AddGithubProviderWithNumericID(cid, csecret string)

v2.1.5

Jul 4, 2026

v2.1.4

May 21, 2026

v2.1.3

May 10, 2026

Changes in this version

type Opts

+ VerifConfirmationStore provider.VerifConfirmationStore

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 GO-2026-5348

GO-2026-5348: auth: Patreon provider assigns the same local user ID to every authenticated Patreon account, enabling cross‑user impersonation in github.com/go-pkgz/auth

v2.1.0

Dec 4, 2025 GO-2026-5348

GO-2026-5348: auth: Patreon provider assigns the same local user ID to every authenticated Patreon account, enabling cross‑user impersonation in github.com/go-pkgz/auth

v2.0.0

Mar 23, 2025 GO-2026-5348

GO-2026-5348: auth: Patreon provider assigns the same local user ID to every authenticated Patreon account, enabling cross‑user impersonation in github.com/go-pkgz/auth

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