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

session

package module

Go to main page

Versions in this module

v1

v1.3.0

Mar 6, 2026

v1.2.0

Feb 4, 2026

v1.1.2

Feb 1, 2026

v1.1.1

Feb 1, 2026

v1.1.0

Jan 27, 2026

Changes in this version

+ type KVManager struct

+ func NewKVManager(store Store, defaultTTL time.Duration) *KVManager

+ func (m *KVManager) Create(ctx context.Context, data map[string]interface{}, ttl time.Duration) (string, error)

+ func (m *KVManager) Delete(ctx context.Context, id string) error

+ func (m *KVManager) Exists(ctx context.Context, id string) (bool, error)

+ func (m *KVManager) Get(ctx context.Context, id string) (*KVSessionRecord, error)

+ func (m *KVManager) Refresh(ctx context.Context, id string, ttl time.Duration) error

+ func (m *KVManager) Set(ctx context.Context, id string, data map[string]interface{}, ttl time.Duration) error

+ type KVSessionRecord struct

+ CreatedAt time.Time

+ Data map[string]interface{}

+ ExpiresAt time.Time

+ ID string

+ type RedisStore struct

+ func NewRedisStore(client *redis.Client, keyPrefix string) *RedisStore

+ func (s *RedisStore) Create(ctx context.Context, data map[string]interface{}, ttl time.Duration) (string, error)

+ func (s *RedisStore) Delete(ctx context.Context, id string) error

+ func (s *RedisStore) Exists(ctx context.Context, id string) (bool, error)

+ func (s *RedisStore) Get(ctx context.Context, id string) (*KVSessionRecord, error)

+ func (s *RedisStore) Set(ctx context.Context, id string, data map[string]interface{}, ttl time.Duration) error

+ type Store interface

+ Create func(ctx context.Context, data map[string]interface{}, ttl time.Duration) (id string, err error)

+ Delete func(ctx context.Context, id string) error

+ Exists func(ctx context.Context, id string) (bool, error)

+ Get func(ctx context.Context, id string) (*KVSessionRecord, error)

+ Set func(ctx context.Context, id string, data map[string]interface{}, ttl time.Duration) error

v1.0.0

Jan 26, 2026

Changes in this version

+ const KeyAMR

+ const KeyAuthenticated

+ const KeyCreatedAt

+ const KeyEmail

+ const KeyLastAccess

+ const KeyPhone

+ const KeyScopes

+ const KeyUserID

+ func AddAMR(session *fibersession.Session, method string)

+ func Authenticate(session *fibersession.Session) error

+ func CreateCookie(config Config, sessionID string) *fiber.Cookie

+ func GetAMR(session *fibersession.Session) []string

+ func GetCreatedAt(session *fibersession.Session) time.Time

+ func GetEmail(session *fibersession.Session) string

+ func GetLastAccess(session *fibersession.Session) time.Time

+ func GetPhone(session *fibersession.Session) string

+ func GetScopes(session *fibersession.Session) []string

+ func GetUserID(session *fibersession.Session) string

+ func HasAMR(session *fibersession.Session, method string) bool

+ func HasScope(session *fibersession.Session, scope string) bool

+ func IsAuthenticated(session *fibersession.Session) bool

+ func SetAMR(session *fibersession.Session, amr []string)

+ func SetEmail(session *fibersession.Session, email string)

+ func SetPhone(session *fibersession.Session, phone string)

+ func SetScopes(session *fibersession.Session, scopes []string)

+ func SetUserID(session *fibersession.Session, userID string)

+ func Unauthenticate(session *fibersession.Session) error

+ func UpdateLastAccess(session *fibersession.Session)

+ type Config struct

+ CookieDomain string

+ CookieName string

+ CookiePath string

+ Expiration time.Duration

+ HTTPOnly bool

+ KeyPrefix string

+ SameSite string

+ Secure bool

+ func DefaultConfig() Config

+ func (c Config) Validate() error

+ func (c Config) WithCookieDomain(domain string) Config

+ func (c Config) WithCookieName(name string) Config

+ func (c Config) WithCookiePath(path string) Config

+ func (c Config) WithExpiration(exp time.Duration) Config

+ func (c Config) WithHTTPOnly(httpOnly bool) Config

+ func (c Config) WithKeyPrefix(prefix string) Config

+ func (c Config) WithSameSite(sameSite string) Config

+ func (c Config) WithSecure(secure bool) Config

+ type Manager struct

+ func NewManager(storage Storage, config Config) *Manager

+ func (m *Manager) CreateSession(id string) *SessionData

+ func (m *Manager) DeleteSession(id string) error

+ func (m *Manager) FiberSessionConfig() fibersession.Config

+ func (m *Manager) GetConfig() Config

+ func (m *Manager) GetStorage() Storage

+ func (m *Manager) LoadSession(id string) (*SessionData, error)

+ func (m *Manager) SaveSession(session *SessionData) error

+ func (m *Manager) TouchSession(session *SessionData) error

+ type MemoryStorage struct

+ func NewMemoryStorage(keyPrefix string, gcInterval time.Duration) *MemoryStorage

+ func (s *MemoryStorage) Close() error

+ func (s *MemoryStorage) Delete(key string) error

+ func (s *MemoryStorage) Get(key string) ([]byte, error)

+ func (s *MemoryStorage) Len() int

+ func (s *MemoryStorage) Reset() error

+ func (s *MemoryStorage) Set(key string, val []byte, exp time.Duration) error

+ type RedisStorage struct

+ func NewRedisStorage(client *redis.Client, keyPrefix string) *RedisStorage

+ func NewRedisStorageFromConfig(addr, password string, db int, keyPrefix string) (*RedisStorage, error)

+ func (s *RedisStorage) Close() error

+ func (s *RedisStorage) Delete(key string) error

+ func (s *RedisStorage) Exists(key string) (bool, error)

+ func (s *RedisStorage) Expire(key string, exp time.Duration) error

+ func (s *RedisStorage) Get(key string) ([]byte, error)

+ func (s *RedisStorage) GetClient() *redis.Client

+ func (s *RedisStorage) GetKeyPrefix() string

+ func (s *RedisStorage) GetTTL(key string) (time.Duration, error)

+ func (s *RedisStorage) Reset() error

+ func (s *RedisStorage) Set(key string, val []byte, exp time.Duration) error

+ type SessionData struct

+ AMR []string

+ Authenticated bool

+ CreatedAt time.Time

+ Data map[string]interface{}

+ Email string

+ ExpiresAt time.Time

+ ID string

+ LastAccessedAt time.Time

+ Phone string

+ Scopes []string

+ UserID string

+ func NewSessionData(id string, expiration time.Duration) *SessionData

+ func (s *SessionData) AddAMR(method string)

+ func (s *SessionData) AddScope(scope string)

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

+ func (s *SessionData) GetValue(key string) (interface{}, bool)

+ func (s *SessionData) HasAMR(method string) bool

+ func (s *SessionData) HasScope(scope string) bool

+ func (s *SessionData) IsAuthenticated() bool

+ func (s *SessionData) IsExpired() bool

+ func (s *SessionData) SetValue(key string, value interface{})

+ func (s *SessionData) Touch()

+ type Storage interface

+ Close func() error

+ Delete func(key string) error

+ Get func(key string) ([]byte, error)

+ Reset func() error

+ Set func(key string, val []byte, exp time.Duration) error

+ func MustNewStorage(cfg StorageConfig) Storage

+ func NewStorage(cfg StorageConfig) (Storage, error)

+ func NewStorageFromEnv(redisEnabled bool, redisAddr, redisPassword string, redisDB int, ...) (Storage, error)

+ type StorageConfig struct

+ KeyPrefix string

+ MemoryGCInterval time.Duration

+ RedisAddr string

+ RedisClient *redis.Client

+ RedisDB int

+ RedisPassword string

+ Type StorageType

+ func DefaultStorageConfig() StorageConfig

+ func (c StorageConfig) WithKeyPrefix(prefix string) StorageConfig

+ func (c StorageConfig) WithMemoryGCInterval(interval time.Duration) StorageConfig

+ func (c StorageConfig) WithRedisAddr(addr string) StorageConfig

+ func (c StorageConfig) WithRedisClient(client *redis.Client) StorageConfig

+ func (c StorageConfig) WithRedisDB(db int) StorageConfig

+ func (c StorageConfig) WithRedisPassword(password string) StorageConfig

+ func (c StorageConfig) WithType(t StorageType) StorageConfig

+ type StorageType string

+ const StorageTypeMemory

+ const StorageTypeRedis