Go keyring library

go-keyring is an OS agnostic library for setting, getting and deleting secrets from the system keyring. It currently support OS X and Linux (dbus). A NO-OP implementation for Windows is also included to make it portable.

Dependencies

OS X

The OS X implementation depends on the /usr/bin/security binary for interfacing with the OS X keychain. It should be available by default.

Linux

The Linux implementation depends on the Secret Service dbus interface which is provided by gnome-keyring.

It's expected that the default collection login exists in the keyring, this is default in most distros. If it doesn't exist you can create it through the keyring frontend program seahorse.

• Open seahorse
• Go to File > New > Password Keyring
• Click Continue
• When asked for a name, use: login

Usage

How to set and get a secret from the keyring.

package main

import (
    "log"

    "github.com/mikkeloscar/go-keyring"
)

func main() {
    service := "my-app"
    user := "anon"
    password := "secret"

    // set password
    err := keyring.Set(service, user, password)
    if err != nil {
        log.Fatal(err)
    }

    // get password
    secret, err := keyring.Get(service, user)
    if err != nil {
        log.Fatal(err)
    }

    log.Println(secret)
}

Tests

Running the tests is simple, just run:

go test

however they depend on your OS. E.g. if you run the tests on Linux it will test the implementation in keyring_linux.go and similar if running the tests in OS X it will test the implementation in keyring_darwin.go.

License

See LICENSE file.