cognito

README

cognito-go

JWT Authentication with AWS Cognito in Go + Gin Middleware

Usage

Single

import "github.com/leemeichin/cognito-go"

c, _ := cognito.NewCognito("ap-southeast-2", "cognito-app", "client-id")
token, err := c.VerifyToken("abc")

Gin Middleware

import (
  "github.com/leemeichin/cognito-go"
  "github.com/gin-gonic/gin"
)

c, _ := cognito.NewCognito("ap-southeast-2", "cognito-app", "client-id")
r := gin.New()
r.GET("/protected", c.Authorize(), protectedEndpoint)

Documentation

Index

• Variables
• type Client
  • func NewCognitoClient(region, usePoolId, clientId string) (Client, error)
• type Cognito
  • func (cog *Cognito) Authorize(c *gin.Context)
  • func (c *Cognito) VerifyToken(tokenStr string) (*jwt.Token, error)
• type PublicKey
• type PublicKeys

Variables

var (
	ErrInvalidParam = errors.New("invalid param")
)

Types

type Client

type Client interface {
	VerifyToken(tokenStr string) (*jwt.Token, error)
	Authorize(c *gin.Context)
}

func NewCognitoClient

func NewCognitoClient(region, usePoolId, clientId string) (Client, error)

type Cognito

type Cognito struct {
	// AWS App Client ID
	ClientId string

	// AWS Cognito Issuer
	Iss string

	// Map of JWKs from AWS Cognito
	PublicKeys PublicKeys
}

func (*Cognito) Authorize

func (cog *Cognito) Authorize(c *gin.Context)

func (*Cognito) VerifyToken

func (c *Cognito) VerifyToken(tokenStr string) (*jwt.Token, error)

type PublicKey

type PublicKey struct {
	Alg string `json:"alg"`
	E   string `json:"e"`
	Kid string `json:"kid"`
	Kty string `json:"kty"`
	N   string `json:"n"`
	Use string `json:"use"`
	PEM *rsa.PublicKey
}

type PublicKeys

type PublicKeys map[string]PublicKey