RETICUX BGP Mastery Day 28- BGP Policy Match Tools: Prefix Lists, AS-Path ACLs and Community Lists —
BGP Policy Match Tools: Prefix Lists, AS-Path ACLs and Community Lists
Opening
BGP policy becomes dangerous when every decision is encoded as a long list of unrelated exceptions. The safer approach is to separate matching primitives from policy actions and make every permit and deny explainable.
Learning objectives
- Explain the protocol mechanism precisely.
- Distinguish standards behavior from Cisco implementation behavior.
- Build a deterministic policy with explicit match and action logic.
- Verify both received and advertised routing information.
- Diagnose the failure mode and roll back safely.
Concept and standards behavior
Reliable BGP policy begins with precise match conditions. Prefix lists answer “which prefixes?”, AS-path filters answer “which path identities?”, and community lists answer “which policy tags?”. Route maps combine these predicates with attribute-setting and permit/deny behavior. This post teaches the tools as composable policy primitives.
Implementation boundary: the standard defines the wire attribute and semantics; Cisco IOS XE syntax, defaults and verification commands must be checked against the selected 17.18.x platform documentation before claiming exact execution behavior.
Engineering scenario
The lab uses three documentation-safe routers: EDGE-A (AS 65001), TRANSIT-A (AS 65002) and EDGE-B (AS 65003). EDGE-A originates 192.0.2.0/24 and 198.51.100.0/24; EDGE-B provides a second policy domain. Loopbacks and point-to-point links use TEST-NET values. No production prefixes, credentials or real ASNs are used.
The engineering requirement is to express policy using reusable metadata and precise filters, then prove that the resulting Adj-RIB-In, best path and Adj-RIB-Out behavior match the intended policy.
Topology
AS 65002 TRANSIT-A
/ \
AS 65001 EDGE-A ---- AS 65003 EDGE-B
192.0.2.0/24
198.51.100.0/24
Prerequisites
- Cisco IOS XE 17.18.x or a release with equivalent documented commands.
- Working eBGP sessions.
- Reachability between BGP next hops.
- Address family
ipv4 unicastenabled. - Console/out-of-band access for rollback.
Baseline configuration
The lab uses a minimal BGP baseline and then introduces only the policy feature under study. Representative configuration is shown below; exact interface names may differ by image.
router bgp 65001
bgp router-id 10.255.1.1
neighbor 192.0.2.2 remote-as 65002
address-family ipv4
neighbor 192.0.2.2 activate
network 192.0.2.0 mask 255.255.255.0
exit-address-family
Verification before modification
Use evidence rather than assumptions:
show ip bgp summary
show ip bgp
show ip bgp neighbors 192.0.2.2 advertised-routes
show ip bgp neighbors 192.0.2.2 received-routes
show ip bgp 192.0.2.0/24
Record the session state, prefix counts, selected path, relevant attributes and advertisement state before changing policy.
Controlled modification
Build a policy with three predicates: prefix-list selects 192.0.2.0/24, AS-path access-list rejects an unwanted transit path, and community-list selects tagged routes. Combine them in route-map sequences and demonstrate implicit deny behavior.
Fault injection
Illustrative lab — not a real incident. Inject one deliberate policy error: either omit the required send-community capability, invert a permit/deny condition, or apply the policy in the wrong direction. The fault must be introduced independently from the baseline so the learner can prove causality.
Expected symptoms include a route missing a tag, a prefix unexpectedly accepted or rejected, an attribute not being propagated, or an advertisement disappearing from Adj-RIB-Out.
Troubleshooting
- Define the affected prefix and peer.
- Confirm the BGP session is Established.
- Inspect the route in Adj-RIB-In.
- Inspect the relevant attribute/community state.
- Verify the policy match condition.
- Verify the policy direction.
- Inspect the selected best path.
- Inspect Adj-RIB-Out toward the affected neighbor.
- Check whether the capability required for attribute exchange is enabled.
- Apply the smallest correction and re-check both control-plane and forwarding results.
Root cause
The smallest proven root cause should be stated only after the evidence chain identifies where the expected policy state diverged from the observed state. Do not blame “BGP” when the evidence points to a policy predicate, attribute propagation rule, address-family activation or missing capability.
Post-fix verification
Verify the peer, prefix, attribute state, selected path, advertised path and traffic behavior. For policy-only changes, also verify that the session did not flap unnecessarily.
Rollback
Remove the new policy or restore the previous sequence, then re-verify the same evidence points used before the change. If the change affects an Internet edge, use out-of-band access and a predefined rollback trigger.
Production lessons
- Treat BGP policy as code: explicit inputs, deterministic predicates and observable outputs.
- Prefer reusable metadata over repeated prefix-specific rules where the architecture supports it.
- Keep import and export intent separate.
- Verify both sides of a policy boundary.
- Never assume an attribute is being exchanged merely because it exists locally.
Knowledge check
- What is the difference between a route tag and a route decision attribute?
- What evidence proves that an outbound policy actually changed Adj-RIB-Out?
- Why is a policy change safer when it can be refreshed without tearing down the BGP session?
Answers
- A tag such as a community carries policy metadata; a decision attribute such as LOCAL_PREF directly influences selection.
- The neighbor’s advertised-route view, combined with the route’s attribute state, proves the outbound result.
- Avoiding an unnecessary session reset reduces convergence disruption and preserves established control-plane state.
Sources
- Cisco command reference: https://www.cisco.com/c/en/us/td/docs/ios-xml/ios/iproute_bgp/command/irg-cr-book/bgp-c1.html
- Cisco route-map continue: https://www.cisco.com/c/en/us/td/docs/routers/ios/config/17-x/ip-routing/b-ip-routing/m_irg-route-map-continue.html
Publishing assets
- Excerpt: BGP policy becomes dangerous when every decision is encoded as a long list of unrelated exceptions. The safer approach is to separate matching primitives from p
- Social caption: BGP policy becomes safer when intent is explicit, metadata is reusable and every change is observable.
- Hashtags: #BGP #Networking #Routing #Cisco #NetworkEngineering #NetOps
- Diagram alt text: Day 28: BGP Policy Match Tools: Prefix Lists, AS-Path ACLs and Community Lists shown across a three-router BGP policy topology.