vvauth 2.6.0 → 2.6.2
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/.github/workflows/publish-npm.yml +2 -4
- package/.github/workflows/test.yml +2 -1
- package/API_and_tests.md +101 -118
- package/README.md +64 -101
- package/SECURITY_AUDIT_COORDINATION.md +36 -0
- package/SECURITY_AUDIT_PROVENANCE.json +35 -0
- package/SECURITY_AUDIT_claude-opus-5-5.md +288 -0
- package/SECURITY_AUDIT_gpt-6.1-sol.md +323 -109
- package/cmd/vauth/main.go +10 -25
- package/cmd/vauth.js +12 -0
- package/gitlab.go +47 -0
- package/gitlab_test.go +116 -0
- package/go.mod +4 -3
- package/go.sum +8 -10
- package/index.js +63 -88
- package/package.json +6 -5
- package/rc.go +81 -193
- package/test/token-cache.js +122 -14
- package/vauth.go +32 -32
- package/vauth_test.go +76 -23
- package/SECURITY_AUDIT_fable-5.1.md +0 -88
|
@@ -1,8 +1,5 @@
|
|
|
1
1
|
name: publish-npm
|
|
2
|
-
on:
|
|
3
|
-
create:
|
|
4
|
-
tags:
|
|
5
|
-
- 'v*'
|
|
2
|
+
on: create
|
|
6
3
|
|
|
7
4
|
permissions:
|
|
8
5
|
id-token: write
|
|
@@ -10,6 +7,7 @@ permissions:
|
|
|
10
7
|
|
|
11
8
|
jobs:
|
|
12
9
|
publish-npm:
|
|
10
|
+
if: github.event.ref_type == 'tag' && startsWith(github.event.ref, 'v')
|
|
13
11
|
runs-on: ubuntu-latest
|
|
14
12
|
steps:
|
|
15
13
|
- uses: actions/checkout@v4
|
package/API_and_tests.md
CHANGED
|
@@ -1,144 +1,127 @@
|
|
|
1
|
-
#
|
|
1
|
+
# API, CLI and verification
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
3
|
+
Node and Go implement the same authentication/profile/environment behavior.
|
|
4
|
+
Constructors, errors and return types stay native to each language. Their CLI
|
|
5
|
+
contracts differ except for the shared calls below.
|
|
6
6
|
|
|
7
|
-
##
|
|
7
|
+
## Shared calls
|
|
8
8
|
|
|
9
|
-
```
|
|
10
|
-
vauth
|
|
9
|
+
```bash
|
|
10
|
+
vauth env --ir://json
|
|
11
|
+
venv
|
|
12
|
+
venv --renew
|
|
13
|
+
venv --gitlab
|
|
11
14
|
```
|
|
12
15
|
|
|
13
|
-
`env
|
|
14
|
-
|
|
15
|
-
`vauth
|
|
16
|
-
`--flag=false` and `--flag=0` mean `false`. `--` ends flag parsing.
|
|
16
|
+
`env --ir://json` writes one JSON object to stdout, with diagnostics on stderr.
|
|
17
|
+
JSON key order and final whitespace are not significant. `venv` sources
|
|
18
|
+
`vauth env --source "$@"`; renewal forces authentication.
|
|
17
19
|
|
|
18
|
-
|
|
19
|
-
| --- | --- | --- |
|
|
20
|
-
| `env [--source] [--renew]` | Resolve the `.vauthrc` environment (`env.map`, `env.paths`, `env.git`, `ssh-agent-crypt`) | JSON object with `--ir://json`; `export K='v'` lines with `--source`; JSON otherwise |
|
|
21
|
-
| `login [--source] [--renew]` | Authenticate, cache the token | `export VAULT_TOKEN='…'` with `--source`; nothing otherwise |
|
|
22
|
-
| `connect [--renew]` | Authenticate, print the token | raw token, no trailing newline (`--ir://json`: JSON string) |
|
|
23
|
-
| `run <command> [args...]` | Run a command with the resolved environment merged over the current one | the command's; exit code propagated |
|
|
24
|
-
| `dotenv` | Resolved environment as `K=v` lines | one `K=v` per line |
|
|
25
|
-
| `show` | Identity metadata merged over `.vauth_database` | JSON object |
|
|
26
|
-
| `set <key> <value>` | Store `KEY` (upper-cased) in `private/<login>/.vauth_database` | nothing |
|
|
27
|
-
| `unset <key>` | Remove a key from `.vauth_database` | nothing |
|
|
28
|
-
| `install` | Append the `venv` shell function to `~/.bashrc` | nothing |
|
|
29
|
-
| `version` (`--version`) | Build version | one line |
|
|
30
|
-
|
|
31
|
-
Diagnostics (`Vauth token: generated · 12h`, `export K=[redacted]`,
|
|
32
|
-
errors) go to stderr; stdout is machine-readable for every command. Exit code is
|
|
33
|
-
`0` on success, `1` on error (or the child's code for `run`). `--renew` discards
|
|
34
|
-
the cached token and authenticates again.
|
|
20
|
+
## Node CLI — cnyks
|
|
35
21
|
|
|
36
|
-
```
|
|
37
|
-
vauth
|
|
38
|
-
source <(vauth env --source) # what the `venv` function does
|
|
39
|
-
vauth run -- terraform plan
|
|
22
|
+
```text
|
|
23
|
+
vauth <command> [--parameter=value] [--ir://json | --ir://raw]
|
|
40
24
|
```
|
|
41
25
|
|
|
42
|
-
|
|
26
|
+
The first positional selects the command; remaining method arguments are named
|
|
27
|
+
flags, not positional remapping. Aliases expose `env`, `login`, `show`, `set`,
|
|
28
|
+
`unset`, `dotenv`, `install`, `version` and `gitlab`. `Connect` remains a hidden
|
|
29
|
+
SDK operation; cnyks retains its namespaced `vauth:Connect` entry, not a
|
|
30
|
+
short `Connect`/`connect` alias. cnyks also reflects other public
|
|
31
|
+
methods; its interactive rendering is not the Go CLI contract.
|
|
43
32
|
|
|
44
|
-
|
|
|
45
|
-
| --- | --- |
|
|
46
|
-
| `
|
|
47
|
-
| `
|
|
48
|
-
| `
|
|
49
|
-
| `
|
|
50
|
-
| `
|
|
51
|
-
| `
|
|
33
|
+
| Command | Parameters | Effect |
|
|
34
|
+
| --- | --- | --- |
|
|
35
|
+
| `env` | `--source`, `--renew`, `--gitlab` | Resolve environment, export it, or initialize GitLab variables |
|
|
36
|
+
| `login` | `--source`, `--renew` | Authentication only; optionally export only VAULT_TOKEN |
|
|
37
|
+
| `show` | — | Merged profile/private database |
|
|
38
|
+
| `set` | `--k=KEY --v=VALUE` | Store an upper-cased private key |
|
|
39
|
+
| `unset` | `--k=KEY` | Remove a private key |
|
|
40
|
+
| `dotenv` | — | Resolved K=v output |
|
|
41
|
+
| `install` | — | Install the venv shell function |
|
|
42
|
+
| `version` | — | Package version |
|
|
43
|
+
| `gitlab` | — | Only CI_PROJECT_* exports |
|
|
44
|
+
|
|
45
|
+
The executable is `cmd/vauth.js`; `index.js` only exports the SDK. Use
|
|
46
|
+
`--ir://json` for machine-readable return values. `env` selects raw cnyks output
|
|
47
|
+
when JSON was not requested, so sourcing does not show the runner menu.
|
|
48
|
+
|
|
49
|
+
## Go CLI — native
|
|
50
|
+
|
|
51
|
+
```text
|
|
52
|
+
vauth <command> [positionals...] [--flag=value] [--ir://json]
|
|
53
|
+
```
|
|
52
54
|
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
55
|
+
Commands are `env`, `login`, `show`, `set`, `unset`, `dotenv`, `install`, `version`
|
|
56
|
+
and `gitlab`. `set KEY VALUE` / `unset KEY` also accept `--k` / `--v`. Boolean
|
|
57
|
+
flags accept true, false, 0 and empty forms. `env` supports source, renew and
|
|
58
|
+
gitlab flags; `login` supports source and renew. Hidden `connect` remains
|
|
59
|
+
available for token-only callers. No command runner is part of this API.
|
|
56
60
|
|
|
57
|
-
|
|
61
|
+
Objects are JSON, strings are raw without JSON mode, and version is one line.
|
|
62
|
+
Exit is zero on success and one on failure; errors go to stderr.
|
|
58
63
|
|
|
59
|
-
|
|
60
|
-
loading on Node 16 separately from the existing suite. JSON copies use
|
|
61
|
-
`nyks/object/structuredClone`, native when available with a JSON fallback.
|
|
64
|
+
## SDK
|
|
62
65
|
|
|
63
66
|
```js
|
|
64
67
|
const Vauth = require('vvauth');
|
|
65
|
-
const
|
|
66
|
-
const token = await
|
|
67
|
-
const env
|
|
68
|
-
await
|
|
69
|
-
const profile = await
|
|
70
|
-
await
|
|
68
|
+
const client = new Vauth();
|
|
69
|
+
const token = await client.Connect(renew);
|
|
70
|
+
const env = await client.Env(source, renew, gitlab);
|
|
71
|
+
await client.Login(source, renew);
|
|
72
|
+
const profile = await client.Show();
|
|
73
|
+
await client.Set(key, value);
|
|
74
|
+
await client.Unset(key);
|
|
75
|
+
await client.Gitlab();
|
|
71
76
|
```
|
|
72
77
|
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
78
|
+
```go
|
|
79
|
+
client, err := vvauth.New()
|
|
80
|
+
token, err := client.Connect(renew)
|
|
81
|
+
env, err := client.Env(renew)
|
|
82
|
+
err = client.Login(source, renew)
|
|
83
|
+
profile, err := client.Show()
|
|
84
|
+
err = client.Set(key, value)
|
|
85
|
+
err = client.Unset(key)
|
|
86
|
+
err = client.Gitlab()
|
|
87
|
+
```
|
|
81
88
|
|
|
82
|
-
`
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
89
|
+
`Connect`, `LookupSelf`, `Request`, immutable `RC` and address/token readers
|
|
90
|
+
belong to vauth-login. vvauth owns `Config`/`config`, profiles, KV operations,
|
|
91
|
+
macro expansion, shell publication and GitLab initialization. Constructors
|
|
92
|
+
check required CI variables when `env.gitlab` is true; explicit initialization
|
|
93
|
+
bypasses that prerequisite. There is no Git inference at construction.
|
|
87
94
|
|
|
88
|
-
|
|
95
|
+
RC is the complete raw configuration; environment sections are copied before
|
|
96
|
+
macro expansion. Both support
|
|
97
|
+
SSH-agent-backed local secret decryption, inherited tokens and forced renewal.
|
|
98
|
+
`env.map` names must be valid environment names. Values become strings; null
|
|
99
|
+
becomes empty, and objects/arrays are rejected, including macro results. Raw RC
|
|
100
|
+
values retain their JSON types. Missing Git identity fields export empty values.
|
|
89
101
|
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
err = v.Set("KEY", "value"); err = v.Unset("KEY")
|
|
99
|
-
code, err := v.Run("terraform", "plan")
|
|
100
|
-
v.PublishEnv(env) // export lines on stdout, redacted echo on stderr
|
|
101
|
-
```
|
|
102
|
+
## Configuration trust boundary
|
|
103
|
+
|
|
104
|
+
The selected configuration controls exported variable names/values and which
|
|
105
|
+
local armored files are decrypted. Name validation enforces shell syntax,
|
|
106
|
+
not a variable allowlist. Review and trust a project configuration before
|
|
107
|
+
sourcing it with `venv`; this tool is not a sandbox for hostile configurations.
|
|
108
|
+
The Vault-origin guard checks authentication destinations, not every effect
|
|
109
|
+
of the environment exported into the calling shell.
|
|
102
110
|
|
|
103
|
-
|
|
104
|
-
the read-only `RC()`, `VAULT_ADDR()` and `VAULT_TOKEN()` readers, plus mutable
|
|
105
|
-
`Agent`, `TokenCache`, `CacheDir`, `HomeDir`, `Environ`, `Stderr`, `Now` and
|
|
106
|
-
`HTTPClient` settings, are owned by that client.
|
|
107
|
-
Use `New()` or supply the embedded client explicitly for isolated programmatic
|
|
108
|
-
use. `Config` holds only `Env`/`AgentCrypt`; `Stdout`/`Stdin` belong to vvauth.
|
|
109
|
-
`ParseConfig`, `ReplaceEnv`, `ShellEscape` and `FunctionExists` support environment and shell operations.
|
|
110
|
-
Construction consumes `RC()` directly: an independent JSON snapshot is decoded
|
|
111
|
-
into vvauth's own configuration, without reopening its file. The JSON map does
|
|
112
|
-
not retain YAML key order; `env.map` keys from this path have deterministic sorted
|
|
113
|
-
order. Explicit `OrderedMap.Set` calls and standalone `ParseConfig` keep their
|
|
114
|
-
insertion/YAML order. There is no second auth parser, token lifecycle, cache
|
|
115
|
-
implementation or HTTP transport in vvauth.
|
|
116
|
-
|
|
117
|
-
Node and Go consume vauth-login 1.1.5 and ssh-agent-crypt 1.4.2; Node uses nyks
|
|
118
|
-
6.17.0. `env.gitlab` derives `CI_PROJECT_*` from the current working repository,
|
|
119
|
-
including when `VAUTHRC` is elsewhere. In CI, supplied variables are retained.
|
|
120
|
-
This is distinct from standalone Go `ParseConfig`, whose explicit file argument
|
|
121
|
-
identifies its Git directory.
|
|
122
|
-
|
|
123
|
-
The SDK keeps language-native conventions: promises/throws in Node,
|
|
124
|
-
values plus errors in Go. Node `Env(source, renew)` can publish directly;
|
|
125
|
-
Go `Env(renew)` returns an ordered map for `PublishEnv`. CLI `--ir://json`
|
|
126
|
-
outputs JSON without a trailing newline in both implementations. JSON object
|
|
127
|
-
key order is not part of the profile (`show`) contract.
|
|
128
|
-
|
|
129
|
-
## Tests
|
|
130
|
-
|
|
131
|
-
Node and Go are tested against an in-process fake Vault (nonce, login, lookup,
|
|
132
|
-
renew, identity, KV) and a throwaway `ssh-agent`; both suites cover token reuse,
|
|
133
|
-
renewal in the final third, expiry, isolation of the cache by Vault and auth,
|
|
134
|
-
corrupt or plaintext cache rejection, identity selection and the interoperability
|
|
135
|
-
of the armored cache with the `ssh-agent-crypt` CLI.
|
|
111
|
+
## Verification
|
|
136
112
|
|
|
137
113
|
```bash
|
|
138
|
-
npm install
|
|
139
|
-
|
|
114
|
+
npm install
|
|
115
|
+
npm run eslint
|
|
116
|
+
npm test
|
|
117
|
+
go vet ./...
|
|
118
|
+
go test -race ./...
|
|
119
|
+
GOOS=windows GOARCH=amd64 go build ./cmd/vauth
|
|
140
120
|
```
|
|
141
121
|
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
122
|
+
Tests use disposable SSH keys/agents, temporary configuration and loopback
|
|
123
|
+
Vault fixtures; they do not require real credentials. Differential checks cover
|
|
124
|
+
profile/KV operations, renewal, trust refusal, local secrets, configuration,
|
|
125
|
+
JSON environment output and the shared armor/cache. Linux/Windows builds and
|
|
126
|
+
Node 16 parsing/loading are checked separately. Release CI publishes npm,
|
|
127
|
+
Go tags and Linux/signed Windows binaries; verify asset checksums independently.
|
package/README.md
CHANGED
|
@@ -1,148 +1,111 @@
|
|
|
1
1
|
# vvauth
|
|
2
2
|
|
|
3
|
-
Node.js 16 or newer is supported; CI includes Node 16 JavaScript syntax and
|
|
4
|
-
module/CLI loading checks alongside the existing test suites.
|
|
5
|
-
|
|
6
3
|
Resolve a shell environment from your Vault identity, private settings and
|
|
7
|
-
secrets. [vauth-login](https://github.com/131/vauth-login)
|
|
8
|
-
token caching
|
|
9
|
-
|
|
10
|
-
Both consume vauth-login 1.1.5's complete read-only RC and token/address readers;
|
|
11
|
-
vvauth copies its own sections for macro expansion without reopening the file.
|
|
4
|
+
secrets. [vauth-login](https://github.com/131/vauth-login) owns authentication,
|
|
5
|
+
HTTP and token caching; [ssh-agent-crypt](https://github.com/131/ssh-agent-crypt)
|
|
6
|
+
protects local secrets. Node and Go are canonical implementations.
|
|
12
7
|
|
|
13
|
-
|
|
8
|
+
## Install
|
|
14
9
|
|
|
15
10
|
```bash
|
|
16
|
-
# node
|
|
17
11
|
npm install -g vvauth
|
|
18
|
-
|
|
19
|
-
# go
|
|
20
12
|
go install github.com/131/vvauth/v2/cmd/vauth@latest
|
|
21
|
-
|
|
22
|
-
# static binary, linux
|
|
23
|
-
wget -O vauth https://github.com/131/vvauth/releases/latest/download/vauth-linux-amd64
|
|
24
|
-
chmod +x vauth
|
|
25
|
-
|
|
26
|
-
# static binary, windows (curl.exe ships with every supported Windows, cmd or PowerShell)
|
|
27
|
-
curl.exe -fsSL -o vauth.exe https://github.com/131/vvauth/releases/latest/download/vauth-windows-amd64.exe
|
|
28
13
|
```
|
|
29
14
|
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
Binaries are static, signed on Windows, with `SHA256SUMS` on every
|
|
33
|
-
[release](https://github.com/131/vvauth/releases); `vauth version` prints the
|
|
34
|
-
build version. On Windows, the SSH agent is `SSH_AUTH_SOCK` when set, else
|
|
35
|
-
Pageant (≥ 0.75, named pipe autodiscovery), else the OpenSSH agent pipe.
|
|
15
|
+
Native Linux and signed Windows binaries, with checksums, are available from
|
|
16
|
+
[GitHub Releases](https://github.com/131/vvauth/releases).
|
|
36
17
|
|
|
37
|
-
##
|
|
18
|
+
## Load the environment
|
|
38
19
|
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
20
|
+
```bash
|
|
21
|
+
vauth install
|
|
22
|
+
source ~/.bashrc
|
|
23
|
+
venv
|
|
24
|
+
venv --renew
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
`vauth install` defines the Bash function `venv` in `~/.bashrc`:
|
|
42
28
|
|
|
43
29
|
```bash
|
|
44
30
|
function venv() { source <(/usr/bin/env vauth env --source "$@"); }
|
|
45
31
|
```
|
|
46
32
|
|
|
47
|
-
`
|
|
48
|
-
|
|
49
|
-
their values redacted. In scripts or CI, without a shell to source into, use
|
|
50
|
-
`vauth run <command>`, `vauth env --ir://json` or `vauth dotenv` instead.
|
|
51
|
-
|
|
33
|
+
`source ~/.bashrc` loads it in the current shell. `--renew` forces fresh
|
|
34
|
+
authentication. For a machine-readable result:
|
|
52
35
|
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
vauth will try to find
|
|
57
|
-
* if specified, the VAUTHRC file
|
|
58
|
-
* fallback to a .vauthrc file in the current directory
|
|
59
|
-
* fallback to a .vauthrc file in the current user home directory
|
|
36
|
+
```bash
|
|
37
|
+
vauth env --ir://json
|
|
38
|
+
```
|
|
60
39
|
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
40
|
+
Both implementations write one JSON object to stdout; diagnostics remain on
|
|
41
|
+
stderr. Node uses cnyks for its CLI; Go has a native command interface.
|
|
42
|
+
[API_and_tests.md](API_and_tests.md) defines both contracts.
|
|
64
43
|
|
|
65
|
-
|
|
66
|
-
* $${profile.XXX} expand to vault entity metadata and user `.vauth_database` vars
|
|
67
|
-
* $${env.XXX} expand to local environement vars
|
|
68
|
-
* $${secrets.XXX} expand to remote scrapped secrets (see the env.paths)
|
|
44
|
+
## Configuration
|
|
69
45
|
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
46
|
+
The first existing configuration is selected: `VAUTHRC`, `./.vauthrc`, then
|
|
47
|
+
`~/.vauthrc`. It is YAML; `VAULT_ADDR` supplies the address fallback.
|
|
48
|
+
The resolved SSH role is normalized to lowercase by vauth-login in both
|
|
49
|
+
implementations; the source configuration, other fields and JWT roles are unchanged.
|
|
73
50
|
|
|
74
|
-
|
|
51
|
+
```yaml
|
|
52
|
+
vault_addr: https://vault.example.test
|
|
75
53
|
ssh_auth:
|
|
76
54
|
role: $${env.VAUTH_USER_LOGIN}
|
|
77
55
|
env:
|
|
78
56
|
map:
|
|
79
57
|
TF_HTTP_USERNAME: $${profile.VAUTH_USER_LOGIN}
|
|
80
58
|
TF_HTTP_PASSWORD: $${profile.GITLAB_API_TOKEN}
|
|
81
|
-
AWS_ACCESS_KEY_ID: $${secrets.AWS_ACCESS_KEY_ID}
|
|
82
59
|
AWS_SECRET_ACCESS_KEY: $${secrets.AWS_SECRET_ACCESS_KEY}
|
|
83
|
-
|
|
84
|
-
# remote secrets mecanism
|
|
85
|
-
# set the secrets mount point - default to secrets
|
|
86
|
-
[path: secrets]
|
|
87
|
-
# list extra secrets to be reached and populated into the $${secrets.XXX} macro
|
|
60
|
+
path: secrets
|
|
88
61
|
paths:
|
|
89
|
-
- /some/
|
|
90
|
-
|
|
62
|
+
- /some/backend.creds
|
|
91
63
|
```
|
|
92
64
|
|
|
65
|
+
Macros read local `env`, Vault `profile` (entity metadata and the user's
|
|
66
|
+
`.vauth_database`), or collected `secrets`. `env.git` supplies Git author and
|
|
67
|
+
committer fields. A `ssh-agent-crypt` section can supply local encrypted secrets
|
|
68
|
+
without contacting Vault when no SSH/JWT authentication is configured.
|
|
93
69
|
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
`vauth env --ir://json` writes the resolved environment as one JSON object on
|
|
97
|
-
stdout; diagnostics stay on stderr, so a caller can parse stdout directly.
|
|
98
|
-
CLI command spelling remains lowercase; public Node/Go SDK methods use the
|
|
99
|
-
same PascalCase names. Every command, flag, output and module signature is in
|
|
100
|
-
[API_and_tests.md](API_and_tests.md).
|
|
70
|
+
With `env.gitlab: true`, project variables must already exist in the shell.
|
|
71
|
+
Initialize them explicitly from `origin`:
|
|
101
72
|
|
|
102
73
|
```bash
|
|
103
|
-
|
|
74
|
+
venv --gitlab
|
|
104
75
|
```
|
|
105
76
|
|
|
77
|
+
## Tokens and trust
|
|
106
78
|
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
without renewal or persistence; profile retrieval is an explicit separate step.
|
|
113
|
-
|
|
114
|
-
Each session file is armored using
|
|
115
|
-
[ssh-agent-crypt](https://github.com/131/ssh-agent-crypt) and your SSH agent’s
|
|
116
|
-
first key (`VAUTH_USER_IDENTITY`, then `VAUTH_USER_MAIL`, select another one).
|
|
117
|
-
Without an SSH agent, disk caching is disabled.
|
|
118
|
-
|
|
119
|
-
Set `token_cache: false` in `.vauthrc` to disable disk cache reads and writes.
|
|
120
|
-
|
|
121
|
-
## Force reauthentication
|
|
122
|
-
|
|
123
|
-
`venv --renew` forces authentication, generates and caches a new token.
|
|
124
|
-
|
|
79
|
+
An inherited `VAULT_TOKEN` is reused offline. Otherwise, vauth-login handles
|
|
80
|
+
login and the SSH-agent-encrypted cache in `~/.vauth/tokens`. `token_cache: false`
|
|
81
|
+
disables disk caching. SSH uses `SSH_AUTH_SOCK`, or native Windows Pageant/OpenSSH
|
|
82
|
+
pipe discovery. Review a project-selected Vault before vouching for it in the
|
|
83
|
+
home configuration or environment.
|
|
125
84
|
|
|
126
|
-
|
|
85
|
+
Review and trust the project configuration before sourcing it. It controls
|
|
86
|
+
the exported environment and local file decryption; the Vault-address check
|
|
87
|
+
is not a sandbox for hostile configuration files.
|
|
127
88
|
|
|
128
|
-
|
|
129
|
-
|
|
89
|
+
Tokens and resolved secrets are credentials: do not log them or store plaintext
|
|
90
|
+
exports. Neither implementation prompts to trust an unknown project Vault.
|
|
130
91
|
|
|
92
|
+
## Security assessments
|
|
131
93
|
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
[
|
|
94
|
+
[Claude](SECURITY_AUDIT_claude-opus-5-5.md) and
|
|
95
|
+
[Sol](SECURITY_AUDIT_gpt-6.1-sol.md) reports identify their exact source commit,
|
|
96
|
+
checks and limitations. They are independent source reviews, not certification.
|
|
97
|
+
[Coordination and open risks](SECURITY_AUDIT_COORDINATION.md) distinguish
|
|
98
|
+
reviewer limitations from host validation; [provenance](SECURITY_AUDIT_PROVENANCE.json)
|
|
99
|
+
records the exact source, models and prompt/report hashes.
|
|
136
100
|
|
|
137
|
-
| Criterion |
|
|
101
|
+
| Criterion | Claude Opus 5.5 | GPT 6.1 Sol |
|
|
138
102
|
| --- | ---: | ---: |
|
|
139
103
|
| ✨ **Coolness** | 15/20 | 17/20 |
|
|
140
|
-
| Robustness |
|
|
141
|
-
| Safety |
|
|
104
|
+
| Robustness | 13/20 | 13/20 |
|
|
105
|
+
| Safety | 13/20 | 12/20 |
|
|
142
106
|
|
|
107
|
+
## Credits
|
|
143
108
|
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
* [Anthropic](https://www.anthropic.com) Claude (Fable 5.1), in collaboration
|
|
148
|
-
* Code signing, courtesy of Essilor International
|
|
109
|
+
- [Francois Leurent](https://github.com/131)
|
|
110
|
+
- OpenAI Codex and Anthropic Claude, in collaboration
|
|
111
|
+
- Code signing, courtesy of Essilor International
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
# Security assessment coordination
|
|
2
|
+
|
|
3
|
+
Two independent source-only reviews assess f368802700f03c8b632bbacefbfc71dbfaae04f4.
|
|
4
|
+
Reports are preserved verbatim; neither findings nor scores were calibrated.
|
|
5
|
+
Execution headers verify Claude Opus 5.5 and GPT 6.1-sol. Exact successful
|
|
6
|
+
inputs are maintained in the operator's SA prompt files; hashes/commands are
|
|
7
|
+
in SECURITY_AUDIT_PROVENANCE.json. Excluded-report/README input boundaries
|
|
8
|
+
were checked against the logged commands; Git hashes/filename inventory are metadata.
|
|
9
|
+
|
|
10
|
+
| Review | Coolness | Robustness | Safety |
|
|
11
|
+
| --- | --- | --- | --- |
|
|
12
|
+
| Claude Opus 5.5 | 15/20 | 13/20 | 13/20 |
|
|
13
|
+
| GPT 6.1-sol | 17/20 | 13/20 | 12/20 |
|
|
14
|
+
|
|
15
|
+
## Release disposition and open boundaries
|
|
16
|
+
|
|
17
|
+
The npm job is explicitly gated on a created v* tag. Functional code and
|
|
18
|
+
workflow assessed here precede release-version metadata only.
|
|
19
|
+
Host validation independently passes 74 Node24 tests, ESLint, Go vet/race,
|
|
20
|
+
Node16 parsing/loading and native Windows cross-builds. Reviewers' read-only
|
|
21
|
+
sandboxes blocked runtime checks; that is a limitation, not evidence that
|
|
22
|
+
those product tests fail. Signing/checksums are checked on the actual release
|
|
23
|
+
artifacts, not inferred from workflow configuration.
|
|
24
|
+
|
|
25
|
+
Project configuration has broad authority over the environment and local
|
|
26
|
+
armored files. The high-severity untrusted-configuration finding remains an
|
|
27
|
+
open boundary: documentation requires reviewing/trusting configurations but
|
|
28
|
+
is not a technical trust gate or sandbox. Host synthetic probes confirm the
|
|
29
|
+
export/decrypt capability without executing exported commands or using a real
|
|
30
|
+
cache. No project-approval system or arbitrary variable denylist was introduced.
|
|
31
|
+
|
|
32
|
+
Other reported boundaries remain: shell-wrapper failure propagation, dotenv
|
|
33
|
+
encoding, concurrent KV writes, response/resource limits, mutable publication
|
|
34
|
+
inputs, and the declared interpolation semantics. Exact nyks behavior and
|
|
35
|
+
native recursion are retained; these reviews do not certify exhaustive parity
|
|
36
|
+
or vulnerability-database clearance. No claim is made that every finding is fixed.
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
{
|
|
2
|
+
"sourceCommit": "f368802700f03c8b632bbacefbfc71dbfaae04f4",
|
|
3
|
+
"date": "2026-10-25",
|
|
4
|
+
"method": "Fresh independent source-only codex exec sessions; no previous reports or coordinator history as inputs",
|
|
5
|
+
"reviews": [
|
|
6
|
+
{
|
|
7
|
+
"profile": "claude",
|
|
8
|
+
"actualModel": "claude-opus-5-5",
|
|
9
|
+
"exit": 0,
|
|
10
|
+
"command": "codex -p claude exec --ephemeral --sandbox read-only -c 'web_search=\"disabled\"' --output-last-message /mnt/d/tmp/tasks/FLEURENT-09/audits/f368802/claude-report.md - < /mnt/d/tmp/tasks/FLEURENT-09/audits/f368802/claude-input.txt",
|
|
11
|
+
"hashes": {
|
|
12
|
+
"input.txt": "f30a9fe080b37646dfd1c0fc18318fa6a30e1db24847b10c1240292fe63a7c1c",
|
|
13
|
+
"report.md": "526c89b5874b420a1229c9414e461028b2012dd5cdcc7ab7f62635841a71aade",
|
|
14
|
+
"exec.log": "e8187235115d563e7e9017155b34dd310970f90b746075e7242f3138440368b6"
|
|
15
|
+
},
|
|
16
|
+
"output": "SECURITY_AUDIT_claude-opus-5-5.md",
|
|
17
|
+
"inputExclusionsChecked": true,
|
|
18
|
+
"modelCheckedAgainstExecutionHeader": true
|
|
19
|
+
},
|
|
20
|
+
{
|
|
21
|
+
"profile": "codex",
|
|
22
|
+
"actualModel": "gpt-6.1-sol_codeassist",
|
|
23
|
+
"exit": 0,
|
|
24
|
+
"command": "codex exec --ephemeral --sandbox read-only -c 'web_search=\"disabled\"' --output-last-message /mnt/d/tmp/tasks/FLEURENT-09/audits/f368802/codex-report.md - < /mnt/d/tmp/tasks/FLEURENT-09/audits/f368802/codex-input.txt",
|
|
25
|
+
"hashes": {
|
|
26
|
+
"input.txt": "7617ec6debad726eed09829efbbd63a180660af91fc1f393927460193094179a",
|
|
27
|
+
"report.md": "60c4fc1f72df58c96ece263d1dc4d64dec619301116e7bdf459bd02f83165400",
|
|
28
|
+
"exec.log": "10b1ae8df60c50acf8a4cd66ce73aaa813aac583eb48304d40144186afc2becc"
|
|
29
|
+
},
|
|
30
|
+
"output": "SECURITY_AUDIT_gpt-6.1-sol.md",
|
|
31
|
+
"inputExclusionsChecked": true,
|
|
32
|
+
"modelCheckedAgainstExecutionHeader": true
|
|
33
|
+
}
|
|
34
|
+
]
|
|
35
|
+
}
|