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

Go to main page

Versions in this module

v1

v1.0.3

Aug 21, 2025

v1.0.2

Aug 20, 2025

v1.0.1

Aug 10, 2025

v1.0.0

Aug 10, 2025

Changes in this version

+ func RequireRole(role string) gin.HandlerFunc

+ type Claims struct

+ Email string

+ Permissions []string

+ Role string

+ SessionID string

+ TenantID string

+ TokenType string

+ UserID string

+ func GetClaimsFromContext(c *gin.Context) (*Claims, error)

+ type JWTClaims struct

+ Email string

+ Role string

+ SessionID string

+ TenantID string

+ UserID string

type JWTConfig

+ AllowedIssuers []string

+ CacheClient cache.Client

+ CachePrefix string

+ CacheTTL time.Duration

+ EnableBlacklist bool

+ ErrorHandler func(*gin.Context, error)

+ MaxTokensPerUser int

+ RequiredClaims []string

+ SkipPaths []string

+ TokenExpiration time.Duration

type JWTMiddleware

+ func NewJWTMiddleware(config config.JWTConfig, logger logger.Logger) *JWTMiddleware

+ func (jm *JWTMiddleware) OptionalAuth() gin.HandlerFunc

+ func (jm *JWTMiddleware) RequireAuth() gin.HandlerFunc

+ func (jm *JWTMiddleware) RequireRole(roles ...string) gin.HandlerFunc

+ func (jm *JWTMiddleware) RequireTenant() gin.HandlerFunc

+ type JWTService struct

+ func NewJWTService(config config.JWTConfig, logger logger.Logger) *JWTService

+ func (js *JWTService) GenerateTokens(ctx context.Context, user UserInfo, sessionID string) (accessToken, refreshToken string, expiresAt time.Time, err error)

+ func (js *JWTService) RefreshTokens(ctx context.Context, refreshTokenString string) (accessToken string, expiresAt time.Time, err error)

+ func (js *JWTService) ValidateAccessToken(ctx context.Context, tokenString string) (*JWTClaims, error)

+ type UserInfo struct

+ Email string

+ ID string

+ Role string

+ TenantID string

v0

v0.1.0

Aug 4, 2025

Changes in this version

+ func JWTMiddleware(config *JWTConfig) gin.HandlerFunc

+ type JWTConfig struct

+ ClaimsFunc func(*gin.Context, jwt.MapClaims)

+ SecretKey string

+ SkipperFunc func(*gin.Context) bool

+ TokenHeadName string

+ TokenLookup string

+ func DefaultJWTConfig(secretKey string) *JWTConfig