NetworkConfigSchema top-level property
Network configuration schema for validation
Implementation
final ConfigSchema<NetworkConfig> NetworkConfigSchema = ConfigSchema(
(value, issues, path) {
final obj = _object(value, path, issues);
if (obj == null) return null;
final allowed = _stringList(
obj['allowedDomains'],
[...path, 'allowedDomains'],
issues,
itemSchema: _domainPortPatternSchema,
);
final denied = _stringList(
obj['deniedDomains'],
[...path, 'deniedDomains'],
issues,
itemSchema: _deniedDomainPatternSchema,
);
Map<String, String>? reasons;
if (_has(obj, 'deniedDomainReasons')) {
final raw = _object(obj['deniedDomainReasons'], [
...path,
'deniedDomainReasons',
], issues);
if (raw != null) {
reasons = {};
for (final entry in raw.entries) {
final val = _string(
entry.value,
[...path, 'deniedDomainReasons', entry.key],
issues,
min: 1,
);
if (val != null) reasons[entry.key] = val;
}
}
}
bool? boolean(String key) =>
_has(obj, key) ? _boolean(obj[key], [...path, key], issues) : null;
List<String>? strings(String key, {int min = 0}) => _has(obj, key)
? _stringList(obj[key], [...path, key], issues, itemMin: min)
: null;
final strict = boolean('strictAllowlist');
final deniedAddresses = _has(obj, 'deniedResolvedAddresses')
? _stringList(
obj['deniedResolvedAddresses'],
[...path, 'deniedResolvedAddresses'],
issues,
itemSchema: _addressRangeSchema,
)
: null;
final unix = strings('allowUnixSockets');
final allUnix = boolean('allowAllUnixSockets');
final localBinding = boolean('allowLocalBinding');
List<String>? mach;
if (_has(obj, 'allowMachLookup')) {
mach = _stringList(obj['allowMachLookup'], [
...path,
'allowMachLookup',
], issues);
if (mach != null) {
for (var i = 0; i < mach.length; i++) {
final val = mach[i];
final prefix = val.endsWith('*')
? val.substring(0, val.length - 1)
: val;
if (prefix.contains('*'))
_addIssue(
issues,
[...path, 'allowMachLookup', i],
'Wildcards are only allowed as a single trailing "*" (e.g., "com.example.*" or "*" for all services).',
);
}
}
}
int? port(String key) => _has(obj, key)
? _number(
obj[key],
[...path, key],
issues,
min: 1,
max: 65535,
integer: true,
)?.toInt()
: null;
final httpPort = port('httpProxyPort');
final socksPort = port('socksProxyPort');
final mitm = _has(obj, 'mitmProxy')
? _MitmProxyConfigSchema._parser(obj['mitmProxy'], issues, [
...path,
'mitmProxy',
])
: null;
final rawFilter = _has(obj, 'filterRequest') ? obj['filterRequest'] : null;
final filter = rawFilter is Function
? (fetch.Request request, [RequestInfo? info]) async =>
await Function.apply(rawFilter, [request, info])
as RequestDecision
: null;
if (_has(obj, 'filterRequest') && filter == null)
_addIssue(issues, [
...path,
'filterRequest',
], 'filterRequest must be a function');
final plaintextHeaderSet = boolean('allowPlaintextHeaderSet');
final stripHeaders = _has(obj, 'stripResponseHeaders')
? _stringList(
obj['stripResponseHeaders'],
[...path, 'stripResponseHeaders'],
issues,
itemMin: 1,
)
: null;
final opaque = boolean('refuseOpaqueTunnels');
final hostMatch = boolean('requireHostMatch');
final ambiguous = _has(obj, 'ambiguousRequestTarget')
? _enumValue(
obj['ambiguousRequestTarget'],
[...path, 'ambiguousRequestTarget'],
issues,
const ['refuse', 'asSpelled', 'normalize'],
)
: null;
final tls = _has(obj, 'tlsTerminate')
? _parseTlsTerminate(obj['tlsTerminate'], issues, [
...path,
'tlsTerminate',
])
: null;
final parent = _has(obj, 'parentProxy')
? _ParentProxyConfigSchema._parser(obj['parentProxy'], issues, [
...path,
'parentProxy',
])
: null;
if (allowed == null || denied == null) return null;
return NetworkConfig(
allowedDomains: allowed,
deniedDomains: denied,
deniedDomainReasons: reasons,
strictAllowlist: strict,
deniedResolvedAddresses: deniedAddresses,
allowUnixSockets: unix,
allowAllUnixSockets: allUnix,
allowLocalBinding: localBinding,
allowMachLookup: mach,
httpProxyPort: httpPort,
socksProxyPort: socksPort,
mitmProxy: mitm,
filterRequest: filter,
allowPlaintextHeaderSet: plaintextHeaderSet,
stripResponseHeaders: stripHeaders,
refuseOpaqueTunnels: opaque,
requireHostMatch: hostMatch,
ambiguousRequestTarget: ambiguous,
tlsTerminate: tls,
parentProxy: parent,
);
},
shape: {
'allowLocalBinding': ConfigSchema(
(v, _, _) => v,
description:
'Whether sandboxed commands may use local ports directly (default: false). macOS: allows binding and accepting on any local port and connecting to localhost on any port. Windows: allows connecting to loopback addresses (127.0.0.0/8, ::1) on any TCP or UDP port; it is part of the machine-wide filter set, so it MUST match how `srt-win install` was run (`--allow-loopback` or not) and a session that differs from the install is refused. Linux: ignored — the sandbox has its own network namespace, whose loopback is always usable and is not the host one. Every service listening on localhost becomes reachable, including any local proxy or forwarder that would carry traffic off the machine.',
),
},
);