Skip to content
forked from gorilla/sessions

Package gorilla/sessions provides cookie and filesystem sessions and infrastructure for custom session backends.

License

Notifications You must be signed in to change notification settings

go-saas/sessions

This branch is 7 commits ahead of, 12 commits behind gorilla/sessions:main.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

74c894c · Nov 27, 2023
Nov 27, 2023
Nov 5, 2023
Jul 23, 2023
Jul 23, 2023
Jul 25, 2023
Jul 23, 2023
Nov 27, 2023
Feb 7, 2022
Feb 7, 2022
Feb 7, 2022
Sep 28, 2018
Jan 5, 2020
Nov 27, 2023
Nov 5, 2023
Mar 27, 2022
Feb 26, 2016
Feb 7, 2022
Feb 7, 2022
Mar 27, 2022
Nov 27, 2023
Nov 27, 2023
Mar 27, 2022

Repository files navigation

This fork remove the dependency on http.Request to adapt gateway usage

sessions

testing codecov godoc sourcegraph

Gorilla Logo

gorilla/sessions provides cookie and filesystem sessions and infrastructure for custom session backends.

The key features are:

  • Simple API: use it as an easy way to set signed (and optionally encrypted) cookies.
  • Built-in backends to store sessions in cookies or the filesystem.
  • Flash messages: session values that last until read.
  • Convenient way to switch session persistency (aka "remember me") and set other attributes.
  • Mechanism to rotate authentication and encryption keys.
  • Multiple sessions per request, even using different backends.
  • Interfaces and infrastructure for custom session backends: sessions from different stores can be retrieved and batch-saved using a common API.

Let's start with an example that shows the sessions API in a nutshell:

	import (
		"net/http"
		"github.com/gorilla/sessions"
	)

	// Note: Don't store your key in your source code. Pass it via an
	// environmental variable, or flag (or both), and don't accidentally commit it
	// alongside your code. Ensure your key is sufficiently random - i.e. use Go's
	// crypto/rand or securecookie.GenerateRandomKey(32) and persist the result.
	var store = sessions.NewCookieStore([]byte(os.Getenv("SESSION_KEY")))

	func MyHandler(w http.ResponseWriter, r *http.Request) {
		// Get a session. We're ignoring the error resulted from decoding an
		// existing session: Get() always returns a session, even if empty.
		session, _ := store.Get(r, "session-name")
		// Set some session values.
		session.Values["foo"] = "bar"
		session.Values[42] = 43
		// Save it before we write to the response/return from the handler.
		err := session.Save(r, w)
		if err != nil {
			http.Error(w, err.Error(), http.StatusInternalServerError)
			return
		}
	}

First we initialize a session store calling NewCookieStore() and passing a secret key used to authenticate the session. Inside the handler, we call store.Get() to retrieve an existing session or create a new one. Then we set some session values in session.Values, which is a map[interface{}]interface{}. And finally we call session.Save() to save the session in the response.

More examples are available on the Gorilla website.

Store Implementations

Other implementations of the sessions.Store interface:

License

BSD licensed. See the LICENSE file for details.

About

Package gorilla/sessions provides cookie and filesystem sessions and infrastructure for custom session backends.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 97.7%
  • Makefile 2.3%