Skip to main content

Documentation Build Status PYPI Version

This script is intended to be used as an ExaBGP process to elaborate and report/log invalid routes that have been tagged with meaningful dedicated BGP communities by route servers.

Invalid routes are those routes that, for some reason, didn’t pass the route server’s validation process (invalid/private ASNs in the AS_PATH, bogon prefixes, invalid NEXT_HOP, IRRDBs data mismatch, …). Route servers, instead of discarding them, can keep these routes and tag them with a BGP community that describes the reason for which they have been considered as invalid.

A session with an ExaBGP-based route collector can be used to announce these invalid routes to this script, that finally processes them, extracts the reject reason and uses this information to log a record or to send an email alert to the involved networks.

If deployed in conjunction with ARouteServer, the “tag” reject policy option can be used to easily setup the route server to work together with this script.

diagram.png

For more information: https://invalidroutesreporter.readthedocs.io

Author

Pier Carlo Chiodi - https://pierky.com

Blog: https://blog.pierky.com Twitter: @pierky

Change log

v0.2.0

  • New: --rejected-route-announced-by-pattern argument, to track a BGP community set with the peer that actually announced the invalid route.

  • New: --peer-asn-only option, to send alerts only to the peers that announced invalid routes.

v0.1.0

First release as a standalone repository.

  • New: make the reject reason BGP community optional and track also routes tagged with a reject BGP community only.

  • New: optional external file containing the reason-code/description matrix.

  • Fix: extended BGP communities processing.

  • Improvement: min_wait and max_wait timers handling.

Metadata

Release files for invalidroutesreporter 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for invalidroutesreporter 0.2.0
File Size Uploaded
invalidroutesreporter-0.2.0.tar.gz 25.3 kB Details

Release files / invalidroutesreporter-0.2.0.tar.gz

Download URL invalidroutesreporter-0.2.0.tar.gz
Size 25.3 kB
Tags Source
SHA-256 checksum
How to use checksums
6e06da3f0e10b9c7d2eb1518e0249b5797ed8168baf39d5dac6dd16499b21cbe
BLAKE2b-256 checksum
How to use checksums
1054442c26ad0dd0ae8f22507438a128ede10ad5e49775b54e37f425a6bd5365
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

0.2.0 This release

1 release file

0.1.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page