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_sourcesis 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_sourcesin a hand-edited
settings.jsonwithholds rather than ships. The admin API rejects a
malformed one outright, including a source name that is not actually
withheld — a typo likeradius_exchangesis 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"]}