yamlock 0.2.5 → 0.2.8
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.
- package/README.md +14 -0
- package/package.json +1 -1
- package/dist/cli/.gitkeep +0 -0
- package/dist/crypto/.gitkeep +0 -0
- package/dist/utils/.gitkeep +0 -0
package/README.md
CHANGED
|
@@ -4,6 +4,9 @@
|
|
|
4
4
|
░░▀░░▀░▀░▀░░░▀░▀▀▀░▀▀▀░▀▀▀░▀░▀░
|
|
5
5
|
```
|
|
6
6
|
|
|
7
|
+
[](https://www.npmjs.com/package/yamlock)
|
|
8
|
+
[](https://github.com/phoenixweiss/yamlock/actions)
|
|
9
|
+
|
|
7
10
|
# yamlock
|
|
8
11
|
|
|
9
12
|
Value-level encryption for YAML and JSON configuration files. The name **yamlock** combines "YAML" and "lock" while also sounding like "warlock", hinting at a little configuration magic.
|
|
@@ -115,6 +118,12 @@ const restored = processConfig(processed, {
|
|
|
115
118
|
});
|
|
116
119
|
```
|
|
117
120
|
|
|
121
|
+
## Advanced usage
|
|
122
|
+
|
|
123
|
+
- **Selective encryption**: combine `--paths` on the CLI or `paths: []` in `processConfig` to encrypt only sensitive sections of a config file.
|
|
124
|
+
- **CI/CD flows**: see [examples/docs/ci-cd.md](examples/docs/ci-cd.md) for a GitHub Actions job that decrypts configs for builds and re-encrypts them before publishing artifacts.
|
|
125
|
+
- **Key rotation**: follow [examples/docs/key-rotation.md](examples/docs/key-rotation.md) for a step-by-step process, including scripting tips for large repos.
|
|
126
|
+
|
|
118
127
|
### Supported algorithms
|
|
119
128
|
|
|
120
129
|
| Algorithm | Type | Notes |
|
|
@@ -126,6 +135,11 @@ const restored = processConfig(processed, {
|
|
|
126
135
|
|
|
127
136
|
You can also pass any algorithm supported by the current Node.js runtime (`crypto.getCiphers()`), along with custom `keyLength`, `ivLength`, or `authTagLength` overrides. Only the algorithms above are actively tested; additional presets may be added or revised in future releases.
|
|
128
137
|
|
|
138
|
+
## Release information
|
|
139
|
+
|
|
140
|
+
- The badges at the top show the latest npm version and the status of the Node test suite.
|
|
141
|
+
- See [CHANGELOG.md](CHANGELOG.md) for detailed release notes; install a specific tag via `npm install yamlock@<version>`.
|
|
142
|
+
|
|
129
143
|
### Encrypted value format
|
|
130
144
|
|
|
131
145
|
Every locked string follows the format:
|
package/package.json
CHANGED
package/dist/cli/.gitkeep
DELETED
|
File without changes
|
package/dist/crypto/.gitkeep
DELETED
|
File without changes
|
package/dist/utils/.gitkeep
DELETED
|
File without changes
|