Skip to content

Guardana Control 0.10.0-alpha

Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 09 Oct 13:16
· 143 commits to main since this release
Immutable release. Only release title and notes can be modified.

One supervised run is now whole. A procedure of schema 0.2 names the
resources its steps bind, the exceptions it allows and how a run's children
are judged; supervise reports a resource outside the run, a denied action
retried in another form and an exception taken, judges a run's tree, and
draws one run as a static page. A finding is confirmed only on the named
run's own calls, so no run can get another one stopped, and a child run can
now be stopped on its own. procedure lint and procedure test check a
procedure with cases, and findings export reads the findings log with a
cursor. The fixes come from an audit of this release's own changes.

Security

  • Built with Go 1.27.2, which fixes GO-2026-6599, GO-2026-6600, GO-2026-6603,
    GO-2026-6604, GO-2026-6605, GO-2026-6607, GO-2026-6608 and GO-2026-6610 in
    crypto/tls, net/http and its HTTP/2 code, html/template,
    mime/multipart and os; govulncheck found the plane's calls reaching
    the HTTP/2 ones under 1.27.1.

Added

  • Procedure schema 0.2, read beside 0.1
    (ADR-0047).
    bindings name the resource type each binding holds and binds ties a
    step or an allowed tool to one; exceptions waive one rule for one step or
    tool, on a granted approval, a failed step or a reason code; children is
    inherit, which judges a root run and its whole tree, or separate, which
    judges one run's own calls and lists its children. A rule that may stop a
    run is waived only on an approval. A 0.1 document reads as before, with
    the same digest and the same confirmed findings.
  • Under a 0.2 procedure supervise reports RESOURCE_OUTSIDE_RUN when one
    binding's calls carry more than one resource, and
    DENIED_ACTION_RETRIED_ARGUMENTS, _RESOURCE and _AROUND when a policy
    denial is followed by the same tool with other arguments, another tool or
    upstream on the same resource (not a read after a denied non-read), or a source's report of the denied tool that no plane
    call joins. An exception taken raises EXCEPTION_TAKEN, never stronger than
    the finding it waived. A finding names the run whose call it rests on, a
    child included, and the report lists the run tree.
  • A child run can be stopped. react writes a stop for a confirmed finding
    about an open child of the finding's tenant, and a plane refuses that
    child's next call while its parent and siblings run on.
  • guardana-control findings export writes the findings log with a cursor,
    in the format guardana.control.findings-export 0.1, up to the last
    write a report closed
    (ADR-0048).
    A log this release creates starts with a header holding a random log_id,
    which its cursors bind to; an older log is known by its first line.
  • guardana-control procedure lint prints a procedure's id, version, digest,
    children mode and each rule with its version and whether it may stop a run;
    procedure test runs a document of cases against it and passes a case only
    on an exact match (guide).
  • supervise --view <file> draws the run as one static HTML page: the
    expected steps beside the calls observed, each marked enforced, decided not
    enforced, observed, exception or approval, blocked or not seen, by shape and
    line as well as colour. It shows each finding's calls and their neighbours,
    or with --view-all every call up to a bound
    (run view).

Changed

  • Every reader of a route (route sign, react, a plane at start, doctor and
    the stops commands) refuses one that names a rule or a rule version outside
    the six whose finding may stop a run: REPEATED_DENIAL,
    STEP_OUTSIDE_PROCEDURE, DEADLINE_EXCEEDED, RESOURCE_OUTSIDE_RUN,
    DENIED_ACTION_RETRIED_ARGUMENTS and DENIED_ACTION_RETRIED_RESOURCE, each
    at version 1. Only route sign checked a route's rules before, so a route
    signed by other means could name any rule.
  • A finding record that carries a run on its event references, a count of
    references left out, a children mode or a run tree is schema 0.2, and a
    0.9 reader refuses it by name. Read a findings log this release writes with
    this release's notify and react.
  • supervise reads from the runs directory only the run's own tree, so a
    directory holding more than 1000 runs no longer refuses a supervision.
  • supervise counts a source as heard only from import reports of its
    descriptor's tenant and project, as coverage does, and bounds each span
    walk on its own as well as in total. Either can move a finding below
    CONFIRMED; a changed verdict is a new record, and so a second alert.
  • STEP_OUT_OF_ORDER and CONTINUED_AFTER_FAILURE are version 2. Two
    proposals of one instant are now untold even within one export, since a
    plane ships several batches at a time, so a finding that rested on their
    place in the export is indeterminate. The rule version is part of a
    finding's id, so supervising a run again writes their findings as new
    records and alerts again. Neither may stop a run; the six that may stay at
    version 1, so a route signed before still holds.

Fixed

  • A finding that rests on many events, such as ten thousand denials, was past
    the log's line bound and refused the whole write. It now cites ten
    references, the most doubtful first, and counts the rest; its verdict is
    still weighed over all of them.
  • Under a 0.2 procedure judging a run's tree, one run's calls could confirm
    a finding against another: a child's denial made the root's later call a
    confirmed retry, a child's probe of another order confirmed
    RESOURCE_OUTSIDE_RUN on the root, and a closed child took the tree's
    REPEATED_DENIAL and deadline. A finding is now confirmed only on the named
    run's own calls (a retry by a descendant of the denied run included); one
    that needs another run's call is suspected at most and stops nothing. Each
    run's deadline is still timed from the tree's first event, which may be
    another run's.
  • The retry rules turned themselves off past about a thousand denials; they
    now judge every denial. A tree is bounded at 400 runs, where its report
    still fits the log's line.
  • DENIED_ACTION_RETRIED_AROUND read as checked with a source never heard,
    silent or not read, and so did STEP_OUTSIDE_PROCEDURE when a span walk ran
    out of steps; both read not checked now, and procedure test compares the
    sources a case expects to be unheard.
  • A rule that is never confirmed could be recorded as confirmed; it is capped.

Image: ghcr.io/guardana/control-gateway@sha256:2b767c40c02999beaca84316f44be15404c3659d3c97526d6ee932835a83513b