Installation

go get github.com/hiyosi/hawk

Example

// sample serverpackage mainimport ("fmt""time""github.com/hiyosi/hawk""net/http")typecredentialStorestruct{}func (c*credentialStore)GetCredential(idstring) (*hawk.Credential,error) {return&hawk.Credential{ID:id,Key:"werxhqb98rpaxn39848xrunpaw3489ruxnpa98w4rxn",Alg:hawk.SHA256,},nil}vartestCredStore=&credentialStore{}funchawkHandler(w http.ResponseWriter,r*http.Request) {s:=hawk.NewServer(testCredStore)// authenticate client requestcred,err:=s.Authenticate(r)iferr!=nil {w.Header().Set("WWW-Authenticate","Hawk")w.WriteHeader(401)fmt.Println(err)return}opt:=&hawk.Option{TimeStamp:time.Now().Unix(),Ext:"response-specific",}// build server response headerh,_:=s.Header(r,cred,opt)w.Header().Set("Server-Authorization",h)w.WriteHeader(200)w.Write([]byte("Hello, "+cred.ID))}funcmain() {http.HandleFunc("/resource",hawkHandler)http.ListenAndServe(":8080",nil)}

// sample clientpackage mainimport ("fmt""time""github.com/hiyosi/hawk""io/ioutil""net/http")funcmain() {c:=hawk.NewClient(&hawk.Credential{ID:"123456",Key:"werxhqb98rpaxn39848xrunpaw3489ruxnpa98w4rxn",Alg:hawk.SHA256,},&hawk.Option{TimeStamp:time.Now().Unix(),Nonce:"3hOHpR",Ext:"some-app-data",},)// build request headerheader,_:=c.Header("GET","http://localhost:8080/resource")req,_:=http.NewRequest("GET","http://localhost:8080/resource",nil)req.Header.Set("Authorization",header)client:=&http.Client{}resp,err:=client.Do(req)iferr!=nil {fmt.Println(err)return}deferresp.Body.Close()// authenticate server response.result,err:=c.Authenticate(resp)iferr!=nil {fmt.Println("Server Authentication Failure")}fmt.Println("Server Authentication: ",result)b,err:=ioutil.ReadAll(resp.Body)iferr==nil {fmt.Println(string(b))}}

// serverb:=hawk.NewBewitConfig(&hawk.Credential{ID:"123456",Key:"werxhqb98rpaxn39848xrunpaw3489ruxnpa98w4rxn",Alg:hawk.SHA256,},10*time.Minute,)bewit:=b.GetBewit("http://localhost:8080/temp/resource",nil)fmt.Println(bewit)

// serverfunchawkBewitHandler(w http.ResponseWriter,r*http.Request) {s:=hawk.NewServer(testCredStore)cred,err:=s.AuthenticateBewit(r)iferr!=nil {w.Header().Set("WWW-Authenticate","Hawk")w.WriteHeader(401)fmt.Println(err)return}w.WriteHeader(200)w.Write([]byte("Access Allow, "+cred.ID))}

s:=hawk.NewServer(testCredStore)s.AuthOption=&hawk.AuthOption{CustomHostNameHeader:"X-Forwarded-Host",}

    s := hawk.NewServer(testCredStore)    s.AuthOption = &hawk.AuthOption{    CustomHostPort: "b.example.com:8888",}

Contribution

License