Merge pull request #748 from ericchiang/better-config-feedback

cmd/dex: provide better feedback when parsing config
This commit is contained in:
Eric Chiang 2016-12-15 13:52:14 -08:00 committed by GitHub
commit 89cbf8d243
2 changed files with 70 additions and 24 deletions

View File

@ -30,7 +30,12 @@ func commandServe() *cobra.Command {
Short: "Connect to the storage and begin serving requests.", Short: "Connect to the storage and begin serving requests.",
Long: ``, Long: ``,
Example: "dex serve config.yaml", Example: "dex serve config.yaml",
RunE: serve, Run: func(cmd *cobra.Command, args []string) {
if err := serve(cmd, args); err != nil {
fmt.Fprintln(os.Stderr, err)
os.Exit(2)
}
},
} }
} }
@ -40,19 +45,27 @@ func serve(cmd *cobra.Command, args []string) error {
return errors.New("surplus arguments") return errors.New("surplus arguments")
case 0: case 0:
// TODO(ericchiang): Consider having a default config file location. // TODO(ericchiang): Consider having a default config file location.
return errors.New("no config file specified") return errors.New("no arguments provided")
case 1: case 1:
} }
configFile := args[0] configFile := args[0]
configData, err := ioutil.ReadFile(configFile) configData, err := ioutil.ReadFile(configFile)
if err != nil { if err != nil {
return fmt.Errorf("read config file %s: %v", configFile, err) return fmt.Errorf("failed to read config file %s: %v", configFile, err)
} }
var c Config var c Config
if err := yaml.Unmarshal(configData, &c); err != nil { if err := yaml.Unmarshal(configData, &c); err != nil {
return fmt.Errorf("parse config file %s: %v", configFile, err) return fmt.Errorf("error parse config file %s: %v", configFile, err)
}
logger, err := newLogger(c.Logger.Level, c.Logger.Format)
if err != nil {
return fmt.Errorf("invalid config: %v", err)
}
if c.Logger.Level != "" {
logger.Infof("config using log level: %s", c.Logger.Level)
} }
// Fast checks. Perform these first for a more responsive CLI. // Fast checks. Perform these first for a more responsive CLI.
@ -75,27 +88,29 @@ func serve(cmd *cobra.Command, args []string) error {
for _, check := range checks { for _, check := range checks {
if check.bad { if check.bad {
return errors.New(check.errMsg) return fmt.Errorf("invalid config: %s", check.errMsg)
} }
} }
logger.Infof("config issuer: %s", c.Issuer)
var grpcOptions []grpc.ServerOption var grpcOptions []grpc.ServerOption
if c.GRPC.TLSCert != "" { if c.GRPC.TLSCert != "" {
if c.GRPC.TLSClientCA != "" { if c.GRPC.TLSClientCA != "" {
// Parse certificates from certificate file and key file for server. // Parse certificates from certificate file and key file for server.
cert, err := tls.LoadX509KeyPair(c.GRPC.TLSCert, c.GRPC.TLSKey) cert, err := tls.LoadX509KeyPair(c.GRPC.TLSCert, c.GRPC.TLSKey)
if err != nil { if err != nil {
return fmt.Errorf("parsing certificate file: %v", err) return fmt.Errorf("invalid config: error parsing gRPC certificate file: %v", err)
} }
// Parse certificates from client CA file to a new CertPool. // Parse certificates from client CA file to a new CertPool.
cPool := x509.NewCertPool() cPool := x509.NewCertPool()
clientCert, err := ioutil.ReadFile(c.GRPC.TLSClientCA) clientCert, err := ioutil.ReadFile(c.GRPC.TLSClientCA)
if err != nil { if err != nil {
return fmt.Errorf("reading from client CA file: %v", err) return fmt.Errorf("invalid config: reading from client CA file: %v", err)
} }
if cPool.AppendCertsFromPEM(clientCert) != true { if cPool.AppendCertsFromPEM(clientCert) != true {
return errors.New("failed to parse client CA") return errors.New("invalid config: failed to parse client CA")
} }
tlsConfig := tls.Config{ tlsConfig := tls.Config{
@ -107,26 +122,26 @@ func serve(cmd *cobra.Command, args []string) error {
} else { } else {
opt, err := credentials.NewServerTLSFromFile(c.GRPC.TLSCert, c.GRPC.TLSKey) opt, err := credentials.NewServerTLSFromFile(c.GRPC.TLSCert, c.GRPC.TLSKey)
if err != nil { if err != nil {
return fmt.Errorf("load grpc certs: %v", err) return fmt.Errorf("invalid config: load grpc certs: %v", err)
} }
grpcOptions = append(grpcOptions, grpc.Creds(opt)) grpcOptions = append(grpcOptions, grpc.Creds(opt))
} }
} }
logger, _ := newLogger(c.Logger.Level, c.Logger.Format)
connectors := make([]server.Connector, len(c.Connectors)) connectors := make([]server.Connector, len(c.Connectors))
for i, conn := range c.Connectors { for i, conn := range c.Connectors {
if conn.ID == "" { if conn.ID == "" {
return fmt.Errorf("no ID field for connector %d", i) return fmt.Errorf("invalid config: no ID field for connector %d", i)
} }
if conn.Config == nil { if conn.Config == nil {
return fmt.Errorf("no config field for connector %q", conn.ID) return fmt.Errorf("invalid config: no config field for connector %q", conn.ID)
} }
logger.Infof("config connector: %s", conn.ID)
connectorLogger := logger.WithField("connector", conn.Name) connectorLogger := logger.WithField("connector", conn.Name)
c, err := conn.Config.Open(connectorLogger) c, err := conn.Config.Open(connectorLogger)
if err != nil { if err != nil {
return fmt.Errorf("open %s: %v", conn.ID, err) return fmt.Errorf("failed to create connector %s: %v", conn.ID, err)
} }
connectors[i] = server.Connector{ connectors[i] = server.Connector{
ID: conn.ID, ID: conn.ID,
@ -134,12 +149,20 @@ func serve(cmd *cobra.Command, args []string) error {
Connector: c, Connector: c,
} }
} }
if c.EnablePasswordDB {
logger.Infof("config connector: local passwords enabled")
}
s, err := c.Storage.Config.Open(logger) s, err := c.Storage.Config.Open(logger)
if err != nil { if err != nil {
return fmt.Errorf("initializing storage: %v", err) return fmt.Errorf("failed to initialize storage: %v", err)
} }
logger.Infof("config storage: %s", c.Storage.Type)
if len(c.StaticClients) > 0 { if len(c.StaticClients) > 0 {
for _, client := range c.StaticClients {
logger.Infof("config static client: %s", client.ID)
}
s = storage.WithStaticClients(s, c.StaticClients) s = storage.WithStaticClients(s, c.StaticClients)
} }
if len(c.StaticPasswords) > 0 { if len(c.StaticPasswords) > 0 {
@ -150,6 +173,13 @@ func serve(cmd *cobra.Command, args []string) error {
s = storage.WithStaticPasswords(s, passwords) s = storage.WithStaticPasswords(s, passwords)
} }
if len(c.OAuth2.ResponseTypes) > 0 {
logger.Infof("config response types accepted: %s", c.OAuth2.ResponseTypes)
}
if c.OAuth2.SkipApprovalScreen {
logger.Infof("config skipping approval screen")
}
serverConfig := server.Config{ serverConfig := server.Config{
SupportedResponseTypes: c.OAuth2.ResponseTypes, SupportedResponseTypes: c.OAuth2.ResponseTypes,
SkipApprovalScreen: c.OAuth2.SkipApprovalScreen, SkipApprovalScreen: c.OAuth2.SkipApprovalScreen,
@ -163,33 +193,38 @@ func serve(cmd *cobra.Command, args []string) error {
if c.Expiry.SigningKeys != "" { if c.Expiry.SigningKeys != "" {
signingKeys, err := time.ParseDuration(c.Expiry.SigningKeys) signingKeys, err := time.ParseDuration(c.Expiry.SigningKeys)
if err != nil { if err != nil {
return fmt.Errorf("parsing signingKeys expiry: %v", err) return fmt.Errorf("invalid config value %q for signing keys expiry: %v", c.Expiry.SigningKeys, err)
} }
logger.Infof("config signing keys expire after: %v", signingKeys)
serverConfig.RotateKeysAfter = signingKeys serverConfig.RotateKeysAfter = signingKeys
} }
if c.Expiry.IDTokens != "" { if c.Expiry.IDTokens != "" {
idTokens, err := time.ParseDuration(c.Expiry.IDTokens) idTokens, err := time.ParseDuration(c.Expiry.IDTokens)
if err != nil { if err != nil {
return fmt.Errorf("parsing idTokens expiry: %v", err) return fmt.Errorf("invalid config value %q for id token expiry: %v", c.Expiry.IDTokens, err)
} }
logger.Infof("config id tokens valid for: %v", idTokens)
serverConfig.IDTokensValidFor = idTokens serverConfig.IDTokensValidFor = idTokens
} }
serv, err := server.NewServer(context.Background(), serverConfig) serv, err := server.NewServer(context.Background(), serverConfig)
if err != nil { if err != nil {
return fmt.Errorf("initializing server: %v", err) return fmt.Errorf("failed to initialize server: %v", err)
} }
errc := make(chan error, 3) errc := make(chan error, 3)
if c.Web.HTTP != "" { if c.Web.HTTP != "" {
logger.Infof("listening (http) on %s", c.Web.HTTP) logger.Infof("listening (http) on %s", c.Web.HTTP)
go func() { go func() {
errc <- http.ListenAndServe(c.Web.HTTP, serv) err := http.ListenAndServe(c.Web.HTTP, serv)
errc <- fmt.Errorf("listening on %s failed: %v", c.Web.HTTP, err)
}() }()
} }
if c.Web.HTTPS != "" { if c.Web.HTTPS != "" {
logger.Infof("listening (https) on %s", c.Web.HTTPS) logger.Infof("listening (https) on %s", c.Web.HTTPS)
go func() { go func() {
errc <- http.ListenAndServeTLS(c.Web.HTTPS, c.Web.TLSCert, c.Web.TLSKey, serv) err := http.ListenAndServeTLS(c.Web.HTTPS, c.Web.TLSCert, c.Web.TLSKey, serv)
errc <- fmt.Errorf("listening on %s failed: %v", c.Web.HTTPS, err)
}() }()
} }
if c.GRPC.Addr != "" { if c.GRPC.Addr != "" {
@ -198,11 +233,12 @@ func serve(cmd *cobra.Command, args []string) error {
errc <- func() error { errc <- func() error {
list, err := net.Listen("tcp", c.GRPC.Addr) list, err := net.Listen("tcp", c.GRPC.Addr)
if err != nil { if err != nil {
return fmt.Errorf("listen grpc: %v", err) return fmt.Errorf("listening on %s failed: %v", c.GRPC.Addr, err)
} }
s := grpc.NewServer(grpcOptions...) s := grpc.NewServer(grpcOptions...)
api.RegisterDexServer(s, server.NewAPI(serverConfig.Storage, logger)) api.RegisterDexServer(s, server.NewAPI(serverConfig.Storage, logger))
return s.Serve(list) err = s.Serve(list)
return fmt.Errorf("listening on %s failed: %v", c.GRPC.Addr, err)
}() }()
}() }()
} }
@ -210,6 +246,11 @@ func serve(cmd *cobra.Command, args []string) error {
return <-errc return <-errc
} }
var (
logLevels = []string{"debug", "info", "error"}
logFormats = []string{"json", "text"}
)
func newLogger(level string, format string) (logrus.FieldLogger, error) { func newLogger(level string, format string) (logrus.FieldLogger, error) {
var logLevel logrus.Level var logLevel logrus.Level
switch strings.ToLower(level) { switch strings.ToLower(level) {
@ -220,7 +261,7 @@ func newLogger(level string, format string) (logrus.FieldLogger, error) {
case "error": case "error":
logLevel = logrus.ErrorLevel logLevel = logrus.ErrorLevel
default: default:
return nil, fmt.Errorf("unsupported logLevel: %s", level) return nil, fmt.Errorf("log level is not one of the supported values (%s): %s", strings.Join(logLevels, ", "), level)
} }
var formatter logrus.Formatter var formatter logrus.Formatter
@ -230,7 +271,7 @@ func newLogger(level string, format string) (logrus.FieldLogger, error) {
case "json": case "json":
formatter = &logrus.JSONFormatter{} formatter = &logrus.JSONFormatter{}
default: default:
return nil, fmt.Errorf("unsupported logger format: %s", format) return nil, fmt.Errorf("log format is not one of the supported values (%s): %s", strings.Join(logFormats, ", "), format)
} }
return &logrus.Logger{ return &logrus.Logger{

View File

@ -33,6 +33,11 @@ web:
# signingKeys: "6h" # signingKeys: "6h"
# idTokens: "24h" # idTokens: "24h"
# Options for controlling the logger.
# logger:
# level: "debug"
# format: "text" # can also be "json"
# Instead of reading from an external storage, use this list of clients. # Instead of reading from an external storage, use this list of clients.
# #
# If this option isn't choosen clients may be added through the gRPC API. # If this option isn't choosen clients may be added through the gRPC API.