// Copyright (C) 2019 Nicola Murino // // This program is free software: you can redistribute it and/or modify // it under the terms of the GNU Affero General Public License as published // by the Free Software Foundation, version 3. // // This program is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU Affero General Public License for more details. // // You should have received a copy of the GNU Affero General Public License // along with this program. If not, see . package plugin import ( "fmt" "slices" "sync" "time" "github.com/hashicorp/go-hclog" "github.com/hashicorp/go-plugin" "github.com/sftpgo/sdk/plugin/notifier" "github.com/drakkan/sftpgo/v2/internal/logger" ) // NotifierConfig defines configuration parameters for notifiers plugins type NotifierConfig struct { FsEvents []string `json:"fs_events" mapstructure:"fs_events"` ProviderEvents []string `json:"provider_events" mapstructure:"provider_events"` ProviderObjects []string `json:"provider_objects" mapstructure:"provider_objects"` LogEvents []int `json:"log_events" mapstructure:"log_events"` RetryMaxTime int `json:"retry_max_time" mapstructure:"retry_max_time"` RetryQueueMaxSize int `json:"retry_queue_max_size" mapstructure:"retry_queue_max_size"` } func (c *NotifierConfig) hasActions() bool { if len(c.FsEvents) > 0 { return true } if len(c.ProviderEvents) > 0 && len(c.ProviderObjects) > 0 { return true } if len(c.LogEvents) > 0 { return true } return false } type eventsQueue struct { sync.RWMutex fsEvents []*notifier.FsEvent providerEvents []*notifier.ProviderEvent logEvents []*notifier.LogEvent } func (q *eventsQueue) addFsEvent(event *notifier.FsEvent) { q.Lock() defer q.Unlock() q.fsEvents = append(q.fsEvents, event) } func (q *eventsQueue) addProviderEvent(event *notifier.ProviderEvent) { q.Lock() defer q.Unlock() q.providerEvents = append(q.providerEvents, event) } func (q *eventsQueue) addLogEvent(event *notifier.LogEvent) { q.Lock() defer q.Unlock() q.logEvents = append(q.logEvents, event) } func (q *eventsQueue) popFsEvent() *notifier.FsEvent { q.Lock() defer q.Unlock() if len(q.fsEvents) == 0 { return nil } truncLen := len(q.fsEvents) - 1 ev := q.fsEvents[truncLen] q.fsEvents[truncLen] = nil q.fsEvents = q.fsEvents[:truncLen] return ev } func (q *eventsQueue) popProviderEvent() *notifier.ProviderEvent { q.Lock() defer q.Unlock() if len(q.providerEvents) == 0 { return nil } truncLen := len(q.providerEvents) - 1 ev := q.providerEvents[truncLen] q.providerEvents[truncLen] = nil q.providerEvents = q.providerEvents[:truncLen] return ev } func (q *eventsQueue) popLogEvent() *notifier.LogEvent { q.Lock() defer q.Unlock() if len(q.logEvents) == 0 { return nil } truncLen := len(q.logEvents) - 1 ev := q.logEvents[truncLen] q.logEvents[truncLen] = nil q.logEvents = q.logEvents[:truncLen] return ev } func (q *eventsQueue) getSize() int { q.RLock() defer q.RUnlock() return len(q.providerEvents) + len(q.fsEvents) + len(q.logEvents) } type notifierPlugin struct { config Config notifier notifier.Notifier client *plugin.Client queue *eventsQueue } func newNotifierPlugin(config Config) (*notifierPlugin, error) { p := ¬ifierPlugin{ config: config, queue: &eventsQueue{}, } if err := p.initialize(); err != nil { logger.Warn(logSender, "", "unable to create notifier plugin: %v, config %+v", err, config) return nil, err } return p, nil } func (p *notifierPlugin) exited() bool { return p.client.Exited() } func (p *notifierPlugin) cleanup() { p.client.Kill() } func (p *notifierPlugin) initialize() error { killProcess(p.config.Cmd) logger.Debug(logSender, "", "create new notifier plugin %q", p.config.Cmd) if !p.config.NotifierOptions.hasActions() { return fmt.Errorf("no actions defined for the notifier plugin %q", p.config.Cmd) } secureConfig, err := p.config.getSecureConfig() if err != nil { return err } client := plugin.NewClient(&plugin.ClientConfig{ HandshakeConfig: notifier.Handshake, Plugins: notifier.PluginMap, Cmd: p.config.getCommand(), SkipHostEnv: true, AllowedProtocols: []plugin.Protocol{ plugin.ProtocolGRPC, }, AutoMTLS: p.config.AutoMTLS, SecureConfig: secureConfig, Managed: false, Logger: &logger.HCLogAdapter{ Logger: hclog.New(&hclog.LoggerOptions{ Name: fmt.Sprintf("%v.%v", logSender, notifier.PluginName), Level: pluginsLogLevel, DisableTime: true, }), }, }) rpcClient, err := client.Client() if err != nil { logger.Debug(logSender, "", "unable to get rpc client for plugin %q: %v", p.config.Cmd, err) return err } raw, err := rpcClient.Dispense(notifier.PluginName) if err != nil { logger.Debug(logSender, "", "unable to get plugin %v from rpc client for command %q: %v", notifier.PluginName, p.config.Cmd, err) return err } p.client = client p.notifier = raw.(notifier.Notifier) return nil } func (p *notifierPlugin) canQueueEvent(timestamp int64) bool { if p.config.NotifierOptions.RetryMaxTime == 0 { return false } if time.Now().After(time.Unix(0, timestamp).Add(time.Duration(p.config.NotifierOptions.RetryMaxTime) * time.Second)) { logger.Warn(logSender, "", "dropping too late event for plugin %v, event timestamp: %v", p.config.Cmd, time.Unix(0, timestamp)) return false } if p.config.NotifierOptions.RetryQueueMaxSize > 0 { return p.queue.getSize() < p.config.NotifierOptions.RetryQueueMaxSize } return true } func (p *notifierPlugin) notifyFsAction(event *notifier.FsEvent) { if !slices.Contains(p.config.NotifierOptions.FsEvents, event.Action) { return } go func() { Handler.addTask() defer Handler.removeTask() p.sendFsEvent(event) }() } func (p *notifierPlugin) notifyProviderAction(event *notifier.ProviderEvent, object Renderer) { if !slices.Contains(p.config.NotifierOptions.ProviderEvents, event.Action) || !slices.Contains(p.config.NotifierOptions.ProviderObjects, event.ObjectType) { return } go func() { Handler.addTask() defer Handler.removeTask() objectAsJSON, err := object.RenderAsJSON(event.Action != "delete") if err != nil { logger.Warn(logSender, "", "unable to render user as json for action %v: %v", event.Action, err) return } event.ObjectData = objectAsJSON p.sendProviderEvent(event) }() } func (p *notifierPlugin) notifyLogEvent(event *notifier.LogEvent) { go func() { Handler.addTask() defer Handler.removeTask() p.sendLogEvent(event) }() } func (p *notifierPlugin) sendFsEvent(event *notifier.FsEvent) { if err := p.notifier.NotifyFsEvent(event); err != nil { logger.Warn(logSender, "", "unable to send fs action notification to plugin %v: %v", p.config.Cmd, err) if p.canQueueEvent(event.Timestamp) { p.queue.addFsEvent(event) } } } func (p *notifierPlugin) sendProviderEvent(event *notifier.ProviderEvent) { if err := p.notifier.NotifyProviderEvent(event); err != nil { logger.Warn(logSender, "", "unable to send user action notification to plugin %v: %v", p.config.Cmd, err) if p.canQueueEvent(event.Timestamp) { p.queue.addProviderEvent(event) } } } func (p *notifierPlugin) sendLogEvent(event *notifier.LogEvent) { if err := p.notifier.NotifyLogEvent(event); err != nil { logger.Warn(logSender, "", "unable to send log event to plugin %v: %v", p.config.Cmd, err) if p.canQueueEvent(event.Timestamp) { p.queue.addLogEvent(event) } } } func (p *notifierPlugin) sendQueuedEvents() { queueSize := p.queue.getSize() if queueSize == 0 { return } logger.Debug(logSender, "", "check queued events for notifier %q, events size: %v", p.config.Cmd, queueSize) fsEv := p.queue.popFsEvent() for fsEv != nil { go func(ev *notifier.FsEvent) { p.sendFsEvent(ev) }(fsEv) fsEv = p.queue.popFsEvent() } providerEv := p.queue.popProviderEvent() for providerEv != nil { go func(ev *notifier.ProviderEvent) { p.sendProviderEvent(ev) }(providerEv) providerEv = p.queue.popProviderEvent() } logEv := p.queue.popLogEvent() for logEv != nil { go func(ev *notifier.LogEvent) { p.sendLogEvent(ev) }(logEv) logEv = p.queue.popLogEvent() } logger.Debug(logSender, "", "queued events sent for notifier %q, new events size: %v", p.config.Cmd, p.queue.getSize()) }