mirror of
https://github.com/status-im/status-go.git
synced 2025-01-10 22:56:40 +00:00
e8c4b7647f
* chore(upgradeSQLCipher): Upgrading SQLCipher to version 5.4.5 Changes: ### github.com/mutecomm/go-sqlcipher 1. The improved crypto argorighms from go-sqlcipher v3 are merged in v4 Tags: v4.4.2-status.1 - merge `burn_stack` improvement v4.4.2-status.2 - merge `SHA1` improvement v4.4.2-status.4- merge 'AES' improvement 2. Fixed `go-sqlcipher` to support v3 database in compatibility mode (`sqlcipher` already supports this) (Tag: v4.4.2-status.3) 3. Upgrade `sqlcipher` to v5.4.5 (Tag: v4.5.4-status.1) ### github.com/status-im/migrate/v4 1. Upgrade `go-sqlcipher` version in `github.com/status-im/migrate/v4` ### status-go 1. Upgrade `go-sqlcipher` and `migrate` modules in status-go 2. Configure the DB connections to open the DB in v3 compatibility mode * chore(upgradeSQLCipher): Use sqlcipher v3 configuration to encrypt a plain text database * chore(upgradeSQLCipher): Scanning NULL BLOB value should return nil Fixing failing tests: TestSyncDeviceSuite/TestPairingSyncDeviceClientAsReceiver; TestSyncDeviceSuite/TestPairingSyncDeviceClientAsSender Considering the following configuration: 1. Table with BLOB column has 1 NULL value 2. Query the value 3. Rows.Scan(&dest sql.NullString) Expected: dest.Valid == false; dest.String == nil Actual: dest.Valid == true; dest.String == "" * chore: Bump go-sqlcipher version to include NULL BLOB fix
78 lines
2.6 KiB
Markdown
78 lines
2.6 KiB
Markdown
## go-sqlcipher
|
|
|
|
[](http://godoc.org/github.com/mutecomm/go-sqlcipher) [](https://github.com/mutecomm/go-sqlcipher/actions)
|
|
|
|
### Description
|
|
|
|
Self-contained Go sqlite3 driver with an AES-256 encrypted sqlite3 database
|
|
conforming to the built-in database/sql interface. It is based on:
|
|
|
|
- Go sqlite3 driver: https://github.com/mattn/go-sqlite3
|
|
- SQLite extension with AES-256 codec: https://github.com/sqlcipher/sqlcipher
|
|
- AES-256 implementation from: https://github.com/libtom/libtomcrypt
|
|
|
|
SQLite itself is part of SQLCipher.
|
|
|
|
### Incompatibilities of SQLCipher
|
|
|
|
The version tags of go-sqlcipher are the same as for SQLCipher.
|
|
|
|
**SQLCipher 4.x is incompatible with SQLCipher 3.x!**
|
|
|
|
go-sqlcipher does not implement any migration strategies at the moment.
|
|
So if you upgrade a major version of go-sqlcipher, you yourself are responsible
|
|
to upgrade existing database files.
|
|
|
|
See [migrating databases](https://www.zetetic.net/sqlcipher/sqlcipher-api/#Migrating_Databases) for details.
|
|
|
|
To upgrade your Go code to the 4.x series, change the import path to
|
|
|
|
"github.com/mutecomm/go-sqlcipher/v4"
|
|
|
|
### Installation
|
|
|
|
This package can be installed with the go get command:
|
|
|
|
go get github.com/mutecomm/go-sqlcipher
|
|
|
|
|
|
### Documentation
|
|
|
|
To create and open encrypted database files use the following DSN parameters:
|
|
|
|
```go
|
|
key := "2DD29CA851E7B56E4697B0E1F08507293D761A05CE4D1B628663F411A8086D99"
|
|
dbname := fmt.Sprintf("db?_pragma_key=x'%s'&_pragma_cipher_page_size=4096", key)
|
|
db, _ := sql.Open("sqlite3", dbname)
|
|
```
|
|
|
|
`_pragma_key` is the hex encoded 32 byte key (must be 64 characters long).
|
|
`_pragma_cipher_page_size` is the page size of the encrypted database (set if
|
|
you want a different value than the default size).
|
|
|
|
```go
|
|
key := url.QueryEscape("secret")
|
|
dbname := fmt.Sprintf("db?_pragma_key=%s&_pragma_cipher_page_size=4096", key)
|
|
db, _ := sql.Open("sqlite3", dbname)
|
|
```
|
|
|
|
This uses a passphrase directly as `_pragma_key` with the key derivation function in
|
|
SQLCipher. Do not forget the `url.QueryEscape()` call in your code!
|
|
|
|
See also [PRAGMA key](https://www.zetetic.net/sqlcipher/sqlcipher-api/#PRAGMA_key).
|
|
|
|
API documentation can be found here:
|
|
http://godoc.org/github.com/mutecomm/go-sqlcipher
|
|
|
|
Use the function
|
|
[sqlite3.IsEncrypted()](https://godoc.org/github.com/mutecomm/go-sqlcipher#IsEncrypted)
|
|
to check whether a database file is encrypted or not.
|
|
|
|
Examples can be found under the `./_example` directory
|
|
|
|
|
|
### License
|
|
|
|
The code of the originating packages is covered by their respective licenses.
|
|
See [LICENSE](LICENSE) file for details.
|