mirror of
https://gitlab.nic.cz/labs/bird.git
synced 2024-12-22 17:51:53 +00:00
65d2a88dd2
The RPKI protocol (RFC 6810) using the RTRLib (http://rpki.realmv6.org/) that is integrated inside the BIRD's code. Implemeted transports are: - unprotected transport over TCP - secure transport over SSHv2 Example configuration of bird.conf: ... roa4 table r4; roa6 table r6; protocol rpki { debug all; # Import both IPv4 and IPv6 ROAs roa4 { table r4; }; roa6 { table r6; }; # Set cache server (validator) address, # overwrite default port 323 remote "rpki-validator.realmv6.org" port 8282; # Overwrite default time intervals retry 10; # Default 600 seconds refresh 60; # Default 3600 seconds expire 600; # Default 7200 seconds } protocol rpki { debug all; # Import only IPv4 routes roa4 { table r4; }; # Set cache server address to localhost, # use default ports tcp => 323 or ssh => 22 remote 127.0.0.1; # Use SSH transport instead of unprotected transport over TCP ssh encryption { bird private key "/home/birdgeek/.ssh/id_rsa"; remote public key "/home/birdgeek/.ssh/known_hosts"; user "birdgeek"; }; } ...
80 lines
2.7 KiB
C
80 lines
2.7 KiB
C
/*
|
|
* BIRD -- The Resource Public Key Infrastructure (RPKI) to Router Protocol
|
|
*
|
|
* (c) 2015 CZ.NIC
|
|
* (c) 2015 Pavel Tvrdik <pawel.tvrdik@gmail.com>
|
|
*
|
|
* This file was a part of RTRlib: http://rpki.realmv6.org/
|
|
*
|
|
* Can be freely distributed and used under the terms of the GNU GPL.
|
|
*/
|
|
|
|
/*
|
|
* The RPKI transport sockets implement the communication channel
|
|
* (e.g., SSH, TCP, TCP-AO) between an RPKI server and client.
|
|
*
|
|
* Before using the transport socket, a tr_socket must be
|
|
* initialized based on a protocol-dependent init function (e.g.,
|
|
* rpki_tr_tcp_init()).
|
|
*
|
|
* The rpki_tr_* functions call the corresponding function pointers, which are
|
|
* passed in the rpki_tr_sock structure, and forward the remaining arguments.
|
|
*/
|
|
|
|
#ifndef _BIRD_RPKI_TRANSPORT_H_
|
|
#define _BIRD_RPKI_TRANSPORT_H_
|
|
|
|
#include <time.h>
|
|
|
|
/* The return values for rpki_tr_ functions */
|
|
enum rpki_tr_rtvals {
|
|
RPKI_TR_SUCCESS = 0, /* Operation was successful */
|
|
RPKI_TR_ERROR = -1, /* Error occurred */
|
|
RPKI_TR_WOULDBLOCK = -2, /* No data is available on the socket */
|
|
RPKI_TR_INTR = -3, /* Call was interrupted from a signal */
|
|
RPKI_TR_CLOSED = -4 /* Connection closed */
|
|
};
|
|
|
|
/* A transport socket structure */
|
|
struct rpki_tr_sock {
|
|
sock *sk; /* Standard BIRD socket */
|
|
struct rpki_cache *cache; /* Cache server */
|
|
int (*open_fp)(struct rpki_tr_sock *); /* Function that establishes the socket connection */
|
|
const char *(*ident_fp)(struct rpki_tr_sock *); /* Function that returns an identifier for the socket endpoint */
|
|
const char *ident; /* Internal. Use ident_fp() hook instead of this pointer */
|
|
};
|
|
|
|
int rpki_tr_open(struct rpki_tr_sock *tr);
|
|
void rpki_tr_close(struct rpki_tr_sock *tr);
|
|
const char *rpki_tr_ident(struct rpki_tr_sock *tr);
|
|
|
|
/* Types of supported transports */
|
|
enum rpki_tr_type {
|
|
RPKI_TR_TCP, /* Unprotected transport over TCP */
|
|
RPKI_TR_SSH, /* Protected transport by SSHv2 connection */
|
|
};
|
|
|
|
/* Common configure structure for transports */
|
|
struct rpki_tr_config {
|
|
enum rpki_tr_type type; /* RPKI_TR_TCP or RPKI_TR_SSH */
|
|
const void *spec; /* Specific transport configuration, i.e. rpki_tr_tcp_config or rpki_tr_ssh_config */
|
|
};
|
|
|
|
struct rpki_tr_tcp_config {
|
|
/* No internal configuration data */
|
|
};
|
|
|
|
struct rpki_tr_ssh_config {
|
|
const char *bird_private_key; /* Filepath to the BIRD server private key */
|
|
const char *cache_public_key; /* Filepath to the public key of cache server, can be file known_hosts */
|
|
const char *user; /* Username for SSH connection */
|
|
};
|
|
|
|
/* ssh_transport.c */
|
|
void rpki_tr_ssh_init(struct rpki_tr_sock *tr);
|
|
|
|
/* tcp_transport.c */
|
|
void rpki_tr_tcp_init(struct rpki_tr_sock *tr);
|
|
|
|
#endif /* _BIRD_RPKI_TRANSPORT_H_ */
|