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

v0

v0.2.1

Jul 10, 2026

Changes in this version

+ const WebAuthnPurposeStepUp

v0.2.0

Jul 5, 2026

Changes in this version

+ const WebAuthnPurposeLogin

+ const WebAuthnPurposeRegister

+ func DummyVerify(secret string)

+ func FormatToken(id, secret string) string

+ func GenerateRecoveryCodes(n int) ([]string, error)

+ func GenerateTOTPSecret() (string, error)

+ func HashBindingToken(token string) string

+ func HashRecoveryCode(code string) string

+ func OTPAuthURI(issuer, account, secret string) string

+ func SplitToken(presented string) (id, secret string, ok bool)

+ func TOTPCodeAt(secret string, t time.Time) (string, error)

+ func ValidateTOTP(secret, code string, t time.Time) bool

+ func ValidateTOTPStep(secret, code string, t time.Time) (uint64, bool)

+ type OIDCAuthState struct

+ BindingHash string

+ ClientIP string

+ CodeVerifier string

+ CreatedAt time.Time

+ ExpiresAt time.Time

+ Nonce string

+ ProviderID string

+ RedirectAfter string

+ State string

+ func NewOIDCAuthState(providerID, clientIP, redirectAfter, codeVerifier, bindingToken string, ...) (OIDCAuthState, error)

+ func (s OIDCAuthState) Expired() bool

type Session

+ Epoch uint64

+ type TOTPChallenge struct

+ Attempts int

+ ClientIP string

+ CreatedAt time.Time

+ ExpiresAt time.Time

+ ID string

+ Used bool

+ UserID string

+ func NewTOTPChallenge(userID, clientIP string, ttl time.Duration) (TOTPChallenge, error)

+ func (c TOTPChallenge) Active(now time.Time) bool

+ type WebAuthnChallenge struct

+ ClientIP string

+ CreatedAt time.Time

+ ExpiresAt time.Time

+ ID string

+ Purpose string

+ SessionData []byte

+ Used bool

+ UserID string

+ func NewWebAuthnChallenge(userID, clientIP, purpose string, sessionData []byte, ttl time.Duration) (WebAuthnChallenge, error)

+ func (c WebAuthnChallenge) Active(now time.Time) bool

+ type WebAuthnCredential struct

+ AAGUID []byte

+ BackupEligible bool

+ BackupState bool

+ CreatedAt time.Time

+ CredentialID []byte

+ ID string

+ LastUsedAt time.Time

+ Name string

+ PublicKey []byte

+ SignCount uint32

+ Transports []string

+ UserID string

v0.1.0

Jun 11, 2026

Changes in this version

+ func HashSecret(secret string) (string, error)

+ func NewRandomToken(bytes int) (string, error)

+ func VerifySecret(encoded, secret string) bool

+ type Session struct

+ ActorID string

+ CSRFToken string

+ CreatedAt time.Time

+ ExpiresAt time.Time

+ ID string

+ Revoked bool

+ func NewSession(actorID string, ttl time.Duration) (Session, error)

+ func (s Session) Active(now time.Time) bool