/usr/share/doc/HOWTO/fr-html/Virtual-Services-HOWTO.html is in doc-linux-fr-html 2013.01-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796 797 798 799 800 801 802 803 804 805 806 807 808 809 810 811 812 813 814 815 816 817 818 819 820 821 822 823 824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841 842 843 844 845 846 847 848 849 850 851 852 853 854 855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 882 883 884 885 886 887 888 889 890 891 892 893 894 895 896 897 898 899 900 901 902 903 904 905 906 907 908 909 910 911 912 913 914 915 916 917 918 919 920 921 922 923 924 925 926 927 928 929 930 931 932 933 934 935 936 937 938 939 940 941 942 943 944 945 946 947 948 949 950 951 952 953 954 955 956 957 958 959 960 961 962 963 964 965 966 967 968 969 970 971 972 973 974 975 976 977 978 979 980 981 982 983 984 985 986 987 988 989 990 991 992 993 994 995 996 997 998 999 1000 1001 1002 1003 1004 1005 1006 1007 1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018 1019 1020 1021 1022 1023 1024 1025 1026 1027 1028 1029 1030 1031 1032 1033 1034 1035 1036 1037 1038 1039 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052 1053 1054 1055 1056 1057 1058 1059 1060 1061 1062 1063 1064 1065 1066 1067 1068 1069 1070 1071 1072 1073 1074 1075 1076 1077 1078 1079 1080 1081 1082 1083 1084 1085 1086 1087 1088 1089 1090 1091 1092 1093 1094 1095 1096 1097 1098 1099 1100 1101 1102 1103 1104 1105 1106 1107 1108 1109 1110 1111 1112 1113 1114 1115 1116 1117 1118 1119 1120 1121 1122 1123 1124 1125 1126 1127 1128 1129 1130 1131 1132 1133 1134 1135 1136 1137 1138 1139 1140 1141 1142 1143 1144 1145 1146 1147 1148 1149 1150 1151 1152 1153 1154 1155 1156 1157 1158 1159 1160 1161 1162 1163 1164 1165 1166 1167 1168 1169 1170 1171 1172 1173 1174 1175 1176 1177 1178 1179 1180 1181 1182 1183 1184 1185 1186 1187 1188 1189 1190 1191 1192 1193 1194 1195 1196 1197 1198 1199 1200 1201 1202 1203 1204 1205 1206 1207 1208 1209 1210 1211 1212 1213 1214 1215 1216 1217 1218 1219 1220 1221 1222 1223 1224 1225 1226 1227 1228 1229 1230 1231 1232 1233 1234 1235 1236 1237 1238 1239 1240 1241 1242 1243 1244 1245 1246 1247 1248 1249 1250 1251 1252 1253 1254 1255 1256 1257 1258 1259 1260 1261 1262 1263 1264 1265 1266 1267 1268 1269 1270 1271 1272 1273 1274 1275 1276 1277 1278 1279 1280 1281 1282 1283 1284 1285 1286 1287 1288 1289 1290 1291 1292 1293 1294 1295 1296 1297 1298 1299 1300 1301 1302 1303 1304 1305 1306 1307 1308 1309 1310 1311 1312 1313 1314 1315 1316 1317 1318 1319 1320 1321 1322 1323 1324 1325 1326 1327 1328 1329 1330 1331 1332 1333 1334 1335 1336 1337 1338 1339 1340 1341 1342 1343 1344 1345 1346 1347 1348 1349 1350 1351 1352 1353 1354 1355 1356 1357 1358 1359 1360 1361 1362 1363 1364 1365 1366 1367 1368 1369 1370 1371 1372 1373 1374 1375 1376 1377 1378 1379 1380 1381 1382 1383 1384 1385 1386 1387 1388 1389 1390 1391 1392 1393 1394 1395 1396 1397 1398 1399 1400 1401 1402 1403 1404 1405 1406 1407 1408 1409 1410 1411 1412 1413 1414 1415 1416 1417 1418 1419 1420 1421 1422 1423 1424 1425 1426 1427 1428 1429 1430 1431 1432 1433 1434 1435 1436 1437 1438 1439 1440 1441 1442 1443 1444 1445 1446 1447 1448 1449 1450 1451 1452 1453 1454 1455 1456 1457 1458 1459 1460 1461 1462 1463 1464 1465 1466 1467 1468 1469 1470 1471 1472 1473 1474 1475 1476 1477 1478 1479 1480 1481 1482 1483 1484 1485 1486 1487 1488 1489 1490 1491 1492 1493 1494 1495 1496 1497 1498 1499 1500 1501 1502 1503 1504 1505 1506 1507 1508 1509 1510 1511 1512 1513 1514 1515 1516 1517 1518 1519 1520 1521 1522 1523 1524 1525 1526 1527 1528 1529 1530 1531 1532 1533 1534 1535 1536 1537 1538 1539 1540 1541 1542 1543 1544 1545 1546 1547 1548 1549 1550 1551 1552 1553 1554 1555 1556 1557 1558 1559 1560 1561 1562 1563 1564 1565 1566 1567 1568 1569 1570 1571 1572 1573 1574 1575 1576 1577 1578 1579 1580 1581 1582 1583 1584 1585 1586 1587 1588 1589 1590 1591 1592 1593 1594 1595 1596 1597 1598 1599 1600 1601 1602 1603 1604 1605 1606 1607 1608 1609 1610 1611 1612 1613 1614 1615 1616 1617 1618 1619 1620 1621 1622 1623 1624 1625 1626 1627 1628 1629 1630 1631 1632 1633 1634 1635 1636 1637 1638 1639 1640 1641 1642 1643 1644 1645 1646 1647 1648 1649 1650 1651 1652 1653 1654 1655 1656 1657 1658 1659 1660 1661 1662 1663 1664 1665 1666 1667 1668 1669 1670 1671 1672 1673 1674 1675 1676 1677 1678 1679 1680 1681 1682 1683 1684 1685 1686 1687 1688 1689 1690 1691 1692 1693 1694 1695 1696 1697 1698 1699 1700 1701 1702 1703 1704 1705 1706 1707 1708 1709 1710 1711 1712 1713 1714 1715 1716 1717 1718 1719 1720 1721 1722 1723 1724 1725 1726 1727 1728 1729 1730 1731 1732 1733 1734 1735 1736 1737 1738 1739 1740 1741 1742 1743 1744 1745 1746 1747 1748 1749 1750 1751 1752 1753 1754 1755 1756 1757 1758 1759 1760 1761 1762 1763 1764 1765 1766 1767 1768 1769 1770 1771 1772 1773 1774 1775 1776 1777 1778 1779 1780 1781 1782 1783 1784 1785 1786 1787 1788 1789 1790 1791 1792 1793 1794 1795 1796 1797 1798 1799 1800 1801 1802 1803 1804 1805 1806 1807 1808 1809 1810 1811 1812 1813 1814 1815 1816 1817 1818 1819 1820 1821 1822 1823 1824 1825 1826 1827 1828 1829 1830 1831 1832 1833 1834 1835 1836 1837 1838 1839 1840 1841 1842 1843 1844 1845 1846 1847 1848 1849 1850 1851 1852 1853 1854 1855 1856 1857 1858 1859 1860 1861 1862 1863 1864 1865 1866 1867 1868 1869 1870 1871 1872 1873 1874 1875 1876 1877 1878 1879 1880 1881 1882 1883 1884 1885 1886 1887 1888 1889 1890 1891 1892 1893 1894 1895 1896 1897 1898 1899 1900 1901 1902 1903 1904 1905 1906 1907 1908 1909 1910 1911 1912 1913 1914 1915 1916 1917 1918 1919 1920 1921 1922 1923 1924 1925 1926 1927 1928 1929 1930 1931 1932 1933 1934 1935 1936 1937 1938 1939 1940 1941 1942 1943 1944 1945 1946 1947 1948 1949 1950 1951 1952 1953 1954 1955 1956 1957 1958 1959 1960 1961 1962 1963 1964 1965 1966 1967 1968 1969 1970 1971 1972 1973 1974 1975 1976 1977 1978 1979 1980 1981 1982 1983 1984 1985 1986 1987 1988 1989 1990 1991 1992 1993 1994 1995 1996 1997 1998 1999 2000 2001 2002 2003 2004 2005 2006 2007 2008 2009 2010 2011 2012 2013 2014 2015 2016 2017 2018 2019 2020 2021 2022 2023 2024 2025 2026 2027 2028 2029 2030 2031 2032 2033 2034 2035 2036 2037 2038 2039 2040 2041 2042 2043 2044 2045 2046 2047 2048 2049 2050 2051 2052 2053 2054 2055 2056 2057 2058 2059 2060 2061 2062 2063 2064 2065 2066 2067 2068 2069 2070 2071 2072 2073 2074 2075 2076 2077 2078 2079 2080 2081 2082 2083 2084 2085 2086 2087 2088 2089 2090 2091 2092 2093 2094 2095 2096 2097 2098 2099 2100 2101 2102 2103 2104 2105 2106 2107 2108 2109 2110 2111 2112 2113 2114 2115 2116 2117 2118 2119 2120 2121 2122 2123 2124 2125 2126 2127 2128 2129 2130 2131 2132 2133 2134 2135 2136 2137 2138 2139 2140 2141 2142 2143 2144 2145 2146 2147 2148 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<html>
<head>
<meta name="generator" content=
"HTML Tidy for Linux (vers 25 March 2009), see www.w3.org">
<meta name="GENERATOR" content="LinuxDoc-Tools 0.9.69">
<title>Virtual Services Howto</title>
</head>
<body>
<h1>Virtual Services Howto</h1>
<h2>Brian Ackerman, <code>brian@nycrc.net</code><br>
Adaptation française Julien Garnault
<code>judge@club-internet.fr</code></h2>
v2.1, 15 Aout 1998
<hr>
<em>Ce document a été écrit pour
répondre au nombre grandissant de questions sur la
manière de rendre un service virtuel.</em>
<hr>
<h2><a name="s1">1. Introduction</a></h2>
<h2><a name="ss1.1">1.1 Pré-requis</a></h2>
<p>Créer une machine pour des services virtuels n'est pas du
tout difficile. Cependant, des connaissances basiques ne sont pas
suffisantes. De plus, ce document n'est pas destiné à
vous expliquer comment configurer une machine sous Linux.</p>
<p>Afin que vous puissiez comprendre ce HOWTO, nous supposerons que
les documents suivants vous sont tout à fait
familiers :</p>
<ul>
<li>Compiler un noyau Linux et ajouter le support de l'IP aliasing
<a href=
"http://www.freenix.org/unix/linux/HOWTO/mini/IP-Alias.html">IP
alias mini-HOWTO</a></li>
<li>Installer et configurer des périphériques
réseau <a href=
"http://www.freenix.org/unix/linux/HOWTO/NET-3-HOWTO.html">NET-3
HOWTO</a></li>
<li>Installer inetd <a href=
"http://www.freenix.org/unix/linux/HOWTO/NET-3-HOWTO.html">NET-3
HOWTO</a></li>
<li>Compiler et installer divers paquetages de logiciels en
réseau comme <a href="http://www.sendmail.org">Le site de
Sendmail</a> <a href="http://www.apache.org">Le site d'Apache</a>
<a href="http://www.cetis.hvu.nl/~koos/wu-ftpd-faq.html">La FAQ de
Wu-Ftpd</a></li>
<li>Mettre en place le DNS <a href=
"http://www.freenix.org/unix/linux/HOWTO/DNS-HOWTO.html">DNS
HOWTO</a></li>
</ul>
<p>Si vous n'êtes pas certain de la marche à suivre
pour effectuer une des actions précédentes, il est
FORTEMENT recommandé que vous suiviez les liens
proposés pour vous familiariser avec tous ces paquetages. Je
ne répondrai à AUCUN mail concernant les points
précédents. Veuillez s'il vous plaît rediriger
toute question à l'auteur du HOWTO approprié.</p>
<h2><a name="ss1.2">1.2 But</a></h2>
<p>Le but des services virtuels est de permettre à une seule
machine de reconnaître de multiples adresses IP sans avoir de
multiples cartes réseau. L'IP aliasing est une option du
noyau qui vous permet d'assigner plus d'une adresse IP à
chaque périphérique réseau. Le noyau
multiplexe (les échange très rapidement) en
tâche de fond et l'utilisateur a l'impression d'avoir
plusieurs cartes réseau dans sa machine.</p>
<p>Ce multiplexage permet à de multiples domaines
(www.domaine1.com, www.domaine2.com, etc.) d'être
logés sur la même machine pour le même
coût que pour un seul domaine. Malheureusement, la plupart
des services (ftp, web, courrier électronique) n'ont pas
été conçus pour gérer de multiples
domaines. Afin de les faire fonctionner correctement, vous devrez
modifier à la fois les fichiers de configuration et le code
source. Ce document décrit comment réaliser ces
modifications pour la mise en place d'une machine virtuelle.</p>
<p>Un démon est également nécessaire afin de
faire fonctionner les services virtuels. Le code source de ce
démon (virtuald) est fourni plus loin dans ce document.</p>
<h2><a name="ss1.3">1.3 Commentaires</a></h2>
<p>Ce document va grossir au fur et à mesure que les
paquetages seront mis à jour et que le code source ou que
les modifications proposées changeront. Si quelque partie de
ce document n'est pas claire, envoyez-moi vous questions ou
suggestions. Afin que je n'aie pas à chercher dans le HOWTO
en entier, assurez vous s'il vous plaît que les commentaires
soient aussi spécifiques que possible et incluent la section
où se trouve le point discutable. Il est important que tout
mail ait un champ Subject: contenant VIRTSERVICES HOWTO. Tout autre
mail sera considéré comme du mail personnel, et tous
mes amis savent que je ne lis pas tout le temps mon mail personnel
et il risque donc d'être effacé avec le leur.</p>
<p>Veuillez également noter que mes exemples ne sont pas
autre chose que des exemples, et ne doivent pas être
recopiés tels quels. Il se peut que vous ayez à
insérer vos propres valeurs. Si vous rencontrez des
problèmes, envoyez moi un mail, contenant tous les fichiers
de configuration pertinents et les messages d'erreur que vous avez
obtenu lors de l'installation. Je vous renverrai mes
suggestions.</p>
<h2><a name="ss1.4">1.4 Historique des changements</a></h2>
<p>V1.0 Document initial.</p>
<p>V1.1 Correction d'une erreur dans la section sur le web
virtuel.</p>
<p>V1.2 Correction de la date.</p>
<p><b>V2.0</b></p>
<p>Mise à jour des liens html.</p>
<p>Mise à jour de la section Web.</p>
<p>Nouvelle option pour sendmail.</p>
<p>Nouvelle option pour Qmail.</p>
<p>Mise à jour de la section Syslogd.</p>
<p>Mise à jour de la section FTP.</p>
<p>Option par défaut de Virtuald.</p>
<p>Nouvelle section Samba.</p>
<p>Mise à jour de la FAQ.</p>
<p><b>V2.1</b></p>
<p>Tous les paths ont été changés pour
/usr/local.</p>
<p>Ajout de l'option de compilation VERBOSELOG.</p>
<p>Correction d'un bug de setuid/setgid dans virtmailfilter.</p>
<p>Correction du bug de execl dans virtmailfilter</p>
<p>Correction du bug de captalization dans virtmailfilter.</p>
<p>Suppression du code mbox de virtmailfilter/virtmaildelivery.</p>
<p>Ajout d'une section tcpserver.init pop pour Qmail</p>
<p>Ajout de la question alias domain name à la FAQ.</p>
<p>Correction de virtmailfilter pour envoyer le répertoire
home à virtmaildelivery.</p>
<h2><a name="ss1.5">1.5 Copyright/Distribution</a></h2>
<p>Ce document est Copyright (c) 1997 par The Computer Resource
Center Inc.</p>
<p>Une copie de ce document peut être reproduite ou
distribuée sur n'importe quel support physique ou
électronique sans la permission de l'auteur. De la
même façon, les traductions sont autorisées
sans permission expresse si elle incluent un mot disant qui l'a
traduit (NdT : voir le début du document pour mes
coordonnées). Une redistribution commerciale est
autorisée et encouragée. Dans ce cas cependant,
faites-en part à <a href="mailto:brian@nycrc.net">Computer
Resource Center</a>.</p>
<p>Vous pouvez utiliser des extraits de ce document sans accord de
l'auteur, à condition que l'oeuvre dérivée
contienne une copie de ce document ou un pointeur vers une copie de
ce document.</p>
<p>Vous avez la permission d'effectuer des copies ainsi que de les
distribuer à condition que le paragraphe sur le copyright
ainsi que cette note soient préservés sur toutes les
copies.</p>
<p>En bref, nous désirons promouvoir la dissémination
de cette information par quelque moyen que ce soit. Cependant, je
désire conserver le copyright sur ce document, et aimerait
être tenu au courant de tous les plans de redistribution de
ce HOWTO.</p>
<h2><a name="s2">2. IP aliasing</a></h2>
<p>L'IP aliasing est une option du noyau qui doit être mise
en place afin de pouvoir faire tourner des services virtuels sur
une machine. Il existe déjà un mini-HOWTO expliquant
l' <a href=
"http://www.freenix.org/unix/linux/HOWTO/mini/IP-Alias.html">IP
aliasing</a>. Référez vous à ce document pour
toute question concernant la mise en place de cette option.</p>
<h2><a name="s3">3. Virtuald</a></h2>
<h2><a name="ss3.1">3.1 Comment ça marche</a></h2>
<p>Toute connexion réseau est composée de deux paires
adresse IP/port. L'API (Applications Program Interface, ou
Interface de Programmation d'Applications) pour la programmation
réseau est nommée l'API Sockets. La socket agit comme
un fichier ouvert, et vous pouvez envoyer ou recevoir des
données à travers une connexion réseau en
lisant ou en écrivant dans la socket. Il existe une
fonction, <code>getsockname</code>, qui retourne l'adresse IP de la
socket locale. Virtuald utilise <code>getsockname</code> pour
déterminer sur quel adresse IP de la machine locale la
connexion a été faite. Virtuald lit un fichier de
configuration pour récupérer le répertoire
associé à cette adresse IP. Il va utiliser
<code>chroot</code> sur ce répertoire et prendre en compte
la connexion au service. <code>Chroot</code> change le
répertoire / (le répertoire root) vers un nouveau
point, de sorte que tout ce qui est au dessus de ce
répertoire devienne inaccessible pour le programme. Ainsi,
chaque adresse IP se voit assigné un système virtuel
de fichiers. Pour le programme réseau, ceci est transparent,
et le programme va se comporter comme si de rien n'était.
Virtuald, en conjonction avec un programme comme inetd, peut
être utilisé pour virtualiser n'importe quel
service.</p>
<h2><a name="ss3.2">3.2 inetd</a></h2>
<p>Inetd est un super serveur réseau qui écoute sur
de multiples ports et, lorsqu'il reçoit une demande de
connexion (par exemple, une requête POP), inetd
réalise la connexion et l'envoie au programme
spécifié. Cela évite de faire tourner des
serveurs pour rien lorsqu'il n'y a aucune demande pour eux</p>
<p>Un fichier <code>/etc/inetd.conf</code> standard ressemble
à ceci :</p>
<pre>
ftp stream tcp nowait root /usr/sbin/tcpd \
wu.ftpd -l -a
pop-3 stream tcp nowait root /usr/sbin/tcpd \
in.qpop -s
</pre>
<p>Un fichier <code>/etc/inetd.conf</code> virtualisé
ressemble à ceci :</p>
<pre>
ftp stream tcp nowait root /usr/bin/virtuald virtuald /virtual/conf.ftp wu.ftpd -l -a
pop-3 stream tcp nowait root /usr/bin/virtuald virtuald /virtual/conf.pop in.qpop -s
</pre>
<h2><a name="ss3.3">3.3 Fichier de Configuration</a></h2>
<p>Chaque service se voit attribué un fichier de
configuration qui contrôlera quelles IPs et quels
répertoires sont autorisés pour ce service. Vous
pouvez avoir un fichier de configuration principal ou de nombreux
fichiers de configuration si vous désirez que chaque service
se voit attribuer une liste de domaines différents. Un
fichier de configuration ressemble à ceci :</p>
<pre>
# C'est un commentaire, comme le sont les lignes blanches
# Format IP "ESPACE" dir "PAS D'ESPACES"
10.10.10.129 /virtual/foo.bar.com
10.10.10.130 /virtual/bar.foo.com
10.10.10.157 /virtual/boo.la.com
</pre>
<h2><a name="ss3.4">3.4 Le code source de virtuald</a></h2>
<p>Ceci est un code source en C du programme virtuald. Compilez-le
et installez-le dans /usr/local/bin avec les permissions 0755,
l'utilisateur root, et le groupe root. La seule option de
compilation est VERBOSELOG qui active ou désactive l'option
de log.</p>
<pre>
#include <netinet/in.h>
#include <sys/socket.h>
#include <arpa/inet.h>
#include <stdarg.h>
#include <unistd.h>
#include <string.h>
#include <syslog.h>
#include <stdio.h>
#define BUFSIZE 8192
int getipaddr(char **ipaddr)
{
struct sockaddr_in virtual_addr;
static char ipaddrbuf[BUFSIZE];
int virtual_len;
char *ipptr;
virtual_len=sizeof(virtual_addr);
if (getsockname(0,(struct sockaddr *)&virtual_addr,&virtual_len) {
syslog(LOG_ERR,"getipaddr: getsockname failed: %m");
return -1;
}
if (!(ipptr=inet_ntoa(virtual_addr.sin_addr)))
{
syslog(LOG_ERR,"getipaddr: inet_ntoa failed: %m");
return -1;
}
strncpy(ipaddrbuf,ipptr,sizeof(ipaddrbuf)-1);
*ipaddr=ipaddrbuf;
return 0;
}
int iptodir(char **dir,char *ipaddr,char *filename)
{
char buffer[BUFSIZE],*bufptr;
static char dirbuf[BUFSIZE];
FILE *fp;
if (!(fp=fopen(filename,"r")))
{
syslog(LOG_ERR,"iptodir: fopen failed: %m");
return -1;
}
*dir=NULL;
while(fgets(buffer,BUFSIZE,fp))
{
buffer[strlen(buffer)-1]=0;
if (*buffer=='#' || *buffer==0)
continue;
if (!(bufptr=strchr(buffer,' ')))
{
syslog(LOG_ERR,"iptodir: strchr failed");
return -1;
}
*bufptr++=0;
if (!strcmp(buffer,ipaddr))
{
strncpy(dirbuf,bufptr,sizeof(dirbuf)-1);
*dir=dirbuf;
break;
}
if (!strcmp(buffer,"default"))
{
strncpy(dirbuf,bufptr,sizeof(dirbuf)-1);
*dir=dirbuf;
break;
}
}
if (fclose(fp)==EOF)
{
syslog(LOG_ERR,"iptodir: fclose failed: %m");
return -1;
}
if (!*dir)
{
syslog(LOG_ERR,"iptodir: ip not found in conf file");
return -1;
}
return 0;
}
int main(int argc,char **argv)
{
char *ipaddr,*dir;
openlog("virtuald",LOG_PID,LOG_DAEMON);
#ifdef VERBOSELOG
syslog(LOG_ERR,"Virtuald Starting: $Revision: 1.49 $");
#endif
if (!argv[1])
{
syslog(LOG_ERR,"invalid arguments: no conf file");
exit(0);
}
if (!argv[2])
{
syslog(LOG_ERR,"invalid arguments: no program to run");
exit(0);
}
if (getipaddr(&ipaddr))
{
syslog(LOG_ERR,"getipaddr failed");
exit(0);
}
#ifdef VERBOSELOG
syslog(LOG_ERR,"Incoming ip: %s",ipaddr);
#endif
if (iptodir(&dir,ipaddr,argv[1]))
{
syslog(LOG_ERR,"iptodir failed");
exit(0);
}
if (chroot(dir)<0)
{
syslog(LOG_ERR,"chroot failed: %m");
exit(0);
}
#ifdef VERBOSELOG
syslog(LOG_ERR,"Chroot dir: %s",dir);
#endif
if (chdir("/")<0)
{
syslog(LOG_ERR,"chdir failed: %m");
exit(0);
}
if (execvp(argv[2],argv+2)<0)
{
syslog(LOG_ERR,"execvp failed: %m");
exit(0);
}
closelog();
exit(0);
}
</pre>
<h2><a name="s4">4. Scripts shell</a></h2>
<h2><a name="ss4.1">4.1 virtfs</a></h2>
<p>Chaque domaine doit avoir une arborescence de
répertoires. Puisque vous utilisez <code>chroot</code>, vous
aurez besoin de copies multiples des librairies, binaires, fichiers
de configuration, etc. J'utilise le répertoire
<code>/virtual/domaine1.com</code> pour chaque domaine que je
crée.</p>
<p>Je comprends bien que cela représente du gaspillage
d'espace disque, mais l'espace disque est meilleur marché
qu'une nouvelle machine ou que des cartes réseau. Si vous
désirez réellement sauver de l'espace disque, vous
pouvez faire des liens, afin qu'une seule copie de chaque binaire
soit présente. Le systeme de fichiers que j'utilise prend un
peu plus de 2Mo. Le script essaye de copier tous les fichiers du
système de fichiers principal pour que ce soit le plus
identique possible.</p>
<p>Voici un fichier virtfs d'exemple :</p>
<pre>
#!/bin/bash
echo '$Revision: 1.49 $'
echo -n "Saisissez le nom de domaine : "
read domain
if [ "$domain" = "" ]
then
echo Vous n'avez rien saisi : on arrête là
exit 0
fi
leadingdir=/virtual
echo -n "Saisissez le nom du répertoire contenant les domaines (défaut: $leadingdir): "
read ans
if [ "$ans" != "" ]
then
leadingdir=$ans
fi
newdir=$leadingdir/$domain
if [ -d "$newdir" ]
then
echo Le répertoire $newdir existe déjà
exit 0
else
echo Nouveau répertoire : $newdir
fi
echo Création de $newdir
mkdir -p $newdir
echo Création de bin
cp -pdR /bin $newdir
echo Création de dev
cp -pdR /dev $newdir
echo Création de dev/log
ln -f /virtual/log $newdir/dev/log
echo Création d'etc
mkdir -p $newdir/etc
for i in /etc/*
do
if [ -d "$i" ]
then
continue
fi
cp -pd $i $newdir/etc
done
echo Création de etc/skel
mkdir -p $newdir/etc/skel
echo Création de home
for i in a b c d e f g h i j k l m n o p q r s t u v w x y z
do
mkdir -p $newdir/home/$i
done
echo Création de home/c/crc
mkdir -p $newdir/home/c/crc
chown crc.users $newdir/home/c/crc
echo Création de lib
mkdir -p $newdir/lib
for i in /lib/*
do
if [ -d "$i" ]
then
continue
fi
cp -pd $i $newdir/lib
done
echo Création de proc
mkdir -p $newdir/proc
echo Création de sbin
cp -pdR /sbin $newdir
echo Création de tmp
mkdir -p -m 0777 $newdir/tmp
chmod +t $newdir/tmp
echo Création de usr
mkdir -p $newdir/usr
echo Création de usr/bin
cp -pdR /usr/bin $newdir/usr
echo Création de usr/lib
mkdir -p $newdir/usr/lib
echo Création de usr/lib/locale
cp -pdR /usr/lib/locale $newdir/usr/lib
echo Création de usr/lib/terminfo
cp -pdR /usr/lib/terminfo $newdir/usr/lib
echo Création de usr/lib/zoneinfo
cp -pdR /usr/lib/zoneinfo $newdir/usr/lib
echo Création de usr/lib/\*.so\*
cp -pdR /usr/lib/*.so* $newdir/usr/lib
echo Création de usr/sbin
cp -pdR /usr/sbin $newdir/usr
echo Lien de usr/tmp vers /tmp
ln -s /tmp $newdir/usr/tmp
echo Création de var
mkdir -p $newdir/var
echo Création de var/lock
cp -pdR /var/lock $newdir/var
echo Création de var/log
mkdir -p $newdir/var/log
echo Création de var/log/wtmp
cp /dev/null $newdir/var/log/wtmp
echo Création de var/run
cp -pdR /var/run $newdir/var
echo Création de var/run/utmp
cp /dev/null $newdir/var/run/utmp
echo Création de var/spool
cp -pdR /var/spool $newdir/var
echo Lien de var/tmp vers /tmp
ln -s /tmp $newdir/var/tmp
echo Création de var/www/html
mkdir -p $newdir/var/www/html
chown webmast.www $newdir/var/www/html
chmod g+s $newdir/var/www/html
echo Création de var/www/master
mkdir -p $newdir/var/www/master
chown webmast.www $newdir/var/www/master
echo Création de var/www/server
mkdir -p $newdir/var/www/server
chown webmast.www $newdir/var/www/server
exit 0
</pre>
<h2><a name="ss4.2">4.2 Virtexec</a></h2>
<p>Afin d'exécuter des commandes dans un environnement
virtuel, vous devez utiliser <code>chroot</code> sur ce
répertoire puis lancer la commande. J'ai écrit un
script shell nommé virtexec se chargeant de ces
opérations, pour n'importe quelle commande :</p>
<pre>
#!/bin/sh
echo '$Revision: 1.49 $'
BNAME=`basename $0`
FIRST4CHAR=`echo $BNAME | cut -c1-4`
REALBNAME=`echo $BNAME | cut -c5-`
if [ "$BNAME" = "virtexec" ]
then
echo Vous ne pouvez pas lancer virtexec directement. Il FAUT un lien symbolique
exit 0
fi
if [ "$FIRST4CHAR" != "virt" ]
then
echo Le lien ne pointe pas sur une fonction virtuelle
exit 0
fi
list=""
num=1
for i in /virtual/*
do
if [ ! -d "$i" ]
then
continue
fi
if [ "$i" = "/virtual/lost+found" ]
then
continue
fi
list="$list $i $num"
num=`expr $num + 1`
done
if [ "$list" = "" ]
then
echo Je ne trouve pas d'environnement virtuel
exit 0
fi
dialog --clear --title 'Virtexec' --menu Pick 20 70 12 $list 2> /tmp/menu.$$
if [ "$?" = "0" ]
then
newdir=`cat /tmp/menu.$$`
else
newdir=""
fi
tput clear
rm -f /tmp/menu.$$
echo '$Revision: 1.49 $'
if [ ! -d "$newdir" ]
then
echo Le nouveau répertoire $newdir N'EXISTE PAS
exit 0
else
echo Nouveau répertoire : $newdir
fi
echo bname: $BNAME
echo realbname: $REALBNAME
if [ "$*" = "" ]
then
echo arguments: aucun
else
echo args: $*
fi
echo Changement de répertoire vers $newdir
cd $newdir
echo Lancement de $REALBNAME
chroot $newdir $REALBNAME $*
exit 0
</pre>
<p>Veuillez noter que vous devez disposer du programme
<code>dialog</code> sur votre système pour que ce script
fonctionne. Pour utiliser virtexec, créez un lien symbolique
d'un programme vers celui-ci. Par exemple :</p>
<pre>
ln -s /usr/local/bin/virtexec /usr/local/bin/virtpasswd
ln -s /usr/local/bin/virtexec /usr/local/bin/virtvi
ln -s /usr/local/bin/virtexec /usr/local/bin/virtpico
ln -s /usr/local/bin/virtexec /usr/local/bin/virtemacs
ln -s /usr/local/bin/virtexec /usr/local/bin/virtmailq
</pre>
<p>A présent, si vous tapez <code>virtvi</code> ou
<code>virtpasswd</code> ou encore <code>virtmailq</code>, cela vous
permettra d'éditer un fichier, changer le mot de passe d'un
utilisateur, ou vérifier la file d'attente de mail sur votre
système virtuel. Vous pouvez créer autant de liens
vers virtexec que vous le désirez. Cependant, notez bien que
si votre programme nécessite une librairie partagée,
celle-ci doit se trouver sur le système de fichiers virtuel,
ainsi que les binaires.</p>
<h2><a name="ss4.3">4.3 Notes</a></h2>
<p>J'installe tous les scripts dans <code>/usr/local/bin</code>.
Tout ce que je ne désire pas mettre sur le système de
fichiers virtuel, je le place dans <code>/usr/local</code>. Le
script ne touche à rien dans ce répertoire lors de la
copie. Les fichiers ne devant pas chevaucher plusieurs
systèmes de fichiers virtuels doivent être
supprimés. Par exemple, <code>ssh</code> est installé
sur mon système, et je n'ai pas voulu que les clefs
privées soient disponibles sur tous les systèmes de
fichier. J'ai donc supprimé le fichier des systèmes
de fichiers virtuels après avoir lancé
<code>virtfs</code>. Je change également le
<code>resolv.conf</code> et supprime tout ce qui contient le nom
d'un autre domaine, pour des raisons légales. Par exemple,
les fichiers <code>/etc/hosts</code> et
<code>/etc/HOSTNAME</code>.</p>
<p>Les programmes pour lesquels je fais un lien symbolique vers
virtexec sont :</p>
<ul>
<li>virtpasswd -- changer le mot de passe d'un utilisateur</li>
<li>virtadduser -- ajouter un utilisateur</li>
<li>virtdeluser -- supprimer un utilisateur</li>
<li>virtsmbstatus -- consulter l'état de samba</li>
<li>virtvi -- éditer un fichier</li>
<li>virtmailq -- vérifier la mailq</li>
<li>virtnewaliases -- reconstruire la table des alias mail</li>
</ul>
<h2><a name="s5">5. DNS</a></h2>
<p>Vous pouvez configurer le DNS normalement. Vous pouvez consulter
le <a href=
"http://www.freenix.org/unix/linuxHOWTO/DNS-HOWTO.html">DNS
HOWTO</a>.</p>
<h2><a name="s6">6. Syslogd</a></h2>
<h2><a name="ss6.1">6.1 Problème</a></h2>
<p>Syslog est l'outil de <em>logging</em> couramment utilisé
sur les systèmes UNIX. C'est un démon qui ouvre un
fichier spécial appelé FIFO. Une FIFO est un fichier
spécial, se comportant comme une file d'attente. Tout ce qui
y est écrit "ressortira" en lecture. Le démon syslog
attend les données en lecture. Il existe des fonctions C
pour écrire dans les FIFO. Si vous utilisez ces fonctions C
dans vos programmes, la sortie ira vers syslod.</p>
<p>Souvenez vous que vous avez utilisé <code>chroot</code>
et que la FIFO que syslog lit <code>/dev/log</code> ne se trouve
pas dans l'environnement virtuel. Cela implique qu'aucun des
environnements virtuels ne pourra utiliser <code>syslog</code>.
Nous ne pouvons pas tout simplement copier le fichier, puisque les
programmes utiliseraient <code>/dev/log</code> au lieu du nouveau
que nous aurions créé.</p>
<h2><a name="ss6.2">6.2 Solution</a></h2>
<p>Syslog peut scruter d'autres FIFO si vous le lui dites en ligne
de commande. Lancez donc syslog avec l'argument :</p>
<pre>
syslog -p /virtual/log
</pre>
<p>Faites alors un lien de <code>/dev/log</code> vers
<code>/virtual/log</code> (un lien symbolique) :</p>
<pre>
ln -sf /virtual/log /dev/log
</pre>
<p>Puis liez toutes les copies de <code>/dev/log</code> vers ce
fichier avec la commande (attention, c'est un lien NON
symbolique) :</p>
<pre>
ln /virtual/log /virtual/domain.com/dev/log
</pre>
<p>Le script virtfs ci-dessus le fait pour vous. Puisque
<code>/virtual</code> est un disque entier, et que les
<code>/dev/log</code> sont liés, ils ont le même
numéro d'inode et pointent vers les mêmes
données. Le <code>chroot</code> ne peut pas empêcher
cela, et donc tous vos <code>/dev/log</code> virtuels vont à
présent fonctionner. Notez également que tous les
messages de toutes les machines virtuelles seront écrits
dans un même fichier. Cependant, vous pouvez écrire
des programmes pour filtrer les données.</p>
<h3>Syslogd.init</h3>
<p>Cette version du fichier <code>syslog.init</code> refait les
liens vers les <code>/dev/log</code> à chaque fois que vous
le lancez. Voici un <code>syslog.init</code>
modifié :</p>
<pre>
#!/bin/sh
# Source function library.
. /etc/rc.d/init.d/functions
case "$1" in
start)
echo -n "Starting dev log: "
ln -sf /virtual/log /dev/log
echo done
echo -n "Starting system loggers: "
daemon syslogd -p /virtual/log
daemon klogd
echo
echo -n "Starting virtual dev log: "
for i in /virtual/*
do
if [ ! -d "$i" ]
then
continue
fi
if [ "$i" = "/virtual/lost+found" ]
then
continue
fi
ln -f /virtual/log $i/dev/log
echo -n "."
done
echo " done"
touch /var/lock/subsys/syslog
;;
stop)
echo -n "Shutting down system loggers: "
killproc syslogd
killproc klogd
echo
rm -f /var/lock/subsys/syslog
;;
*)
echo "Usage: syslog {start|stop}"
exit 1
esac
exit 0
</pre>
<h2><a name="ss6.3">6.3 Plusieurs syslod</a></h2>
<h3>Un par disque</h3>
<p>Si vous manquez de place sur un système de fichiers, et
que vous devez séparer vos domaines virtuels en plusieurs
disques, rappellez-vous que les liens (non symboliques) ne peuvent
pas passer à travers plusieurs disques. Ce qui implique de
devoir lancer un syslogd pour chaque groupe de domaine par disque.
Par exemple, si vous avez 13 domaines sur /virtual1 et 15 sur
/virtual2, vous devrez faire un lien pour les 13 domaines sur
/virtual1/log et lancer syslogd avec <code>syslogd -p
/virtual1/log</code> , ainsi qu'un lien pour les 15 domaines sur
/virtual2/log et lancer <code>syslogd -p /virtual2/log</code> .</p>
<h3>Un par domaine</h3>
<p>Si vous ne voulez pas centrer les logs sur un seul endroit, vous
pouvez aussi lancer un syslogd par domaine. Cela donne des pertes
de processus ID, donc je ne le recommande pas, mais c'est facile
à mettre en oeuvre. Vous devriez modifier votre fichier
syslod.init pour lancer syslogd par <code>chroot
/virtual/domain1.com syslogd</code> pour chaque domaine. Ceci
lancera syslogd dans le <code>chroot</code> et les logs se
trouveront dans /virtual/domain1.com/var/log au lieu d'être
tous rassemblés dans /var/log. N'oubliez pas de lancer
syslod normalement <code>syslod</code> pour le système
principal ainsi qu'un logger pour le noyau <code>klogd</code> .</p>
<h2><a name="s7">7. FTP virtuel</a></h2>
<h2><a name="ss7.1">7.1 Inetd</a></h2>
<p>Wu-ftpd intégre en standard le support des domaines
virtuels. Cependant, vous ne pouvez pas utiliser des fichiers de
mot de passe différents pour chaque domaine. Par exemple, si
<code>bob@domaine1.com</code> et <code>bob@domaine2.com</code>
désirent tous les deux un compte, vous devrez donner
à l'un des deux le nom <code>bob2</code> ou demander
à un des utilisateurs de choisir un autre nom de login.
Puisque vous disposez à présent de systèmes de
fichiers différents pour chaque domaine, vous disposez de
fichiers de mot de passe différents et ce problème
disparaît. Vous n'avez qu'à créer un script
<code>virtnewuser</code> et <code>virtpasswd</code> de la
façon qui est expliquée ci-dessus, et tout
fonctionnera.</p>
<p>Les entrées pour wu-ftp dans <code>inetd.conf</code>
sont :</p>
<pre>
ftp stream tcp nowait root /usr/local/bin/virtuald \
virtuald /virtual/conf.ftp wu.ftpd -l -a
</pre>
<h2><a name="ss7.2">7.2 Les FTP anonymes</a></h2>
<p>Ils ne sont pas affectés par la presence de virtuald.
Pour un utilisateur anonyme, créer l'utilisateur FTP dans
/virtual/domain1.com/etc/passwd comme vous le feriez
d'habitude.</p>
<pre>
ftp:x:14:50:Anonymous FTP:/var/ftp:/bin/false
</pre>
<p>Puis l'installation du répertoire anonyme du FTP. Vous
avez des fichier de mot de passe séparés, donc vous
pouvez restreindre n'importe quel domaine à un FTP avec un
compte anonyme. Notez que comme le serveur à un
<code>chroot</code> dans le répertoire /virtual/domain1.com
vous n'avez pas a préfixer de chemins avec.</p>
<h2><a name="ss7.3">7.3 Utilisateurs de FTP Virtuel</a></h2>
<p>Wu-ftpd supporte quelque chose qui s'appelle un groupe
d'invité (guest group). Ça permet de créer
différentes zones FTP pour chaque utilisateur. Le serveur
FTP fait un <code>chroot</code> vers la zone specifiée,
donc, l'utilisateur ne peut sortir du répertoire. Si vous
créez un utilisateur dans un domaine virtuel, il ne sera pas
capable de voir le système de fichiers Système.</p>
<p>Ajouter le group guest au fichier
/virtual/domain1.com/etc/ftpaccess.</p>
<p>Créer une entrée dans
/virtual/domain1.com/etc/passwd avec <code>chroot</code> et le
répertoire home de départ séparé par
<code>/./</code> :</p>
<pre>
guest1:x:8500:51:Guest FTP:/home/g/guest1/./incoming:/bin/false
</pre>
<p>Puis installer le home du guest comme vous feriez pour un FTP
anonyme. Vous avez des fichiers de mots de passe separés
pour chaque domaine, donc vous pouvez spécifier quel domaine
dispose d'un compte guest et les utilisateurs qui sont des
utilisateurs guest dans un domaine. Notez que depuis que le serveur
FTP est <code>chrooté</code> vers le repertoire
/virtual/domain1.com vous n'avez pas à préfixer de
chemin.</p>
<h2><a name="s8">8. Web virtuel</a></h2>
<h2><a name="ss8.1">8.1 Lancement avec virtuald</a></h2>
<h3>Non recommandé</h3>
<p>Apache supporte en standard la gestion des domaines virtuels.
C'est d'ailleurs le seul programme pour lequel je recommande
d'utiliser le système de gestion des domaines virtuels
fourni avec. Lorsque vous lancez un programme par
l'intermédiaire d'inetd, il y a un coût
supplémentaire, puisque le programme doit démarrer
à chaque fois qu'il y a une demande de connexion, et vous
obtenez des temps de réponse beaucoup plus longs,
inacceptables pour le web. Apache intégre également
un mécanisme pour stopper les connexions lorsqu'elles sont
trop nombreuses.</p>
<p>Comme il est simplement indiqué ci-dessus, rendre virtuel
Apache avec virtuald est une tres mauvaise idée. Le but de
virtuald est de combler la lacune des serveurs qui n'ont pas leur
propre systeme interne pour faire ce travail. Virtuald n'est pas
fait pour remplacer du bon code qui remplit déjà la
tâche.</p>
<p>Ce qui suit ne restera pas ici, c'est pour expliquer à
ceux qui sont assez idiots pour le faire.</p>
<h3>Inetd</h3>
<p>Éditez /etc/inetd.conf</p>
<pre>
vi /etc/inetd.conf # Ajouter cette ligne
www stream tcp nowait www /usr/local/bin/virtuald \
virtuald /virtual/conf.www httpd -f /var/www/conf/httpd.conf
</pre>
<h3>Httpd.conf</h3>
<p>Éditez /var/www/conf/httpd.conf</p>
<pre>
vi /var/www/conf/httpd.conf # Où l'emplacement des fichiers de configuration d'Apache
Il doit y avoir :
ServerType standalone
Remplacez-le par :
ServerType inetd
</pre>
<h3>Configuration</h3>
<p>Ensuite, configurez chaque cas du serveur Apache comme si vous
n'aviez qu'un seul domaine.</p>
<h3>Httpd.init</h3>
<p>Un fichier httpd.init n'est pas nécéssaire si le
serveur est lancé par inetd.</p>
<h2><a name="ss8.2">8.2 Lancer Apache avec VirtualHost</a></h2>
<p>Apache a trois fichiers de configuration
<code>access.conf</code> , <code>httpd.conf</code> et
<code>srm.conf</code> . De nouvelles versions d'Apache ont rendues
les trois fichiers de configuration inutiles. Ainsi, je trouve que
séparer en trois sections la configuration la rend plus
simple à gérer, donc je garderai ce style dans le
HOWTO.</p>
<h3>Access.conf</h3>
<p>Ce fichier de configuration est utilisé pour
contrôler l'accès aux répertoires dans la
structure du répertoire web. Voici un exemple de fichier de
configuration qui montre comment avoir plusieurs options pour
chaque domaine.</p>
<pre>
# /var/www/conf/access.conf: Configuration des accès globaux
# Les options sont heritées du répertoire précedent
# Mettre les options par défaut pour le répertoire principal
<Directory />
AllowOverride None
Options Indexes
</Directory>
# Créer un répertoire protegé par mot de passe pour un domaine
<Directory /virtual/domain1.com/var/www/html/priv>
AuthUserFile /var/www/passwd/domain1.com-priv
AuthGroupFile /var/www/passwd/domain1.com-priv-g
AuthName PRIVSECTION
AuthType Basic
<Limit GET PUT POST>
require valid-user
</Limit>
</Directory>
# Créer un autre domaine Server Side Include (SSI)
<Directory /virtual/domain2.com/var/www/html>
Options IncludesNOEXEC
</Directory>
</pre>
<h3>Httpd.conf</h3>
<p>Ce fichier de configuration est utilisé pour
contrôler les options principales du serveur Apache. Voici un
exemple de fichier de configuration qui montre comment avoir
différentes options pour chaque domaine.</p>
<pre>
# /var/www/conf/httpd.conf: Fichier de configuration principal du serveur
# Début: Section principale
ServerType standalone
# Numéro du port
Port 80
# Log des clients avec le nom et l'IP
HostnameLookups on
# Utilisateur qui lance le serveur
User www
Group www
# Emplacement des fichiers de config, erreurs et log
ServerRoot /var/www
# Processus ID du serveur dans ce fichier
PidFile /var/run/httpd.pid
# Informations du processus interne du serveur
ScoreBoardFile /var/www/logs/apache_status
# Les options du Timeout et KeepAlive
Timeout 400
KeepAlive 5
KeepAliveTimeout 15
# Nombre de Serveur à lancer
MinSpareServers 5
MaxSpareServers 10
StarsServers 5
MaxClients 150
MaxRequestsPerChild 30
# Fin: Section de configuration principale
# Début: Section de l'hébergement virtuel
# Indique au serveur d'accepter les connexions pour IP:Port
# Il y a une ligne pour chaque IP nécessaire donc, vous pouvez ignorer certains
# domaines
Listen 10.10.10.129:80
Listen 10.10.10.130:80
# La commande VirtualHost permet de spécifier un autre domaine virtuel sur le
# serveur. La plupart des options d'Apache peuvent être spécifiées dans cette
# section.
<VirtualHost www.domain1.com>
# E-mail à laquelle sont envoyées les erreurs
ServerAdmin webmaster@domain1.com
# Endroit où sont mis les documents du domaine virtuel
DocumentRoot /virtual/domain1.com/var/www/html
# Nom du serveur
ServerName www.domain1.com
# Fichiers de Log relatifs à l'option ServerRoot
ErrorLog logs/domain1.com-error_log
TransferLog logs/domain1.com-access_log
RefererLog logs/domain1.com-referer_log
AgentLog logs/domain1.com-agent_log
# Utiliser les scripts CGI dans ce domaine
ScriptAlias /cgi-bin/ /var/www/cgi-bin/domain1.com/
AddHandler cgi-script .cgi
AddHandler cgi-script .pl
</VirtualHost>
<VirtualHost www.domain2.com>
# E-mail à laquelle sont envoyées les erreurs
ServerAdmin webmaster@domain2.com
# Endroit où sont mis les documents du domaine virtuel
DocumentRoot /virtual/domain2.com/var/www/html
# Nom du Serveur
ServerName www.domain2.com
# Fichiers de Log relatifs à l'option ServerRoot
ErrorLog logs/domain2.com-error_log
TransferLog logs/domain2.com-access_log
RefererLog logs/domain2.com-referer_log
AgentLog logs/domain2.com-agent_log
# Pas de script CGI pour ce domaine
</VirtualHost>
# Fin: Section de l'hebergement virtuel
</pre>
<h3>Srm.conf</h3>
<p>Ce fichier de configuration est utilisé pour
contrôler comment sont servies les demandes et comment sont
formattés les résultats. Vous n'avez pas besoin
d'éditer quoi que ce soit ici pour les domaines virtuels. Le
fichier de configuration de base d'Apache doit fonctionner.</p>
<h3>Httpd.init</h3>
<p>Rien de spécial n'est à faire dans ce fichier.
Utilisez la version de base qui est fournie avec Apache.</p>
<h2><a name="ss8.3">8.3 Descripteurs de fichiers : limite de
capacité</a></h2>
<h3>Attention</h3>
<p>Cela s'applique seulement à la version standalone du
serveur Apache. Un serveur qui se lance au travers d'inetd
n'intervient pas avec les autres domaines et à accès
à toute la table des descripteurs de fichiers.</p>
<p>Chaque fichier de log qu'ouvre Apache est un autre descripteur
de fichier pour le processus. Il y a une limite de 256 descripteurs
de fichier par processus au coeur du systeme Linux. Depuis que vous
avez plusieurs domaines, vous utilisez plus de descripteurs de
fichiers. Si vous avez trop de domaines tournant sur un processus
du serveur Apache, vous pouvez engorger cette table. Cela peut
impliquer que certains logs ne fonctionneront pas et que certains
CGI seront interrompus.</p>
<h3>Plusieurs serveur Apache</h3>
<p>Si vous prévoyez cinq descripteurs de fichiers par
domaine, vous pouvez avoir 50 domaines tournant sur votre serveur
Apache sans problèmes. Mais, si votre serveur a des
problèmes, vous pouvez créer /var/www1 avec un
serveur Apache qui s'occupe des domaines 1 à 25 et /var/www2
avec un autre serveur qui s'occupe des domaines 26 à 50.
Ainsi, chaque serveur aura son propre fichier de configuration,
d'erreurs et de log. Chaque serveur doit être
configuré separement avec ses propres directives de Listen
et VirtualHost. Et n'oubliez pas de lancer plusieurs serveurs dans
votre fichier httpd.ini.</p>
<h2><a name="ss8.4">8.4 Héberger plusieurs serveurs avec une
IP</a></h2>
<h3>Économiser des IP</h3>
<p>La version 1.1 du protocole HTTP (HyperText Transfer Protocol)
inclue une fonction qui communique le nom du serveur au client. Ce
qui implique que le client n'a pas besoin de rechercher le nom du
serveur à partir de son adresse IP. Comme ça, deux
serveurs virtuels peuvent avoir la même adresse IP et
être deux site Web différents. La configuration
d'Apache est la même qu'avant, à part que vous n'avez
pas besoin de mettre plusieurs directives Listen comme les deux
domaines ont la même IP.</p>
<h3>Inconvénient</h3>
<p>Le seul problème est que virtuald utilise les adresses IP
pour distinguer les domaines. Dans sa forme actuelle Virtuald ne
serait pas capable de <code>chroot</code> vers un répertoire
de mail (spool) pour chaque domaine. Donc, les mails ne peuvent
etre reçus que sur une IP et il n'y aurait plus un
répertoire spool pour chaque domaine. Tous les clients d'un
serveur web partageant une IP devront se partager le meme
repertoire spool. Ce qui signifierait que dupliquer les noms
d'utilisateurs serait encore une solution. Enfin, c'est le prix
à payer pour économiser une IP.</p>
<h2><a name="ss8.5">8.5 Plus d'informations</a></h2>
<p>Ce HOWTO montre seulement comment implémenter le support
virtuel sur le serveur Web Apache. La plupart des serveur Web
utilisent une interface similaire. Pour plus d'informations sur
l'hébergement de web virtuel, consultez le <a href=
"http://www.freenix.org/unix/l%20inux/HOWTO/WWW-HOWTO.html">WWW-HOWTO</a>,
la documentation d'Apache sur le <a href=
"http://www.apache.org">Site d'Apache</a>, ou la documentation sur
<a href="http://www.apacheweek.com">ApacheWeek</a>.</p>
<h2><a name="s9">9. Mail virtuel avec Pop</a></h2>
<h2><a name="ss9.1">9.1 Problème</a></h2>
<p>Le support du mail virtuel est une demande toujours
grandissante. Sendmail affirme qu'il supporte le mail virtuel. En
fait, il se contente d'être à l'écoute de mail
pour différents domaines. Vous pouvez alors demander
à faire suivre le mail quelque part. Cependant, si vous le
faites suivre sur la machine locale et que vous avez du mail pour
bob@domaine1.com et bob@domaine2.com, ils vont atteindre la
même boîte. C'est un problème puisque les bob
sont deux personnes différentes, avec du courrier
électronique différent.</p>
<h2><a name="ss9.2">9.2 Solution</a></h2>
<p>Vous pouvez vous assurer que chaque nom d'utilisateur est unique
en utilisant une numérotation des noms d'utilisateurs :
bob1, bob2, etc... Vous pourriez également hacker le mail et
le pop pour que ces conversions soient invisibles, mais cela peut
devenir désordonné. Le mail sortant à pour
domaine domaineprincipal.com et vous désirez que chaque mail
envoyé dans chaque sous-domaine ait une adresse From:
différente.</p>
<p>J'ai deux solutions. L'une fonctionne avec sendmail et l'autre
avec Qmail. La solution avec sendmail devrait fonctionner avec une
installation standard de sendmail. Cependant elle partage toutes
les limitations établies dans sendmail. Il est
nécessaire aussi qu'un sendmail ait été
lancé en mode de file d'attente (queue mode) pour chaque
domaine. Avoir 50 ou plus processus sendmail en mode de file
d'attente qui se réveillent toutes les heures peut ajouter
des contraintes sur une machine.</p>
<p>La solution pour Qmail ne requiert pas plusieurs exemplaires de
Qmail et peut n'utiliser qu'un seul répertoire de file
d'attente. Il a besoin d'un autre programme puisque que Qmail ne se
fonde pas sur virtuald. Je crois qu'une procédure similaire
peut être faite avec Sendmail. Cependant, Qmail se
prête plus aisément à cette solution.</p>
<p>Je ne cautionne aucun des deux programmes en particulier.
L'installation de Sendmail est un peu moins complexe mais Qmail est
pobablement le plus puissant des deux paquetages de serveur
Mail.</p>
<h2><a name="ss9.3">9.3 Solution pour Sendmail</a></h2>
<h3>Introduction</h3>
<p>Chaque système de fichiers virtuel fournit à
chaque domaine un fichier <code>/etc/passwd</code>. Cela signifie
que bob@domaine1.com et bob@domaine2.com sont des utilisateurs
différents dans des fichiers <code>/etc/passwd</code>
différents, donc le mail ne constituera aucun
problème. Ils possèdent également chacun un
spool de mail, donc les boîtes aux lettres seront des
fichiers différents sur des système de fichiers
virtuels différents.</p>
<h3>Créer un fichier de configuration Sendmail</h3>
<p>Créez <code>/etc/sendmail.cf</code> comme vous le feriez
d'habitude avec m4 :</p>
<pre>
divert(0)
VERSIONID(`tcpproto.mc')
OSTYPE(linux)
FEATURE(redirect)
FEATURE(always_add_domain)
FEATURE(use_cw_file)
FEATURE(local_procmail)
MAILER(local)
MAILER(smtp)
</pre>
<h3>Édition du fichier de configuration</h3>
<p>Éditez /virtual/domain1.com/etc/sendmail.cf pour
l'adapter à votre domaine virtuel :</p>
<pre>
vi /virtual/domain1.com/etc/sendmail.cf
</pre>
Approximativement à la ligne 86 il doit y avoir :
<pre>
#Dj$w.Foo.COM
</pre>
Remplacez-le avec :
<pre>
Djdomain1.com
</pre>
<h3>Distribution locale par Sendmail</h3>
<p>Éditez /virtual/domain1.com/etc/sendmail.cw</p>
<pre>
vi /virtual/domain1.com/etc/sendmail.cw
mail.domain1.com
domain1.com
domain1
localhost
</pre>
<h3>Sendmail et les domaines virtuels : la bidouille
(pre8.8.6)</h3>
<p>Cependant, sendmail nécessite un changement mineur de son
code source. Sendmail utilise un fichier nommé
<code>/etc/sendmail.cw</code> qui contient tous les noms de machine
pour lequel il distribuera le mail localement au lieu de le faire
suivre à une autre machine. Sendmail fait une
vérification interne de toutes les interfaces réseau
de la machine pour initialiser cette liste avec les adresses IP
locales. Cela présente un problème si vous envoyez
des mails entre deux domaines virtuels de la même machine.
Sendmail pensera que l'autre domaine virtuel est une adresse locale
et il distribuera le mail localement. Par exemple, bob@domaine1.com
envoie un mail à fred@domaine2.com. Puisque le sendmail de
domaine1.com pense que domaine2.com est une adresse locale, il va
envoyer ce mail à domaine1.com et ne l'enverra jamais
à domaine2.com. Vous avez à modifier sendmail (ce que
j'ai fait sans problème sur la version 8.8.6) :</p>
<pre>
vi v8.8.5/src/main.c
</pre>
Vers la ligne 494 vous devriez remplacer la ligne :
<pre>
load_if_names();
</pre>
Par :
<pre>
/* load_if_names(); Commenté puisque cela casse les domaines virtuels */
</pre>
<p>Notez que cette modification n'est nécessaire que si vous
désirez envoyer du mail entre des domaines virtuels, ce qui
est probable, je pense.</p>
<p>Cela corrigera le problème. Cependant, l'adaptateur
réseau principal eth0 n'est pas supprimé. Ainsi, si
vous envoyez un mail depuis une adresse IP virtuelle vers une
adresse sur eth0 de la même machine, il sera
délivré localement. Pour cela, j'utilise une adresse
IP bidon virtuel1.domaine.com (10.10.10.157). Je n'envoie jamais de
mail à cet hôte, les domaines virtuels non plus. C'est
aussi l'adresse IP que j'utiliserai pour me connecter sur la
machine via ssh, pour vérifier si le système
fonctionne.</p>
<h3>Sendmail et les domaines virtuels : Nouvelle fonction
(POST8.8.6)</h3>
<p>Depuis la version 8.8.6 de Sendmail, il existe une option qui
désactive le chargement des interfaces réseaux
supplémentaires. Ce qui implique la NON
nécéssité de toucher au code source. Elle
s'appelle <code>DontProbeInterfaces</code> .</p>
<p>Editer /virtual/domain1.com/etc/sendmail.cf</p>
<pre>
vi /virtual/domain1.com/etc/sendmail.cf
</pre>
Ajouter la ligne :
<pre>
O DontProbeInterfaces=True
</pre>
<h3>Sendmail.init</h3>
<p>Sendmail ne peut pas être lancé tel quel, vous
allez devoir le lancer à travers inetd. C'est un moyen
inefficace qui implique un temps de réponse plus long, mais
si vous avez un site tellement occupé pour que la
différence soit importante, alors vous devriez utiliser une
machine dédiée à ce site. Notez que vous ne de
devez PAS utiliser l'option <code>-bd</code>. Notez
également que vous devez lancer <code>sendmail -q</code>
pour chaque domaine que vous gérez. Le nouveau fichier
<code>sendmail.init</code> est le suivant :</p>
<pre>
#!/bin/sh
# Source function library.
. /etc/rc.d/init.d/functions
case "$1" in
start)
echo -n "Starting sendmail: "
daemon sendmail -q1h
echo
echo -n "Starting virtual sendmail: "
for i in /virtual/*
do
if [ ! -d "$i" ]
then
continue
fi
if [ "$i" = "/virtual/lost+found" ]
then
continue
fi
chroot $i sendmail -q1h
echo -n "."
done
echo " done"
touch /var/lock/subsys/sendmail
;;
stop)
echo -n "Stopping sendmail: "
killproc sendmail
echo
rm -f /var/lock/subsys/sendmail
;;
*)
echo "Usage: sendmail {start|stop}"
exit 1
esac
exit 0
</pre>
<h3>Configuration d'inetd</h3>
<p>Pop devrait s'installer normalement, sans effort
supplémentaire. Vous n'avez qu'à modifier
l'entrée pour pop dans le fichier <code>inetd.conf</code>
pour utiliser le démon virtuald. Pour sendmail et pop, cela
donne :</p>
<pre>
pop-3 stream tcp nowait root /usr/bin/virtuald \
virtuald /virtual/conf.pop in.qpop -s
smtp stream tcp nowait root /usr/bin/virtuald \
virtuald /virtual/conf.mail sendmail -bs
</pre>
<h2><a name="ss9.4">9.4 Solution pour Qmail</a></h2>
<h3>Introduction</h3>
<p>Cette solution prend la responsabilité de distribution du
qmail-local, donc l'utilisation des fichiers .qmail dans les
répertoire home des domaines virtuels ne marcheront pas.
Cependant, chaque domaine aura toujours un utilisateur maître
par domaine qui contrôlera les aliasing du domaine. Deux
programmes externes seront utilisés pour le fichier
<code>.qmail-default</code> des maîtres de domaine. Le mail
passera par ces deux programmes afin de distribuer le courrier
à chaque domaine.</p>
<p>Deux programmes sont necéssaires, car l'un deux est
lancé avec le setuid root. C'est un petit programme qui se
change en un utilisateur non administrateur et lance le second
programme. Consultez le site le plus proche relatif à la
sécurité pour une discussion sur le pourquoi est-ce
nécessaire.</p>
<p>Cette solution se passe de virtuald. Qmail est assez flexible
pour ne pas avoir besoin d'une configuration virtuald
génerale. La conception de Qmail utilise
l'enchaînement de programmes pour distribuer les mails. Cette
conception facilite l'insertion d'une section virtuelle dans le
processus de distribution de Qmail sans altérer une
installation standard de Qmail.</p>
<p>Depuis que vous utilisez Qmail, tout nom de domaine non
qualifié sera développé en utilisant le
serveur principal. C'est dû au fait que vous n'avez pas un
Qmail pour chaque domaine. Donc, soyez sûr que vos clients
(Eudora, elm, mutt, etc.) puissent developper tous vos noms de
domaines non qualifiés.</p>
<h3>Installation des domaines virtuels</h3>
<p>Qmail doit être configuré de manière
à accepter les mails pour chaque domaine que vous
désservez. Tapez la commande suivante :</p>
<pre>
echo "domain1.com:domain1" >> /var/qmail/control/virtualdomains
</pre>
<h3>Installation de l'utilisateur maître du domaine</h3>
<p>Ajouter à votre fichier <code>/etc/passwd</code>
principal l'utilisateur domain1. Je choisirais le shell /bin/false
pour que le maître du domaine ne puisse se connecter. Cet
utilisateur sera capable d'ajouter des fichier .qmail et tous les
mails passeront par ce compte. Notez que les noms d'utilisateurs ne
peuvent faire que 8 caractères et les noms de domaines
peuvent être plus long. Les caractères restants seront
ignorés. Ce qui implique, que les utilisateurs domain12 et
domain123 seraient le même utilisateur et Qmail pourra
être perturbé. Donc, attention à votre
convention pour nommer les utilisateurs maîtres des
domaines.</p>
<p>Créer les fichiers .qmail du maître de domaine avec
les commandes suivantes. Ajoutez les autres alias système au
même endroit. Par exemple, webmaster ou hostmaster.</p>
<pre>
echo "user@domain1.com" > /home/d/domain1/.qmail-mail-daemon
echo "user@domain1.com" > /home/d/domain1/.qmail-postmaster
echo "user@domain1.com" > /home/d/domain1/.qmail-root
</pre>
<p>Créez le fichier .qmail-default du maître de
domaine. Il filtre tous les mails du domaine virtuel.</p>
<pre>
echo "| /usr/local/bin/virtmailfilter" > /home/d/domain1/.qmail-default
</pre>
<h3>Tcpserver</h3>
<p>Qmail a besoin d'un pop spécial qui supporte le format
maildir. Le programme pop doit être rendu virtuel. L'auteur
de Qmail recommande d'utiliser <code>tcpserver</code> (un
remplacement à inetd) avec Qmail, donc mes exemples
utilisent tcpserver et NON inetd.</p>
<p>Tcpserver n'a pas besoin de fichier de configuration. Toutes les
informations peuvent etre passées par une ligne de commande.
Ci-dessous, se trouve le fichier tcpserver.ini que vous devez
utiliser pour le démon mail et le serveur pop :</p>
<pre>
#!/bin/sh
. /etc/rc.d/init.d/functions
QMAILDUSER=`grep qmaild /etc/passwd | cut -d: -f3`
QMAILDGROUP=`grep qmaild /etc/passwd | cut -d: -f4`
# Regarder comment nous étions appellés.
case "$1" in
start)
echo -n "Starting tcpserver: "
tcpserver -u 0 -g 0 0 pop-3 /usr/local/bin/virtuald \
/virtual/conf.pop qmail-popup virt.domain1.com \
/bin/checkpassword /bin/qmail-pop3d Maildir &
echo -n "pop "
tcpserver -u $QMAILDUSER -g $QMAILDGROUP 0 smtp \
/var/qmail/bin/qmail-smtpd &
echo -n "qmail "
echo
touch /var/lock/subsys/tcpserver
;;
stop)
echo -n "Stopping tcpserver: "
killall -TERM tcpserver
echo -n "killing "
echo
rm -f /var/lock/subsys/tcpserver
;;
*)
echo "Usage: tcpserver {start|stop}"
exit 1
esac
exit 0
</pre>
<h3>Qmail.init</h3>
<p>Vous pouvez utiliser le script standard de Qmail.init fourni.
Qmail est livré avec une très bonne documentation
décrivant comment le mettre en place.</p>
<h3>Source</h3>
<p>Vous avez besoin de deux autres programmes pour que votre
serveur mail virtuel fonctionne avec Qmail. Ce sont virtmailfilter
et virtmaildelivery. Ceci est le code source en C de
virtmailfilter. Il doit être installé dans
/usr/local/bin avec les permissions 4750, l'utilisateur root et le
groupe nofiles.</p>
<pre>
#include <sys/wait.h>
#include <unistd.h>
#include <string.h>
#include <stdlib.h>
#include <stdio.h>
#include <ctype.h>
#include <pwd.h>
#define VIRTPRE "/virtual"
#define VIRTPWFILE "etc/passwd"
#define VIRTDELIVERY "/usr/local/bin/virtmaildelivery"
#define VIRTDELIVERY0 "virtmaildelivery"
#define PERM 100
#define TEMP 111
#define BUFSIZE 8192
int main(int argc,char **argv)
{
char *username,*usernameptr,*domain,*domainptr,*homedir;
char virtpath[BUFSIZE];
struct passwd *p;
FILE *fppw;
int status;
gid_t gid;
pid_t pid;
if (!(username=getenv("EXT")))
{
fprintf(stdout,"environment variable EXT not set\n");
exit(TEMP);
}
for(usernameptr=username;*usernameptr;usernameptr++)
{
*usernameptr=tolower(*usernameptr);
}
if (!(domain=getenv("HOST")))
{
fprintf(stdout,"environment variable HOST not set\n");
exit(TEMP);
}
for(domainptr=domain;*domainptr;domainptr++)
{
if (*domainptr=='.' && *(domainptr+1)=='.')
{
fprintf(stdout,"environment variable HOST has ..\n");
exit(TEMP);
}
if (*domainptr=='/')
{
fprintf(stdout,"environment variable HOST has /\n");
exit(TEMP);
}
*domainptr=tolower(*domainptr);
}
for(domainptr=domain;;)
{
snprintf(virtpath,BUFSIZE,"%s/%s",VIRTPRE,domainptr);
if (chdir(virtpath)>=0)
break;
if (!(domainptr=strchr(domainptr,'.')))
{
fprintf(stdout,"domain failed: %s\n",domain);
exit(TEMP);
}
domainptr++;
}
if (!(fppw=fopen(VIRTPWFILE,"r+")))
{
fprintf(stdout,"fopen failed: %s\n",VIRTPWFILE);
exit(TEMP);
}
while((p=fgetpwent(fppw))!=NULL)
{
if (!strcmp(p->pw_name,username))
break;
}
if (!p)
{
fprintf(stdout,"user %s: not exist\n",username);
exit(PERM);
}
if (fclose(fppw)==EOF)
{
fprintf(stdout,"fclose failed\n");
exit(TEMP);
}
gid=p->pw_gid;
homedir=p->pw_dir;
if (setgid(gid)<0 || setuid(p->pw_uid)<0)
{
fprintf(stdout,"setuid/setgid failed\n");
exit(TEMP);
}
switch(pid=fork())
{
case -1:
fprintf(stdout,"fork failed\n");
exit(TEMP);
case 0:
if (execl(VIRTDELIVERY,VIRTDELIVERY0,username,homedir,NU {
fprintf(stdout,"execl failed\n");
exit(TEMP);
}
default:
if (wait(&status)<0)
{
fprintf(stdout,"wait failed\n");
exit(TEMP);
}
if (!WIFEXITED(status))
{
fprintf(stdout,"child did not exit normally\n"); }
break;
}
exit(WEXITSTATUS(status));
}
</pre>
<h3>Source</h3>
<p>Ceci est le code source de virtmaildelivery. Il doit etre
installé dans /usr/local/bin avec les permissions 0755,
l'utilisateur root et le groupe root.</p>
<pre>
#include <sys/stat.h>
#include <sys/file.h>
#include <stdlib.h>
#include <string.h>
#include <unistd.h>
#include <stdio.h>
#include <errno.h>
#include <time.h>
#define TEMP 111
#define BUFSIZE 8192
#define ATTEMPTS 10
int main(int argc,char **argv)
{
char *user,*homedir,*dtline,*rpline,buffer[BUFSIZE],*p,mail[BUFSIZE];
char maildir[BUFSIZE],newmaildir[BUFSIZE],host[BUFSIZE];
int fd,n,nl,i,retval;
struct stat statp;
time_t thetime;
pid_t pid;
FILE *fp;
retval=0;
if (!argv[1])
{
fprintf(stdout,"invalid arguments: need username\n");
exit(TEMP);
}
user=argv[1];
if (!argv[2])
{
fprintf(stdout,"invalid arguments: need home directory\n");
exit(TEMP);
}
homedir=argv[2];
if (!(dtline=getenv("DTLINE")))
{
fprintf(stdout,"environment variable DTLINE not set\n");
exit(TEMP);
}
if (!(rpline=getenv("RPLINE")))
{
fprintf(stdout,"environment variable RPLINE not set\n");
exit(TEMP);
}
while (*homedir=='/')
homedir++;
snprintf(maildir,BUFSIZE,"%s/Maildir",homedir);
if (chdir(maildir)<0)
{
fprintf(stdout,"chdir failed: %s\n",maildir);
exit(TEMP);
}
time(&thetime);
pid=getpid();
if (gethostname(host,BUFSIZE)<0)
{
fprintf(stdout,"gethostname failed\n");
exit(TEMP);
}
for(i=0;i<ATTEMPTS;i++)
{
snprintf(mail,BUFSIZE,"tmp/%u.%d.%s",thetime,pid,host);
errno=0;
stat(mail,&statp);
if (errno==ENOENT)
break;
sleep(2);
time(&thetime);
}
if (i>=ATTEMPTS)
{
fprintf(stdout,"could not create %s\n",mail);
exit(TEMP);
}
if (!(fp=fopen(mail,"w+")))
{
fprintf(stdout,"fopen failed: %s\n",mail);
retval=TEMP; goto unlinkit;
}
fd=fileno(fp);
if (fprintf(fp,"%s",rpline)<0)
{
fprintf(stdout,"fprintf failed\n");
retval=TEMP; goto unlinkit;
}
if (fprintf(fp,"%s",dtline)<0)
{
fprintf(stdout,"fprintf failed\n");
retval=TEMP; goto unlinkit;
}
while(fgets(buffer,BUFSIZE,stdin))
{
for(p=buffer;*p=='>';p++)
;
if (!strncmp(p,"From ",5))
{
if (fputc('>',fp)<0)
{
fprintf(stdout,"fputc failed\n");
retval=TEMP; goto unlinkit;
}
}
if (fprintf(fp,"%s",buffer)<0)
{
fprintf(stdout,"fprintf failed\n");
retval=TEMP; goto unlinkit;
}
}
p=buffer+strlen(buffer);
nl=2;
if (*p=='\n')
nl=1;
for(n=0;n<nl;n++)
{
if (fputc('\n',fp)<0)
{
fprintf(stdout,"fputc failed\n");
retval=TEMP; goto unlinkit;
}
}
if (fsync(fd)<0)
{
fprintf(stdout,"fsync failed\n");
retval=TEMP; goto unlinkit;
}
if (fclose(fp)==EOF)
{
fprintf(stdout,"fclose failed\n");
retval=TEMP; goto unlinkit;
}
snprintf(newmaildir,BUFSIZE,"new/%u.%d.%s",thetime,pid,host);
if (link(mail,newmaildir)<0)
{
fprintf(stdout,"link failed: %s %s\n",mail,newmaildir);
retval=TEMP; goto unlinkit;
}
unlinkit:
if (unlink(mail)<0)
{
fprintf(stdout,"unlink failed: %s\n",mail);
retval=TEMP;
}
exit(retval);
}
</pre>
<h2><a name="ss9.5">9.5 Remerciements</a></h2>
<p>Merci à <a href="mailto:vince@nycrc.net">Vicente Gonzalez
(vince@nycrc.net)</a> pour son aide qui a rendu possible la
solution pour Qmail. Vous pouvez certainement écrire a
Vince, pour le remercier, ainsi que lui poser vos questions et
commentaires a propos de Qmail, le reste concernant ce HOWTO devant
m'être adressé.</p>
<h2><a name="s10">10. Samba Virtuel</a></h2>
<h2><a name="ss10.1">10.1 Mise en place</a></h2>
<p>L'installation de Samba Virtuel est très simple. Soyez
sûr que les fichiers suivants soit installés
correctement :</p>
<ul>
<li>/virtual/domain1.com/etc/smb.conf FICHIER</li>
<li>/virtual/domain1.com/var/lock/samba REPERTOIRE</li>
<li>/virtual/domain1.com/var/log/ REPERTOIRE</li>
<li>/usr/local/bin/virtsmbstatus SYMLINK
/usr/local/bin/virtexec</li>
</ul>
<h2><a name="ss10.2">10.2 Inetd</a></h2>
<p>Éditez /etc/inetd.conf</p>
<pre>
vi /etc/inetd.conf
</pre>
Ajoutez cette ligne :
<pre>
netbios-ssn stream tcp nowait root /usr/local/bin/virtuald \
virtuald /virtual/conf.smbd smbd
</pre>
<h2><a name="ss10.3">10.3 Smb.init</a></h2>
<p>Un fichier smb.init n'est pas nécessaire tant que le
serveur est lancé via inetd.</p>
<h2><a name="s11">11. Le reste</a></h2>
<p>Tout autre service devrait suivre une procédure
similaire :</p>
<ul>
<li>Lancer virtfs pour ajouter le binaire et les librairies au
système de fichiers virtuel ;</li>
<li>L'ajouter dans <code>/etc/inetd.conf</code> ;</li>
<li>Créer un fichier
<code>/virtual/conf.service</code> ;</li>
<li>Créer tout script virtuel manquant.</li>
</ul>
<h2><a name="s12">12. Conclusion</a></h2>
<p>Voici tout ce dont vous avez besoin. J'espère que cet
article répond à vos attentes. Vous pouvez utiliser
l'email à <a href="mailto:brian@nycrc.net">Computer Resource
Center</a> pour tout commentaire (NdT : en anglais bien
sûr). Si vous avez une question, ou si vous me proposez une
mise à jour, faites-le moi savoir et je l'ajouterai.</p>
<p>Ce document a rencontré un grand intêret. Je
remercie toutes les personnes qui m'ont envoyé des questions
et qui m'ont aidé à former ce document pour obtenir
l'intérêt des utilisateurs. Avant de me poser des
questions, je vous recommande de lire la FAQ pour voir si cela n'a
pas déjà été demandé. Merci
encore. <a href="mailto:brian@nycrc.net">Brian</a></p>
<h2><a name="s13">13. FAQ</a></h2>
<p><b>Q1</b>. J'ai créé un sendmail.init et
syslogd.init. Je les ai mis dans /usr/local/bin et essayé de
les lancer, mais ils me donnent des erreurs.</p>
<p><b>R1</b>. Ces fichiers sont appellés scripts
d'initialisation. Ils sont lancés par le programme init
quand votre ordinateur démarre. Ils ne vont pas avec les
binaires de /usr/local. Consultez le Guide de l'Administrateur
Système Linux (Linux System Administrators Guide) ou le
Guide pour Bien Démarrer avec Linux (Linux Getting Started
Guide) pour des informations sur la manière d'utiliser les
scripts d'initialisation du système.</p>
<p><b>Q2</b>. J'ai mis ces lignes dans /etc/sendmail.cf :</p>
<pre>
divert(0)
VERSIONID(`tcpproto.mc')
OSTYPE(linux)
FEATURE(redirect)
FEATURE(always_add_domain)
FEATURE(use_cw_file)
FEATURE(local_procmail)
MAILER(local)
MAILER(smtp)
</pre>
<p>Et j'obtiens une sortie vraiment étrange.
Pourquoi ?</p>
<p><b>R2</b>. Vous ne devez pas mettre ces lignes directement dans
/etc/sendmail.cf. Le fichier sendmail.cf a été
écrit pour que sendmail le comprenne facilement et est
difficile à lire aux humains. Ainsi, pour le rendre facile
à configurer, nous utilisons un programme appellé
<code>m4</code> et ses capacités de macros pour créer
le fichier <code>sendmailf.cf</code> . Les lignes FEATURE sont en
fait des macros qui se développent par rapport à la
configuration de Sendmail. Lisez la documentation de sendmail pour
savoir comment configurer sendmail avec cette méthode.
Aussi, notez que vous créez un fichier /etc/sendmail.cf
principal et le script virtfs le copie sur
/virtual/domain1.com/etc/sendmail.cf. Puis, vous éditez ce
sendmail.cf pour l'adapter à votre domaine.</p>
<p><b>Q3</b>. Ou puis-je trouver virtuald, qu'est-ce donc et
comment l'utiliser ?</p>
<p><b>R3</b>. Virtuald est un programme en C que j'ai écrit
pour lancer un service virtuel. Il est inclus dans ce HOWTO. Vous
le compilez comme un programme C normal : <code>make
virtuald</code> . Le binaire résultant est placé dans
/usr/local/bin. Ajoutez les lignes nécessaires à
/etc/inetd.conf pour utiliser virtuald comme une facade vers un
programme serveur.</p>
<p><b>Q4</b>. Dialog n'est pas installé sur mon
système ?</p>
<p><b>R4</b>. Dialog est un programme qui permet d'avoir des
fenêtres dans vos scripts shell. Il est
nécéssaire pour faire fonctionner mon script shell
virtuel. Vous pouvez trouver une copie de dialog sur <a href=
"ftp://metalab.unc.edu/pub/Linux/utils/shell/cdialog-0.9a.tar.gz">metalab</a>.
Il ne devrait pas y avoir de problèmes pour le compiler et
l'installer.</p>
<p><b>Q5</b>. Comment puis-je savoir si le syslogd virtuel
marche ?</p>
<p><b>R5</b>. Quand virtuald est lancé, il doit envoyer le
message suivant à syslogd (/var/log/messages) :</p>
<pre>
Nov 19 17:21:07 virtual virtuald[10223]: Virtuald Starting: $Revision: 1.49 $
Nov 19 17:21:07 virtual virtuald[10223]: Incoming ip: 204.249.11.136
Nov 19 17:21:07 virtual virtuald[10223]: Chroot dir: /virtual/domain1.com
</pre>
<p>Le message du <code>chroot</code> est envoyé par virtuald
une fois l'appel système <code>chroot</code>
effectué. Si ce message apparaît, alors le syslogd
virtuel fonctionne. Si le service que vous rendez virtuel logue les
messages par syslogd et que vous les voyez, c'est aussi un signe
que le syslod virtuel fonctionne correctement.</p>
<p>Noter que si vous n'avez pas mis l'option VERBOSELOG lors de la
compilation, Virtuald ne loguera pas du tout. Le seul moyen de
savoir si le syslogd virtuel marche dans ce cas là, c'est de
voir si un démon qui rend un service virtuel
indépendamment, logue quelque chose avec syslogd.</p>
<p><b>Q6</b>. Comment puis-je installer des quotas à travers
un système de fichiers virtuel ?</p>
<p><b>R6</b>. Vous l'installez comme vous le feriez d'habitude.
Aller voir le <a href=
"http://www.freenix.org/unix/linux/HOWTO/mini/Quota.html">Quota
mini-HOWTO</a>. Cependant, vous devez être sûr qu'il
n'y ait pas de conflits d'uid entre les domaines. S'il y'a des
conflits, les utilisateurs devront partager un quota.
Préparez un intervalle d'uid qui auront le quota
activé et dites aux domaines qu'ils ne peuvent avoir
d'utilisateurs dans cet intervalle, à part ceux qui sont
retenus pour avoir un quota.</p>
<p><b>Q7</b>. Que fait cette notation "\" dans toutes les
entrées du inetd.conf ?</p>
<p><b>R7</b>. C'est juste une méthode pour couper une ligne
d'un fichier de configuration en deux lignes. J'ai fait ça
pour que les lignes puissent avoir un retour à la ligne de
manière à obtenir une meilleure présentation.
Vous pouvez ingorer le "\" et les rejoindre en une seule.</p>
<p><b>Q8</b>. Quand je lance <code>passwd</code> ou n'importe quel
programme concernant les logins, le système me renvoie
<code>permission denied</code> . Quand je lance FTP ou
<code>su</code> le système me renvoié <code>no
modules loaded for service XXX</code> . Pourquoi ?</p>
<p><b>R8</b>. Ce sont les messages d'erreur de PAM. J'ai
écrit les scripts avant que PAM ne sorte. Mon script virtfs
ne copie pas <code>/etc/pam.d</code> ,
<code>/usr/lib/cracklib_dict.*</code> , <code>/lib/security</code>
ou n'importe quel fichier dont PAM a besoin. PAM en a besoin pour
fonctionner. Si vous éditez mon script virtfs pour copier
ces fichiers, il n'y aura plus de problèmes.</p>
<p><b>Q9</b>. Est-ce que virtuald peut fonctionner avec les
hosts.allow et hosts.deny de tcpd ?</p>
<p><b>R9</b>. Oui, il peut, mais avec quelques modifications.</p>
<p>D'abord, le code source doit être changé en deux
endroits.</p>
<p>Il faut insérer ces lignes là où les
arguments sont analysés.</p>
<pre>
if (!argv[3])
{
syslog(LOG_ERR,"invalid arguments: no program to run");
exit(0);
}
</pre>
<p>La ligne d'exécution doit remplacer :</p>
<pre>
if (execvp(argv[2],argv+2)<0)
</pre>
<p>par :</p>
<pre>
if (execvp(argv[2],argv+3)<0)
</pre>
<p>Deuxièmement, les lignes du fichier
<code>inetd.conf</code> :</p>
<pre>
ftp stream tcp nowait root /usr/local/bin/virtuald \
virtuald /virtual/conf.ftp tcpd wu.ftpd -l -a
</pre>
<p>Troisièmement, éditer les fichier
<code>/virtual/domain1.com/etc/hosts.allow</code> et
<code>/virtual/domain1.com/etc/hosts.deny</code> pour mettre vos
paramètres.</p>
<p><b>Q10</b>. Est-ce que mon serveur virtuel peut lancer des
CGI ?</p>
<p><b>R10</b>. Bien sûr, mais je vous recommande de mettre le
répertoire <code>/cgi-bin</code> à un endroit en
dehors du <code>chroot</code> , où vous seul avez
accès. Par exemple, /var/www/cgi-bin/domain1.com. Donner
l'accès aux cients à /cgi-bin leur donne la
possibilité de lancer des programmes sur votre serveur.
C'est un gros trou de sécurité. Soyez prudent. Je ne
laisse aucun CGI tourner sur mon système sans que je n'ai
pas personnellement cherché d'éventuels bugs.</p>
<p><b>Q11</b>. Mes fichiers de configuration sont différents
de vos exemples. Que dois je faire ?</p>
<p><b>R11</b> Il y a deux styles de configuration : System V
et BSD. Les exemples fournis dans ce HOWTO sont basés sur
les fichiers de configuration System V. Les services virtuels
marchent aussi bien sur l'autre système. Pour des
informations sur la méthode pour configurer vos fichier de
style BSD, consultez l'origine de votre distribution ou le site LDP
le plus près.</p>
<p><b>Q12</b>. Je vous ai envoyé un mail et n'ai pas
reçu de réponses ou alors elles ont pris un long
moment avant de me parvenir. Pourquoi ?</p>
<p><b>R12</b>. Vous n'avez sûrement pas mis VIRTSERVICES
HOWTO dans le sujet. Sachez que je suis un administrateur
réseau, et que parmi mes 20 heures par jour, j'administre
mes machines virtuelles et celles de mes clients. Un mail qui est
proprement adressé aura toujours une réponse dans les
deux ou trois jours suivants. Les mails mal adressés ne
seront pas filtrés vers ma boîte aux lettres pour
VIRTSERVICES, et peuvent m'être inconnus pendant plusieurs
jours, voir semaines.</p>
<p><b>Q13</b>. Est-ce que virtuald marche avec une connection a
100Mbit ?</p>
<p><b>R13</b>. La vitesse d'une carte réseau est totalement
indépendante du fait que virtuald fonctionne ou pas.
Vérifiez que votre serveur tourne sous 10Mbit et que votre
carte 100Mbit fonctionne normalement sans un serveur virtuel.</p>
<p><b>Q14</b>. Est-ce que je dois utiliser la <code>table
virthost</code> de sendmail ?</p>
<p><b>R14</b>. Non, c'est une fonctionnalité de Sendmail qui
reçoit les informations pour plusieurs domaines. Virtuald
donne à chaque Sendmail son propre environnement
<code>chroot</code> . Installez Virtuald et configurez sendmail
comme vous le feriez à l'habitude pour chaque domaine.</p>
<p><b>Q15</b>. Puis-je installer un telnet virtuel sur ma
machine ? Et est-il possible de créer un compte root
virtuel, pour que les client puissent administrer leur propre
domaine ?</p>
<p><b>R15</b>. Ces questions reviennent souvent, et pour etre
honnête, j'en ai un peu marre de les entendre. La
réponse, qui est dans ce document, est que n'importe quel
service lancé par inetd peut être rendu virtuel, donc
rien ne vous empêche de le faire. Rien, à part le bon
sens. Cependant, les bénéfices que vous pouvez avoir
sont fortement altérés par le prix de la
securité de votre machine virtuelle (ainsi que les sites que
vous êtes supposés héberger d'une
manière résponsable). Voici quelques
exemples :</p>
<ul>
<li>Afin de duper une session telnet entrante vous devez modifier
le noyau, pour avoir plusieurs proccessus, réinitialiser
votre adresse IP source pour les connections sortantes, duper
<code>gethostname</code> pour qu'il utilise le nom de domaine
virtuel et non celui du système, etc. Si vous êtes un
utilisateur avancé, hackez le kernel. Pour un
débutant, je ne le recommande pas.</li>
<li>En autorisant les utilisateurs à venir sur votre machine
en telnet, vous les autorisez à lancer des programmes
dangereux. Et ceux qui savent hacker peuvent prendre les
privilèges root et causer des dommages sur votre
système.</li>
<li>Donner un accès root en telnet sur une machine virtuelle
est très mauvais. Un utilisateur root virtuel peut quand
même lire les fichiers des péripheriques , ce qui
annule le <code>chroot</code> , peut éteindre le
système et tuer les autres processus sur le
système.</li>
<li>Telnet est un service réseau non sécurisé.
Des mots de passes sont envoyés en clair par le
réseau. Si un utilisateur avec de mauvaises intentions
récupère ce mot de passe, il ou elle peut utiliser
les attaques mentionnées ci-dessus pour nuire à votre
système.</li>
<li>Votre environnement virtuel devra être plus gros. Vous
aurez besoin de plus de librairies, plus de fichiers de
configuration, et plus d'exécutables. Un disque de 6Go peut
être très vite rempli.</li>
</ul>
<p>Comme quoi, c'est une très mauvaise idée
d'autoriser des connections sur une machine virtuelle. Si vous le
permettez, tous les sites hebergés sur cette machine seront
en danger. Si vous voulez autoriser un propriétaire de site
à administrer ses utilisateurs, vous devez alors
écrire (pas de script) le programme nécessaire pour
lancer un processus virtuel qui l'autorise à les ajouter,
effacer ou modifier en se connectant par ssh. Ceci devra être
complètement exécuté par menus, vous ne devrez
jamais autoriser de consoles, ou d'accès root. Afin
d'accomplir ceci, vous devrez changer le propriétaire des
fichiers concernés de root à un autre utilisateur. Si
c'est fait de cette maniere, c'est assez securisé pour
être incorporé dans une machine virtuelle. Il ne sera
jamais acceptable d'autoriser des connections root en telnet ou
ssh. Le faire, serait simplement une invitation au désastre.
S'il y avait une raison de le faire, le site devrait être
hébergé sur une machine dédiée,
où le risque serait juste pour lui. Aucun administrateur
responsable ne ferait autrement et donc je ne perdrai pas plus de
temps sur cette question.</p>
<p><b>Q16</b>. Y a-t-il un rpm, tar, site web, liste de diffusion,
etc. associé à virtuald et au Virtual-Services
HOWTO ?</p>
<p><b>R16</b>. Pour le moment il n'y a rien de tout ceci. Ce HOWTO
est la seule source d'information sur tout ce que j'ai fait
concernant ce projet. Je trouve ce HOWTO assez informatif, rendant
le besoin d'autres renseignements superflu.</p>
<p><b>Q17</b>. Quand j'essaye de lancer virtexec en tant que simple
utilisateur, j'ai <code>chroot: operation not permitted</code> .
Pourquoi ?</p>
<p><b>R17</b>. <code>chroot</code> est un appl système
restreint au root. Seulement le super utilisateur peut l'executre.
Le script virtexec lance le programme <code>chroot</code> ce qui
implique le besoin d'être root pour le lancer.</p>
<p><b>Q18</b>. J'ai mis en place pop et sendmail, mais la
récuperation des mails ne semble pas marcher. D'où
cela vient-il ?</p>
<p><b>R18</b>. Certains programmes pop prennent comme emplacement
des fichiers mail <code>/usr/spool/mail</code> . Je sais que
<code>qpop</code> doit etre édité manuellement pour
résoudre ce problème. Soit vous recompilez les
sources de votre programme, soit vous faites un lien symbolique de
<code>/virtual/domain1.com/usr/spool</code> vers
<code>/virtual/domain1.com/var/spool</code> .</p>
<p><b>Q19</b>. Je n'ai pas utilisé le programme
mentionné dans votre HOWTO, j'utilise le programme XXX. Il
ne marche pas. Pourquoi ?</p>
<p><b>R19</b>. J'ai essayé de faire des exemples le plus
génerique possible pour chaque serveur. Je sais que
certaines personnes ont leur version favorite de chaque serveur.
Envoyez-moi le plus d'informations possible, et j'essaierai de
trouver une solution à votre problème et je
l'incluerai dans la FAQ. L'information la plus importante est de me
dire ou trouver la version du programme que vous utilisez (sous la
forme ftp://ftp.domain.com/subdir/subdir/file.tgz).</p>
<p><b>Q20</b>. Quand je lance virtexec il dit <code>symlink not a
virt function</code> . Qu'est-ce que cela veut dire et comment le
réparer ?</p>
<p><b>R20</b>. Virtexec est programme pour lequel les arguments
sont les quatres premiers caractères, et il lance le nom
restant dans l'environnement virtuel. Par exemple,
<code>virtpasswd</code> lance <code>passwd</code> . Si les quatres
premiers caracteres ne sont pas <code>virt</code> , il se plaint et
sort un message d'erreur. Virtexec est écrit en script shell
et devrait être très simple à porter.
Référez vous aux pages de manuels de bash ou du shell
que vous utilisez pour vos question sur la programmation de script
shell.</p>
<p><b>Q21</b>. J'ai une question à propos de Qmail, Samba,
Apache, etc. qui n'a aucun rapport avec la mise en place de
virtuald ou l'interface entre le paquetage et virtuald.</p>
<p><b>R21</b>. Tous les paquetages décris ici sont
pleinement documentés. Certains ont un site web comme
<code>www.nom_du_paquetage.org</code> qui leur est
entièrement dédié. S'il vous plait consultez
ces documents à propos de ce genre de questions.</p>
<p><b>Q22</b>. J'ai plusieurs alias de domaines pointant sur
domain1.com mais les mails continuent à être
renvoyés aux alias. D'où est-ce que ca
vient ?</p>
<p><b>A22</b>. Virtmaildelivery compte sur les variables
d'environnement qui lui sont passées pour déterminer
quel répertoire /virtual/domain1.com utiliser pour
distribuer le courrier. Il ne fait pas de recherche DNS pour
déterminer l'adresse du mail. Puis, si l'adresse est
<code>submail.mail.domain1.com</code> , virtmaildelivery essayera
en premier cette adresse puis <code>mail.domain1.com</code> et puis
<code>domain1.com</code> . Il essaye dans cet ordre, jusqu'à
ce qu'une concordance ait lieu où qu'il ne reste plus de
noms de domaines.</p>
<p>De toutes facons, si vous avez des alias de domaines qui ne sont
pas des sous-domaines d'un autre, vous devez créer des liens
symboliques comme :</p>
<pre>
cd /virtual
ln -s domain1.com domain1alias.com
</pre>
<p>De cette manière, virtmaildelivery sera trompé en
pensant que ces mêmes répertoires existent même
si l'un d'eux est un lien symbolique et le mail pourra être
distribué à <code>user@domain1.com</code> ou
<code>user@domain1alias.com</code> . Notez que
<code>virtexec</code> listera les deux répertoires des
domaines dans la boîte de dialogue quand vous le lancerez.
Vous pouvez choisir n'importe lequel, mais ce sera le même
système de fichier.</p>
</body>
</html>
|