keyring

README

keyring provides cross-platform keychain access

http://godoc.org/github.com/tmc/keyring

Keyring provides a common interface to keyring/keychain tools.

License: ISC

Currently implemented:

• OSX
• SecretService
• gnome-keychain (via "gnome_keyring" build flag)

Contributions welcome!

Usage example:

  err := keyring.Set("libraryFoo", "jack", "sacrifice")
  password, err := keyring.Get("libraryFoo", "jack")
  fmt.Println(password)
  Output: sacrifice

Example program:

 $ go get -v github.com/tmc/keyring/keyring-example && keyring-example

Linux

Linux requirements:

SecretService provider

• dbus

gnome-keychain provider

• gnome-keychain headers
• Ubuntu/Debian: libgnome-keyring-dev
• Archlinux: libgnome-keyring

Tests on Linux:

 $ go test github.com/tmc/keyring
 $ # for gnome-keyring provider
 $ go test -tags gnome_keyring github.com/tmc/keyring

Example:

 $ # for SecretService provider
 $ go get -v github.com/tmc/keyring/keyring-example && keyring-example
 $ # for gnome-keyring provider
 $ go get -v -tags gnome_keyring github.com/tmc/keyring/keyring-example && keyring-example

Documentation

Overview

Package keyring provides a cross-platform interface to keychains for password management

Currently implemented:

• OSX
• SecretService
• gnome-keychain (via "gnome_keyring" build flag)

Usage

Example usage:

err := keyring.Set("libraryFoo", "jack", "sacrifice")
password, err := keyring.Get("libraryFoo", "jack")
fmt.Println(password)
Output: sacrifice

TODO

• Write Windows provider

Index

• Variables
• func Get(Service, Username string) (string, error)
• func Set(Service, Username, Password string) error

Examples

• Get

Variables

var (
	// ErrNotFound means the requested password was not found
	ErrNotFound = errors.New("Password not found")
	// ErrNoDefault means that no default keyring provider has been found
	ErrNoDefault = errors.New("No keyring provider found (check your build flags)")
)

Functions

func Get

func Get(Service, Username string) (string, error)

Get gets the password for a paricular Service and Username using the default keyring provider.

Example

package main

import (
	"fmt"
	"github.com/tmc/keyring"
)

func main() {
	keyring.Set("keyring-test", "jack", "test password")
	pw, _ := keyring.Get("keyring-test", "jack")
	fmt.Println("pw:", pw)
	// don't ignore errors like this in your code
	

func Set

func Set(Service, Username, Password string) error

Set sets the password for a particular Service and Username using the default keyring provider.