secret-keeper 1.0.0 → 2.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/README.md +71 -39
- data/lib/secret-keeper.rb +42 -24
- data/spec/secret-keeper_spec.rb +77 -3
- metadata +9 -7
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 1a314a84c5cdc4c6ef06e417d3c638186eafdaeb522936e97c87a54f7050940a
|
4
|
+
data.tar.gz: 2e40a932f8d0c92aa78fea56401f4c115862c302e0c584cc8cf5f95d06faf09a
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 877c488a822ec78ca1ef89b2f58c1461de62a866bf5625954a8cb0772af3d1ba6fb789f05802c885eb6841857d4a6e5599af18e0abe129987f13777b86de9e22
|
7
|
+
data.tar.gz: 3d580b41a2585c1c2977affbad1ef8ac443b20b59074ce715265b57fc2879da1a6f848702fff8dea3fbf7ca443e70a2cf21ac5d65bf71a3edf99db2267d7f8f5
|
data/README.md
CHANGED
@@ -6,65 +6,97 @@ Keep all your secret files within openssl
|
|
6
6
|
|
7
7
|
from console
|
8
8
|
|
9
|
-
|
9
|
+
```bash
|
10
|
+
gem install secret-keeper
|
11
|
+
```
|
10
12
|
|
11
13
|
with bundler, write follwing line in your Gemfile
|
12
14
|
|
13
|
-
|
15
|
+
```bash
|
16
|
+
gem 'secret-keeper', require: false
|
17
|
+
```
|
18
|
+
|
19
|
+
## Upgrade from v1 to v2
|
20
|
+
|
21
|
+
The *remove_production* parameter of *decrypt_files* has been removed after version 2.0.0.
|
22
|
+
If you wants to remove *production* settings after decrypt files, you can set *remove_production* option to *true* in *secret-keeper.yml*:
|
23
|
+
|
24
|
+
```yaml
|
25
|
+
options:
|
26
|
+
remove_production: false
|
27
|
+
```
|
14
28
|
|
15
29
|
## Usage
|
16
30
|
setup files need to be encrypted in config/secret-keeper.yml
|
17
31
|
|
18
|
-
|
19
|
-
|
20
|
-
|
21
|
-
|
22
|
-
|
23
|
-
|
24
|
-
|
25
|
-
|
26
|
-
|
27
|
-
|
28
|
-
|
29
|
-
|
30
|
-
|
31
|
-
|
32
|
-
|
32
|
+
```yaml
|
33
|
+
# config/secret-keeper.yml example
|
34
|
+
development:
|
35
|
+
ev_name: SECRET_KEEPER
|
36
|
+
cipher: AES-256-CBC
|
37
|
+
options:
|
38
|
+
slience: false
|
39
|
+
remove_production: false
|
40
|
+
remove_source: false
|
41
|
+
tasks:
|
42
|
+
-
|
43
|
+
encrypt_from: example/database.yml
|
44
|
+
encrypt_to: example/database.yml.enc
|
45
|
+
# decrypt_from: example/database.yml.enc
|
46
|
+
# decrypt_to: example/database.yml
|
47
|
+
-
|
48
|
+
encrypt_from: example/secrets_from_other_source.yml
|
49
|
+
encrypt_to: example/secrets.yml.enc
|
50
|
+
# decrypt_from: example/secrets.yml.enc
|
51
|
+
decrypt_to: example/secrets.yml
|
52
|
+
```
|
33
53
|
|
34
54
|
using environment variable SECRET_KEEPER to be your key of cipher
|
35
55
|
|
36
|
-
|
56
|
+
```bash
|
57
|
+
$> SECRET_KEEPER=[YOUR-CIPHER-KEY-HERE] irb
|
58
|
+
```
|
37
59
|
|
38
60
|
require on demand
|
39
61
|
|
40
|
-
|
62
|
+
```bash
|
63
|
+
irb> require 'secret-keeper'
|
64
|
+
```
|
41
65
|
|
42
66
|
encrypt files based on your tasks defined in config/secret-keeper.yml
|
43
67
|
|
44
|
-
|
45
|
-
|
46
|
-
|
47
|
-
|
48
|
-
|
68
|
+
```bash
|
69
|
+
irb> SecretKeeper.encrypt_files
|
70
|
+
# Encrypting...
|
71
|
+
# * example/database.yml --> example/database.yml.enc, ok
|
72
|
+
# * example/secrets.yml --> example/secrets.yml.enc, ok
|
73
|
+
# Done!
|
74
|
+
```
|
49
75
|
|
50
76
|
decrypt files based on your tasks defined in config/secret-keeper.yml
|
51
77
|
|
52
|
-
|
53
|
-
|
54
|
-
|
55
|
-
|
56
|
-
|
78
|
+
```bash
|
79
|
+
irb> SecretKeeper.decrypt_files
|
80
|
+
# Decrypting...
|
81
|
+
# * example/database.yml.enc --> example/database.yml, ok
|
82
|
+
# * example/secrets.yml.enc --> example/secrets.yml, ok
|
83
|
+
# Done!
|
84
|
+
```
|
57
85
|
|
58
|
-
|
86
|
+
## Available Ciphers
|
59
87
|
|
60
|
-
|
61
|
-
|
62
|
-
|
63
|
-
|
64
|
-
# * example/secrets.yml.enc --> example/secrets.yml, ok
|
65
|
-
# Done!
|
88
|
+
```bash
|
89
|
+
irb> require 'openssl'
|
90
|
+
irb> OpenSSL::Cipher.ciphers
|
91
|
+
```
|
66
92
|
|
67
|
-
##
|
93
|
+
## Options
|
94
|
+
|
95
|
+
* slience
|
96
|
+
When this option set to *true*, the tasks will run in slience mode. Messages will not show no screen. Default is *false*.
|
97
|
+
|
98
|
+
* remove_production
|
99
|
+
When this option set to *true*, the *production* settings in the decrypted files will be removed after the decryption task. Default is *false*.
|
68
100
|
|
69
|
-
|
70
|
-
|
101
|
+
* remove_source
|
102
|
+
When this option set to *true*, the source file will be removed after either encrypt or decrypt tasks. Default is *false*.
|
data/lib/secret-keeper.rb
CHANGED
@@ -2,27 +2,37 @@ require 'openssl'
|
|
2
2
|
require 'yaml'
|
3
3
|
|
4
4
|
class SecretKeeper
|
5
|
+
attr_reader :tasks, :options
|
6
|
+
|
5
7
|
def self.encrypt_files
|
8
|
+
printer = ['Encrypting...']
|
6
9
|
sk = SecretKeeper.new
|
7
|
-
|
10
|
+
printer << '(production config removed)' if sk.options['remove_production']
|
11
|
+
printer << '(source files removed)' if sk.options['remove_source']
|
8
12
|
ok_queue = []
|
9
13
|
sk.tasks.each do |task|
|
10
|
-
from = task['encrypt_from']
|
14
|
+
from = File.exist?(task['encrypt_from']) ? task['encrypt_from'] : task['decrypt_to']
|
11
15
|
to = task['encrypt_to']
|
12
16
|
|
13
17
|
result = sk.encrypt_file(from, to)
|
18
|
+
if result == :ok
|
19
|
+
result = sk.remove_file(from) if sk.options['remove_source']
|
20
|
+
end
|
21
|
+
|
14
22
|
ok_queue << result if result == :ok
|
15
|
-
|
23
|
+
printer << " * #{from} --> #{to}, #{result}"
|
16
24
|
end
|
17
25
|
success = ok_queue.count == sk.tasks.count
|
18
|
-
|
26
|
+
printer << (success ? 'Done!' : 'Failed!')
|
27
|
+
printer.each{ |row| puts row } unless sk.options['slience']
|
19
28
|
success
|
20
29
|
end
|
21
30
|
|
22
|
-
def self.decrypt_files
|
31
|
+
def self.decrypt_files
|
32
|
+
printer = ['Decrypting...']
|
23
33
|
sk = SecretKeeper.new
|
24
|
-
|
25
|
-
|
34
|
+
printer << '(production config removed)' if sk.options['remove_production']
|
35
|
+
printer << '(source files removed)' if sk.options['remove_source']
|
26
36
|
|
27
37
|
ok_queue = []
|
28
38
|
sk.tasks.each do |task|
|
@@ -30,16 +40,17 @@ class SecretKeeper
|
|
30
40
|
to = task['decrypt_to'] || task['encrypt_from']
|
31
41
|
|
32
42
|
result = sk.decrypt_file(from, to)
|
33
|
-
|
34
|
-
|
35
|
-
result = sk.
|
43
|
+
if result == :ok
|
44
|
+
result = sk.remove_production_config(to) if sk.options['remove_production']
|
45
|
+
result = sk.remove_file(from) if sk.options['remove_source']
|
36
46
|
end
|
37
47
|
|
38
48
|
ok_queue << result if result == :ok
|
39
|
-
|
49
|
+
printer << " * #{from} --> #{to}, #{result}"
|
40
50
|
end
|
41
51
|
success = ok_queue.count == sk.tasks.count
|
42
|
-
|
52
|
+
printer << (success ? 'Done!' : 'Failed!')
|
53
|
+
printer.each{ |row| puts row } unless sk.options['slience']
|
43
54
|
success
|
44
55
|
end
|
45
56
|
|
@@ -47,8 +58,12 @@ class SecretKeeper
|
|
47
58
|
env = ENV['RAILS_ENV'] || 'development'
|
48
59
|
string = File.open('config/secret-keeper.yml', 'rb') { |f| f.read }
|
49
60
|
fail 'config/secret-keeper.yml not existed nor not readable' if string.nil?
|
50
|
-
|
51
|
-
|
61
|
+
begin
|
62
|
+
config = YAML.load(string, aliases: true)[env] || {}
|
63
|
+
rescue ArgumentError
|
64
|
+
config = YAML.load(string)[env] || {}
|
65
|
+
end
|
66
|
+
fail 'config/secret-keeper.yml incorrect or environment not exist' if config.nil? || config.empty?
|
52
67
|
ev_name = config['ev_name'] || 'SECRET_KEEPER'
|
53
68
|
fail "environment variable #{ev_name} not exist" if ENV[ev_name].nil?
|
54
69
|
|
@@ -56,15 +71,7 @@ class SecretKeeper
|
|
56
71
|
@using_cipher = OpenSSL::Cipher.new(config['cipher'] || 'AES-256-CBC')
|
57
72
|
@cipher_key = Digest::SHA2.hexdigest(ENV[ev_name])[0...@using_cipher.key_len]
|
58
73
|
|
59
|
-
@
|
60
|
-
end
|
61
|
-
|
62
|
-
def tasks
|
63
|
-
@tasks
|
64
|
-
end
|
65
|
-
|
66
|
-
def slience
|
67
|
-
@slience
|
74
|
+
@options = config['options']
|
68
75
|
end
|
69
76
|
|
70
77
|
def encrypt_file(from_file, to_file)
|
@@ -85,7 +92,11 @@ class SecretKeeper
|
|
85
92
|
|
86
93
|
def remove_production_config(file_path)
|
87
94
|
return :ok unless file_path =~ /\.yml/
|
88
|
-
|
95
|
+
begin
|
96
|
+
hash = YAML.load_file(file_path, aliases: true)
|
97
|
+
rescue ArgumentError
|
98
|
+
hash = YAML.load_file(file_path)
|
99
|
+
end
|
89
100
|
hash.delete('production')
|
90
101
|
File.write(file_path, YAML.dump(hash))
|
91
102
|
:ok
|
@@ -93,6 +104,13 @@ class SecretKeeper
|
|
93
104
|
e
|
94
105
|
end
|
95
106
|
|
107
|
+
def remove_file(file_path)
|
108
|
+
File.delete(file_path)
|
109
|
+
:ok
|
110
|
+
rescue => e
|
111
|
+
e
|
112
|
+
end
|
113
|
+
|
96
114
|
private
|
97
115
|
|
98
116
|
def encrypt(data)
|
data/spec/secret-keeper_spec.rb
CHANGED
@@ -1,6 +1,12 @@
|
|
1
1
|
describe SecretKeeper do
|
2
2
|
before(:each) do
|
3
3
|
ENV['SECRET_KEEPER'] = 'PASSWORD_HERE'
|
4
|
+
FileUtils.copy_entry('./example', './example_backup')
|
5
|
+
end
|
6
|
+
|
7
|
+
after(:each) do
|
8
|
+
FileUtils.rm_r('./example')
|
9
|
+
FileUtils.mv('./example_backup', './example')
|
4
10
|
end
|
5
11
|
|
6
12
|
describe '.encrypt_files' do
|
@@ -8,23 +14,91 @@ describe SecretKeeper do
|
|
8
14
|
result = SecretKeeper.encrypt_files
|
9
15
|
expect(result).to eq(true)
|
10
16
|
end
|
17
|
+
|
18
|
+
it 'should return true on remove_source true' do
|
19
|
+
options = {
|
20
|
+
'slience' => true,
|
21
|
+
'remove_production' => false,
|
22
|
+
'remove_source' => true
|
23
|
+
}
|
24
|
+
allow_any_instance_of(SecretKeeper).to receive(:options).and_return(options)
|
25
|
+
|
26
|
+
result = SecretKeeper.encrypt_files
|
27
|
+
expect(result).to eq(true)
|
28
|
+
SecretKeeper.new.tasks.each do |task|
|
29
|
+
source_file = task['encrypt_from']
|
30
|
+
target_file = task['encrypt_to']
|
31
|
+
expect(File.exist?(source_file)).to eq(false)
|
32
|
+
expect(File.exist?(target_file)).to eq(true)
|
33
|
+
end
|
34
|
+
end
|
11
35
|
end
|
12
36
|
|
13
37
|
describe '.decrypt_files' do
|
14
38
|
it 'should return true' do
|
15
39
|
result = SecretKeeper.decrypt_files
|
16
40
|
expect(result).to eq(true)
|
17
|
-
|
41
|
+
begin
|
42
|
+
hash = YAML.load_file('example/secrets.yml', aliases: true)
|
43
|
+
rescue ArgumentError
|
44
|
+
hash = YAML.load_file('example/secrets.yml')
|
45
|
+
end
|
18
46
|
expect(hash['development']['secret_key_base']).to eq('e8310af93d52f174f475940c41fbfb90417b300ebc19e1b24bd5639f4fe35c5ffaa5775a347ace9732958f656a47f6bb8e1fd0760b12e51b0b4fe1f65ef0a1d6')
|
19
47
|
expect(hash['production']['secret_key_base']).to eq('339f639f4fe35c5ffaa47ace973260b12e51b0b4fe1f65effd283a5f054f47594b24bd565779e351a20dfd4ada4f777958f0417b305c06cdedbde392b8e1fd07')
|
20
48
|
end
|
21
49
|
|
22
|
-
it 'should return true on remove_production true' do
|
23
|
-
|
50
|
+
it 'should return true on remove_production true and remove_source false' do
|
51
|
+
options = {
|
52
|
+
'slience' => true,
|
53
|
+
'remove_production' => true,
|
54
|
+
'remove_source' => false
|
55
|
+
}
|
56
|
+
allow_any_instance_of(SecretKeeper).to receive(:options).and_return(options)
|
57
|
+
|
58
|
+
result = SecretKeeper.decrypt_files
|
59
|
+
expect(result).to eq(true)
|
60
|
+
hash = YAML.load_file('example/secrets.yml')
|
61
|
+
expect(hash['development']['secret_key_base']).to eq('e8310af93d52f174f475940c41fbfb90417b300ebc19e1b24bd5639f4fe35c5ffaa5775a347ace9732958f656a47f6bb8e1fd0760b12e51b0b4fe1f65ef0a1d6')
|
62
|
+
expect(hash['production']).to be_nil
|
63
|
+
end
|
64
|
+
|
65
|
+
it 'should return true on remove_production false and remove_source true' do
|
66
|
+
options = {
|
67
|
+
'slience' => true,
|
68
|
+
'remove_production' => false,
|
69
|
+
'remove_source' => true
|
70
|
+
}
|
71
|
+
allow_any_instance_of(SecretKeeper).to receive(:options).and_return(options)
|
72
|
+
|
73
|
+
result = SecretKeeper.decrypt_files
|
74
|
+
expect(result).to eq(true)
|
75
|
+
SecretKeeper.new.tasks.each do |task|
|
76
|
+
source_file = task['decrypt_from'] || task['encrypt_to']
|
77
|
+
target_file = task['decrypt_to'] || task['encrypt_from']
|
78
|
+
expect(File.exist?(source_file)).to eq(false)
|
79
|
+
expect(File.exist?(target_file)).to eq(true)
|
80
|
+
end
|
81
|
+
end
|
82
|
+
|
83
|
+
it 'should return true on remove_production true and remove_source true' do
|
84
|
+
options = {
|
85
|
+
'slience' => true,
|
86
|
+
'remove_production' => true,
|
87
|
+
'remove_source' => true
|
88
|
+
}
|
89
|
+
allow_any_instance_of(SecretKeeper).to receive(:options).and_return(options)
|
90
|
+
|
91
|
+
result = SecretKeeper.decrypt_files
|
24
92
|
expect(result).to eq(true)
|
25
93
|
hash = YAML.load_file('example/secrets.yml')
|
26
94
|
expect(hash['development']['secret_key_base']).to eq('e8310af93d52f174f475940c41fbfb90417b300ebc19e1b24bd5639f4fe35c5ffaa5775a347ace9732958f656a47f6bb8e1fd0760b12e51b0b4fe1f65ef0a1d6')
|
27
95
|
expect(hash['production']).to be_nil
|
96
|
+
SecretKeeper.new.tasks.each do |task|
|
97
|
+
source_file = task['decrypt_from'] || task['encrypt_to']
|
98
|
+
target_file = task['decrypt_to'] || task['encrypt_from']
|
99
|
+
expect(File.exist?(source_file)).to eq(false)
|
100
|
+
expect(File.exist?(target_file)).to eq(true)
|
101
|
+
end
|
28
102
|
end
|
29
103
|
|
30
104
|
it 'should be false, if SECRET_KEEPER incorrect' do
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: secret-keeper
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version:
|
4
|
+
version: 2.0.1
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Ray Lee
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date:
|
11
|
+
date: 2023-05-11 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: rspec
|
@@ -16,14 +16,14 @@ dependencies:
|
|
16
16
|
requirements:
|
17
17
|
- - "~>"
|
18
18
|
- !ruby/object:Gem::Version
|
19
|
-
version: '3.
|
19
|
+
version: '3.9'
|
20
20
|
type: :development
|
21
21
|
prerelease: false
|
22
22
|
version_requirements: !ruby/object:Gem::Requirement
|
23
23
|
requirements:
|
24
24
|
- - "~>"
|
25
25
|
- !ruby/object:Gem::Version
|
26
|
-
version: '3.
|
26
|
+
version: '3.9'
|
27
27
|
description: A Secret keeper
|
28
28
|
email: ray-lee@kdanmobile.com
|
29
29
|
executables: []
|
@@ -37,7 +37,9 @@ files:
|
|
37
37
|
homepage: https://github.com/kdan-mobile-software-ltd/secret-keeper
|
38
38
|
licenses:
|
39
39
|
- MIT
|
40
|
-
metadata:
|
40
|
+
metadata:
|
41
|
+
source_code_uri: https://github.com/kdan-mobile-software-ltd/secret-keeper
|
42
|
+
changelog_uri: https://github.com/kdan-mobile-software-ltd/secret-keeper/blob/master/CHANGELOG.md
|
41
43
|
post_install_message:
|
42
44
|
rdoc_options:
|
43
45
|
- "--charset=UTF-8"
|
@@ -47,14 +49,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
|
|
47
49
|
requirements:
|
48
50
|
- - ">="
|
49
51
|
- !ruby/object:Gem::Version
|
50
|
-
version: 2.
|
52
|
+
version: 2.7.0
|
51
53
|
required_rubygems_version: !ruby/object:Gem::Requirement
|
52
54
|
requirements:
|
53
55
|
- - ">="
|
54
56
|
- !ruby/object:Gem::Version
|
55
57
|
version: '0'
|
56
58
|
requirements: []
|
57
|
-
rubygems_version: 3.
|
59
|
+
rubygems_version: 3.4.10
|
58
60
|
signing_key:
|
59
61
|
specification_version: 4
|
60
62
|
summary: Keep all your secret files within openssl
|