Documentation
¶
Index ¶
Examples ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Alg ¶ added in v0.6.0
type Alg[S SigningKey, V VerifyKey, M SigningMethod] interface { SecretKeyFunc(uid string) (S, error) VerifyKeyFunc(uid string) (V, error) SigningMethod() M }
type Builder ¶ added in v0.6.0
type Builder[ S SigningKey, V VerifyKey, M SigningMethod, T Alg[S, V, M], ] struct { // contains filtered or unexported fields }
func InstanceBuilder ¶ added in v0.6.0
func InstanceBuilder[ S SigningKey, V VerifyKey, M SigningMethod, T Alg[S, V, M], ](alg T) *Builder[S, V, M, T]
InstanceBuilder returns a Builder instance.
func (*Builder[S, V, M, T]) SetRefreshTimeout ¶ added in v0.6.0
SetRefreshTimeout sets the refresh timeout for the Instance.
type ECDSA ¶ added in v0.6.0
type ECDSA struct {
*jwt.SigningMethodECDSA
// contains filtered or unexported fields
}
Example ¶
privateKey, err := ecdsa.GenerateKey(elliptic.P256(), rand.Reader)
if err != nil {
panic(err)
}
instance := InstanceBuilder(NewECDSA(
jwt.SigningMethodES256,
func(uid string) (*ecdsa.PrivateKey, error) {
return privateKey, nil
},
func(uid string) (*ecdsa.PublicKey, error) {
return &privateKey.PublicKey, nil
}),
).Build()
token, err := instance.Sign("user")
if err != nil {
panic(err)
}
uid, err := instance.CheckToken(token)
if err != nil {
panic(err)
}
fmt.Println(uid)
Output: user
func (*ECDSA) SecretKeyFunc ¶ added in v0.6.0
func (h *ECDSA) SecretKeyFunc(uid string) (*ecdsa.PrivateKey, error)
func (*ECDSA) SigningMethod ¶ added in v0.6.0
func (h *ECDSA) SigningMethod() *jwt.SigningMethodECDSA
type Ed25519 ¶ added in v0.6.0
type Ed25519 struct {
*jwt.SigningMethodEd25519
// contains filtered or unexported fields
}
Example ¶
publicKey, privateKey, err := ed25519.GenerateKey(rand.Reader)
if err != nil {
panic(err)
}
instance := InstanceBuilder(NewEd25519(
func(uid string) (ed25519.PrivateKey, error) {
return privateKey, nil
},
func(uid string) (ed25519.PublicKey, error) {
return publicKey, nil
}),
).Build()
token, err := instance.Sign("user")
if err != nil {
panic(err)
}
uid, err := instance.CheckToken(token)
if err != nil {
panic(err)
}
fmt.Println(uid)
Output: user
func NewEd25519 ¶ added in v0.6.0
func (*Ed25519) SecretKeyFunc ¶ added in v0.6.0
func (h *Ed25519) SecretKeyFunc(uid string) (ed25519.PrivateKey, error)
func (*Ed25519) SigningMethod ¶ added in v0.6.0
func (h *Ed25519) SigningMethod() *jwt.SigningMethodEd25519
type HMAC ¶ added in v0.6.0
type HMAC struct {
*jwt.SigningMethodHMAC
// contains filtered or unexported fields
}
Example ¶
instance := InstanceBuilder(NewHMAC(
jwt.SigningMethodHS256,
func(uid string) ([]byte, error) {
return []byte("secret"), nil
}),
).Build()
token, err := instance.Sign("user")
if err != nil {
panic(err)
}
uid, err := instance.CheckToken(token)
if err != nil {
panic(err)
}
fmt.Println(uid)
Output: user
func (*HMAC) SecretKeyFunc ¶ added in v0.6.0
func (*HMAC) SigningMethod ¶ added in v0.6.0
func (h *HMAC) SigningMethod() *jwt.SigningMethodHMAC
type ITokenManager ¶ added in v0.6.2
type ITokenManager interface {
// SignWithClaims signs the token with the given claims.
SignWithClaims(uid string, claims map[string]any) (token string, err error)
// ParseToken parses the token string and returns a jwt.Token and an error.
ParseToken(token string) (*jwt.Token, error)
// RefreshToken accepts a valid token and
// returns a new token with new expire time.
RefreshToken(token string) (newToken string, err error)
}
type Instance ¶ added in v0.5.0
type Instance struct {
ITokenManager
}
Example ¶
package main
import (
"fmt"
"net/http"
"time"
"github.com/emicklei/go-restful/v3"
"github.com/golang-jwt/jwt/v5"
"github.com/tuotoo/biu/auth"
"github.com/tuotoo/biu/box"
)
func main() {
instance := auth.InstanceBuilder(
auth.NewHMAC(
jwt.SigningMethodHS256,
func(userID string) ([]byte, error) {
return []byte("hello world"), nil
}),
).SetTimeout(time.Second * 4).
SetRefreshTimeout(time.Second * 5).Build()
token, _ := instance.Sign("user")
ctx := &box.Ctx{
Request: &restful.Request{
Request: &http.Request{
Header: map[string][]string{
"Authorization": {token},
},
},
},
}
u1, err := ctx.IsLogin(instance)
if err != nil {
panic(err)
}
fmt.Println(u1)
u2, err := instance.CheckToken(token)
if err != nil {
panic(err)
}
fmt.Println(u2)
time.Sleep(time.Second * 2)
newToken, err := instance.RefreshToken(token)
if err != nil {
panic(err)
}
_, err = instance.CheckToken(newToken)
if err != nil {
panic(err)
}
time.Sleep(time.Second * 3)
// token is expired, newToken is still valid
_, err = ctx.IsLogin(instance)
fmt.Println(err != nil)
_, err = instance.CheckToken(token)
fmt.Println(err != nil)
_, err = instance.CheckToken(newToken)
if err != nil {
panic(err)
}
time.Sleep(time.Second)
// cant refresh token if refresh timeout is reached
_, err = instance.RefreshToken(newToken)
fmt.Println(err != nil)
ctx2 := &box.Ctx{
Request: &restful.Request{
Request: &http.Request{
Header: map[string][]string{
"Authorization": {"wtf"},
},
},
},
}
_, err = ctx2.IsLogin(instance)
fmt.Println(err != nil)
}
Output: user user true true true true
func (*Instance) CheckToken ¶ added in v0.5.0
CheckToken accept a jwt token and returns the uid in token.
type RSA ¶ added in v0.6.0
type RSA struct {
*jwt.SigningMethodRSA
// contains filtered or unexported fields
}
Example ¶
privateKey, err := rsa.GenerateKey(rand.Reader, 2048)
if err != nil {
panic(err)
}
instance := InstanceBuilder(NewRSA(jwt.SigningMethodRS256,
func(uid string) (*rsa.PrivateKey, error) {
return privateKey, nil
},
func(uid string) (*rsa.PublicKey, error) {
return &privateKey.PublicKey, nil
}),
).Build()
token, err := instance.Sign("user")
if err != nil {
panic(err)
}
uid, err := instance.CheckToken(token)
if err != nil {
panic(err)
}
fmt.Println(uid)
Output: user
func (*RSA) SecretKeyFunc ¶ added in v0.6.0
func (h *RSA) SecretKeyFunc(userID string) (*rsa.PrivateKey, error)
func (*RSA) SigningMethod ¶ added in v0.6.0
func (h *RSA) SigningMethod() *jwt.SigningMethodRSA
type RSAPSS ¶ added in v0.6.0
type RSAPSS struct {
*jwt.SigningMethodRSAPSS
// contains filtered or unexported fields
}
Example ¶
privateKey, err := rsa.GenerateKey(rand.Reader, 2048)
if err != nil {
panic(err)
}
instance := InstanceBuilder(NewRSAPSS(jwt.SigningMethodPS256,
func(uid string) (*rsa.PrivateKey, error) {
return privateKey, nil
},
func(uid string) (*rsa.PublicKey, error) {
return &privateKey.PublicKey, nil
}),
).Build()
token, err := instance.Sign("user")
if err != nil {
panic(err)
}
uid, err := instance.CheckToken(token)
if err != nil {
panic(err)
}
fmt.Println(uid)
Output: user
func (*RSAPSS) SecretKeyFunc ¶ added in v0.6.0
func (h *RSAPSS) SecretKeyFunc(userID string) (*rsa.PrivateKey, error)
func (*RSAPSS) SigningMethod ¶ added in v0.6.0
func (h *RSAPSS) SigningMethod() *jwt.SigningMethodRSAPSS
type SigningKey ¶ added in v0.6.0
type SigningKey interface {
[]byte | *ecdsa.PrivateKey | ed25519.PrivateKey | *rsa.PrivateKey
}
type SigningMethod ¶ added in v0.6.0
type SigningMethod interface {
jwt.SigningMethod
}
type TokenManager ¶ added in v0.6.1
type TokenManager[ S SigningKey, V VerifyKey, M SigningMethod, T Alg[S, V, M], ] struct { // contains filtered or unexported fields }
func (*TokenManager[S, V, M, T]) ParseToken ¶ added in v0.6.1
func (i *TokenManager[S, V, M, T]) ParseToken(token string) (*jwt.Token, error)
ParseToken parse a token string.
func (*TokenManager[S, V, M, T]) RefreshToken ¶ added in v0.6.1
func (i *TokenManager[S, V, M, T]) RefreshToken(token string) (newToken string, err error)
RefreshToken accepts a valid token and returns a new token with new expire time.
func (*TokenManager[S, V, M, T]) SignWithClaims ¶ added in v0.6.1
func (i *TokenManager[S, V, M, T]) SignWithClaims(uid string, claims map[string]any) (token string, err error)
SignWithClaims signs the token with the given claims.
Click to show internal directories.
Click to hide internal directories.