keychain

Documentation

Overview

Package keychain implements a simple interface to the macOS Keychain. Based on /usr/bin/security.

Index

• Variables
• type Keychain
  • func New(service string) *Keychain
  • func (kc *Keychain) Delete(account string) error
  • func (kc *Keychain) Get(account string) (password string, err error)
  • func (kc *Keychain) Set(account, password string) error

Variables

var (
	// Returned by Keychain.Get() and Keychain.Delete() if the specified
	// account doesn't exist.
	ErrNotFound = errors.New("password not found")
)

Specific errors returned by the API.

Types

type Keychain

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

Keychain manages macOS Keychain passwords for a specific service.

func New

func New(service string) *Keychain

New Keychain for specified service.

func (*Keychain) Delete

func (kc *Keychain) Delete(account string) error

Delete a password from user's Keychain. Returns ErrNotFound if account doesn't exist.

func (*Keychain) Get

func (kc *Keychain) Get(account string) (password string, err error)

Get password from user's Keychain. Returns ErrNotFound if specified account doesn't exist.

func (*Keychain) Set

func (kc *Keychain) Set(account, password string) error

Set password in user's Keychain. If the account already exists, it is replaced.