Suivant: , Précédent: , Monter: Services   [Table des matières][Index]


10.8.21 Services VPN

The (gnu services vpn) module provides services related to virtual private networks (VPNs).

OpenVPN

It provides a client service for your machine to connect to a VPN, and a server service for your machine to host a VPN.

Procédure Scheme : openvpn-client-service [#:config (openvpn-client-configuration)]

Renvoie un service qui lance openvpn, un démon VPN, en tant que client.

Procédure Scheme : openvpn-server-service [#:config (openvpn-server-configuration)]

Renvoie un service qui lance openvpn, un démon VPN, en tant que serveur.

Les deux services peuvent être lancés en même temps.

Les champs de openvpn-client-configuration disponibles sont :

paramètre de openvpn-client-configuration : package openvpn

Le paquet OpenVPN.

paramètre de openvpn-client-configuration : string pid-file

Le fichier de PID d’OpenVPN.

La valeur par défaut est ‘"/var/run/openvpn/openvpn.pid"’.

paramètre de openvpn-client-configuration : proto proto

Le protocole (UDP ou TCP) utilisé pour ouvrir un canal entre les clients et les serveurs.

La valeur par défaut est ‘udp’.

paramètre de openvpn-client-configuration : dev dev

Le périphérique utilisé pour représenter la connexion VPN.

La valeur par défaut est ‘tun’.

If you do not have some of these files (eg. you use a username and password), you can disable any of the following three fields by setting it to 'disabled.

openvpn-client-configuration parameter : maybe-string ca

L’autorité de certification qui sert à vérifier les connexions.

La valeur par défaut est ‘"/etc/openvpn/ca.crt"’.

openvpn-client-configuration parameter : maybe-string cert

Le certificat de la machine sur laquelle tourne le démon. Il devrait être signé par l’autorité indiquée dans ca.

La valeur par défaut est ‘"/etc/openvpn/client.crt"’.

openvpn-client-configuration parameter : maybe-string key

La clef de la machine sur laquelle tourne le démon. Elle doit être la clef dont le certificat est donné dans cert.

La valeur par défaut est ‘"/etc/openvpn/client.key"’.

paramètre de openvpn-client-configuration : boolean comp-lzo?

Indique s’il faut utiliser l’algorithme de compression lzo.

La valeur par défaut est ‘#t’.

paramètre de openvpn-client-configuration : boolean persist-key?

Ne pas relire les fichiers de clefs entre les SIGUSR1 et les –ping-restart.

La valeur par défaut est ‘#t’.

paramètre de openvpn-client-configuration : boolean persist-tun?

Ne pas fermer et rouvrir les périphériques TUN/TAP ou lancer de scripts de démarrage/d’arrêt entre les SIGUSR1 et les –ping-restart.

La valeur par défaut est ‘#t’.

paramètre de openvpn-client-configuration : boolean fast-io?

(Expérimental) Optimise les écritures TUN/TAP/UDP en évitant d’appeler poll/epoll/select avant l’opération d’écriture.

La valeur par défaut est ‘#f’.

paramètre de openvpn-client-configuration : number verbosity

Niveau de verbosité.

La valeur par défaut est ‘3’.

paramètre de openvpn-client-configuration : tls-auth-client tls-auth

Ajoute une couche d’authentification HMAC supplémentaire au dessus du canal de contrôle TLS pour se protéger contre les attaques DoS.

La valeur par défaut est ‘#f’.

paramètre de openvpn-client-configuration : maybe-string auth-user-pass

S’authentifie avec le serveur en utilisant le nom d’utilisateur et le mot de passe. L’option est un fichier contenant le nom d’utilisateur et le mot de passe sur deux lignes. N’utilisez pas un objet simili-fichier car il serait ajouté au dépôt et serait lisible pour n’importe quel utilisateur.

La valeur par défaut est ‘'disabled’.

paramètre de openvpn-client-configuration : key-usage verify-key-usage?

Indique s’il faut vérifier que le certificat du serveur a l’extension d’utilisation.

La valeur par défaut est ‘#t’.

paramètre de openvpn-client-configuration : bind bind?

Se lier à un port spécifique.

La valeur par défaut est ‘#f’.

paramètre de openvpn-client-configuration : resolv-retry resolv-retry?

Réessayer de résoudre l’adresse du serveur.

La valeur par défaut est ‘#t’.

paramètre de openvpn-client-configuration : openvpn-remote-list remote

Une liste de serveurs distants sur lesquels se connecter.

La valeur par défaut est ‘()’.

Les champs de openvpn-remote-configuration disponibles sont :

paramètre de openvpn-remote-configuration : string name

Nom du serveur.

La valeur par défaut est ‘"my-server"’.

paramètre de openvpn-remote-configuration : number port

Numéro de port sur lequel écoute le serveur.

La valeur par défaut est ‘1194’.

Les champs de openvpn-server-configuration disponibles sont :

paramètre de openvpn-server-configuration : package openvpn

Le paquet OpenVPN.

paramètre de openvpn-server-configuration : string pid-file

Le fichier de PID d’OpenVPN.

La valeur par défaut est ‘"/var/run/openvpn/openvpn.pid"’.

paramètre de openvpn-server-configuration : proto proto

Le protocole (UDP ou TCP) utilisé pour ouvrir un canal entre les clients et les serveurs.

La valeur par défaut est ‘udp’.

paramètre de openvpn-server-configuration : dev dev

Le périphérique utilisé pour représenter la connexion VPN.

La valeur par défaut est ‘tun’.

If you do not have some of these files (eg. you use a username and password), you can disable any of the following three fields by setting it to 'disabled.

openvpn-server-configuration parameter : maybe-string ca

L’autorité de certification qui sert à vérifier les connexions.

La valeur par défaut est ‘"/etc/openvpn/ca.crt"’.

openvpn-server-configuration parameter : maybe-string cert

Le certificat de la machine sur laquelle tourne le démon. Il devrait être signé par l’autorité indiquée dans ca.

La valeur par défaut est ‘"/etc/openvpn/client.crt"’.

openvpn-server-configuration parameter : maybe-string key

La clef de la machine sur laquelle tourne le démon. Elle doit être la clef dont le certificat est donné dans cert.

La valeur par défaut est ‘"/etc/openvpn/client.key"’.

paramètre de openvpn-server-configuration : boolean comp-lzo?

Indique s’il faut utiliser l’algorithme de compression lzo.

La valeur par défaut est ‘#t’.

paramètre de openvpn-server-configuration : boolean persist-key?

Ne pas relire les fichiers de clefs entre les SIGUSR1 et les –ping-restart.

La valeur par défaut est ‘#t’.

paramètre de openvpn-server-configuration : boolean persist-tun?

Ne pas fermer et rouvrir les périphériques TUN/TAP ou lancer de scripts de démarrage/d’arrêt entre les SIGUSR1 et les –ping-restart.

La valeur par défaut est ‘#t’.

paramètre de openvpn-server-configuration : boolean fast-io?

(Expérimental) Optimise les écritures TUN/TAP/UDP en évitant d’appeler poll/epoll/select avant l’opération d’écriture.

La valeur par défaut est ‘#f’.

paramètre de openvpn-server-configuration : number verbosity

Niveau de verbosité.

La valeur par défaut est ‘3’.

paramètre de openvpn-server-configuration : tls-auth-server tls-auth

Ajoute une couche d’authentification HMAC supplémentaire au dessus du canal de contrôle TLS pour se protéger contre les attaques DoS.

La valeur par défaut est ‘#f’.

paramètre de openvpn-server-configuration : number port

Spécifie le numéro de port sur lequel les serveurs écoutent.

La valeur par défaut est ‘1194’.

paramètre de openvpn-server-configuration : ip-mask server

Une ip et un masque de sous-réseau spécifiant le sous-réseau dans le réseau virtuel.

La valeur par défaut est ‘"10.8.0.0 255.255.255.0"’.

paramètre de openvpn-server-configuration : cidr6 server-ipv6

Une notation CIDR pour spécifier le sous-réseau IPv6 dans le réseau virtuel.

La valeur par défaut est ‘#f’.

paramètre de openvpn-server-configuration : string dh

Le fichier de paramètres Diffie-Hellman.

La valeur par défaut est ‘"/etc/openvpn/dh2048.pem"’.

paramètre de openvpn-server-configuration : string ifconfig-pool-persist

Le fichier qui enregistre les IP des clients.

La valeur par défaut est ‘"/etc/openvpn/ipp.txt"’.

paramètre de openvpn-server-configuration : gateway redirect-gateway?

Lorsque la valeur est vraie, le serveur agira comme une passerelle pour ses clients.

La valeur par défaut est ‘#f’.

paramètre de openvpn-server-configuration : boolean client-to-client?

Lorsque la valeur est vraie, les clients sont autorisés à se parler entre eux dans le VPN.

La valeur par défaut est ‘#f’.

paramètre de openvpn-server-configuration : keepalive keepalive

Fait que des messages de ping sont envoyés régulièrement dans les deux sens pour que chaque côté sache quand l’autre n’est plus disponible. keepalive a besoin d’une paire. Le premier élément est la période d’envoi du ping, et le second élément est le délai d’attente avant de considéré que l’autre côté n’est plus disponible.

paramètre de openvpn-server-configuration : number max-clients

Le nombre maximum de clients.

La valeur par défaut est ‘100’.

paramètre de openvpn-server-configuration : string status

Le fichier de statut. Ce fichier montre un court rapport sur les connexions actuelles. Il est tronqué et réécrit toutes les minutes.

La valeur par défaut est ‘"/var/run/openvpn/status"’.

paramètre de openvpn-server-configuration : openvpn-ccd-list client-config-dir

La liste des configuration pour certains clients.

La valeur par défaut est ‘()’.

Les champs de openvpn-ccd-configuration disponibles sont :

paramètre de openvpn-ccd-configuration : string name

Nom du client.

La valeur par défaut est ‘"client"’.

paramètre de openvpn-ccd-configuration : ip-mask iroute

Le réseau du client

La valeur par défaut est ‘#f’.

paramètre de openvpn-ccd-configuration : ip-mask ifconfig-push

IP du client sur le VPN.

La valeur par défaut est ‘#f’.

Wireguard

Scheme Variable : wireguard-service-type

A service type for a Wireguard tunnel interface. Its value must be a wireguard-configuration record as in this example:

(service wireguard-service-type
         (wireguard-configuration
          (peers
           (list
            (wireguard-peer
             (name "my-peer")
             (endpoint "my.wireguard.com:51820")
             (public-key "hzpKg9X1yqu1axN6iJp0mWf6BZGo8m1wteKwtTmDGF4=")
             (allowed-ips '("10.0.0.2/32")))))))
Data Type : wireguard-configuration

Data type representing the configuration of the Wireguard service.

wireguard

The wireguard package to use for this service.

interface (default: "wg0")

The interface name for the VPN.

addresses (default: '("10.0.0.1/32"))

The IP addresses to be assigned to the above interface.

private-key (default: "/etc/wireguard/private.key")

The private key file for the interface. It is automatically generated if the file does not exist.

peers (default: '())

The authorized peers on this interface. This is a list of wireguard-peer records.

Data Type : wireguard-peer

Data type representing a Wireguard peer attached to a given interface.

name

The peer name.

endpoint (default: #f)

The optional endpoint for the peer, such as "demo.wireguard.com:51820".

public-key

The peer public-key represented as a base64 string.

allowed-ips

A list of IP addresses from which incoming traffic for this peer is allowed and to which incoming traffic for this peer is directed.


Suivant: , Précédent: , Monter: Services   [Table des matières][Index]