certificates/ca/ca.go

334 lines
8.9 KiB
Go
Raw Normal View History

2018-10-05 21:48:36 +00:00
package ca
import (
"crypto/tls"
"crypto/x509"
2019-05-27 00:41:10 +00:00
"fmt"
"log"
2018-10-05 21:48:36 +00:00
"net/http"
2019-05-27 00:41:10 +00:00
"net/url"
"reflect"
2018-10-05 21:48:36 +00:00
"github.com/go-chi/chi"
"github.com/pkg/errors"
2019-05-27 00:41:10 +00:00
"github.com/smallstep/certificates/acme"
acmeAPI "github.com/smallstep/certificates/acme/api"
2021-03-05 07:10:46 +00:00
acmeNoSQL "github.com/smallstep/certificates/acme/db/nosql"
"github.com/smallstep/certificates/api"
"github.com/smallstep/certificates/authority"
2021-05-03 19:48:20 +00:00
"github.com/smallstep/certificates/authority/config"
"github.com/smallstep/certificates/authority/mgmt"
2021-05-07 00:03:12 +00:00
mgmtAPI "github.com/smallstep/certificates/authority/mgmt/api"
"github.com/smallstep/certificates/db"
"github.com/smallstep/certificates/logging"
"github.com/smallstep/certificates/monitoring"
"github.com/smallstep/certificates/server"
2019-05-27 00:41:10 +00:00
"github.com/smallstep/nosql"
2018-10-05 21:48:36 +00:00
)
type options struct {
configFile string
password []byte
issuerPassword []byte
database db.AuthDB
2018-10-05 21:48:36 +00:00
}
func (o *options) apply(opts []Option) {
for _, fn := range opts {
fn(o)
}
}
// Option is the type of options passed to the CA constructor.
type Option func(o *options)
// WithConfigFile sets the given name as the configuration file name in the CA
// options.
func WithConfigFile(name string) Option {
return func(o *options) {
o.configFile = name
}
}
// WithPassword sets the given password as the configured password in the CA
// options.
func WithPassword(password []byte) Option {
return func(o *options) {
o.password = password
}
}
2021-03-25 18:06:37 +00:00
// WithIssuerPassword sets the given password as the configured certificate
// issuer password in the CA options.
func WithIssuerPassword(password []byte) Option {
return func(o *options) {
o.issuerPassword = password
}
}
// WithDatabase sets the given authority database to the CA options.
func WithDatabase(db db.AuthDB) Option {
return func(o *options) {
o.database = db
}
}
2018-10-05 21:48:36 +00:00
// CA is the type used to build the complete certificate authority. It builds
// the HTTP server, set ups the middlewares and the HTTP handlers.
type CA struct {
2019-09-19 20:17:23 +00:00
auth *authority.Authority
2021-05-03 19:48:20 +00:00
config *config.Config
2019-09-19 20:17:23 +00:00
srv *server.Server
opts *options
renewer *TLSRenewer
2018-10-05 21:48:36 +00:00
}
// New creates and initializes the CA with the given configuration and options.
2021-05-03 19:48:20 +00:00
func New(config *config.Config, opts ...Option) (*CA, error) {
2018-10-05 21:48:36 +00:00
ca := &CA{
config: config,
opts: new(options),
}
ca.opts.apply(opts)
return ca.Init(config)
}
// Init initializes the CA with the given configuration.
2021-05-03 19:48:20 +00:00
func (ca *CA) Init(config *config.Config) (*CA, error) {
// Intermediate Password.
if len(ca.opts.password) > 0 {
2018-10-05 21:48:36 +00:00
ca.config.Password = string(ca.opts.password)
}
// Certificate issuer password for RA mode.
if len(ca.opts.issuerPassword) > 0 {
if ca.config.AuthorityConfig != nil && ca.config.AuthorityConfig.CertificateIssuer != nil {
ca.config.AuthorityConfig.CertificateIssuer.Password = string(ca.opts.issuerPassword)
}
}
var opts []authority.Option
if ca.opts.database != nil {
opts = append(opts, authority.WithDatabase(ca.opts.database))
}
auth, err := authority.New(config, opts...)
2018-10-05 21:48:36 +00:00
if err != nil {
return nil, err
}
tlsConfig, err := ca.getTLSConfig(auth)
if err != nil {
return nil, err
}
// Using chi as the main router
mux := chi.NewRouter()
handler := http.Handler(mux)
2019-05-27 00:41:10 +00:00
// Add regular CA api endpoints in / and /1.0
2018-10-05 21:48:36 +00:00
routerHandler := api.New(auth)
routerHandler.Route(mux)
mux.Route("/1.0", func(r chi.Router) {
routerHandler.Route(r)
})
2019-05-27 00:41:10 +00:00
//Add ACME api endpoints in /acme and /1.0/acme
dns := config.DNSNames[0]
u, err := url.Parse("https://" + config.Address)
if err != nil {
return nil, err
}
port := u.Port()
if port != "" && port != "443" {
dns = fmt.Sprintf("%s:%s", dns, port)
}
2021-05-07 00:03:12 +00:00
// ACME Router
2019-05-27 00:41:10 +00:00
prefix := "acme"
2021-03-25 03:46:02 +00:00
var acmeDB acme.DB
if config.DB == nil {
acmeDB = nil
} else {
2021-05-03 19:48:20 +00:00
acmeDB, err = acmeNoSQL.New(auth.GetDatabase().(nosql.DB), mgmt.DefaultAuthorityID)
2021-03-25 03:46:02 +00:00
if err != nil {
return nil, errors.Wrap(err, "error configuring ACME DB interface")
}
2021-03-06 21:06:43 +00:00
}
acmeHandler := acmeAPI.NewHandler(acmeAPI.HandlerOptions{
Backdate: *config.AuthorityConfig.Backdate,
2021-03-06 21:06:43 +00:00
DB: acmeDB,
DNS: dns,
Prefix: prefix,
2021-03-05 07:10:46 +00:00
CA: auth,
})
2019-05-27 00:41:10 +00:00
mux.Route("/"+prefix, func(r chi.Router) {
2021-03-06 21:06:43 +00:00
acmeHandler.Route(r)
2019-05-27 00:41:10 +00:00
})
// Use 2.0 because, at the moment, our ACME api is only compatible with v2.0
// of the ACME spec.
mux.Route("/2.0/"+prefix, func(r chi.Router) {
2021-03-06 21:06:43 +00:00
acmeHandler.Route(r)
2019-05-27 00:41:10 +00:00
})
2021-05-20 20:01:58 +00:00
// Admin API Router
adminDB := auth.GetAdminDatabase()
if adminDB != nil {
mgmtHandler := mgmtAPI.NewHandler(auth)
mux.Route("/admin", func(r chi.Router) {
2021-05-07 00:03:12 +00:00
mgmtHandler.Route(r)
})
}
// helpful routine for logging all routes //
/*
walkFunc := func(method string, route string, handler http.Handler, middlewares ...func(http.Handler) http.Handler) error {
fmt.Printf("%s %s\n", method, route)
return nil
}
if err := chi.Walk(mux, walkFunc); err != nil {
fmt.Printf("Logging err: %s\n", err.Error())
}
*/
2019-05-27 00:41:10 +00:00
2018-10-05 21:48:36 +00:00
// Add monitoring if configured
if len(config.Monitoring) > 0 {
m, err := monitoring.New(config.Monitoring)
if err != nil {
return nil, err
}
handler = m.Middleware(handler)
}
// Add logger if configured
if len(config.Logger) > 0 {
logger, err := logging.New("ca", config.Logger)
if err != nil {
return nil, err
}
handler = logger.Middleware(handler)
}
ca.auth = auth
ca.srv = server.New(config.Address, handler, tlsConfig)
return ca, nil
}
// Run starts the CA calling to the server ListenAndServe method.
func (ca *CA) Run() error {
return ca.srv.ListenAndServe()
}
// Stop stops the CA calling to the server Shutdown method.
func (ca *CA) Stop() error {
2018-11-27 23:57:13 +00:00
ca.renewer.Stop()
if err := ca.auth.Shutdown(); err != nil {
log.Printf("error stopping ca.Authority: %+v\n", err)
}
2018-10-05 21:48:36 +00:00
return ca.srv.Shutdown()
}
// Reload reloads the configuration of the CA and calls to the server Reload
// method.
func (ca *CA) Reload() error {
2021-05-03 19:48:20 +00:00
config, err := config.LoadConfiguration(ca.opts.configFile)
2018-10-05 21:48:36 +00:00
if err != nil {
return errors.Wrap(err, "error reloading ca configuration")
}
logContinue := func(reason string) {
log.Println(reason)
log.Println("Continuing to run with the original configuration.")
log.Println("You can force a restart by sending a SIGTERM signal and then restarting the step-ca.")
2018-10-05 21:48:36 +00:00
}
// Do not allow reload if the database configuration has changed.
2019-05-10 23:14:21 +00:00
if !reflect.DeepEqual(ca.config.DB, config.DB) {
logContinue("Reload failed because the database configuration has changed.")
return errors.New("error reloading ca: database configuration cannot change")
}
newCA, err := New(config,
WithPassword(ca.opts.password),
WithIssuerPassword(ca.opts.issuerPassword),
WithConfigFile(ca.opts.configFile),
WithDatabase(ca.auth.GetDatabase()),
)
2018-10-05 21:48:36 +00:00
if err != nil {
logContinue("Reload failed because the CA with new configuration could not be initialized.")
2018-10-05 21:48:36 +00:00
return errors.Wrap(err, "error reloading ca")
}
if err = ca.srv.Reload(newCA.srv); err != nil {
logContinue("Reload failed because server could not be replaced.")
return errors.Wrap(err, "error reloading server")
}
// 1. Stop previous renewer
2021-02-12 01:38:14 +00:00
// 2. Safely shutdown any internal resources (e.g. key manager)
// 3. Replace ca properties
// Do not replace ca.srv
ca.renewer.Stop()
ca.auth.CloseForReload()
ca.auth = newCA.auth
ca.config = newCA.config
ca.opts = newCA.opts
ca.renewer = newCA.renewer
return nil
2018-10-05 21:48:36 +00:00
}
// getTLSConfig returns a TLSConfig for the CA server with a self-renewing
// server certificate.
func (ca *CA) getTLSConfig(auth *authority.Authority) (*tls.Config, error) {
// Create initial TLS certificate
tlsCrt, err := auth.GetTLSCertificate()
if err != nil {
return nil, err
}
// Start tls renewer with the new certificate.
// If a renewer was started, attempt to stop it before.
if ca.renewer != nil {
ca.renewer.Stop()
}
ca.renewer, err = NewTLSRenewer(tlsCrt, auth.GetTLSCertificate)
if err != nil {
return nil, err
}
ca.renewer.Run()
var tlsConfig *tls.Config
if ca.config.TLS != nil {
tlsConfig = ca.config.TLS.TLSConfig()
} else {
tlsConfig = &tls.Config{
MinVersion: tls.VersionTLS12,
}
}
certPool := x509.NewCertPool()
2019-01-07 23:30:28 +00:00
for _, crt := range auth.GetRootCertificates() {
certPool.AddCert(crt)
}
2018-10-05 21:48:36 +00:00
// GetCertificate will only be called if the client supplies SNI
// information or if tlsConfig.Certificates is empty.
// When client requests are made using an IP address (as opposed to a domain
// name) the server does not receive any SNI and may fallback to using the
// first entry in the Certificates attribute; by setting the attribute to
// empty we are implicitly forcing GetCertificate to be the only mechanism
// by which the server can find it's own leaf Certificate.
tlsConfig.Certificates = []tls.Certificate{}
2018-11-27 23:57:13 +00:00
tlsConfig.GetCertificate = ca.renewer.GetCertificateForCA
2018-10-05 21:48:36 +00:00
// Add support for mutual tls to renew certificates
tlsConfig.ClientAuth = tls.VerifyClientCertIfGiven
tlsConfig.ClientCAs = certPool
// Use server's most preferred ciphersuite
tlsConfig.PreferServerCipherSuites = true
return tlsConfig, nil
}