Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

secretref

package

Go to main page

Versions in this module

v1

v1.13.0

Mar 18, 2026

Changes in this version

type KeychainBackend

+ func (b *KeychainBackend) DefaultRef(storeName, account string) string

+ func (b *KeychainBackend) DisplayName() string

+ func (b *KeychainBackend) Exists(ctx context.Context, ref Ref) (bool, error)

+ func (b *KeychainBackend) Scheme() string

+ func (b *KeychainBackend) Store(ctx context.Context, ref Ref, value string) error

+ func (b *KeychainBackend) WriteSupported() bool

type Resolver

+ func (r *Resolver) Exists(ctx context.Context, raw string) (bool, error)

+ func (r *Resolver) Store(ctx context.Context, raw, value string) error

+ func (r *Resolver) WritableBackends() []WritableBackend

+ type SecretServiceBackend struct

+ func NewSecretServiceBackend() *SecretServiceBackend

+ func (b *SecretServiceBackend) DefaultRef(storeName, account string) string

+ func (b *SecretServiceBackend) DisplayName() string

+ func (b *SecretServiceBackend) Exists(ctx context.Context, ref Ref) (bool, error)

+ func (b *SecretServiceBackend) Resolve(ctx context.Context, ref Ref) (string, error)

+ func (b *SecretServiceBackend) Scheme() string

+ func (b *SecretServiceBackend) Store(ctx context.Context, ref Ref, value string) error

+ func (b *SecretServiceBackend) WriteSupported() bool

+ type WincredBackend struct

+ func NewWincredBackend() *WincredBackend

+ func (b *WincredBackend) DefaultRef(storeName, account string) string

+ func (b *WincredBackend) DisplayName() string

+ func (b *WincredBackend) Exists(ctx context.Context, ref Ref) (bool, error)

+ func (b *WincredBackend) Resolve(ctx context.Context, ref Ref) (string, error)

+ func (b *WincredBackend) Scheme() string

+ func (b *WincredBackend) Store(ctx context.Context, ref Ref, value string) error

+ func (b *WincredBackend) WriteSupported() bool

+ type WritableBackend interface

+ DefaultRef func(storeName, account string) string

+ DisplayName func() string

+ Exists func(ctx context.Context, ref Ref) (bool, error)

+ Scheme func() string

+ Store func(ctx context.Context, ref Ref, value string) error

+ WriteSupported func() bool

v1.12.1

Mar 16, 2026

v1.12.0

Mar 16, 2026

Changes in this version

+ type Backend interface

+ Resolve func(ctx context.Context, ref Ref) (string, error)

+ type EnvBackend struct

+ func NewEnvBackend(lookup EnvLookup) *EnvBackend

+ func (b *EnvBackend) Resolve(_ context.Context, ref Ref) (string, error)

+ type EnvLookup func(string) (string, bool)

+ type Error struct

+ Detail string

+ Err error

+ Kind ErrorKind

+ Ref string

+ func (e *Error) Error() string

+ func (e *Error) Unwrap() error

+ type ErrorKind string

+ const KindBackendUnavailable

+ const KindInvalidRef

+ const KindNotFound

+ type KeychainBackend struct

+ func NewKeychainBackend() *KeychainBackend

+ func (b *KeychainBackend) Resolve(ctx context.Context, ref Ref) (string, error)

+ type Ref struct

+ Path string

+ Raw string

+ Scheme string

+ func Parse(raw string) (Ref, error)

+ type Resolver struct

+ func NewDefaultResolver() *Resolver

+ func NewResolver(backends map[string]Backend) *Resolver

+ func (r *Resolver) Resolve(ctx context.Context, raw string) (string, error)