https://github.com/tobischo/gokeepasslib

A library to read and write keepass 2 files written in go
https://github.com/tobischo/gokeepasslib

Last synced: 6 days ago
JSON representation

A library to read and write keepass 2 files written in go

• Host: GitHub
• URL: https://github.com/tobischo/gokeepasslib
• Owner: tobischo
• License: mit
• Created: 2015-06-20T22:20:06.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2024-05-13T13:16:39.000Z (8 months ago)
• Last Synced: 2024-05-17T00:32:30.568Z (8 months ago)
• Language: Go
• Homepage:
• Size: 873 KB
• Stars: 237
• Watchers: 13
• Forks: 30
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.md

Awesome Lists containing this project

• my-awesome - tobischo/gokeepasslib - 12 star:0.3k fork:0.0k A library to read and write keepass 2 files written in go (Go)

README

        
gokeepasslib

============

![GitHub](https://img.shields.io/github/license/tobischo/gokeepasslib) ![Build Status](https://github.com/tobischo/gokeepasslib/actions/workflows/test.yml/badge.svg)  ![GitHub go.mod Go version](https://img.shields.io/github/go-mod/go-version/tobischo/gokeepasslib/master) ![GitHub release (latest by date)](https://img.shields.io/github/v/release/tobischo/gokeepasslib)

gokeepasslib is a library which allows reading Keepass 2 files (kdbx).

Note: only Keepass v2.30 or higher is properly supported since earlier versions do not allow empty XML tags but expected self-closing tags (which is valid XML but not really supported by Golang on XML marshaling)

Basically: this lib can probably read most Keepass2 files, but only Keepass v2.30 can be expected to read files created in this lib.

### Installing

Use `go get` to retrieve the latest version:

```

go get -u github.com/tobischo/gokeepasslib/v3@latest

```

For including it in your code:

```

import "github.com/tobischo/gokeepasslib/v3"

```

### Example: reading a file

```go

package main

import (

    "fmt"

    "github.com/tobischo/gokeepasslib/v3"

    "os"

)

func main() {

    file, _ := os.Open("examples/reading/example.kdbx")

    db := gokeepasslib.NewDatabase()

    db.Credentials = gokeepasslib.NewPasswordCredentials("abcdefg12345678")

    _ = gokeepasslib.NewDecoder(file).Decode(db)

    db.UnlockProtectedEntries()

    // Note: This is a simplified example and the groups and entries will depend on the specific file.

    // bound checking for the slices is recommended to avoid panics.

    entry := db.Content.Root.Groups[0].Groups[0].Entries[0]

    fmt.Println(entry.GetTitle())

    fmt.Println(entry.GetPassword())

}

```

Note the `db.UnlockProtectedEntries()` call: you have to unlock protected entries before using the database

and call `db.LockProtectedEntries()` before saving it to ensure that the passwords are not stored in plaintext in the xml.

In kdbx files, which are encrypted using the file credentials, fields are protected with another stream cipher.

### Example: writing a file

See [examples/writing/example-writing.go](examples/writing/example-writing.go)

### Example: deleting a file

See [examples/deleting/example-deleting.go](examples/deleting/example-deleting.go)

### TODO

* Improve code readability

* Write more tests

### Contributing

[CONTRIBUTING](CONTRIBUTING.md)

### Changelog

[CHANGELOG](CHANGELOG.md)

### License

[LICENSE](LICENSE.md)

### Copyright

Copyright © 2024 Tobias Schoknecht. All rights reserved.