vault

package
v3.1.2 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Apr 26, 2023 License: GPL-3.0 Imports: 29 Imported by: 0

Documentation

Index

Constants

View Source 
const (
	Current = v2_5_x
)
View Source 
const DefaultMaxSyncMemory = 2 * 1024 * uint64(1024*1024)
View Source 
const (
	ForbiddenRollout = 0.6046602879796196
)

Variables

View Source 
var RandomToken = crypto.RandomToken // nolint:gochecknoglobals

RandomToken is a function that returns a random token. By default, we use crypto.RandomToken to generate tokens.

Functions

func GetDefaultSyncWorkerCount 

func GetDefaultSyncWorkerCount() int

func GetHelper 

func GetHelper(vaultDir string) (string, error)

func GetVaultKey added in v3.1.0 

func GetVaultKey(kc *keychain.Keychain) ([]byte, error)

func HasVaultKey added in v3.1.0 

func HasVaultKey(kc *keychain.Keychain) (bool, error)

func NewVaultKey added in v3.1.0 

func NewVaultKey(kc *keychain.Keychain) ([]byte, error)

func SetHelper 

func SetHelper(vaultDir, helper string) error

func SetVaultKey added in v3.1.0 

func SetVaultKey(kc *keychain.Keychain, key []byte) error

Types

type AddressMode 

type AddressMode int
const (
	CombinedMode AddressMode = iota
	SplitMode
)

func (AddressMode) String 

func (mode AddressMode) String() string

type Cert 

type Cert struct {
	Cert, Key []byte
}

type Certs 

type Certs struct {
	Bridge    Cert
	Installed bool

	// If non-empty, the path to the PEM-encoded certificate file.
	CustomCertPath string
	CustomKeyPath  string
}

type Data 

type Data struct {
	Settings Settings
	Users    []UserData
	Cookies  []byte
	Certs    Certs
	Migrated bool
}

type Data_2_3_x 

type Data_2_3_x struct {
	Settings Settings_2_3_x
	Users    []UserData_2_3_x
}

type Data_2_4_x 

type Data_2_4_x struct {
	Settings Settings_2_4_x
	Users    []UserData_2_4_x
}

type File 

type File struct {
	Version Version
	Data    []byte
}

File holds a versioned, serialized data.

type Keychain 

type Keychain struct {
	Helper string
}

type Settings 

type Settings struct {
	GluonDir string

	IMAPPort int
	SMTPPort int
	IMAPSSL  bool
	SMTPSSL  bool

	UpdateChannel updater.Channel
	UpdateRollout float64

	ColorScheme  string
	ProxyAllowed bool
	ShowAllMail  bool
	Autostart    bool
	AutoUpdate   bool

	LastVersion string
	FirstStart  bool

	MaxSyncMemory uint64

	// **WARNING**: These entry can't be removed until they vault has proper migration support.
	SyncWorkers int
	SyncAttPool int
}

type Settings_2_3_x 

type Settings_2_3_x struct {
	GluonDir string

	IMAPPort string
	SMTPPort string
}

type Settings_2_4_x 

type Settings_2_4_x struct {
	GluonDir string

	IMAPPort int
	SMTPPort int
}

type SyncStatus 

type SyncStatus struct {
	HasLabels        bool
	HasMessages      bool
	LastMessageID    string
	FailedMessageIDs []string
}

func (SyncStatus) IsComplete 

func (status SyncStatus) IsComplete() bool

type User 

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

func (*User) AddFailedMessageID added in v3.0.6 

func (user *User) AddFailedMessageID(messageID string) error

AddFailedMessageID adds a message ID to the list of failed message IDs.

func (*User) AddressMode 

func (user *User) AddressMode() AddressMode

AddressMode returns the user's address mode.

func (*User) AuthRef 

func (user *User) AuthRef() string

AuthRef returns the user's auth refresh token.

func (*User) AuthUID 

func (user *User) AuthUID() string

AuthUID returns the user's auth UID.

func (*User) BridgePass 

func (user *User) BridgePass() []byte

BridgePass returns the user's bridge password as raw token bytes (unencoded).

func (*User) Clear 

func (user *User) Clear() error

Clear clears the user's auth secrets.

func (*User) ClearSyncStatus 

func (user *User) ClearSyncStatus() error

ClearSyncStatus clears the user's sync status.

func (*User) Close 

func (user *User) Close() error

Close closes the user. This allows it to be removed from the vault.

func (*User) EventID 

func (user *User) EventID() string

EventID returns the last processed event ID of the user.

func (*User) GetGluonIDs 

func (user *User) GetGluonIDs() map[string]string

func (*User) GetSyncStatus added in v3.0.14 

func (user *User) GetSyncStatus() SyncStatus

GetSyncStatus returns the user's sync status.

func (*User) GluonKey 

func (user *User) GluonKey() []byte

GluonKey returns the key needed to decrypt the user's gluon database.

func (*User) KeyPass 

func (user *User) KeyPass() []byte

KeyPass returns the user's (salted) key password.

func (*User) PrimaryEmail added in v3.0.12 

func (user *User) PrimaryEmail() string

PrimaryEmail returns the user's primary email address.

func (*User) RemFailedMessageID added in v3.0.6 

func (user *User) RemFailedMessageID(messageID string) error

RemFailedMessageID removes a message ID from the list of failed message IDs.

func (*User) RemoveGluonID 

func (user *User) RemoveGluonID(addrID, gluonID string) error

func (*User) SetAddressMode 

func (user *User) SetAddressMode(mode AddressMode) error

SetAddressMode sets the address mode for the given user.

func (*User) SetAuth 

func (user *User) SetAuth(authUID, authRef string) error

SetAuth sets the auth secrets for the given user.

func (*User) SetBridgePass added in v3.0.7 

func (user *User) SetBridgePass(newPass []byte) error

SetBridgePass saves bridge password as raw token bytes (unecoded).

func (*User) SetEventID 

func (user *User) SetEventID(eventID string) error

SetEventID sets the event ID for the given user.

func (*User) SetGluonID 

func (user *User) SetGluonID(addrID, gluonID string) error

func (*User) SetHasLabels 

func (user *User) SetHasLabels(hasLabels bool) error

SetHasLabels sets whether the user's labels have been synced.

func (*User) SetHasMessages 

func (user *User) SetHasMessages(hasMessages bool) error

SetHasMessages sets whether the user's messages have been synced.

func (*User) SetKeyPass 

func (user *User) SetKeyPass(keyPass []byte) error

SetKeyPass sets the user's (salted) key password.

func (*User) SetLastMessageID 

func (user *User) SetLastMessageID(messageID string) error

SetLastMessageID sets the last synced message ID for the given user.

func (*User) SetPrimaryEmail added in v3.0.12 

func (user *User) SetPrimaryEmail(email string) error

SetPrimaryEmail sets the user's primary email address.

func (*User) SyncStatus 

func (user *User) SyncStatus() SyncStatus

SyncStatus return's the user's sync status.

func (*User) UserID 

func (user *User) UserID() string

func (*User) Username 

func (user *User) Username() string

type UserData 

type UserData struct {
	UserID       string
	Username     string
	PrimaryEmail string

	GluonKey    []byte
	GluonIDs    map[string]string
	BridgePass  []byte // raw token represented as byte slice (needs to be encoded)
	AddressMode AddressMode

	AuthUID string
	AuthRef string
	KeyPass []byte

	SyncStatus SyncStatus
	EventID    string

	// **WARNING**: This value can't be removed until we have vault migration support.
	UIDValidity map[string]imap.UID
}

UserData holds information about a single bridge user. The user may or may not be logged in.

type UserData_2_3_x 

type UserData_2_3_x struct {
	ID   string
	Name string

	GluonKey  []byte
	SplitMode bool
}

type UserData_2_4_x 

type UserData_2_4_x struct {
	UserID   string
	Username string

	GluonKey  string
	SplitMode bool
}

type Vault 

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

Vault is an encrypted data vault that stores bridge and user data.

func New 

func New(vaultDir, gluonCacheDir string, key []byte, panicHandler async.PanicHandler) (*Vault, bool, error)

New constructs a new encrypted data vault at the given filepath using the given encryption key.

func (*Vault) AddUser 

func (vault *Vault) AddUser(userID, username, primaryEmail, authUID, authRef string, keyPass []byte) (*User, error)

AddUser creates a new user in the vault with the given ID, username and password. A bridge password and gluon key are generated using the package's token generator.

func (*Vault) Close 

func (vault *Vault) Close() error

func (*Vault) DeleteUser 

func (vault *Vault) DeleteUser(userID string) error

DeleteUser removes the given user from the vault.

func (*Vault) ForUser 

func (vault *Vault) ForUser(parallelism int, fn func(*User) error) error

ForUser executes a callback for each user in the vault.

func (*Vault) GetAutoUpdate 

func (vault *Vault) GetAutoUpdate() bool

GetAutoUpdate sets whether the bridge should automatically update.

func (*Vault) GetAutostart 

func (vault *Vault) GetAutostart() bool

GetAutostart sets whether the bridge should autostart.

func (*Vault) GetBridgeTLSCert 

func (vault *Vault) GetBridgeTLSCert() ([]byte, []byte)

GetBridgeTLSCert returns the PEM-encoded certificate for the bridge. If CertPEMPath is set, it will attempt to read the certificate from the file. Otherwise, or on read/validation failure, it will return the certificate from the vault.

func (*Vault) GetCertsInstalled 

func (vault *Vault) GetCertsInstalled() bool

func (*Vault) GetColorScheme 

func (vault *Vault) GetColorScheme() string

GetColorScheme sets the color scheme to be used by the bridge GUI.

func (*Vault) GetCookies 

func (vault *Vault) GetCookies() ([]byte, error)

func (*Vault) GetFirstStart 

func (vault *Vault) GetFirstStart() bool

GetFirstStart returns whether this is the first time the bridge has been started.

func (*Vault) GetGluonCacheDir added in v3.0.12 

func (vault *Vault) GetGluonCacheDir() string

GetGluonCacheDir sets the directory where the gluon should store its data.

func (*Vault) GetIMAPPort 

func (vault *Vault) GetIMAPPort() int

GetIMAPPort sets the port that the IMAP server should listen on.

func (*Vault) GetIMAPSSL 

func (vault *Vault) GetIMAPSSL() bool

GetIMAPSSL sets whether the IMAP server should use SSL.

func (*Vault) GetLastVersion 

func (vault *Vault) GetLastVersion() *semver.Version

GetLastVersion returns the last version of the bridge that was run.

func (*Vault) GetMaxSyncMemory added in v3.1.0 

func (vault *Vault) GetMaxSyncMemory() uint64

GetMaxSyncMemory returns the maximum amount of memory the sync process should use.

func (*Vault) GetProxyAllowed 

func (vault *Vault) GetProxyAllowed() bool

GetProxyAllowed sets whether the bridge is allowed to use alternative routing.

func (*Vault) GetSMTPPort 

func (vault *Vault) GetSMTPPort() int

GetSMTPPort sets the port that the SMTP server should listen on.

func (*Vault) GetSMTPSSL 

func (vault *Vault) GetSMTPSSL() bool

GetSMTPSSL sets whether the SMTP server should use SSL.

func (*Vault) GetShowAllMail 

func (vault *Vault) GetShowAllMail() bool

GetShowAllMail sets whether the bridge should show the All Mail folder.

func (*Vault) GetUpdateChannel 

func (vault *Vault) GetUpdateChannel() updater.Channel

GetUpdateChannel sets the update channel.

func (*Vault) GetUpdateRollout 

func (vault *Vault) GetUpdateRollout() float64

GetUpdateRollout sets the update rollout.

func (*Vault) GetUser 

func (vault *Vault) GetUser(userID string, fn func(*User)) error

GetUser provides access to a vault user. It returns an error if the user does not exist.

func (*Vault) GetUserIDs 

func (vault *Vault) GetUserIDs() []string

GetUserIDs returns the user IDs and usernames of all users in the vault.

func (*Vault) HasUser 

func (vault *Vault) HasUser(userID string) bool

HasUser returns true if the vault contains a user with the given ID.

func (*Vault) Migrated 

func (vault *Vault) Migrated() bool

func (*Vault) NewUser 

func (vault *Vault) NewUser(userID string) (*User, error)

NewUser returns a new vault user. It must be closed before it can be deleted.

func (*Vault) Path added in v3.1.0 

func (vault *Vault) Path() string

func (*Vault) Reset 

func (vault *Vault) Reset(gluonDir string) error

func (*Vault) SetAutoUpdate 

func (vault *Vault) SetAutoUpdate(autoUpdate bool) error

SetAutoUpdate sets whether the bridge should automatically update.

func (*Vault) SetAutostart 

func (vault *Vault) SetAutostart(autostart bool) error

SetAutostart sets whether the bridge should autostart.

func (*Vault) SetBridgeTLSCertKey added in v3.0.21 

func (vault *Vault) SetBridgeTLSCertKey(cert, key []byte) error

SetBridgeTLSCertKey sets the path to PEM-encoded certificates for the bridge.

func (*Vault) SetBridgeTLSCertPath added in v3.1.0 

func (vault *Vault) SetBridgeTLSCertPath(certPath, keyPath string) error

SetBridgeTLSCertPath sets the path to PEM-encoded certificates for the bridge.

func (*Vault) SetCertsInstalled 

func (vault *Vault) SetCertsInstalled(installed bool) error

func (*Vault) SetColorScheme 

func (vault *Vault) SetColorScheme(colorScheme string) error

SetColorScheme sets the color scheme to be used by the bridge GUI.

func (*Vault) SetCookies 

func (vault *Vault) SetCookies(cookies []byte) error

func (*Vault) SetFirstStart 

func (vault *Vault) SetFirstStart(firstStart bool) error

SetFirstStart sets whether this is the first time the bridge has been started.

func (*Vault) SetGluonDir 

func (vault *Vault) SetGluonDir(dir string) error

SetGluonDir sets the directory where the gluon should store its data.

func (*Vault) SetIMAPPort 

func (vault *Vault) SetIMAPPort(port int) error

SetIMAPPort sets the port that the IMAP server should listen on.

func (*Vault) SetIMAPSSL 

func (vault *Vault) SetIMAPSSL(ssl bool) error

SetIMAPSSL sets whether the IMAP server should use SSL.

func (*Vault) SetLastVersion 

func (vault *Vault) SetLastVersion(version *semver.Version) error

SetLastVersion sets the last version of the bridge that was run.

func (*Vault) SetMaxSyncMemory added in v3.1.0 

func (vault *Vault) SetMaxSyncMemory(maxMemory uint64) error

SetMaxSyncMemory sets the maximum amount of memory the sync process should use.

func (*Vault) SetMigrated 

func (vault *Vault) SetMigrated() error

func (*Vault) SetProxyAllowed 

func (vault *Vault) SetProxyAllowed(allowed bool) error

SetProxyAllowed sets whether the bridge is allowed to use alternative routing.

func (*Vault) SetSMTPPort 

func (vault *Vault) SetSMTPPort(port int) error

SetSMTPPort sets the port that the SMTP server should listen on.

func (*Vault) SetSMTPSSL 

func (vault *Vault) SetSMTPSSL(ssl bool) error

SetSMTPSSL sets whether the SMTP server should use SSL.

func (*Vault) SetShowAllMail 

func (vault *Vault) SetShowAllMail(showAllMail bool) error

SetShowAllMail sets whether the bridge should show the All Mail folder.

func (*Vault) SetUpdateChannel 

func (vault *Vault) SetUpdateChannel(channel updater.Channel) error

SetUpdateChannel sets the update channel.

func (*Vault) SetUpdateRollout 

func (vault *Vault) SetUpdateRollout(rollout float64) error

SetUpdateRollout sets the update rollout.

type Version 

type Version int

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.