Skip to main content

RPKI AS0 Slurm file generator for bogons

Project description

rpki-as0-bogons

SLURM file generator for bogons with AS0 as origin.

This script generates a JSON file compatible with RFC8416 to be used for a local validator.

The script takes bogon files from the Team Cymru Bogon Reference or builds a list of all the networks not assigned according to the official NRO Delegated Statistics file, and turns them into a SLURM file. All the networks are added to the SLURM file with origin: AS0 and with a default MaxPrefix of 32 for IPv4 and 128 for IPv6.

Once loaded in a validator, this file will suggest the validating software to create "fake" ROAs for these networks. If your network performs origin validation and applies "Invalid: Reject" policies, any BGP announcement of these networks coming from your peers or upstreams should be discarded.

Installation

You can find the software on PyPi, so you can install it easily via pip.

# pip3 install rpki-as0-bogons

Usage

usage: rpki-as0-bogons [-h] [-f DEST_FILE] [-P] (-N | -C)

A script to generate a SLURM file for all bogons with origin AS0

optional arguments:
  -h, --help    show this help message and exit
  -f DEST_FILE  File to be created with all the SLURM content (default is
                /usr/local/etc/slurm.json)
  -P            Include the list of IXP LANs from PeeringDB. While some of
                them already have AS0 ROAs, not all of them do. Overlapping
                ROAs are fine, so it will be okay to generate them anyway
  -N            Use the NRO delegated stats
  -C            Use the Team Cymru's bogons list

Version 0.3.1

You have to specify if you want to use the Team Cymru lists (-C) or the NRO delegated stats (-N). For bogons only, use the Team Cymru lists, but if you want to include any network that's not assigned or allocated at the moment, it's better to use the NRO file.

Using it with a validator

Routinator

You should start routinator with the -x switch, providing the path to the file (the file is saved by the tool into /usr/local/etc/slurm.json)

RIPE NCC Validator 3

You can use curl to supply the file to the validator:

/usr/local/bin/curl -X POST -F "file=@slurm.json" localhost:8080/api/slurm/upload

Forth

Use the --slurm option when running the software.

Recommendations

Since the bogon files are updated daily, a daily run via cron is suggested for this tool.

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

rpki-as0-bogons-0.3.2.tar.gz (5.6 kB view details)

Uploaded Source

File details

Details for the file rpki-as0-bogons-0.3.2.tar.gz.

File metadata

  • Download URL: rpki-as0-bogons-0.3.2.tar.gz
  • Upload date:
  • Size: 5.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.13

File hashes

Hashes for rpki-as0-bogons-0.3.2.tar.gz
Algorithm Hash digest
SHA256 6d2c98bc7081eb5acb737018a085393aab1dd3c99ed5b25fdf81b39fe6995d72
MD5 3cd3099799627d294143e77e04ce2fc4
BLAKE2b-256 fff748b88a615be38d85236473fad1d0c4c8b4f661adcc484592611e0e2b1c6e

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