bitbucket.org/lygo/lygo_ext_auth0

LyGo auth0

LyGo Auth0 is a library to help developers play with JWT.

Note

Internal JWT implementation is a porting of original go-jwt library.

JWT.io has a great introduction to JSON Web Tokens.

Example

Create and Validate a Token

package main

import (
    "bitbucket.org/lygo/lygo_ext_auth0/jwt"
    "bitbucket.org/lygo/lygo_ext_auth0/jwt/signing"
    "bitbucket.org/lygo/lygo_ext_auth0/jwt/elements"
    "errors"
    "fmt"
    "io/ioutil"
    "time"
)

var hmacSampleSecret []byte

func main(){
    nbf := time.Date(2015, 10, 10, 12, 0, 0, 0, time.UTC).Unix()

	// Create a new token object, specifying signing method and the claims
	// you would like it to contain.
	token := jwt.NewWithClaims(signing.SigningMethodHS256, elements.MapClaims{
		"foo": "bar",
		"nbf": nbf,
		"uid":"USER_1234",
	})

	// Sign and get the complete encoded token as a string using the secret
	tokenString, err := token.SignedString(hmacSampleSecret)

	fmt.Println(tokenString, err)

	// Parse takes the token string and a function for looking up the key. The latter is especially
	// useful if you use multiple keys for your application.  The standard is to use 'kid' in the
	// head of the token to identify which key to use, but the parsed token (head and claims) is provided
	// to the callback, providing flexibility.
	parsed, err := jwt.Parse(tokenString, func(token *elements.Token) (interface{}, error) {
		// Don't forget to validate the alg is what you expect:
		if _, ok := token.Method.(*signing.SigningMethodHMAC); !ok {
			return nil, fmt.Errorf("Unexpected signing method: %v", token.Header["alg"])
		}

		// hmacSampleSecret is a []byte containing your secret, e.g. []byte("my_secret_key")
		return hmacSampleSecret, nil
	})

	if nil==parsed{
		panic(errors.New("TOKEN not parsed!"))
	}

	if claims, ok := parsed.Claims.(elements.MapClaims); ok && parsed.Valid {
		foo := claims["foo"].(string)
		uid := claims["uid"].(string)
		if foo != "bar" {
			panic(errors.New("foo is not 'bar'"))
		}
		fmt.Println(foo, claims["nbf"], uid)
	}
}
 
func init() {
	// Load sample key data
	if keyData, e := ioutil.ReadFile("./_test/test/hmacTestKey"); e == nil {
		hmacSampleSecret = keyData
	} else {
		panic(e)
	}
}
   

How to Use

To use just call:

go get -u bitbucket.org/lygo/lygo_ext_auth0

Dependencies

go get -u bitbucket.org/lygo/lygo_commons

auth0 Dependencies

auth0 require a persistence layer to store tokens and login data.

go get -u github.com/arangodb/go-driver
go get -u github.com/arangodb/go-driver/http

go get -u bitbucket.org/lygo/lygo_ext_dbbolt

Versioning

Sources are versioned using git tags:

git tag v0.1.13
git push origin v0.1.13