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
- API
  
  Reference documentation for the pkg.go.dev API
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

credentials

package module

Go to main page

Versions in this module

v0

v0.3.2

Aug 24, 2026

v0.3.1

Aug 5, 2026

v0.3.0

Aug 3, 2026

v0.2.2

Jul 27, 2026

v0.2.1

Jul 21, 2026

v0.2.0

Jul 19, 2026

v0.1.0

Jul 18, 2026

Changes in this version

+ const KeychainOpTimeout

+ var ErrCredentialNotFound = errors.New("credential not found in keychain")

+ var ErrCredentialUnsupported = errors.New(...)

+ func ClearKeysExcept(w KeyWriter, all []string, keep ...string)

+ func Delete(ctx context.Context, service, account string) error

+ func IsCI() bool

+ func KeychainAvailable() bool

+ func Probe(ctx context.Context) bool

+ func RefuseLiteralUnderCI(mode Mode) error

+ func RegisterBackend(b Backend)

+ func Retrieve(ctx context.Context, service, account string) (string, error)

+ func Store(ctx context.Context, service, account, secret string) error

+ func ValidateEnvVarName(name string) error

+ type Backend interface

+ Available func() bool

+ Delete func(ctx context.Context, service, account string) error

+ Retrieve func(ctx context.Context, service, account string) (string, error)

+ Store func(ctx context.Context, service, account, secret string) error

+ type KeyWriter interface

+ Set func(key string, value any)

+ type Mode string

+ const ModeEnvVar

+ const ModeKeychain

+ const ModeLiteral

+ func AvailableModes() []Mode

+ type ModeChoice struct

+ Label string

+ Mode Mode

+ func ModeChoices(ci, keychainUsable bool, envLabel, keychainLabel, literalLabel string) []ModeChoice

+ type Prompter interface

+ InputEnvVarName func(ctx context.Context, title, placeholder string, validate func(string) error) (string, error)

+ InputSecret func(ctx context.Context, title string) (string, error)

+ SelectMode func(ctx context.Context, title string, choices []ModeChoice) (Mode, error)

+ func DefaultPrompter() Prompter