auth

README

negroni-auth

Negroni middleware/handler for http basic authentication forked from martini-contrib/auth.

API Reference

Usage

import (
  "github.com/codegangsta/negroni"
  "github.com/nabeken/negroni-auth"
)

func main() {
  m := negroni.New()
  // authenticate every request
  m.UseHandler(auth.Basic("username", "secretpassword"))
  m.Run()
}

Authors

• Jeremy Saenz
• Brendon Murphy
• nabeken

Documentation

Overview

Package auth implements Basic authentication.

Index

• Variables
• func Basic(userid, password string) negroni.HandlerFunc
• func CacheBasic(datastore datastore.Datastore, cacheExpireTime, cachePurseTime time.Duration) negroni.HandlerFunc
• func CacheBasicDefault(datastore datastore.Datastore) negroni.HandlerFunc
• func Hash(password string) ([]byte, error)
• func NewBasic(datastore datastore.Datastore) negroni.HandlerFunc
• func NewSimpleBasic(userId, password string) (*datastore.Simple, error)
• func SecureCompare(given string, actual string) bool

Variables

var BcryptCost = 10

See https://godoc.org/golang.org/x/crypto/bcrypt#pkg-constants for more details.

Functions

func Basic

func Basic(userid, password string) negroni.HandlerFunc

Basic returns a negroni.HandlerFunc that authenticates via Basic Auth. Writes a http.StatusUnauthorized if authentication fails.

func CacheBasic

func CacheBasic(datastore datastore.Datastore, cacheExpireTime, cachePurseTime time.Duration) negroni.HandlerFunc

CacheBasic returns a negroni.HandlerFunc that authenticates via Basic auth using cache. Writes a http.StatusUnauthorized if authentication fails.

func CacheBasicDefault

func CacheBasicDefault(datastore datastore.Datastore) negroni.HandlerFunc

CacheBasicDefault returns a negroni.HandlerFunc that authenticates via Basic auth using cache. with default cache configuration. Writes a http.StatusUnauthorized if authentication fails.

func Hash

func Hash(password string) ([]byte, error)

Hash returns a hashed password.

func NewBasic

func NewBasic(datastore datastore.Datastore) negroni.HandlerFunc

NewBasic returns a negroni.HandlerFunc that authenticates via Basic auth using data store. Writes a http.StatusUnauthorized if authentication fails.

func NewSimpleBasic

func NewSimpleBasic(userId, password string) (*datastore.Simple, error)

NewSimpleBasic returns *datastore.Simple built from userid, password.

func SecureCompare

func SecureCompare(given string, actual string) bool

SecureCompare performs a constant time compare of two strings to limit timing attacks.