Document the accepted MVP and retire superseded development plans
Rust development slice / linux (push) Failing after 14s
Rust development slice / linux (push) Failing after 14s
This commit is contained in:
@@ -1,51 +1,12 @@
|
||||
# Targeted local agent/helper checks
|
||||
# Skriptaufträge und Linux-Installationsstaging testen
|
||||
|
||||
Actually executed on the development Linux host, not the target VM:
|
||||
|
||||
```sh
|
||||
/home/Kevin/.cargo/bin/cargo test -p rmm-agent -p rmm-agent-linux -p rmm-privileged-helper
|
||||
```
|
||||
|
||||
First-increment result: **24 unit tests passed** (4 agent, 12 Linux provider,
|
||||
6 helper verifier/ledger/clock, 2 helper peer-ACL/policy). Tests live next to their private
|
||||
implementation APIs. They cover SQLite reopen, exact duplicate/conflicting
|
||||
offers, request reservation ambiguity, state/event rollback, cancellation/
|
||||
expiry evidence, duplicate grants and attempts, unknown resource retention,
|
||||
every permit/identity binding, forged signatures, payload tampering, clock
|
||||
window endpoints, unsafe paths/corruption, peer UID mismatch, root execution
|
||||
denial in the network agent, actual harmless script bytes/output/limits and
|
||||
provider process-group cleanup. Unsafe service/package/reboot effects use
|
||||
existing typed mocks; native APT mutation is specifically tested as denied.
|
||||
|
||||
Also actually passed for these packages: `cargo clippy --all-targets -- -D warnings`,
|
||||
`cargo fmt -- --check`, and debug `cargo build -p rmm-agent -p rmm-privileged-helper`
|
||||
(using the explicit `/home/Kevin/.cargo/bin/cargo` path). Initial Clippy errors in
|
||||
two provider test slice clones, helper accept-loop style and agent nested-if
|
||||
style were corrected, not suppressed.
|
||||
|
||||
This is not a real browser-approved WSS job, VM service, package or reboot
|
||||
acceptance. The complete bootstrap and known hard blockers are in
|
||||
`deploy/linux/README.md`. Do not run native host mutation to replace VM evidence.
|
||||
|
||||
## Second increment — actually executed locally
|
||||
|
||||
The targeted Rust command above now passes **34 tests** (10 agent, 15 Linux,
|
||||
7 helper-library, 2 helper-binary). Added tests cover native observation wire
|
||||
mapping/size/unsupported metadata, fresh live inventory time, typed log request
|
||||
allowlist/window/limits including inward fractional-time rounding, future-schedule fairness, write-once signing-key pins,
|
||||
actual loopback **mTLS** key bootstrap with DNS/SNI-preserving connect override,
|
||||
wrong-server-name rejection without creating trust, and durable original boot/
|
||||
awaiting-reboot evidence with retained resource locking.
|
||||
|
||||
Also actually passed:
|
||||
Vom Projektstamm aus lassen sich die Tests für Auftragsbindung und Ausführungsjournal sowie die beiden Tests des Linux-Stagingwerkzeugs aufrufen.
|
||||
|
||||
```sh
|
||||
cargo test --locked -p rmm-agent-core --test contracts
|
||||
python3 tests/agent_jobs/test_install.py
|
||||
python3 -m py_compile deploy/linux/install.py tests/agent_jobs/test_install.py
|
||||
```
|
||||
|
||||
Two create-only staging/guard tests passed; the installer was not run against
|
||||
the host root or VM. An initial Python annotation incompatibility on the local
|
||||
interpreter was corrected using postponed annotations; tests then passed.
|
||||
Targeted Clippy with `-D warnings`, debug builds and Rust formatting checks also
|
||||
passed. No native service/package/reboot effects, VM access or server restart.
|
||||
Die Rust-Tests prüfen die Signatur und die Bindung des Startrechts an Gerät, Versuch und Skript. Sie öffnen das Journal nach dem Verbrauch eines Startrechts erneut und prüfen, dass derselbe Versuch keine zweite Ausführung auslöst. [Vertragstests](../../crates/agent-core/tests/contracts.rs)
|
||||
|
||||
Der Python-Test baut einen temporären Verzeichnisbaum für `deploy/linux/install.py` auf. Er prüft die vorbereiteten Dateien, das Verhalten bei erneuter Anlage sowie die Ablehnung unsicherer Pfade und privater Schlüssel. Die Abnahme des öffentlichen HTTPS-Installers und der tatsächlichen Geräteaufträge steht im MVP-Nachweis. [Stagingtest](test_install.py) · [Abnahme](../../docs/mvp-completion-plan.md)
|
||||
|
||||
+5
-258
@@ -1,264 +1,11 @@
|
||||
# Reconciliation client handoff — isolated module, not yet production wire-up
|
||||
# Wiederanmeldung und Journalabgleich testen
|
||||
|
||||
**Historical module-only handoff.** Production wire-up has since been implemented
|
||||
in the agent dispatcher, helper control RPC and shared transport actor. Current
|
||||
contract and verification boundaries: `deploy/linux/runtime-README.md`. The
|
||||
earlier patch-position instructions below are retained as implementation history,
|
||||
not an assertion that the modules are still unregistered.
|
||||
Linux und Windows nutzen den gemeinsamen Agentenkern für den Abgleich nach einem Verbindungswechsel. Die Integrationstests legen eigene SQLite-Journale in temporären Verzeichnissen an. Sie prüfen unter anderem die Bindung signierter Entscheidungen an die aktuelle Verbindung, den Erhalt eines verbrauchten Startrechts und die Rückmeldung bereits gespeicherter Skriptergebnisse. Der Test für den Windows-SYSTEM-Helper deckt die Wiederanmeldung nach bereits quittierter Ergebnismeldung ab. [Agentenabgleich](../../crates/agent-core/tests/reconcile.rs) · [Helper-Abgleich](../../crates/agent-core/tests/helper_reconcile.rs)
|
||||
|
||||
Only new files were added for this dispatch:
|
||||
`crates/agent/src/reconcile.rs`, `crates/agent/tests/reconcile.rs`, this document.
|
||||
No existing agent/helper/backend/domain/protocol file or Cargo manifest was
|
||||
changed. No VM, SSH, API approval, root effect or server restart was performed.
|
||||
The test module uses the actual public protocol/domain contracts, OpenSSL
|
||||
Ed25519 and real SQLite files, not substitute wire structs or an in-memory mock
|
||||
journal. Build-directory locks were allowed to resolve normally.
|
||||
|
||||
## Public module API
|
||||
|
||||
* `ClientSync::new(Binding)` — process-local mutation gate starts closed. Existing
|
||||
`safety('connected')` is never reset/deleted. The binding contains the already
|
||||
provisioned administrative key, not a key received with a response.
|
||||
* `Channel { connection_generation, boot_id }` — construct only after validating
|
||||
the current authenticated ServerHello. Use the native Linux boot UUID, never
|
||||
the agent instance/process UUID. Enrollment/assignment/tenant/asset/agent remain
|
||||
bound by `Binding` and by every decoded local offer.
|
||||
* `SyncClock::now()` and production `NativeClock::default()` — native synchronized
|
||||
clock plus wall/monotonic jump checks. A false clock closes mutation authority;
|
||||
it does not prevent independent passive telemetry.
|
||||
* `initialize(&Connection)` — creates only additive `reconcile_*` tables in the
|
||||
already locked, privately opened agent journal. Existing tables are required:
|
||||
`counter`, `job_attempts`, `job_events`. The second connection is the existing
|
||||
private `consumption.sqlite` with `consumed`/`execution_evidence`.
|
||||
* `prepare(&mut journal, &consumption, Channel, Option<&HelperSnapshot>, &clock)`
|
||||
returns `PreparedSync { envelope, request }`. It closes the old gate, checks
|
||||
integrity/checkpoint/generation, archives original results, records ambiguous
|
||||
requesting/running/verifying as unknown, reads real offers/consumption/boot/
|
||||
outcomes/events and durably reserves the fresh request and sequence BEFORE
|
||||
sending. Resend that exact envelope on the same live channel. After lost
|
||||
response/reconnect, prepare a NEW request, using the durable prior request ID;
|
||||
it does not invent a checkpoint or execution grant.
|
||||
* `apply(&mut journal, &SyncResponse, &clock)` returns `Applied { decision_id,
|
||||
acknowledged_message_ids, helper_instruction, reason }`. Verify exact signed
|
||||
bytes before parsing, the separate reconciliation domain/profile, exact prost
|
||||
request hash, every current identity/channel/boot/journal/checkpoint/key/time
|
||||
binding, complete attempt coverage and exact receipt IDs. All agent changes,
|
||||
result archives, ACK deletions and decision chain commit in one transaction.
|
||||
Identical already-applied current responses are idempotent; stale/different
|
||||
responses cannot open a gate. Terminal local state is never downgraded. Negative
|
||||
server unknown decisions may carry an older server revision, but local revision
|
||||
is retained with max(local, server), never reset and never made startable.
|
||||
* `apply_consumption(&mut consumption, &clock)` applies only the agent process's
|
||||
own targeted signed unlocks in an independent SQLite transaction. Recompare
|
||||
grant/attempt/device and previous canonical local outcome, preserve consumed
|
||||
tombstones, persist exact decision evidence, then allow the process gate to open.
|
||||
Failure/crash between journal and consumption commits leaves mutations closed.
|
||||
* `HelperInstruction` is the ORIGINAL `SyncResponse` plus its signed decision ID,
|
||||
helper journal and checkpoint. Forward it unchanged to the authenticated helper.
|
||||
It is never a new grant, permit, shell command or unsigned unlock boolean.
|
||||
* `confirm_helper(&HelperSnapshot)` requires the independently authenticated root
|
||||
helper to report that exact decision/checkpoint as durably applied and no
|
||||
unsettled effects. `can_start(&Channel, root: bool, &clock)` stays false for
|
||||
root until then, and expires with the signed decision deadline. Select `root`
|
||||
from the verified immutable job identity, not from caller convenience.
|
||||
* `close()` on every disconnect, new Hello, transport fencing or revocation.
|
||||
* `archive_events(&Connection)` INSIDE the existing event-ACK transaction, before
|
||||
deleting an ACKed event. This preserves original result envelope ID/sequence/
|
||||
boot/time/raw outputs for future sync. No historical result is rewrapped with
|
||||
a new sync envelope identity.
|
||||
* `verify_response(...)` is the pure independently testable signature/binding
|
||||
verifier; it does not apply or execute anything.
|
||||
|
||||
`HelperSnapshot { journal_id, checkpoint, previous_decision_id, attempts }` is a
|
||||
complete snapshot obtained from the root-owned helper journal via authenticated
|
||||
socket/peer credentials. It must NEVER be deserialized from a server response or
|
||||
an unauthenticated local socket. Canonical helper outcome bytes can be imported
|
||||
as a **new** durable agent JobResult with fresh event identity/revision (no new
|
||||
job/attempt/effect). This resolves a lost helper response while retaining both
|
||||
the older unknown result and the actual helper result. A consumed root attempt
|
||||
omitted by the helper, changed helper journal/checkpoint, missing authoritative
|
||||
server job/history, sequence rollback or generation regression remains blocked.
|
||||
Sticky recovery faults cannot be cleared merely by omitting the offending entry.
|
||||
|
||||
## Minimal integration patch positions (after APT ownership release)
|
||||
|
||||
1. `main.rs` module declarations: add `mod reconcile;`. Agent fields: retain one
|
||||
`ClientSync` and `NativeClock`, initialized from the pinned job Binding. A
|
||||
passive agent without a binding must not advertise sync/root readiness.
|
||||
2. `Agent::session`: advertise `rmm.sync.v1`; after validated ServerHello, before
|
||||
any permit request, obtain the authenticated helper snapshot if configured,
|
||||
call `prepare`, send its envelope. Both WSS and HTTPS singleton MessageBatch
|
||||
carry the SAME envelope. No transport-specific readiness shortcut.
|
||||
3. Inbound payload match: route current valid `Payload::SyncResponse` to `apply`;
|
||||
then `apply_consumption`; forward any helper instruction unchanged, fetch the
|
||||
helper's post-apply authenticated snapshot and call `confirm_helper`.
|
||||
4. Replace the first-session `safe_session` condition in the scheduler AND the
|
||||
immediately-before-effect dispatcher with `can_start`. Retain fresh independent
|
||||
ExecutionPermit verification/consumption, immutable plan binding, normal
|
||||
cancellation checks and provider resource locks. Sync never supplies start
|
||||
authority or creates an executable job. Resync before the <=60s gate lease
|
||||
expires, and call `close()` immediately when a channel fails/is fenced.
|
||||
5. In `jobs::ack`, call `initialize` once during open and `archive_events` in the
|
||||
same transaction as the concrete ACK's deletion. Without this hook, this module
|
||||
still archives pending results during prepare, but cannot recover an original
|
||||
event already erased by old code. Legacy final results can still reconcile
|
||||
canonical hashes against authoritative stored server results.
|
||||
6. Helper RPC needs typed authenticated snapshot/apply operations. Its new process
|
||||
gate must start closed. Independently verify the original decision signature,
|
||||
all helper identity/checkpoint/attempt/hash/action/boot/previous-outcome bindings
|
||||
against ROOT-owned state, apply targeted unlocks transactionally, keep consumed
|
||||
tombstones, then acknowledge its signed decision/checkpoint. An ordinary APT
|
||||
probe/capability ready flag is NOT sufficient. This dispatch deliberately did
|
||||
not modify the concurrently owned helper/transport files or claim this root
|
||||
RPC consumer already wired. Never call agent `apply_consumption` on a helper's
|
||||
root database as a substitute for independent helper verification.
|
||||
|
||||
The adapter refuses >256 attempts/receipts, >512 KiB canonical outcomes or a
|
||||
>1 MiB request, rather than dropping unknown attempts/results. There is no unsafe
|
||||
automatic compaction, journal deletion, new-grant retry or recovery-fault reset.
|
||||
Coordinated rollback of every independent ledger still requires operator recovery.
|
||||
|
||||
## Targeted verification
|
||||
|
||||
Actually executed successfully during implementation:
|
||||
|
||||
Final result: **18 reconciliation integration tests passed**; targeted Clippy
|
||||
with `-D warnings` and formatting check passed. No warnings were suppressed.
|
||||
Aufruf im Projektstamm
|
||||
|
||||
```sh
|
||||
/home/Kevin/.cargo/bin/cargo test -p rmm-agent --test reconcile --locked
|
||||
/home/Kevin/.cargo/bin/cargo clippy -p rmm-agent --test reconcile --locked -- -D warnings
|
||||
/home/Kevin/.cargo/bin/rustfmt --edition 2024 --check crates/agent/src/reconcile.rs crates/agent/tests/reconcile.rs
|
||||
cargo test --locked -p rmm-agent-core --test reconcile --test helper_reconcile
|
||||
```
|
||||
|
||||
Coverage includes real SQLite reopen, clean reconnect and accepted-unstarted jobs,
|
||||
exact signatures/all identity bindings/fake key, replay and response-loss recovery,
|
||||
original result retention and exact ACKs, canonical outcome rejection, unknown
|
||||
resource retention, sticky missing server/helper records and checkpoint regression,
|
||||
independent local outcome mismatch, actual helper-result import and original/new
|
||||
boot evidence. Helper/server responses in these local tests are fixtures; no real
|
||||
approval, helper root operation or backend/VM end-to-end acceptance is claimed.
|
||||
|
||||
## Independent helper consumer (separate ownership increment)
|
||||
|
||||
New files: `crates/privileged-helper/src/reconcile.rs` and
|
||||
`crates/privileged-helper/tests/reconcile.rs`. Existing helper lib/main/APT and
|
||||
agent files were deliberately NOT changed. This is a complete SQLite/verifier
|
||||
core, **not yet registered in the production RPC dispatcher**.
|
||||
|
||||
### Helper API and locking
|
||||
|
||||
* `ExecutorGuard::acquire(state_directory, owner_uid)` opens the SAME existing
|
||||
`executor.lock`. Production uses owner UID 0. `snapshot`, `apply` and `can_start`
|
||||
verify the supplied connection is that directory's actual `consumption.sqlite`,
|
||||
not a memory/private copy. Replace, rather than nest, existing per-request
|
||||
`lock_state` acquisition. Hold this guard through grant consumption and effect.
|
||||
* `HelperSync::new(independently_provisioned_Binding, &clock)` always starts closed.
|
||||
The pin cannot be supplied in IPC or automatically replaced. The root-owned
|
||||
journal persists a binding hash; changed key/identity requires controlled
|
||||
recovery, not an in-band rebind.
|
||||
* `snapshot(&mut db, &guard, generation, &clock, &boot)` closes the previous lease,
|
||||
reads **every** actual consumed row plus saved Request, verifies the historical
|
||||
exact Ed25519 grant at its original validity window, checks current bound
|
||||
device/action/job/attempt/plan/authorization, and derives canonical outcomes,
|
||||
original native boot and durable per-row revisions. It atomically reserves a
|
||||
fresh monotone independent helper checkpoint. No agent-provided attempt list is
|
||||
used to construct this root snapshot.
|
||||
* `apply(&mut db, &guard, &SignedResponse, original_request_protobuf, &clock, &boot)`
|
||||
independently verifies the exact reconciliation signature/domain/profile/key,
|
||||
device and all current request/channel/journal/checkpoint/boot/time bindings.
|
||||
It hashes the ORIGINAL canonical `SyncRequest::encode_to_vec()` bytes, not a
|
||||
JSON rendering. All captured root attempts must appear in both request and
|
||||
signed decisions; root grant/action/plan/previous canonical outcome must match.
|
||||
The entire actual ledger fingerprint is rechecked while holding the same
|
||||
executor guard and SQLite immediate transaction. Mutation after capture,
|
||||
omissions, missing original evidence, unknown state, checkpoint/history rollback
|
||||
and independently detected agent-journal replacement fail closed; recovery
|
||||
faults are sticky and have no automatic reset API.
|
||||
* Only explicit, independently matched signed per-attempt `unlock` decisions
|
||||
update `consumed.result` and the saved outcome. The consumed grant/attempt stays
|
||||
permanently present. Definitive known outcomes may be unlocked while another
|
||||
unknown retains the global resource lock and readiness remains false. An unknown
|
||||
script cannot become successful from a server-ready/callback boolean or a new
|
||||
body; only the separately validated reboot reconciliation can supply a new
|
||||
definitive body. Reboot additionally compares the helper's OWN current boot
|
||||
source with the original persisted native boot and signed new-boot/inventory
|
||||
evidence. Process instance UUIDs are not a boot source.
|
||||
* Apply returns `Applied { snapshot, unlocked_grants, ready }`. Forward its
|
||||
`snapshot` as the authenticated checkpoint ACK. It has the applied decision ID
|
||||
and SAME checkpoint expected by `ClientSync::confirm_helper`. Do not call
|
||||
`snapshot()` again to make the ACK: that creates a new challenge/checkpoint.
|
||||
* `can_start(&db, &guard, generation, &clock, &boot)` rechecks process-local lease,
|
||||
deadline, actual boot, persisted decision/checkpoint, complete ledger fingerprint
|
||||
and absence of unresolved consumed resources immediately before a fresh grant.
|
||||
`close()` removes the process lease. Native implementations are `NativeClock`
|
||||
(synchronization/monotonic jump checks) and `NativeBoot` (Linux boot_id).
|
||||
|
||||
Gate admission is checked immediately before grant consumption while retaining
|
||||
the executor guard through save_start, the existing final fresh-grant/clock check
|
||||
and actual execution. After consumption the changed fingerprint intentionally
|
||||
blocks **new** starts; it does not retroactively revoke the already admitted
|
||||
locked operation. Do not retry admission after consuming the same grant or
|
||||
release/reacquire the guard between admission and execution. ExecutorGuard is
|
||||
movable but not shareable by reference across threads, preventing accidental
|
||||
concurrent use of one flock guard by separate request handlers.
|
||||
|
||||
No protocol dependency or manifest change was added: the helper currently has no
|
||||
direct prost/rmm-protocol dependency. Its private bounded parser reads the actual
|
||||
existing SyncRequest tags 1–12 and SyncAttempt tags 1–13. Unknown/duplicate fields,
|
||||
bad wire types, nonminimal/overflowing varints, truncation and size/count violations
|
||||
are denied. Nested JobResult/Envelope never serve as independent root proof.
|
||||
Production glue passes bytes from the real agent protocol type; shared-wire
|
||||
schema changes must update this fail-closed decoder explicitly, not silently.
|
||||
|
||||
### Mapping and production patch positions
|
||||
|
||||
1. Register `mod reconcile;` in the helper **binary** `main.rs` (the standalone
|
||||
module imports the package's existing library types). Construct one HelperSync
|
||||
from the root-owned config/key and NativeClock; do not restore an open gate
|
||||
from SQLite. Keep existing action policy, APT manifest/runtime validation,
|
||||
artifact checks, privilege boundary and peer ACL intact.
|
||||
2. Add typed snapshot/apply RPC variants after socket ACL/SO_PEERCRED validation.
|
||||
Apply accepts original `decision_bytes`, `signature` and original canonical
|
||||
SyncRequest bytes. It accepts NO external key or unlock/ready callback flag.
|
||||
General and APT listeners must share the same root DB and executor guard.
|
||||
3. Root `Snapshot` maps to agent `HelperSnapshot`:
|
||||
journal_id/checkpoint/previous_decision_id unchanged; each LocalAttempt maps
|
||||
UUIDs to strings and copies job_payload_hash, grant_id, consumption, state,
|
||||
revision, original_boot_id, outcome_sha256 and canonical outcome_bytes.
|
||||
Set optional result/result_envelope to None and result_message_id empty. The
|
||||
agent core already imports actual helper outcomes as new durable agent results
|
||||
when needed. Additional root-only plan/request hash fields remain available
|
||||
for audit and independent checks.
|
||||
4. Map agent `HelperInstruction.response` byte arrays directly to SignedResponse;
|
||||
pass the prepared SyncRequest's original prost bytes alongside it. Send the
|
||||
apply-returned authenticated snapshot to `ClientSync::confirm_helper`.
|
||||
5. Add `HelperSync::can_start` checks under ExecutorGuard before **every** general
|
||||
or APT grant consumption/effect path. Probe/capability flags do not replace
|
||||
that check. Shared checkpoint state alone never opens another process's gate.
|
||||
A fresh capture fences older process leases. Prefer one shared broker/gate for
|
||||
both profiles; if they are separate processes, reconcile the selected process
|
||||
before use rather than assuming both inherited readiness.
|
||||
|
||||
### Replay safety bound without a new protocol nonce
|
||||
|
||||
Each new process requires a fresh in-memory capture and a newly committed helper
|
||||
checkpoint. Cached DB readiness/captures are not loaded as process authority.
|
||||
Additionally the signed issued_at must be >= process birth AND the private fresh
|
||||
capture time, and validity is at most 60 seconds. Thus an old cached response
|
||||
cannot initialize a restarted helper, even while its old TTL has not expired;
|
||||
ordinary same-process retries of the exact already-applied response are idempotent
|
||||
and do not extend the lease. A local clock ahead of the signer may cause a safe
|
||||
clock/reconciliation block: there is deliberately no skew grace that would admit
|
||||
a pre-process response. This is a strict liveness limitation of the current
|
||||
nonce-less contract, not an invented attestation or perpetual authorization.
|
||||
Coordinated restore of all independent histories remains operator recovery.
|
||||
|
||||
The helper integration tests use actual SQLite files, real Ed25519 and the shared
|
||||
executor lock, with fixture signatures and an injectable boot source for the
|
||||
simulated positive reboot change. No native reboot/service/APT effect or root
|
||||
deployment was performed. Targeted command:
|
||||
|
||||
```sh
|
||||
/home/Kevin/.cargo/bin/cargo test -p rmm-privileged-helper --test reconcile --locked
|
||||
```
|
||||
Für die Geräteabnahme werden vor und nach einem Neustart Bootbezug und Installationskennung verglichen. Ein auf dem neuen Boot ausgeführter Folgeauftrag liefert den Nachweis für den wiederhergestellten Skriptbetrieb. [MVP-Abnahme](../../docs/mvp-completion-plan.md)
|
||||
|
||||
@@ -1,48 +1,11 @@
|
||||
# Native agent transport regressions
|
||||
# HTTPS-Gerätekanal testen
|
||||
|
||||
These are local Linux tests, **not VM/MVP acceptance**. They use ephemeral PKI,
|
||||
strict server-name/CA verification and mandatory client certificates on loopback.
|
||||
No production endpoint, VM, enrollment, job approval or database is touched.
|
||||
Die lokalen Linux-Integrationstests betreiben einen TLS-Server auf Loopback und erzeugen eigene Zertifikate. Der Agent meldet sich mit Clientzertifikat an, sendet Nachrichten und fragt nach Arbeit. Der Test unterbricht eine Antwort und prüft anhand der Nachrichten-ID, dass beim erneuten Senden nur ein Datensatz entsteht. Weitere Fälle prüfen falschen Servernamen, unbekannte CA und fehlendes Clientzertifikat. [Transporttest](../../crates/agent/tests/https_channel.rs) · [Gemeinsamer Testserver](common.rs)
|
||||
|
||||
The OpenSSL fixture must set a session-id context for client authentication.
|
||||
On this host (OpenSSL 1.1.1w), the isolated replay regression originally failed
|
||||
on reconnect with `ssl_get_prev_session`, code `336433429`, reason
|
||||
`session id context uninitialized`; the client received TLS `InternalError`.
|
||||
Disabling the session cache and tickets did not provide that context. The fix
|
||||
sets a fixture-specific session context and restores normal caching/tickets;
|
||||
it changes neither production TLS nor certificate verification. Handshake
|
||||
diagnostics print only SSL codes and static library/function/reason metadata.
|
||||
Der Zertifikatstest deckt den Verlust einer Erneuerungsantwort und die Zuordnung des erneuerten Zertifikats zum vorhandenen Schlüssel ab. Er prüft die Übernahme nach einem unterbrochenen Wechsel und die Ablehnung ungültiger Identitäten. [Zertifikatserneuerung](../../crates/agent/tests/certificate_rotation.rs)
|
||||
|
||||
Locked versions: openssl 0.10.82 / openssl-sys 0.9.118; reqwest 0.12.28 uses
|
||||
rustls 0.23.46 with ring 0.17.14 (workspace disables reqwest default TLS).
|
||||
|
||||
The replay test asserts missing response returns an error without a fabricated
|
||||
ACK, repeats the exact encoded batch/message ID, and retains one deduplicated
|
||||
application record. No execution retry is introduced. Rotation retains its
|
||||
three identity/crash/recovery tests. Its harness also runs the four HTTPS
|
||||
contract tests because it compiles and uses that same transport implementation;
|
||||
rotation-only fixtures live in the rotation test, without dead-code allowances.
|
||||
|
||||
Reproduce locally (commands, not a VM acceptance recipe):
|
||||
Aufruf im Projektstamm
|
||||
|
||||
```sh
|
||||
OPENSSL_CONF=/dev/null cargo test -p rmm-agent --test https_channel --locked real_mtls_hello_poll_durable_replay_and_fencing -- --exact --nocapture
|
||||
cargo test -p rmm-agent --test https_channel --test certificate_rotation --locked
|
||||
cargo clippy -p rmm-agent --test https_channel --test certificate_rotation --locked -- -D warnings
|
||||
cargo test --locked -p rmm-agent --test https_channel --test certificate_rotation
|
||||
```
|
||||
|
||||
`OPENSSL_CONF=/dev/null` isolates only the test process from host OpenSSL config;
|
||||
it does not disable TLS, trust, name verification or mandatory mTLS.
|
||||
|
||||
## Observed local verification (2026-11-12)
|
||||
|
||||
- Isolated pre-fix replay: failed with the server reason/code above and client
|
||||
`received fatal alert: InternalError` on the second explicit send.
|
||||
- After the context fix: isolated pair of targets passed (7 + 4 tests).
|
||||
- Five additional consecutive native runs with the normal environment passed
|
||||
(7 + 4 each; 55 test executions, seven distinct cases because the HTTPS
|
||||
contract is deliberately included in the rotation harness).
|
||||
- Targeted `cargo clippy ... -- -D warnings` passed; file-scoped rustfmt check
|
||||
passed. No dead-code/lint suppression was added.
|
||||
- VM execution, production backend integration and production wiring were not
|
||||
performed by this dispatch; Linux-MVP acceptance remains outside this result.
|
||||
|
||||
@@ -1,42 +0,0 @@
|
||||
# Integrated server OIDC test (explicit local development fixture)
|
||||
|
||||
Prerequisites: native `cargo build -p rmm-server --locked`, normal migrations through
|
||||
0011 applied to the existing development database, existing protected development
|
||||
configuration/CA/job key, Python cryptography, existing web Playwright/Chromium and
|
||||
the isolated certutil tool used by the browser harness. No external IdP is required.
|
||||
|
||||
Run `python3 tests/oidc/server_integration.py`. It starts its own ephemeral loopback
|
||||
TLS provider and native API on an unused loopback port, and reaches the existing
|
||||
development PostgreSQL container through its bridge address. It does not publish
|
||||
PostgreSQL or restart the existing server/database. Private configuration is parsed
|
||||
internally as data; no shell sourcing, credential stdout/argv or browser artifacts.
|
||||
|
||||
The only administrative fixtures are its own random restricted auth-state login
|
||||
role, synthetic external identity routing row and explicit `human` membership row
|
||||
in development tenant A. It grants no membership from OIDC groups/email. Those
|
||||
fixtures and its own encrypted state rows are removed afterwards. It does **not**
|
||||
write authorization/job/permit rows or positively invoke a plan approval endpoint.
|
||||
The only approval-endpoint test uses a bearer and must be denied before plan lookup.
|
||||
|
||||
Actual latest standalone run: **35 assertions passed**, including a real Chromium
|
||||
provider button/cross-site callback with normal CA validation and a temporary NSS
|
||||
store. Browser interaction is visibly synthetic and uses explicit dev simulation.
|
||||
The configured production-profile start/login check uses simulation false solely
|
||||
to test configuration behavior against the mock; this is **not** external-provider,
|
||||
human production-approval or Linux-VM acceptance.
|
||||
|
||||
Covered: code/PKCE/nonce/state, binding non-burning and callback replay, stable
|
||||
mapping, final session/CSRF/logout, JWT resource audience/ID-token separation,
|
||||
issuer/expiry/kid/rotation/scopes, actual MCP lifecycle/inventory call and insufficient
|
||||
scope denial, persistent membership revocation, disabled external identity, foreign
|
||||
tenant not-found, bearer+cookie approval denial, production dev-route disabling.
|
||||
|
||||
Harness corrections during implementation: avoid duplicate Python environment
|
||||
keywords; do not route the dev-login JSON extractor in production; read MCP SSE to
|
||||
its concrete JSON-RPC response instead of waiting for a long-lived stream to close.
|
||||
No auth/approval check was disabled to make the harness pass.
|
||||
|
||||
Current backend configuration/routes/migration/provisioning contract is
|
||||
`crates/server/OIDC.md`. Earlier `proto/BACKEND_CONTRACT.md` statements about absent
|
||||
production auth describe the pre-OIDC backend increment, not this additive adapter.
|
||||
The other Sync/root/APT contracts and native-execution gates are unchanged.
|
||||
Reference in New Issue
Block a user