secureenv

Documentation

Index

• type EnvConfig
  • func DefaultEnvConfig() *EnvConfig
• type Manager
  • func NewManager(config *EnvConfig) *Manager
  • func (m *Manager) BuildSecureEnvironment() []string
  • func (m *Manager) GetFilteredEnvCount() (filteredCount, totalCount int)
  • func (m *Manager) GetPathDiscovery() *PathDiscovery
  • func (m *Manager) GetSystemEnvVar(key string) (string, bool)
  • func (m *Manager) ValidateConfig() error
• type PathDiscovery

Types

type EnvConfig

type EnvConfig struct {
	InheritSystemSafe bool              `json:"inherit_system_safe"`
	AllowedSystemVars []string          `json:"allowed_system_vars"`
	CustomVars        map[string]string `json:"custom_vars"`
	EnhancePath       bool              `json:"enhance_path"` // Enable PATH enhancement for Launchd scenarios
}

EnvConfig represents environment configuration for secure filtering

func DefaultEnvConfig

func DefaultEnvConfig() *EnvConfig

DefaultEnvConfig returns default environment configuration with safe system variables

type Manager

type Manager struct {
	// contains filtered or unexported fields
}

Manager handles secure environment variable filtering

func NewManager

func NewManager(config *EnvConfig) *Manager

NewManager creates a new secure environment manager

func (*Manager) BuildSecureEnvironment

func (m *Manager) BuildSecureEnvironment() []string

BuildSecureEnvironment builds a secure environment variable list

func (*Manager) GetFilteredEnvCount

func (m *Manager) GetFilteredEnvCount() (filteredCount, totalCount int)

GetFilteredEnvCount returns the number of filtered and total system environment variables

func (*Manager) GetPathDiscovery

func (m *Manager) GetPathDiscovery() *PathDiscovery

GetPathDiscovery returns the discovered path information

func (*Manager) GetSystemEnvVar

func (m *Manager) GetSystemEnvVar(key string) (string, bool)

GetSystemEnvVar safely gets a system environment variable.

func (*Manager) ValidateConfig

func (m *Manager) ValidateConfig() error

ValidateConfig checks if the environment configuration is valid

type PathDiscovery

type PathDiscovery struct {
	HomePath        string
	BrewPaths       []string
	NodePaths       []string
	PythonPaths     []string
	RustPaths       []string
	GoPaths         []string
	ChocoPaths      []string
	ScoopPaths      []string
	SystemPaths     []string
	DiscoveredPaths []string
	AvailableTools  map[string]string
}

PathDiscovery contains auto-discovered paths for common tools