doc: proposed structure for documentation => one place to see them all. Add in doc/readme.md all the source for documentation include emissary-agent

README.md

@@ -16,6 +16,10 @@ Download the pre-compiled binaries from the [releases page](https://forge.cadole
 
 See [`doc`](./doc/README.md)
 
+## Avancée
+
+See [TODO](./doc/fr/TODO.md)
+
 ## Licence & mentions
 
 [AGPL-3.0](https://www.gnu.org/licenses/agpl-3.0.html#license-text)

doc/README.md

@@ -8,6 +8,35 @@
 - (FR) - [Déployer un serveur mandataire inverse sur un agent](./tutorials/fr/deploy-reverse-proxy.md)
 - (FR) - [Déployer une configuration UCI personnalisée sur un agent](./tutorials/fr/deploy-uci-configuration.md)
 
+Emplacement des différentes documentation pour installation emissary.
+
+- (FR) -[Différentes méthodes pour installer emissary](./tutorials/fr/install-emmissary-only.md)
+
+## Emissary-agent
+
+### borne
+
+- [banana-bpi](https://forge.cadoles.com/arcad/emissary-firmware/src/branch/bananapi-r3/doc/Hardware-Sheet/banana-rpi-sheet.md)
+- raspberry (a venir)
+- linksys (a venir)
+
+### BUILD
+
+- [Compiler un firmware](https://forge.cadoles.com/arcad/emissary-firmware/src/branch/master/doc/tutorials/firmware-compilation.md)
+  - Compiler un firmware préconfiguré
+  - Créer une nouvelle cible de construction
+- [flasher une borne](https://forge.cadoles.com/arcad/emissary-firmware/src/branch/bananapi-r3/doc/tutorials/device-flashing.md)
+
+## DEBUG
+
+### emissary-server
+
+> TODO
+
+### emissary-agent
+
+> TODO
+
 ## References
 
 ### Specifications

doc/fr/TODO.md

@@ -0,0 +1,54 @@
+# document de suivi des évolutions et test
+
+## tableau de suivi
+
+| etat | action | détail |
+| :- | :-: | :- |
+| OK | construction d'un firmware (bpi-r3) | #valide2023-08-02 |
+| OK | documentation construction d'un firmware pour les autres version | #valide2023-08-02 |
+| OK | installation d'un firmware sur bananapi bpi-r3 | #valide2023-08-16 |
+| OK | validation firmware pour bananapi bpi-r3 | #valide2023-08-18 |
+| OK | test appairage banana pi bpi-r3 | #valide2023-08 |
+| OK | validation firmware pour bananapi bpi-r3 | #valide |
+| EnCours | pousser dans la branche master construction d'un firmware (bpi-r3) | - |
+| EnCours | installation d'un firmware sur raspberry3 | - |
+| EnCours | validation firmware pour raspberry3 | fonctionnement avant apparaige |
+| NEXT | test appairage raspberry3 | implique réalisation d'une doc |
+| NEXT | validation firmware pour raspberry3 | fonctionnement après apparaige |
+| NEXT | test appairage pour raspberry3 | fonctionnement après apparaige |
+| NEXT | validation/réalisation documentation | - |
+| NOK | construction d'un firmware sur lynksys | - |
+| NOK | installation d'un firmware sur lynksys | - |
+| NOK | - | - |
+| NOK | - | - |
+| NOK | chaîne de validation avant/après apparairage | implique réalisation d'une doc |
+| Server| SERVER | server |
+| OK | installation emissary server en locale | via tar.gz #valide2023-08-02 |
+| OK | validation installation du server en locale | #valide2023-08 |
+| OK | installation emissary server sur ubuntu mint 21.0 | via paquet .deb #valide2023-08-02 |
+| OK | installation emissary server sur ubuntu 22.04 | via paquet .deb #valide2023-08-02 |
+| OK | validation installation du server | #valide2023-08 |
+| OK | appairage borne (bpi-r3) sur emissary-server (ubuntu) | #valide2023-08 |
+| OK | appairage documentation (ubuntu) borne (bpi-r3) | #valide2023-08 |
+| OK | validation ansible | #valide2023-08 alpine3.16 |
+| OK | validation ansible | #valide2023-08 alpine3.18 |
+| OK | validation ansible documentation | #valide2023-08 |
+| OK | appairage borne (bpi-r3) sur emissary-server (alpine 3.16 & 3.18) | #valide2023-08 |
+| OK | appairage documentation (ansible alpine) borne (bpi-r3) | #valide2023-08 |
+| OK | modification conf uci d'une borne | #valide2023-08 |
+| OK | documentation modification conf uci d'une borne | #valide2023-08 |
+| autre | AUTRE | autre |
+| EnCours | relecture doc officiel | implique application des actions mentionné |
+| EnCours | création d'un point de redirection pour toute la documentation |  |
+
+## demande supplémentaire
+
+Stipuler l'émetteur permet de savoir à qui s'adresser pour en discuter.
+
+| STATUS | action | détail | emetteur|
+|:- | :-: | :- | :- |
+installation/debug emissary-server | lseys |
+| Proposition | CODE | script de validation installation/debug emissary-agent | lseys |
+| Proposition | CODE | script de validation 
+| Proposition | DOC | debug/astuce emissary-server | lseys |
+| Proposition | DOC | debug/astuce emissary-agent | lseys |

doc/tutorials/fr/install-emmissary-only.md

@@ -0,0 +1,17 @@
+# installation
+
+processus d'installation
+
+Il y a à ce jours trois méthode différente d'installation !
+
+1. via le paquet.deb disponible sur la forge (pour installation sur un serveur)
+
+    cf : [doc-emissary](./first-steps.md) (chapitre : Installer le serveur Emissary)
+
+2. via l'archive disponible sur la forge (pour installation sur une machine locale a des fin de test ou autre)
+
+    cf : [doc-emissary-firmware](https://forge.cadoles.com/arcad/emissary-firmware/src/branch/master/doc/tutorials/first-steps.md) (chapitre : Récupérer et lancer un serveur Emissary sur sa machine)
+
+3. via ansible (uniquement alpine pour le moment) (cf: [arcad-ansible](https://forge.cadoles.com/arcad/ansible))
+
+    cf : [doc-arcad-ansible](https://forge.cadoles.com/arcad/ansible/src/branch/master/doc/deploy-new-env.md) (Chapitre : Préparation de l'environnement)

go.mod

@@ -7,6 +7,7 @@ require (
 	github.com/Masterminds/sprig/v3 v3.2.3
 	github.com/alecthomas/participle/v2 v2.0.0-beta.5
 	github.com/andreyvit/diff v0.0.0-20170406064948-c7f18ee00883
+	github.com/antonmedv/expr v1.12.7
 	github.com/brutella/dnssd v1.2.6
 	github.com/btcsuite/btcd/btcutil v1.1.3
 	github.com/davecgh/go-spew v1.1.1

go.sum

@@ -149,6 +149,8 @@ github.com/alexflint/go-filemutex v1.1.0/go.mod h1:7P4iRhttt/nUvUOrYIhcpMzv2G6CY
 github.com/andreyvit/diff v0.0.0-20170406064948-c7f18ee00883 h1:bvNMNQO63//z+xNgfBlViaCIJKLlCJ6/fmUseuG0wVQ=
 github.com/andreyvit/diff v0.0.0-20170406064948-c7f18ee00883/go.mod h1:rCTlJbsFo29Kk6CurOXKm700vrz8f0KW0JNfpkRJY/8=
 github.com/antihax/optional v1.0.0/go.mod h1:uupD/76wgC+ih3iEmQUL+0Ugr19nfwCT1kdvxnR2qWY=
+github.com/antonmedv/expr v1.12.7 h1:jfV/l/+dHWAadLwAtESXNxXdfbK9bE4+FNMHYCMntwk=
+github.com/antonmedv/expr v1.12.7/go.mod h1:FPC8iWArxls7axbVLsW+kpg1mz29A1b2M6jt+hZfDkU=
 github.com/apache/arrow/go/arrow v0.0.0-20210818145353-234c94e4ce64/go.mod h1:2qMFB56yOP3KzkB3PbYZ4AlUFg3a88F67TIx5lB/WwY=
 github.com/apache/arrow/go/arrow v0.0.0-20211013220434-5962184e7a30/go.mod h1:Q7yQnSMnLvcXlZ8RV+jwz/6y1rQTqbX6C82SndT52Zs=
 github.com/armon/circbuf v0.0.0-20150827004946-bbbad097214e/go.mod h1:3U/XgcO3hCbHZ8TKRvWD2dDTCfh9M9ya+I9JpbB7O8o=

internal/auth/agent/authenticator.go

@@ -11,7 +11,6 @@ import (
 	"github.com/lestrrat-go/jwx/v2/jws"
 	"github.com/lestrrat-go/jwx/v2/jwt"
 	"github.com/pkg/errors"
-	"gitlab.com/wpetit/goweb/logger"
 )
 
 const DefaultAcceptableSkew = 5 * time.Minute
@@ -23,8 +22,6 @@ type Authenticator struct {
 
 // Authenticate implements auth.Authenticator.
 func (a *Authenticator) Authenticate(ctx context.Context, r *http.Request) (auth.User, error) {
-	ctx = logger.With(r.Context(), logger.F("remoteAddr", r.RemoteAddr))
-
 	authorization := r.Header.Get("Authorization")
 	if authorization == "" {
 		return nil, errors.WithStack(auth.ErrUnauthenticated)

internal/auth/thirdparty/authenticator.go

@@ -8,22 +8,25 @@ import (
 
 	"forge.cadoles.com/Cadoles/emissary/internal/auth"
 	"forge.cadoles.com/Cadoles/emissary/internal/jwk"
+	"github.com/lestrrat-go/jwx/v2/jwt"
 	"github.com/pkg/errors"
-	"gitlab.com/wpetit/goweb/logger"
 )
 
 const DefaultAcceptableSkew = 5 * time.Minute
 
+type (
+	GetKeySet    func(context.Context) (jwk.Set, error)
+	GetTokenRole func(context.Context, jwt.Token) (string, error)
+)
+
 type Authenticator struct {
-	keys           jwk.Set
-	issuer         string
+	getKeySet      GetKeySet
+	getTokenRole   GetTokenRole
 	acceptableSkew time.Duration
 }
 
 // Authenticate implements auth.Authenticator.
 func (a *Authenticator) Authenticate(ctx context.Context, r *http.Request) (auth.User, error) {
-	ctx = logger.With(r.Context(), logger.F("remoteAddr", r.RemoteAddr))
-
 	authorization := r.Header.Get("Authorization")
 	if authorization == "" {
 		return nil, errors.WithStack(auth.ErrUnauthenticated)
@@ -34,37 +37,37 @@ func (a *Authenticator) Authenticate(ctx context.Context, r *http.Request) (auth
 		return nil, errors.WithStack(auth.ErrUnauthenticated)
 	}
 
-	token, err := parseToken(ctx, a.keys, a.issuer, rawToken, a.acceptableSkew)
+	keys, err := a.getKeySet(ctx)
 	if err != nil {
 		return nil, errors.WithStack(err)
 	}
 
-	rawRole, exists := token.Get(keyRole)
-	if !exists {
-		return nil, errors.New("could not find 'thumbprint' claim")
+	token, err := parseToken(ctx, keys, rawToken, a.acceptableSkew)
+	if err != nil {
+		return nil, errors.WithStack(err)
 	}
 
-	role, ok := rawRole.(string)
-	if !ok {
-		return nil, errors.Errorf("unexpected '%s' claim value: '%v'", keyRole, rawRole)
+	rawRole, err := a.getTokenRole(ctx, token)
+	if err != nil {
+		return nil, errors.WithStack(err)
 	}
 
-	if !isValidRole(role) {
-		return nil, errors.Errorf("invalid role '%s'", role)
+	if !isValidRole(rawRole) {
+		return nil, errors.Errorf("invalid role '%s'", rawRole)
 	}
 
 	user := &User{
 		subject: token.Subject(),
-		role:    Role(role),
+		role:    Role(rawRole),
 	}
 
 	return user, nil
 }
 
-func NewAuthenticator(keys jwk.Set, issuer string, acceptableSkew time.Duration) *Authenticator {
+func NewAuthenticator(getKeySet GetKeySet, getTokenRole GetTokenRole, acceptableSkew time.Duration) *Authenticator {
 	return &Authenticator{
-		keys:           keys,
-		issuer:         issuer,
+		getTokenRole:   getTokenRole,
+		getKeySet:      getKeySet,
 		acceptableSkew: acceptableSkew,
 	}
 }

internal/auth/thirdparty/jwt.go

@@ -11,15 +11,13 @@ import (
 	"github.com/pkg/errors"
 )
 
-const keyRole = "role"
-
-func parseToken(ctx context.Context, keys jwk.Set, issuer string, rawToken string, acceptableSkew time.Duration) (jwt.Token, error) {
+func parseToken(ctx context.Context, keys jwk.Set, rawToken string, acceptableSkew time.Duration) (jwt.Token, error) {
 	token, err := jwt.Parse(
 		[]byte(rawToken),
 		jwt.WithKeySet(keys, jws.WithRequireKid(false)),
-		jwt.WithIssuer(issuer),
 		jwt.WithValidate(true),
 		jwt.WithAcceptableSkew(acceptableSkew),
+		jwt.WithContext(ctx),
 	)
 	if err != nil {
 		return nil, errors.WithStack(err)
@@ -28,18 +26,16 @@ func parseToken(ctx context.Context, keys jwk.Set, issuer string, rawToken strin
 	return token, nil
 }
 
-func GenerateToken(ctx context.Context, key jwk.Key, issuer, subject string, role Role) (string, error) {
+const DefaultRoleKey string = "role"
+
+func GenerateToken(ctx context.Context, key jwk.Key, subject string, role Role) (string, error) {
 	token := jwt.New()
 
 	if err := token.Set(jwt.SubjectKey, subject); err != nil {
 		return "", errors.WithStack(err)
 	}
 
-	if err := token.Set(jwt.IssuerKey, issuer); err != nil {
-		return "", errors.WithStack(err)
-	}
-
-	if err := token.Set(keyRole, role); err != nil {
+	if err := token.Set(DefaultRoleKey, role); err != nil {
 		return "", errors.WithStack(err)
 	}
 

internal/command/server/auth/create_token.go

@@ -36,12 +36,17 @@ func CreateTokenCommand() *cli.Command {
 			subject := ctx.String("subject")
 			role := ctx.String("role")
 
-			key, err := jwk.LoadOrGenerate(string(conf.Server.PrivateKeyPath), jwk.DefaultKeySize)
+			localAuth := conf.Server.Auth.Local
+			if localAuth == nil {
+				return errors.New("local auth is disabled")
+			}
+
+			key, err := jwk.LoadOrGenerate(string(localAuth.PrivateKeyPath), jwk.DefaultKeySize)
 			if err != nil {
 				return errors.WithStack(err)
 			}
 
-			token, err := thirdparty.GenerateToken(ctx.Context, key, string(conf.Server.Issuer), subject, thirdparty.Role(role))
+			token, err := thirdparty.GenerateToken(ctx.Context, key, subject, thirdparty.Role(role))
 			if err != nil {
 				return errors.WithStack(err)
 			}

internal/config/environment.go

@@ -4,6 +4,7 @@ import (
 	"os"
 	"regexp"
 	"strconv"
+	"time"
 
 	"github.com/pkg/errors"
 	"gopkg.in/yaml.v3"
@@ -123,3 +124,37 @@ func (iss *InterpolatedStringSlice) UnmarshalYAML(value *yaml.Node) error {
 
 	return nil
 }
+
+type InterpolatedDuration time.Duration
+
+func (id *InterpolatedDuration) UnmarshalYAML(value *yaml.Node) error {
+	var str string
+
+	if err := value.Decode(&str); err != nil {
+		return errors.Wrapf(err, "could not decode value '%v' (line '%d') into string", value.Value, value.Line)
+	}
+
+	if match := reVar.FindStringSubmatch(str); len(match) > 0 {
+		str = os.Getenv(match[1])
+	}
+
+	duration, err := time.ParseDuration(str)
+	if err != nil {
+		return errors.Wrapf(err, "could not parse duration '%v',  line '%d'", str, value.Line)
+	}
+
+	*id = InterpolatedDuration(duration)
+
+	return nil
+}
+
+func (id *InterpolatedDuration) MarshalYAML() (interface{}, error) {
+	duration := time.Duration(*id)
+
+	return duration.String(), nil
+}
+
+func NewInterpolatedDuration(d time.Duration) *InterpolatedDuration {
+	id := InterpolatedDuration(d)
+	return &id
+}

internal/config/server.go

@@ -1,19 +1,50 @@
 package config
 
+import (
+	"fmt"
+
+	"forge.cadoles.com/Cadoles/emissary/internal/auth/thirdparty"
+)
+
 type ServerConfig struct {
-	PrivateKeyPath InterpolatedString `yaml:"privateKeyPath"`
-	Issuer         InterpolatedString `yaml:"issuer"`
-	HTTP           HTTPConfig         `yaml:"http"`
-	Database       DatabaseConfig     `yaml:"database"`
-	CORS           CORSConfig         `yaml:"cors"`
+	HTTP     HTTPConfig     `yaml:"http"`
+	Database DatabaseConfig `yaml:"database"`
+	CORS     CORSConfig     `yaml:"cors"`
+	Auth     AuthConfig     `yaml:"auth"`
 }
 
 func NewDefaultServerConfig() ServerConfig {
 	return ServerConfig{
-		PrivateKeyPath: "server-key.json",
-		Issuer:         "http://127.0.0.1:3000",
-		HTTP:           NewDefaultHTTPConfig(),
-		Database:       NewDefaultDatabaseConfig(),
-		CORS:           NewDefaultCORSConfig(),
+		HTTP:     NewDefaultHTTPConfig(),
+		Database: NewDefaultDatabaseConfig(),
+		CORS:     NewDefaultCORSConfig(),
+		Auth:     NewDefaultAuthConfig(),
 	}
 }
+
+type AuthConfig struct {
+	Local               *LocalAuthConfig  `yaml:"local"`
+	Remote              *RemoteAuthConfig `yaml:"remote"`
+	RoleExtractionRules []string          `yaml:"roleExtractionRules"`
+}
+
+func NewDefaultAuthConfig() AuthConfig {
+	return AuthConfig{
+		Local: &LocalAuthConfig{
+			PrivateKeyPath: "server-key.json",
+		},
+		Remote: nil,
+		RoleExtractionRules: []string{
+			fmt.Sprintf("jwt.%s != nil ? str(jwt.%s) : ''", thirdparty.DefaultRoleKey, thirdparty.DefaultRoleKey),
+		},
+	}
+}
+
+type LocalAuthConfig struct {
+	PrivateKeyPath InterpolatedString `yaml:"privateKeyPath"`
+}
+
+type RemoteAuthConfig struct {
+	JsonWebKeySetURL InterpolatedString    `yaml:"jwksUrl"`
+	RefreshInterval  *InterpolatedDuration `yaml:"refreshInterval"`
+}

internal/jwk/jwk.go

@@ -1,11 +1,13 @@
 package jwk
 
 import (
+	"context"
 	"crypto/rand"
 	"crypto/rsa"
 	"encoding/json"
 	"io/ioutil"
 	"os"
+	"time"
 
 	"github.com/btcsuite/btcd/btcutil/base58"
 	"github.com/lestrrat-go/jwx/v2/jwa"
@@ -34,7 +36,7 @@ func Parse(src []byte, options ...jwk.ParseOption) (Set, error) {
 	return jwk.Parse(src, options...)
 }
 
-func PublicKeySet(keys ...jwk.Key) (jwk.Set, error) {
+func RS256PublicKeySet(keys ...jwk.Key) (jwk.Set, error) {
 	set := jwk.NewSet()
 
 	for _, k := range keys {
@@ -85,6 +87,27 @@ func LoadOrGenerate(path string, size int) (jwk.Key, error) {
 	return key, nil
 }
 
+func CreateCachedRemoteKeySet(ctx context.Context, url string, refreshInterval time.Duration) (func(context.Context) (jwk.Set, error), error) {
+	cache := jwk.NewCache(ctx)
+
+	if err := cache.Register(url, jwk.WithMinRefreshInterval(refreshInterval)); err != nil {
+		return nil, errors.WithStack(err)
+	}
+
+	if _, err := cache.Refresh(ctx, url); err != nil {
+		return nil, errors.WithStack(err)
+	}
+
+	return func(ctx context.Context) (jwk.Set, error) {
+		keySet, err := cache.Get(ctx, url)
+		if err != nil {
+			return nil, errors.WithStack(err)
+		}
+
+		return keySet, nil
+	}, nil
+}
+
 func Generate(size int) (jwk.Key, error) {
 	privKey, err := rsa.GenerateKey(rand.Reader, size)
 	if err != nil {

internal/jwk/jwk_test.go

@@ -12,7 +12,7 @@ func TestJWK(t *testing.T) {
 		t.Fatalf("%+v", errors.WithStack(err))
 	}
 
-	keySet, err := PublicKeySet(privateKey)
+	keySet, err := RS256PublicKeySet(privateKey)
 	if err != nil {
 		t.Fatalf("%+v", errors.WithStack(err))
 	}

internal/server/server.go

@@ -6,6 +6,9 @@ import (
 	"log"
 	"net"
 	"net/http"
+	"reflect"
+	"strings"
+	"time"
 
 	"forge.cadoles.com/Cadoles/emissary/internal/auth"
 	"forge.cadoles.com/Cadoles/emissary/internal/auth/agent"
@@ -13,9 +16,13 @@ import (
 	"forge.cadoles.com/Cadoles/emissary/internal/config"
 	"forge.cadoles.com/Cadoles/emissary/internal/datastore"
 	"forge.cadoles.com/Cadoles/emissary/internal/jwk"
+	"github.com/antonmedv/expr"
+	"github.com/antonmedv/expr/vm"
 	"github.com/go-chi/chi"
 	"github.com/go-chi/chi/middleware"
 	"github.com/go-chi/cors"
+	"github.com/lestrrat-go/jwx/v2/jwa"
+	"github.com/lestrrat-go/jwx/v2/jwt"
 	"github.com/pkg/errors"
 	"gitlab.com/wpetit/goweb/logger"
 )
@@ -72,20 +79,6 @@ func (s *Server) run(parentCtx context.Context, addrs chan net.Addr, errs chan e
 		}
 	}()
 
-	key, err := jwk.LoadOrGenerate(string(s.conf.PrivateKeyPath), jwk.DefaultKeySize)
-	if err != nil {
-		errs <- errors.WithStack(err)
-
-		return
-	}
-
-	keys, err := jwk.PublicKeySet(key)
-	if err != nil {
-		errs <- errors.WithStack(err)
-
-		return
-	}
-
 	router := chi.NewRouter()
 
 	router.Use(middleware.Logger)
@@ -100,12 +93,19 @@ func (s *Server) run(parentCtx context.Context, addrs chan net.Addr, errs chan e
 
 	router.Use(corsMiddleware.Handler)
 
+	thirdPartyAuth, err := s.getThirdPartyAuthenticator()
+	if err != nil {
+		errs <- errors.WithStack(err)
+
+		return
+	}
+
 	router.Route("/api/v1", func(r chi.Router) {
 		r.Post("/register", s.registerAgent)
 
 		r.Group(func(r chi.Router) {
 			r.Use(auth.Middleware(
-				thirdparty.NewAuthenticator(keys, string(s.conf.Issuer), thirdparty.DefaultAcceptableSkew),
+				thirdPartyAuth,
 				agent.NewAuthenticator(s.agentRepo, agent.DefaultAcceptableSkew),
 			))
 
@@ -131,6 +131,151 @@ func (s *Server) run(parentCtx context.Context, addrs chan net.Addr, errs chan e
 	logger.Info(ctx, "http server exiting")
 }
 
+func (s *Server) getThirdPartyAuthenticator() (*thirdparty.Authenticator, error) {
+	var localPublicKey jwk.Key
+
+	localAuth := s.conf.Auth.Local
+	if localAuth != nil {
+		key, err := jwk.LoadOrGenerate(string(localAuth.PrivateKeyPath), jwk.DefaultKeySize)
+		if err != nil {
+			return nil, errors.WithStack(err)
+		}
+
+		publicKey, err := key.PublicKey()
+		if err != nil {
+			return nil, errors.WithStack(err)
+		}
+
+		if err := publicKey.Set(jwk.AlgorithmKey, jwa.RS256); err != nil {
+			return nil, errors.WithStack(err)
+		}
+
+		localPublicKey = publicKey
+	}
+
+	var getRemoteKeySet thirdparty.GetKeySet
+
+	remoteAuth := s.conf.Auth.Remote
+	if remoteAuth != nil {
+		refreshInterval := time.Minute * 15
+		if remoteAuth.RefreshInterval != nil {
+			refreshInterval = time.Duration(*remoteAuth.RefreshInterval)
+		}
+
+		fn, err := jwk.CreateCachedRemoteKeySet(context.Background(), string(remoteAuth.JsonWebKeySetURL), refreshInterval)
+		if err != nil {
+			return nil, errors.WithStack(err)
+		}
+
+		getRemoteKeySet = fn
+	}
+
+	getKeySet := func(ctx context.Context) (jwk.Set, error) {
+		keySet := jwk.NewSet()
+
+		if localPublicKey != nil {
+			if err := keySet.AddKey(localPublicKey); err != nil {
+				return nil, errors.WithStack(err)
+			}
+		}
+
+		if getRemoteKeySet != nil {
+			remoteKeySet, err := getRemoteKeySet(ctx)
+			if err != nil {
+				return nil, errors.WithStack(err)
+			}
+
+			for idx := 0; idx < remoteKeySet.Len(); idx++ {
+				key, ok := remoteKeySet.Key(idx)
+				if !ok {
+					break
+				}
+
+				if err := keySet.AddKey(key); err != nil {
+					return nil, errors.WithStack(err)
+				}
+			}
+		}
+
+		return keySet, nil
+	}
+
+	getTokenRole, err := s.createGetTokenRoleFunc()
+	if err != nil {
+		return nil, errors.WithStack(err)
+	}
+
+	return thirdparty.NewAuthenticator(getKeySet, getTokenRole, thirdparty.DefaultAcceptableSkew), nil
+}
+
+func (s *Server) createGetTokenRoleFunc() (func(ctx context.Context, token jwt.Token) (string, error), error) {
+	rawRules := s.conf.Auth.RoleExtractionRules
+	rules := make([]*vm.Program, 0, len(rawRules))
+
+	type Env struct {
+		JWT map[string]any `expr:"jwt"`
+	}
+
+	strFunc := expr.Function(
+		"str",
+		func(params ...any) (any, error) {
+			var builder strings.Builder
+
+			for _, p := range params {
+				if _, err := builder.WriteString(fmt.Sprintf("%v", p)); err != nil {
+					return nil, errors.WithStack(err)
+				}
+			}
+
+			return builder.String(), nil
+		},
+		new(func(any) string),
+	)
+
+	for _, rr := range rawRules {
+		r, err := expr.Compile(rr,
+			expr.Env(Env{}),
+			expr.AsKind(reflect.String),
+			strFunc,
+		)
+		if err != nil {
+			return nil, errors.Wrapf(err, "could not compile role extraction rule '%s'", rr)
+		}
+
+		rules = append(rules, r)
+	}
+
+	return func(ctx context.Context, token jwt.Token) (string, error) {
+		jwt, err := token.AsMap(ctx)
+		if err != nil {
+			return "", errors.WithStack(err)
+		}
+
+		vm := vm.VM{}
+
+		for _, r := range rules {
+			result, err := vm.Run(r, Env{
+				JWT: jwt,
+			})
+			if err != nil {
+				return "", errors.WithStack(err)
+			}
+
+			role, ok := result.(string)
+			if !ok {
+				logger.Debug(ctx, "ignoring unexpected role extraction result", logger.F("result", result))
+				continue
+			}
+
+			if role != "" {
+				return role, nil
+			}
+		}
+
+		return "", errors.New("could not extract role from token")
+	}, nil
+}
+
 func New(funcs ...OptionFunc) *Server {
 	opt := defaultOption()
 	for _, fn := range funcs {

misc/packaging/common/config-server.yml

@@ -2,8 +2,6 @@ logger:
   level: 1
   format: human
 server:
-  privateKeyPath: /var/lib/emissary/server-key.json
-  issuer: http://127.0.0.1:3000
   http:
     host: 0.0.0.0
     port: 3000
@@ -25,3 +23,11 @@ server:
       - Authorization
       - Sentry-Trace
   debug: false
+  auth:
+    local:
+      privateKeyPath: /var/lib/emissary/server-key.json
+    roleExtractionRules:
+      - "jwt.role != nil ? str(jwt.role) : ''"
+    remote: ~
+      # jwksUrl: https://my-server/.well-known/jwks.json
+    

pkg/client/register_agent.go

@@ -10,7 +10,7 @@ import (
 )
 
 func (c *Client) RegisterAgent(ctx context.Context, key Key, thumbprint string, meta []MetadataTuple, funcs ...OptionFunc) (*Agent, error) {
-	keySet, err := jwk.PublicKeySet(key)
+	keySet, err := jwk.RS256PublicKeySet(key)
 	if err != nil {
 		return nil, errors.WithStack(err)
 	}