What the shipper does with this source

radius-exchanges is not shipped off the box unless you opt a destination
in.
Every other source ships exactly as it always has.

The shipper holds a short list of sources it withholds by default —
WITHHELD_SOURCES in quantumtouch_bng/helpers/audit_shipper.py, which today
contains radius-exchanges and nothing else. A destination ships a withheld
source only if it names that source in opt_in_sources:

{
  "bng": {"audit": {"shipping": {"destinations": [
    {"name": "corp-siem", "type": "syslog", "host": "siem.example.com"},
    {"name": "local-archive", "type": "s3", "bucket": "audit-archive",
     "opt_in_sources": ["radius-exchanges"]}
  ]}}}
}

corp-siem above gets every source it got before — the qt event lines, the
config changes, the snapshot operations — and no RADIUS entries.
local-archive gets those plus radius-exchanges.

Four things follow, and they are worth being explicit about:

  • opt_in_sources is an opt-in list, not an allow-list. Naming one source
    never stops another from shipping. A destination that does not have the key
    at all ships precisely what it shipped before this filter existed — the
    filter cannot change an existing deployment's behaviour for any source that
    is not on the withheld list.
  • It is per destination. You can archive RADIUS entries to a bucket whose
    retention you control while your corporate SIEM never sees them.
  • The filter is at the shipper, not at the entry. Nothing is hashed,
    truncated or masked. The identifier in the local log and on the operator's
    timeline is the real one, so searching the timeline for the subscriber you
    are on the phone with still works, and two boxes shipping to one SIEM stay
    correlatable because nothing was salted per box.
  • It fails closed. A malformed opt_in_sources in a hand-edited
    settings.json withholds rather than ships. The admin API rejects a
    malformed one outright, including a source name that is not actually
    withheld — a typo like radius_exchanges is a 400, not a setting that looks
    configured and does nothing.

You can set it in the web UI instead — Settings → Audit shipping → Edit a
destination → "Ship radius-exchanges entries to this destination"
, unticked
on every destination including new ones — or through the admin API:

PATCH /api/bng/audit/shipping/destinations/local-archive
{"opt_in_sources": ["radius-exchanges"]}