General options
All paths are relative to EXTCONF..
Missing fields use the defaults below.
Mode and addresses
-
- Type
- integer
- Default
- 1
Only schema version 1 is accepted.
-
- Type
- string
- Default
- 'enforce'
enforcecontrols the transport and blocks denied requests.observeevaluates and reports decisions but does not block additional requests or provide verified transport binding.disableddisables the additional protection. The mode never changes automatically on error. Existing Core or Vault checks remain effective in their respective adapter.
-
- Type
- list<string>
- Default
- []
Additional operator restrictions for IPv4 or IPv6. These networks remain denied even with a valid endpoint profile. An empty value does not remove built-in restrictions. IPv4-mapped IPv6 CIDRs are not accepted; configure the corresponding IPv4 CIDR instead.
-
- Type
- map<string, array>
- Default
- []
At most 128 named profiles. All profile fields are documented in Endpoint profiles.
Resolver
-
- Type
- map<string, list<string>>
- Default
- []
Exact canonical hostnames with complete, non-empty IP lists. Wildcards, IP hosts as keys and operating system search domains are forbidden. Static responses pass the same address and endpoint checks as DNS responses. A static entry grants no permission by itself.
-
- Type
- integer
- Default
- 5
Range: 0 to 5 seconds. Zero disables DNS memoization. Entries never exceed the smallest remaining TTL in the complete response and CNAME chain. Negative or incomplete responses are not cached as positive results.
-
- Type
- integer
- Default
- 32
Range: 1 to 1024. Maximum positive host entries per resolver instance. When the cache is full, its oldest entry is evicted.
-
- Type
- integer
- Default
- 64
Range: 1 to 64. Larger responses are rejected in full rather than truncated to their first permitted candidates.
-
- Type
- integer
- Default
- 8
Range: 0 to 8. Cycles and longer chains are rejected. Zero prohibits following a CNAME redirect.
Redirects and TLS
-
- Type
- integer
- Default
- 5
Range: 0 to 10. Upper limit for supported redirect paths. Endpoint profiles may additionally forbid redirects entirely. PSR-18
sendnever follows redirects, regardless of this value.Request ()
-
- Type
- boolean
- Default
- false
With
true, callers cannot disable TLS verification. The defaultfalsedoes not disable verification itself: the transport normally usesverify=true, but permits an explicitly configuredverify=falseSDK option.doctorwarns when policy does not require verification. For internal HTTPS targets, use an appropriate CA bundle andrequire.Verification=true
Logging
-
- Type
- integer|float
- Default
- 0
A finite number from 0 to 1. Fraction of allowed decisions to log; the default is zero percent. Denial counters remain available even when log events are rate limited.
-
- Type
- string
- Default
- 'hash'
hashpseudonymizes the host using the configured HMAC key. Without a key, the host is omitted.plainlogs the canonical host in clear text and is an explicit operator choice. Paths, queries and complete URLs are omitted in both modes.
-
- Type
- string|null
- Default
- null
Name of a real process environment variable containing the HMAC key. The name uses ASCII letters, digits and underscores, starts with a letter or underscore, and contains at most 128 characters. The key itself must not be part of a policy array or request.
-
- Type
- integer
- Default
- 60
Range: 1 to 10000. Rate limits denial log events, never policy enforcement. The event format is documented in Decision logs.