Skip to main content

An ExaBGP process to elaborate and report/log invalid routes received by route servers.

Project description

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

invalidroutesreporter-0.2.0.tar.gz (25.3 kB view details)

Uploaded Source

File details

Details for the file invalidroutesreporter-0.2.0.tar.gz.

File metadata

File hashes

Hashes for invalidroutesreporter-0.2.0.tar.gz
Algorithm Hash digest
SHA256 6e06da3f0e10b9c7d2eb1518e0249b5797ed8168baf39d5dac6dd16499b21cbe
MD5 2c26ca84d973c27803df2865bd434d2e
BLAKE2b-256 1054442c26ad0dd0ae8f22507438a128ede10ad5e49775b54e37f425a6bd5365

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page