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

Go to main page

Versions in this module

v1

v1.26.0

Oct 12, 2026

v1.25.0

Oct 12, 2026

v1.24.0

Oct 11, 2026

Changes in this version

+ var ErrExpired = errors.New("credential expired")

+ var ErrForbidden = errors.New("authentication policy refused")

+ var ErrRevoked = errors.New("credential revoked")

+ var ErrSenderProofRequired = errors.New("sender proof required")

+ var ErrStepUpRequired = errors.New("step-up required")

+ var ErrUnauthenticated = errors.New("authentication required")

+ var ErrUnavailable = errors.New("authentication unavailable")

+ type Asserted interface

+ Asserted func() bool

+ type Authenticator interface

+ Authenticate func(r *http.Request) (Verified, error)

+ type Bound interface

+ BoundScope func() Scope

+ type Challenge struct

+ Err error

+ Header http.Header

+ MaxAge time.Duration

+ Metadata map[string]any

+ func (c *Challenge) Error() string

+ func (c *Challenge) Unwrap() error

+ type Credential struct

+ ID string

+ Kind CredentialKind

+ func (c Credential) State() any

+ func (c Credential) WithState(state any) Credential

+ type CredentialKind string

+ const CredentialAPIKey

+ const CredentialAccessToken

+ const CredentialDeviceKey

+ const CredentialSession

+ const CredentialSignedToken

+ type Headers interface

+ AllowedHeaders func() []string

+ ExposedHeaders func() []string

+ type Identity struct

+ Credential Credential

+ Email string

+ EmailVerified bool

+ Invoker Invoker

+ Issuer string

+ Subject string

+ SubjectKind SubjectKind

+ Username string

+ func (i Identity) SelfInvoked() bool

+ type Invoker struct

+ ID string

+ Issuer string

+ type PermissionCatalog interface

+ KnownPermission func(permission string) bool

+ type PermissionChecker interface

+ Can func(ctx context.Context, scope Scope, permission string) (bool, error)

+ type RecentSignInChecker interface

+ CheckRecentSignIn func(ctx context.Context) error

+ type Refusal struct

+ Header http.Header

+ Metadata map[string]any

+ Status int

+ func Refuse(r *http.Request, err error) Refusal

+ type Root interface

+ RootScope func(ctx context.Context) (Scope, error)

+ type Scope struct

+ Authority string

+ ID string

+ type SubjectKind string

+ const SubjectApplication

+ const SubjectUser

+ type Verified interface

+ Identity func() Identity