session

package

Go to main page

Versions in this module

v0

v0.7.0

Sep 11, 2025

v0.6.1

Jul 22, 2025

v0.6.0

Jul 18, 2025

Changes in this version

+ const SessionIdentityKey

type Config

+ EncryptionKey secure.DefaultCredentialConfig

+ type Manager struct

+ func (m *Manager) Clear(c *gin.Context)

+ func (m *Manager) Middleware() gin.HandlerFunc

+ func (m *Manager) Regenerate(c *gin.Context)

+ func (m *Manager) Shutdown()

+ type ManagerOpt func(*Manager) error

+ func ManagerWithLogger(log *log.Logger) ManagerOpt

+ func ManagerWithStore(store *Store) ManagerOpt

type SessionData

+ func (s *SessionData) DeleteIdentity()

+ func (s *SessionData) GetIdentity() (any, bool)

+ func (s *SessionData) HasIdentity() bool

+ func (s *SessionData) SetIdentity(identity any)

v0.5.2

Jul 14, 2025

v0.5.1

Jul 13, 2025

v0.5.0

Jul 12, 2025

Changes in this version

+ func GenerateSessionID() string

type SessionData

+ func (s *SessionData) Delete(key string)

+ func (s *SessionData) Flash(value any)

+ func (s *SessionData) FlashString(value string)

+ func (s *SessionData) Get(key string) (any, bool)

+ func (s *SessionData) GetBool(key string) (bool, bool)

+ func (s *SessionData) GetFlash() (interface{}, bool)

+ func (s *SessionData) GetFlashString() (string, bool)

+ func (s *SessionData) GetInt(key string) (int, bool)

+ func (s *SessionData) GetString(key string) (string, bool)

+ func (s *SessionData) Has(key string) bool

+ func (s *SessionData) Set(key string, value any)

v0.4.2

Apr 19, 2025

v0.4.1

Apr 19, 2025

v0.4.0

Apr 15, 2025

v0.3.1

Apr 3, 2025

v0.3.0

Apr 3, 2025

Changes in this version

+ const ContextSessionKey

+ const DefaultCleanupInterval

+ const DefaultHttpOnly

+ const DefaultSameSite

+ const DefaultSecure

+ const DefaultSessionCookieName

+ const DefaultSessionExpiration

+ const DefaultSessionIdleTimeout

+ const ErrInvalidCleanupIntervalSeconds

+ const ErrInvalidExpirationSeconds

+ const ErrInvalidIdleTimeoutSeconds

+ const ErrInvalidSameSite

+ const ErrInvalidSigningAlgorithm

+ const ErrJWTSigningKey

+ const ErrSessionExpired

+ const ErrSessionNotFound

+ var ErrJWTExpired = errors.New("JWT token expired")

+ var ErrJWTInvalid = errors.New("invalid JWT token")

+ var ErrJWTNotFound = errors.New("JWT token not found")

+ func Delete(c *gin.Context, key string)

+ func Flash(c *gin.Context, key string, value interface{})

+ func FlashString(c *gin.Context, key, value string)

+ func GetBool(c *gin.Context, key string) (bool, bool)

+ func GetFlash(c *gin.Context, key string) (interface{}, bool)

+ func GetFlashString(c *gin.Context, key string) (string, bool)

+ func GetInt(c *gin.Context, key string) (int, bool)

+ func GetString(c *gin.Context, key string) (string, bool)

+ func GetValue(c *gin.Context, key string) (interface{}, bool)

+ func Has(c *gin.Context, key string) bool

+ func MarshallSessionData(session *SessionData) (string, error)

+ func Set(c *gin.Context, key string, value interface{})

+ type Claims struct

+ Data map[string]interface{}

+ type Config struct

+ CleanupIntervalSeconds int

+ CookieName string

+ Domain string

+ ExpirationSeconds int

+ HttpOnly bool

+ IdleTimeoutSeconds int

+ Path string

+ SameSite int

+ Secure bool

+ func NewConfig() *Config

+ func (c *Config) Validate() error

+ type JWTConfig struct

+ Audience string

+ Expiration time.Duration

+ ExpirationSeconds int

+ Issuer string

+ SigningAlgorithm string

+ SigningKey []byte

+ SigningMethod jwt.SigningMethod

+ func NewJWTConfig() *JWTConfig

+ func (c *JWTConfig) Validate() error

+ type JWTManager struct

+ func NewJWTManager(config *JWTConfig, logger *log.Logger) (*JWTManager, error)

+ func (m *JWTManager) Generate(sessionID string, sessionData *SessionData) (string, error)

+ func (m *JWTManager) Get(tokenString string) (*SessionData, error)

+ func (m *JWTManager) NewSession() (*SessionData, string)

+ func (m *JWTManager) Refresh(tokenString string) (string, error)

+ func (m *JWTManager) Set(id string, session *SessionData) error

+ func (m *JWTManager) Validate(tokenString string) (*Claims, error)

+ type JWTSessionManager struct

+ func NewJWTSessionManager(manager *JWTManager) *JWTSessionManager

+ func (m *JWTSessionManager) Clear(c *gin.Context)

+ func (m *JWTSessionManager) Middleware() gin.HandlerFunc

+ func (m *JWTSessionManager) Regenerate(c *gin.Context)

+ type SessionData struct

+ Created time.Time

+ ID string

+ LastAccessed time.Time

+ Values map[string]interface{}

+ func Get(c *gin.Context) *SessionData

+ func SessionDataFromClaims(claims *Claims) *SessionData

+ func UnmarshallSessionData(data string) (*SessionData, error)

+ type SessionManager struct

+ func NewManager(store *Store, config *Config, logger *log.Logger) *SessionManager

+ func (m *SessionManager) Clear(c *gin.Context)

+ func (m *SessionManager) Middleware() gin.HandlerFunc

+ func (m *SessionManager) Regenerate(c *gin.Context)

+ type Store struct

+ func NewStore(config *Config, backend kv.KV, logger *log.Logger) *Store

+ func (s *Store) Close()

+ func (s *Store) Delete(id string) error

+ func (s *Store) Generate() (*SessionData, string)

+ func (s *Store) Get(id string) (*SessionData, error)

+ func (s *Store) Set(id string, session *SessionData) error

+ func (s *Store) StartCleanup()

+ func (s *Store) StopCleanup()

Other modules containing this package

github.com/oddbit-project/blueprint/provider/httpserver

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL