Skip to main content
Version: v2.x

Encrypt Cookie

Encrypt middleware for Fiber which encrypts cookie values. Note: this middleware does not encrypt cookie names.


// Intitializes the middleware
func New(config ...Config) fiber.Handler

// Returns a random 32 character long string
func GenerateKey() string


Import the middleware package that is part of the Fiber web framework

import (

After you initiate your Fiber app, you can use the following possibilities:

// Provide a minimal config
// `Key` must be a 32 character string. It's used to encrypt the values, so make sure it is random and keep it secret.
// You can run `openssl rand -base64 32` or call `encryptcookie.GenerateKey()` to create a random key for you.
// Make sure not to set `Key` to `encryptcookie.GenerateKey()` because that will create a new key every run.
Key: "secret-thirty-2-character-string",

// Get / reading out the encrypted cookie
app.Get("/", func(c *fiber.Ctx) error {
return c.SendString("value=" + c.Cookies("test"))

// Post / create the encrypted cookie
app.Post("/", func(c *fiber.Ctx) error {
Name: "test",
Value: "SomeThing",
return nil


Nextfunc(*fiber.Ctx) boolNext defines a function to skip this middleware when returned true.nil
Except[]stringArray of cookie keys that should not be encrypted.[]
KeystringBase64 encoded unique key to encode & decode cookies. Required. Key length should be 32 characters.(No default, required field)
Encryptorfunc(decryptedString, key string) (string, error)Custom function to encrypt cookies.EncryptCookie
Decryptorfunc(encryptedString, key string) (string, error)Custom function to decrypt cookies.DecryptCookie

Default Config

var ConfigDefault = Config{
Next: nil,
Except: []string{"csrf_"},
Key: "",
Encryptor: EncryptCookie,
Decryptor: DecryptCookie,

Normally, encryptcookie middleware skips csrf_ cookies. However, it won't work when you use custom cookie names for CSRF. You should update Except config to avoid this problem. For example:

Key: "secret-thirty-2-character-string",
Except: []string{"csrf_1"}, // exclude CSRF cookie
KeyLookup: "form:test",
CookieName: "csrf_1",
CookieHTTPOnly: true,