rougail/doc/service/ip.md

48 lines
1.2 KiB
Markdown
Raw Normal View History

2021-02-14 10:12:42 +01:00
# La gestion d'une IP
2021-02-16 10:22:29 +01:00
## La balise IP
2021-02-14 10:12:42 +01:00
La gestion des IP se fait dans un conteneur de [service](README.md).
2021-02-10 08:19:33 +01:00
2021-02-16 10:22:29 +01:00
La déclaration de l'attribut permet d'associer une IP autorisé à accéder au service.
2021-02-10 08:19:33 +01:00
2021-02-19 10:50:28 +01:00
Il est nécessaire, au minimum, de spécifier le nom d'une variable de type "IP" :
2021-02-16 10:22:29 +01:00
```
2021-02-19 10:50:28 +01:00
<ip ip_type="variable">variable_ip</ip>
2021-02-16 10:22:29 +01:00
```
## La gestion d'un réseau
2021-02-19 10:50:28 +01:00
L'adresse peut être de type réseau ("network") :
2021-02-17 09:52:17 +01:00
```
2021-02-19 10:50:28 +01:00
<ip netmask="variable_netmask">variable_ip</ip>
2021-02-17 09:52:17 +01:00
```
2021-02-19 10:50:28 +01:00
Attention, dans ce cas il faut préciser une variable de type "netmask" dans l'attribut netmask.
2021-02-17 09:52:17 +01:00
2021-02-16 10:22:29 +01:00
## Désactiver la génération d'une IP
Il est possible de définir une [condition](../condition/README.md) de type "disabled_if_in" ou "disabled_if_not_in" sur une balise IP :
```
<services>
2021-12-11 16:33:55 +01:00
<service name="test">
<ip iplist="test_ip">variable_ip</ip>
</service>
2021-02-16 10:22:29 +01:00
</services>
<variables>
2021-12-11 16:33:55 +01:00
<variable name="condition" type="boolean"/>
<variable name="variable_ip" type="ip"/>
2021-02-16 10:22:29 +01:00
</variables>
<constraints>
2021-12-11 16:33:55 +01:00
<condition name="disabled_if_in" source="condition">
<param>False</param>
<target type="iplist">test_ip</target>
</condition>
2021-02-16 10:22:29 +01:00
</constraints>
```
Dans ce cas, tous les IP avec un attribut iplist à "test_ip" seront désactivé si la variable "condition" est False.