mirror of https://github.com/portainer/portainer
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
267 lines
10 KiB
267 lines
10 KiB
package settings
|
|
|
|
import (
|
|
"cmp"
|
|
"net/http"
|
|
"strings"
|
|
"time"
|
|
|
|
portainer "github.com/portainer/portainer/api"
|
|
"github.com/portainer/portainer/api/dataservices"
|
|
"github.com/portainer/portainer/api/filesystem"
|
|
"github.com/portainer/portainer/api/internal/edge"
|
|
"github.com/portainer/portainer/pkg/libhelm"
|
|
httperror "github.com/portainer/portainer/pkg/libhttp/error"
|
|
"github.com/portainer/portainer/pkg/libhttp/request"
|
|
"github.com/portainer/portainer/pkg/libhttp/response"
|
|
|
|
"github.com/asaskevich/govalidator"
|
|
"github.com/pkg/errors"
|
|
"golang.org/x/oauth2"
|
|
)
|
|
|
|
type settingsUpdatePayload struct {
|
|
// URL to a logo that will be displayed on the login page as well as on top of the sidebar. Will use default Portainer logo when value is empty string
|
|
LogoURL *string `example:"https://mycompany.mydomain.tld/logo.png"`
|
|
// A list of label name & value that will be used to hide containers when querying containers
|
|
BlackListedLabels []portainer.Pair
|
|
// Active authentication method for the Portainer instance. Valid values are: 1 for internal, 2 for LDAP, or 3 for oauth
|
|
AuthenticationMethod *int `example:"1"`
|
|
InternalAuthSettings *portainer.InternalAuthSettings
|
|
LDAPSettings *portainer.LDAPSettings
|
|
OAuthSettings *portainer.OAuthSettings
|
|
// The interval in which environment(endpoint) snapshots are created
|
|
SnapshotInterval *string `example:"5m"`
|
|
// URL to the templates that will be displayed in the UI when navigating to App Templates
|
|
TemplatesURL *string `example:"https://raw.githubusercontent.com/portainer/templates/master/templates.json"`
|
|
// Deployment options for encouraging deployment as code
|
|
GlobalDeploymentOptions *portainer.GlobalDeploymentOptions // The default check in interval for edge agent (in seconds)
|
|
EdgeAgentCheckinInterval *int `example:"5"`
|
|
// Whether edge compute features are enabled
|
|
EnableEdgeComputeFeatures *bool `example:"true"`
|
|
// The duration of a user session
|
|
UserSessionTimeout *string `example:"5m"`
|
|
// The expiry of a Kubeconfig
|
|
KubeconfigExpiry *string `example:"24h" default:"0"`
|
|
// Whether telemetry is enabled
|
|
EnableTelemetry *bool `example:"false"`
|
|
// Helm repository URL
|
|
HelmRepositoryURL *string `example:"https://charts.bitnami.com/bitnami"`
|
|
// Kubectl Shell Image
|
|
KubectlShellImage *string `example:"portainer/kubectl-shell:latest"`
|
|
// TrustOnFirstConnect makes Portainer accepting edge agent connection by default
|
|
TrustOnFirstConnect *bool `example:"false"`
|
|
// EnforceEdgeID makes Portainer store the Edge ID instead of accepting anyone
|
|
EnforceEdgeID *bool `example:"false"`
|
|
// EdgePortainerURL is the URL that is exposed to edge agents
|
|
EdgePortainerURL *string `json:"EdgePortainerURL"`
|
|
}
|
|
|
|
func (payload *settingsUpdatePayload) Validate(r *http.Request) error {
|
|
if payload.AuthenticationMethod != nil && *payload.AuthenticationMethod != 1 && *payload.AuthenticationMethod != 2 && *payload.AuthenticationMethod != 3 {
|
|
return errors.New("Invalid authentication method value. Value must be one of: 1 (internal), 2 (LDAP/AD) or 3 (OAuth)")
|
|
}
|
|
|
|
if payload.LogoURL != nil && *payload.LogoURL != "" && !govalidator.IsURL(*payload.LogoURL) {
|
|
return errors.New("Invalid logo URL. Must correspond to a valid URL format")
|
|
}
|
|
|
|
if payload.TemplatesURL != nil && *payload.TemplatesURL != "" && !govalidator.IsURL(*payload.TemplatesURL) {
|
|
return errors.New("Invalid external templates URL. Must correspond to a valid URL format")
|
|
}
|
|
|
|
if payload.HelmRepositoryURL != nil && *payload.HelmRepositoryURL != "" && !govalidator.IsURL(*payload.HelmRepositoryURL) {
|
|
return errors.New("Invalid Helm repository URL. Must correspond to a valid URL format")
|
|
}
|
|
|
|
if payload.UserSessionTimeout != nil {
|
|
if _, err := time.ParseDuration(*payload.UserSessionTimeout); err != nil {
|
|
return errors.New("Invalid user session timeout")
|
|
}
|
|
}
|
|
|
|
if payload.KubeconfigExpiry != nil {
|
|
if _, err := time.ParseDuration(*payload.KubeconfigExpiry); err != nil {
|
|
return errors.New("Invalid Kubeconfig Expiry")
|
|
}
|
|
}
|
|
|
|
if payload.EdgePortainerURL != nil && *payload.EdgePortainerURL != "" {
|
|
if _, err := edge.ParseHostForEdge(*payload.EdgePortainerURL); err != nil {
|
|
return err
|
|
}
|
|
}
|
|
|
|
if payload.OAuthSettings != nil {
|
|
if payload.OAuthSettings.AuthStyle < oauth2.AuthStyleAutoDetect || payload.OAuthSettings.AuthStyle > oauth2.AuthStyleInHeader {
|
|
return errors.New("Invalid OAuth AuthStyle")
|
|
}
|
|
}
|
|
|
|
return nil
|
|
}
|
|
|
|
// @id SettingsUpdate
|
|
// @summary Update Portainer settings
|
|
// @description Update Portainer settings.
|
|
// @description **Access policy**: administrator
|
|
// @tags settings
|
|
// @security ApiKeyAuth
|
|
// @security jwt
|
|
// @accept json
|
|
// @produce json
|
|
// @param body body settingsUpdatePayload true "New settings"
|
|
// @success 200 {object} portainer.Settings "Success"
|
|
// @failure 400 "Invalid request"
|
|
// @failure 500 "Server error"
|
|
// @router /settings [put]
|
|
func (handler *Handler) settingsUpdate(w http.ResponseWriter, r *http.Request) *httperror.HandlerError {
|
|
var payload settingsUpdatePayload
|
|
err := request.DecodeAndValidateJSONPayload(r, &payload)
|
|
if err != nil {
|
|
return httperror.BadRequest("Invalid request payload", err)
|
|
}
|
|
|
|
var settings *portainer.Settings
|
|
if err = handler.DataStore.UpdateTx(func(tx dataservices.DataStoreTx) error {
|
|
settings, err = handler.updateSettings(tx, payload)
|
|
|
|
return err
|
|
}); err != nil {
|
|
var httpErr *httperror.HandlerError
|
|
if errors.As(err, &httpErr) {
|
|
return httpErr
|
|
}
|
|
|
|
return httperror.InternalServerError("Unexpected error", err)
|
|
}
|
|
|
|
hideFields(settings)
|
|
return response.JSON(w, settings)
|
|
}
|
|
|
|
func (handler *Handler) updateSettings(tx dataservices.DataStoreTx, payload settingsUpdatePayload) (*portainer.Settings, error) {
|
|
settings, err := tx.Settings().Settings()
|
|
if err != nil {
|
|
return nil, httperror.InternalServerError("Unable to retrieve the settings from the database", err)
|
|
}
|
|
|
|
if payload.AuthenticationMethod != nil {
|
|
settings.AuthenticationMethod = portainer.AuthenticationMethod(*payload.AuthenticationMethod)
|
|
}
|
|
|
|
settings.LogoURL = *cmp.Or(payload.LogoURL, &settings.LogoURL)
|
|
settings.TemplatesURL = *cmp.Or(payload.TemplatesURL, &settings.TemplatesURL)
|
|
|
|
// Update the global deployment options, and the environment deployment options if they have changed
|
|
settings.GlobalDeploymentOptions = *cmp.Or(payload.GlobalDeploymentOptions, &settings.GlobalDeploymentOptions)
|
|
|
|
if payload.HelmRepositoryURL != nil {
|
|
settings.HelmRepositoryURL = ""
|
|
if *payload.HelmRepositoryURL != "" {
|
|
newHelmRepo := strings.TrimSuffix(strings.ToLower(*payload.HelmRepositoryURL), "/")
|
|
|
|
if newHelmRepo != settings.HelmRepositoryURL && newHelmRepo != portainer.DefaultHelmRepositoryURL {
|
|
if err := libhelm.ValidateHelmRepositoryURL(*payload.HelmRepositoryURL, nil); err != nil {
|
|
return nil, httperror.BadRequest("Invalid Helm repository URL. Must correspond to a valid URL format", err)
|
|
}
|
|
}
|
|
|
|
settings.HelmRepositoryURL = newHelmRepo
|
|
}
|
|
}
|
|
|
|
if payload.BlackListedLabels != nil {
|
|
settings.BlackListedLabels = payload.BlackListedLabels
|
|
}
|
|
|
|
if payload.InternalAuthSettings != nil {
|
|
settings.InternalAuthSettings.RequiredPasswordLength = payload.InternalAuthSettings.RequiredPasswordLength
|
|
}
|
|
|
|
if payload.LDAPSettings != nil {
|
|
ldapReaderDN := cmp.Or(payload.LDAPSettings.ReaderDN, settings.LDAPSettings.ReaderDN)
|
|
ldapPassword := cmp.Or(payload.LDAPSettings.Password, settings.LDAPSettings.Password)
|
|
|
|
settings.LDAPSettings = *payload.LDAPSettings
|
|
settings.LDAPSettings.ReaderDN = ldapReaderDN
|
|
settings.LDAPSettings.Password = ldapPassword
|
|
}
|
|
|
|
if payload.OAuthSettings != nil {
|
|
clientSecret := payload.OAuthSettings.ClientSecret
|
|
if clientSecret == "" {
|
|
clientSecret = settings.OAuthSettings.ClientSecret
|
|
}
|
|
|
|
kubeSecret := payload.OAuthSettings.KubeSecretKey
|
|
if kubeSecret == nil {
|
|
kubeSecret = settings.OAuthSettings.KubeSecretKey
|
|
}
|
|
|
|
settings.OAuthSettings = *payload.OAuthSettings
|
|
settings.OAuthSettings.ClientSecret = clientSecret
|
|
settings.OAuthSettings.KubeSecretKey = kubeSecret
|
|
settings.OAuthSettings.AuthStyle = payload.OAuthSettings.AuthStyle
|
|
}
|
|
|
|
settings.EnableEdgeComputeFeatures = *cmp.Or(payload.EnableEdgeComputeFeatures, &settings.EnableEdgeComputeFeatures)
|
|
settings.TrustOnFirstConnect = *cmp.Or(payload.TrustOnFirstConnect, &settings.TrustOnFirstConnect)
|
|
settings.EnforceEdgeID = *cmp.Or(payload.EnforceEdgeID, &settings.EnforceEdgeID)
|
|
settings.EdgePortainerURL = *cmp.Or(payload.EdgePortainerURL, &settings.EdgePortainerURL)
|
|
|
|
if payload.SnapshotInterval != nil && *payload.SnapshotInterval != settings.SnapshotInterval {
|
|
if err := handler.updateSnapshotInterval(settings, *payload.SnapshotInterval); err != nil {
|
|
return nil, httperror.InternalServerError("Unable to update snapshot interval", err)
|
|
}
|
|
}
|
|
|
|
settings.EdgeAgentCheckinInterval = *cmp.Or(payload.EdgeAgentCheckinInterval, &settings.EdgeAgentCheckinInterval)
|
|
settings.KubeconfigExpiry = *cmp.Or(payload.KubeconfigExpiry, &settings.KubeconfigExpiry)
|
|
|
|
if payload.UserSessionTimeout != nil {
|
|
settings.UserSessionTimeout = *payload.UserSessionTimeout
|
|
|
|
userSessionDuration, _ := time.ParseDuration(*payload.UserSessionTimeout)
|
|
|
|
handler.JWTService.SetUserSessionDuration(userSessionDuration)
|
|
}
|
|
|
|
settings.EnableTelemetry = *cmp.Or(payload.EnableTelemetry, &settings.EnableTelemetry)
|
|
|
|
if err := handler.updateTLS(settings); err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
settings.KubectlShellImage = *cmp.Or(payload.KubectlShellImage, &settings.KubectlShellImage)
|
|
|
|
if err := tx.Settings().UpdateSettings(settings); err != nil {
|
|
return nil, httperror.InternalServerError("Unable to persist settings changes inside the database", err)
|
|
}
|
|
|
|
return settings, nil
|
|
}
|
|
|
|
func (handler *Handler) updateSnapshotInterval(settings *portainer.Settings, snapshotInterval string) error {
|
|
settings.SnapshotInterval = snapshotInterval
|
|
|
|
return handler.SnapshotService.SetSnapshotInterval(snapshotInterval)
|
|
}
|
|
|
|
func (handler *Handler) updateTLS(settings *portainer.Settings) error {
|
|
if (settings.LDAPSettings.TLSConfig.TLS || settings.LDAPSettings.StartTLS) && !settings.LDAPSettings.TLSConfig.TLSSkipVerify {
|
|
caCertPath, _ := handler.FileService.GetPathForTLSFile(filesystem.LDAPStorePath, portainer.TLSFileCA)
|
|
settings.LDAPSettings.TLSConfig.TLSCACertPath = caCertPath
|
|
|
|
return nil
|
|
}
|
|
|
|
settings.LDAPSettings.TLSConfig.TLSCACertPath = ""
|
|
|
|
if err := handler.FileService.DeleteTLSFiles(filesystem.LDAPStorePath); err != nil {
|
|
return httperror.InternalServerError("Unable to remove TLS files from disk", err)
|
|
}
|
|
|
|
return nil
|
|
}
|