Pour éditer le wiki, il faut demander un compte à un Lapin !

Ateliers Babel

From Le L∞p's Wiki
Revision as of 14:58, 5 January 2014 by Naar (Talk | contribs) (fix Deb template inclusion)

Jump to: navigation, search

L'objectif de cet atelier est de partager les connaissances sur le protocole Babel afin de permettre à un maximum de personnes d'installer des nœuds Babel et de lancer une expérimentation de grande taille.

Description

Lors de cet atelier, je vais vous présenter Babel à partir des distributions GNU/Linux Debian et OpenWrt, mais cela devrait être facilement adaptable pour d'autres distributions.

Pour le moment, Babel n'a pas de système d'authentification (la plupart des protocoles de réseaux maillés, y compris BGP, n'en possèdent pas non plus), mais un russe, Denis Ovsienko, a déjà implémenté un système d'authentification[1] qui fonctionne pour la version Quagga de Babel.

Prérequis

Si vous souhaitez participer à l'expérience des réseaux maillés, il est préférable de venir avec votre propre ordinateur pré-configuré. Les paquets [1] et [2] sont très légers, donc si vous ne les avez pas encore installés ni configurés, vous pourrez le faire sur place :

  • par exemple, sous Debian avec aptitude install babeld ahcpd ou sous OpenWrt avec opkg install babeld ahcpd;
  • disposer des pilotes réseau pour votre ordinateur ;
  • autoriser le transfert des paquets ;
  • avoir l'IPv6 activé.

Configuration pour Debian GNU/Linux

On va imaginer ici que vous avez un routeur dans votre réseau local qui fournit une adresse IP et une route par défaut, et que vous êtes connecté par un câble Ethernet à ce routeur qui vous donne l'accès à Internet (ce routeur va donc indiquer une route par défaut que vous aller redistribuer au sous-réseau Babel).

/etc/network/interfaces

# Exemple à adapter à votre réseau local :
allow-hotplug eth0
iface eth0 inet dhcp
  post-up invoke-rc.d babeld restart
  post-up invoke-rc.d ahcpd restart
 
# Les lignes suivantes sont commentées et représentent une configuration alternative :
#  allow-hotplug eth0
#  iface eth0 inet manual
#    post-up invoke-rc.d babeld restart
#    post-up invoke-rc.d ahcpd restart
 
auto wlan0
iface wlan0 inet manual
# Les lignes suivantes sont commentées parce qu'on obtient une adresse avec ahcpd.
# Par contre, un serveur ahcpd DOIT avoir une adresse IP (il ne se l'auto-attribue pas) :
# si vous souhaitez que ahcpd soit en mode serveur, vous devez activer et régler les 3 lignes suivantes
#  address 192.168.100.x
#  netmask 255.255.255.255
#  network 192.168.100.0
wireless-essid babel-mesh
wireless-channel 6
wireless-mode ad-hoc
wireless-rts 512
# La ligne suivante n'est pas strictement nécessaire et peut être commentée :
wireless-ap ca:fe:ca:fe:ca:fe 
    post-up invoke-rc.d babeld restart
    post-up invoke-rc.d ahcpd restart

Pour la configuration du WiFi, certains pilotes ne supportent pas la façon dont j'ai écrit les lignes commençant par wireless-... . Une solution sans garantie consiste à utiliser les directives pre-up suivies de commandes comme iwconfig.

/etc/babeld.conf

redistribute proto 3 ip 0.0.0.0/0 eq 0 metric 128

Le partage de la route par défaut se fait avec ip 0.0.0.0/0 eq 0, tandis que proto 3 est là pour indiquer que la route par défaut sera obtenue à partir de DHCP.

/etc/default/babeld

# Liste des interfaces réseau sur lesquelles le protocole Babel devrait fonctionner :
INTERFACES="eth0 wlan0"

/etc/default/ahcpd

# Liste des interfaces réseau sur lesquelles le protocole AHCP devrait fonctionner :
INTERFACES="eth0 wlan0"

Pour déployer un serveur AHCP et ainsi donner une adresse IP aux nœuds, sous Debian, il vous faut créer le fichier /etc/ahcp/ahcpd.conf :

mode server

prefix fde6:20f5:c9ac:358::/64
prefix 192.168.100.128/25
lease-dir /var/lib/leases
#  name-server fde6:20f5:c9ac:358::1

# Ici, j'indique 127.0.0.1 pour ceux qui utilisent dbndns (fork de djbdns) et dnscache-run.
# Pour les autres, je ne sais pas comment reprendre le DNS fourni, par exemple, par DHCP.
name-server 127.0.0.1

# ahcpd fonctionne mieux avec un serveur NTP, mais si vous n'en disposez pas, ce n'est pas fatal.
#  ntp-server 192.168.2.4

Ensuite il faut lancer ahcpd avec son fichier de configuration en paramètre, ce que je ne sais pas encore faire de façon automatique au démarrage sous Debian. Il faudrait voir du coté de /etc/init.d/ahcpd. Je le lance donc à la main (on pourrait aussi utilier le fichier /etc/rc.local):

ahcpd -D -c /etc/ahcp/ahcpd.conf eth0 wlan0
  • -D pour le lancer en daemon. On peut remplacer -D par -d2 pour passer en mode debug.
  • -c pour indiquer le fichier de configuration.
  • eth0 et wlan0 sont les interfaces sur lesquelles ahcpd sera à l'écoute.

Configuration pour OpenWrt

on va imaginer ici que vous avez un routeur dans votre réseau local qui fournit une adresse ip et une route par defaut, et que vous êtes connecté par le câble réseau à ce routeur qui vous donne l'accès à Internet (ce routeur va donc indiquer une route par defaut que vous aller redistribuer au sous-réseau Babel).

/etc/config/network

# Exemple à adapter à votre réseau local :
config interface 'loopback'
 option ifname 'lo'
 option proto 'static'
 option ipaddr '127.0.0.1'
 option netmask '255.0.0.0'

## config globals 'globals'
##  option ula_prefix 'fdff:5ce0:a48d::/48'

config interface 'lan'
 option ifname 'eth0'
 option proto  'static'
 option ipaddr '192.168.10.1'
 option netmask '255.255.255.0'

# Bababa-baba-babel	
config interface 'wlan'
 option ifname 'wifi_babel'
 option proto  'static'
 option ipaddr '192.168.10.2'
 option netmask '255.255.255.255'

/etc/config/wireless

config wifi-device  wlan0
 option type     mac80211
 option channel  6
 option hwmode	11ng
 option path	'platform/ar933x_wmac'
 option htmode	HT20
 list ht_capab	SHORT-GI-20
 list ht_capab	SHORT-GI-40
 list ht_capab	RX-STBC1
 list ht_capab	DSSS_CCK-40

config wifi-iface
 option ifname 	'wifi_babel'
 option device   'wlan0'
 option network  'wlan'
 option mode     'adhoc'
 option ssid     'babel-mesh'
 option encryption none

/etc/config/babeld

Quelques lignes inchangées au début du fichier :

config interface wlan
# Remove this line to enable babeld on this interface
## option 'ignore' 'true'
## option 'wired' 'auto'
## option 'link_quality' 'auto'
## option 'split_horizon' 'auto'
# The default is 96 for wired interfaces, and 256 for wireless ones
## option 'rxcost' '256'
# The default is specified with the -h and -H command-line flags.
## option 'hello_interval' '4'
# This can be set to a fairly large  value,  unless significant
# packet loss is expected.  The default is four times the hello
# interval.
## option 'update_interval' '16'

config interface lan
## option 'ignore' 'true'

# A filter consists in a type ('in', 'out' or 'redistribute'), an action
# ('allow', 'deny' or 'metric xxx') and a set of selectors ('ip', 'eq',
# etc.).  See /etc/babeld.conf for more details.
# Here is a sample filter wich redistributes the default route if its
# protocol number is "boot", e.g. when it installed by dhcp.  It is
# disabled by default.
config filter
## option 'ignore' 'true'
# Type
option 'type' 'redistribute'
# Selectors: ip, eq, le, ge, neigh, id, proto, local, if
option 'ip' '0.0.0.0/0' 
option 'eq' '0'
## option 'proto' '3'
# Action 
option 'action' 'metric 128'

/etc/config/ahcpd

Quelques lignes inchangées au début du fichier :

package ahcpd

config ahcpd
 # Choose ahcp mode: client (default), server or forwarder
 option 'mode' 'server'
 # Uncomment the following lines to enable ahcpd on the desired
 # interfaces.
  list 'interface' 'lan'
  list 'interface' 'wlan'

 # The following only makes sense in 'server' mode.
 # Tweak to suit your needs.
  list 'prefix' 'fde6:20f5:c9ac:358::/64'
  list 'prefix' '192.168.10.128/25'
 ## list 'name_server' 'fde6:20f5:c9ac:358::1'
  list 'name_server' '192.168.1.1'
 ## list 'ntp_server' '192.168.4.2'
  option 'lease_dir' '/tmp'

 # option 'id_file' '/var/lib/ahcp-unique-id'
 # option 'log_file' '/var/log/ahcpd.log'
 # The configuration file is not necessary since you can configure
 # everything from this file.  But still, you might prefer using it.
 ## option 'conf_file' '/etc/ahcp/ahcp.conf'

 # option 'multicast_address' 'ff02::cca6:c0f9:e182:5359'
 # option 'port' '5359'
 # option 'ipv4_only' 'false'
 # option 'ipv6_only' 'false'
 # option 'lease_time' '3666'
 # option 'debug' '1'

NAT avec iptables /etc/rc.local (Debian et OpenWrt)

Pour, finir je rajoute une règle iptables pour faire de la NAT. Il existe d'autres solutions plus élégantes, mais celle-ci s'applique au cas où vous n'avez pas le contrôle sur le routeur qui vous donne l'accès à Internet.

Cela vous permettra de router vos paquets entre le réseau local et le sous-réseau obtenu avec Babel (oui, c'est un sous-réseau ; on comprend plus de choses quand on sait ça, entre autres que ce sont les adresses MAC qui sont importantes, beaucoup plus que les adresses IP).

iptables -t nat -A POSTROUTING -s 192.168.0.0/16 -j MASQUERADE

Mais pourquoi ça fonctionne pas ?

Vérifiez :

  • que [3] et [4] sont lancés (avec la commande pidof babeld et pidof ahcpd) ; il arrive que Babel ne parvienne pas à enlever le /var/run/babeld.pid lorsque il est déjà présent au boot. Il faudra alors supprimer le fichier /var/run/babeld à la main en tant que root;
  • que vous ayez de l'IPv6 une adresse IPv6 au moins locale commence par fe80;
  • que le pare-feu autorise la NAT (avec la commande iptables -t nat -L) ;
  • que le pare-feu accepte le transfert de port.(règle FORWARD a ACCEPT);
  • que vous n'ayez pas obtenu la même adresse IP qu'un autre nœud, (dans la configuration que je vous ai indiqué pour openwrt, le service ahcpd enregistre les IP attribuées dans /tmp pour éviter d'écrire dans la mémoire flash, or ce dossier est complètement purgé au boot). Il est dommage que ahcpd ne vérifie pas la présence d'une IP sur le réseau avant de l'attribuer. Une methode peut être de vous attribuer vous même , manuelement une adresse IP, mais vérifiez au moins que l'adresse convoitée n'est pas déjà prise; Il parait que ce n'est pas facile/possible de vérifer, une solution serait de n'attriber que des adresses IPv6, (ahcpd fourni un prefixe, le nœud complète avec son adresse matériele)
  • que votre carte wifi, ou votre driver wifi supporte le mode ad-hoc;

j'ai déjà vu des cas où ça ne fonctionne pas en wifi (mais ça passe en filaire), et je n'ai pas su pourquoi.

Quand

Date
Samedi 23 novembre 2013 à partir de 14h00
Durée envisagée
Quelques heures, disons jusqu'à 19h?
Animation
Err404

Notes et références

  1. D. Ovsienko, « Babel HMAC Cryptographic Authentication »

Voir aussi