Crate routinator

The Routinator Library

This crate contains all the moving parts of the Routinator. The application itself, via main.rs is only a very tiny frontend.

In addition, this also lets you use Routinator as a library for your own dedicated RPKI validation needs. The operation module should serve as a good starting point and set of examples since it contains the code for the various commands Routinator provides and uses all functionality.

The library roughly consists of three parts: one part collects and validates RPKI data, one processes the validated data, and the third part distributes the output data to whomever it may concern.

The first part can be found in three modules:

• collector, which synchronizes a local copy of the published RPKI data with its upstream sources,
• store, which maintains a set of data that has passed fundamental vetting in order to deal with incomplete or broken updates from upstream sources, and
• engine, which performs a validation run using both collector and store.

The second part currently comes in two flavours:

• payload, which processes data for Route Origin Validation (i.e., checking that a BGP route has been announced by someone who was authorized to do so), and
• rta, which processes Resource Tagged Authorizations (i.e., objects signed by resource holders).

Additional modules can be added in the future.

The third part is represented by a number of modules with differing purposes:

• output allows formatting data – currently Route Origin Validation data only – in different formats,
• http provides an HTTP server with mutliple endpoints for all sorts of purposes, and
• rtr provides an RTR server which allows routers to synchronize their RPKI filter tables.

Apart from these, there are a few more modules that support these core parts in their work.

Re-exports

pub use self::config::Config;

pub use self::error::Failed;

pub use self::error::ExitError;

pub use self::operation::Operation;

pub use rpki;

pub use reqwest;

Modules

collector

Maintaining a local copy of the RPKI repositories.

config

Configuration.

engine

error

http

The HTTP server.

metrics

Monitoring metrics.

operation

What Routinator can do for you.

output

Output of validated RPKI payload.

payload

process

Managing the process Routinator runs in.

rta

rtr

slurm

Local exceptions per RFC 8416 aka SLURM.

store

A store for correctly published RPKI objects.

tals

The TALs bundled with Routinator.

utils

Various useful things.

validity

Checking for validity of route announcements.