tegwick
0ced2995ee
- cmd/flex-auth -> cmd/access-engine; usage and serving lines say access-engine - cmd/flex-auth: prints the rename and exits 2, with a test - image: entrypoint /usr/local/bin/access-engine, flex-auth stub alongside; live pins pass only args, so their next roll is unaffected - Makefile, CI, verify-posture, tenancy.yaml, live docs updated; workplans, decisions and ADRs left as written - runtime names (module, audience, k8s, image package, /opt paths) unchanged Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Assistant: claude-code Assistant-Model: opus Assistant-Process: 735967@bnt-lap001 Assistant-Session: 5971967f-77f8-4ced-9e02-c6ef67040ffc
65 lines
3.2 KiB
Markdown
65 lines
3.2 KiB
Markdown
# qonto-assistant Consumer Integration Fixtures
|
|
|
|
`QONTO-WP-0004-T04`. Registers `qonto-assistant` as a flex-auth
|
|
protected-system consumer, gating its `finance.qonto.read` capability
|
|
(the live-authorization half of `docs/SecurityPractice.md` — the other half
|
|
is a `tenant-engine` capability-role/plan liveness check, deliberately kept
|
|
separate; see `policy_package.md`'s scope note).
|
|
|
|
## Files
|
|
|
|
| File | Purpose |
|
|
| --- | --- |
|
|
| `protected_system_manifest.yaml` | Resource type (`finance-snapshot`) and action (`finance.qonto.read`) |
|
|
| `subject_manifest.yaml` | Registered callers: an agent-harness session identity and the founder's human identity, both in `group:qonto-assistant-readers` |
|
|
| `policy_package.md` | Rego rules + embedded tests gating the read action |
|
|
| `policy_fixtures.yaml` | Allow/deny request/decision pairs, referenced by `policy_package.md`'s frontmatter |
|
|
| `registry_snapshot.json` | Merged `systems`/`subjects`/`groups` snapshot assembled from the two manifests above, loadable by `access-engine serve`/`check`/`load-registry` |
|
|
| `check_request_allow_read.json`, `check_request_deny_wrong_tenant.json` | Standalone example requests for `access-engine check` |
|
|
|
|
**No `resource_manifest.yaml`** — like tenant-engine's tenants, `qonto-assistant`
|
|
doesn't have a fixed enumerable resource inventory to register; the single
|
|
`finance-snapshot` resource type is declared on the protected-system
|
|
manifest and that is sufficient for this policy's coarse per-actor/per-tenant
|
|
gate.
|
|
|
|
## Verified
|
|
|
|
```bash
|
|
go build -o bin/access-engine ./cmd/access-engine
|
|
|
|
# Rego rules + embedded tests + fixtures, all pass:
|
|
bin/access-engine test-policy -file examples/qonto-assistant/policy_package.md
|
|
|
|
# Registry loads cleanly:
|
|
bin/access-engine load-registry -file examples/qonto-assistant/registry_snapshot.json
|
|
|
|
# Individual requests via the CLI:
|
|
bin/access-engine check \
|
|
-registry examples/qonto-assistant/registry_snapshot.json \
|
|
-policy examples/qonto-assistant/policy_package.md \
|
|
-request examples/qonto-assistant/check_request_allow_read.json
|
|
|
|
# End-to-end over real HTTP: a live `access-engine serve` loaded with this exact
|
|
# registry+policy, hit by qonto-assistant's actual FlexAuthCheckClient (not
|
|
# a mock) -- see qonto-assistant/tests/test_flex_auth_client.py and
|
|
# tests/test_live_authorization_gate.py, and the manual curl walkthrough
|
|
# below:
|
|
bin/access-engine serve -addr 127.0.0.1:9099 \
|
|
-registry examples/qonto-assistant/registry_snapshot.json \
|
|
-policy examples/qonto-assistant/policy_package.md
|
|
# from another shell:
|
|
curl -s -X POST http://127.0.0.1:9099/v1/check -H "Content-Type: application/json" \
|
|
-d @examples/qonto-assistant/check_request_allow_read.json
|
|
# -> effect: allow, reason: finance_read_policy_matched
|
|
curl -s -X POST http://127.0.0.1:9099/v1/check -H "Content-Type: application/json" \
|
|
-d @examples/qonto-assistant/check_request_deny_wrong_tenant.json
|
|
# -> effect: deny, reason: wrong_tenant
|
|
```
|
|
|
|
## Related
|
|
|
|
- `qonto-assistant/docs/SecurityPractice.md`
|
|
- `qonto-assistant/workplans/QONTO-WP-0004-security-hardening-and-scale-to-zero.md`
|
|
- `examples/tenant-engine/` — the pattern this was modeled on
|
|
- `net-kingdom/docs/adr/ADR-0014-tenant-capability-roles-and-tenant-engine-ownership.md`
|