Krediet

Dank gaat uit naar een paar mensen (in alfabetische volgorde) voor hun hulp van onschatbare waarde.

• Lee Archie voor het proeflezen

• James Bruce en Bill Poston voor de kans om mijn eerste permanente machine met Majordomo op te zetten

• Joseph D. Sloan voor het lezen van het deel dat gaat over Sendmail en het geven van behulpzame suggesties

• Aanvulling van de vertaler: Met dank aan Reggy Ekkebus voor het vertalen van versie 1.10, dd 10 november 1999 van dit document naar het Nederlands. Dit document is opnieuw vertaald vanwege de omzetting van linuxdoc naar DocBook en de uitgave van een nieuwe versie.

Referenties

Alhoewel ik heb getracht deze HOWTO zo compleet mogelijk te maken, is het altijd een goed idee meer dan één bron te bekijken. Hieronder tref je een lijst aan met de bronnen die ik behulpzaam vond bij het voor de eerste keer proberen te configureren van Majordomo.

Boeken:

• Bryan Costales with Eric Allman, sendmail. Cambridge: O'Reilly, 1997.

• Alan Schwartz, Managing Mailing Lists. Cambridge: O'Reilly, 1998.

Vrije bronnen:

• de documentatie die met Sendmail wordt geleverd, vooral README.cf

• de documentatie die met Majordomo wordt geleverd, met name INSTALL en NEWLIST

• het Majordomo-Users discussielijstarchief.

• de documentatie die bij MajorCool wordt geleverd.

Aliassen

Het aliassenbestand van Sendmail (gewoonlijk /etc/aliases) wordt gebruikt voor het maken van aliassen voor E-mailadressen. Zodra Majordomo is geïnstalleerd bijvoorbeeld, komt er in het bestand aliases gewoonlijk een regel voor als:

majordomo-owner: jarchie

Deze regel betekent dat alle mail geadresseerd aan [email protected] in werkelijkheid zal worden gestuurd naar [email protected]. Het is niet nodig @host.com aan jarchie toe te voegen, omdat beide gebruikers zich op dezelfde host bevinden. Als het gewenst zou zijn om het bericht naar een andere gebruiker op een andere host door te sturen, dan zou men het deel @host.com moeten toevoegen.

Een ander type regel in het bestand aliases staat toe dat E-mail naar meerdere adressen opgesomd in een bestand kan worden doorgestuurd:

testlist: :include:/usr/local/majordomo-1.94.5/lists/testlist

Deze regel geeft aan dat elk bericht gestuurd naar [email protected] zal worden doorgestuurd naar alle adressen die zijn opgesomd in het bestand /usr/local/majordomo-1.94.5/lists/testlist. Het bestand testlist zou er zo uit kunnen zien:

[email protected] [email protected] [email protected]

Majordomo kan door gebruik te maken van deze feature adressen aan een lijst toevoegen of van een lijst verwijderen. Wanneer een subscribe verzoek wordt verwerkt, wordt het E-mailadres van de gebruiker toegevoegd aan het bestand testlist; wanneer een unsubscribe verzoek wordt verwerkt, wordt het E-mailadres van de gebruiker verwijderd uit het bestand testlist. Men kan tevens adressen handmatig toevoegen of verwijderen door simpelweg het bestand te bewerken met een teksteditor zoals vi.

Aangezien Majordomo opdrachten moet kunnen verwerken die er via E-mail naartoe zijn gestuurd, moet Sendmail het Majordomo programma kunnen uitvoeren en er het bericht aan door kunnen geven. Dit wordt bewerkstelligd door een ander type regel toe te voegen aan het bestand aliases:

majordomo: "|/usr/local/majordomo-1.94.5/wrapper majordomo"

Het programma /usr/local/majordomo-1.94.5/wrapper is een wrapper (SUID majordomo en SGID majordomo of daemon afhankelijk van de configuratie) dat het Majordomo programma uitvoert. De aanhalingstekens rondom het tweede deel van de alias worden gebruikt om Sendmail aan te geven dat dit deel van de regel uit één statement bestaat; de aanhalingstekens zouden niet nodig zijn als er geen spatie tussen wrapper en majordomo zou staan. Het |-teken staat bekend als een "pipe"; het wordt gebruikt om Sendmail aan te geven de E-mail aan de wrapper via de standaardinvoer naar de wrapper te sturen. (Aangezien het enige dat de wrapper hier doet het aanroepen van majordomo is, wordt de E-mail in feite doorgestuurd naar Majordomo.) De wrapper accepteert één parameter, namelijk de parameter van het programma dat het verondersteld wordt uit te voeren. (Parameters na de eerste zullen worden doorgegeven aan het programa dat de wrapper uitvoert.) Om beveiligingsredenen, voert de wrapper alleen programma's uit die zijn de vinden in de Majordomo directory, /usr/local/majordomo-1.94.5/. Deze beperking verhindert een programmeur de wrapper te gebruiken programma's uit te voeren die geen Majordomo privileges zouden moeten hebben. (Bijvoorbeeld, wrapper /bin/vi zou een gebruiker toestaan elk Majordomo configuratiebestand te bewerken.) Wanneer een bericht naar [email protected] is gezonden, start Sendmail de wrapper, die op zijn beurt, majordomo opstart, en Sendmail stuurt het bericht naar het majordomo script via de standaardinvoer. Majordomo extraheert de opdrachten dan uit het bericht en reageert dienovereenkomstig.

Bewerken van sendmail.cf

Door zijn geheimzinnige syntax is sendmail.cf misschien wel het meest beangstigend van alle configuratiebestanden. Bij de installatie van majordomo, is het niet strict noodzakelijk om sendmail.cf te bewerken; echter een paar features zijn buitengewoon handig. Tenzij belangrijke wijzigingen moeten worden aangebracht aan sendmail.cf (wat Majordomo gelukkig niet vereist), is het bewerken van het bestand niet zo moeilijk. Het enige dat nodig is, is het toevoegen van extra regels aan het bestand.

Configureren van sendmail.cf met behulp van de M4 configuratie

Voor beheerders die het bestand sendmail.cf niet direct willen bewerken, is het mogelijk gebruik te maken van M4 om het bestand aan te maken; in deze sectie wordt beschreven hoe de besproken wijzigingen in de vorige sectie te maken aan het mc bestand in plaats van het cf bestand.

Het doel van de M4 configuratie is te voorzien in een makkelijke manier om het bestand sendmail.cf aan te maken. Het idee erachter is dat het aangemaakte mc bestand makkelijker is te begrijpen dan het bestand sendmail.cf. Door uitvoering van de preprocessor m4, wordt een sendmail.cf bestand gegenereerd:

[root@kes etc]# m4 /etc/sendmail.mc > /etc/sendmail.cf

Sendmail beveiligingskwesties

Beveiliging is omgekeerd evenredig proportioneel met gemak; de enige veilige machine is die door niemand kan worden benaderd. Wanneer een aantal van de beveiligingsfeatures zijn gedeactiveerd, zal een machine onvermijdelijk minder veilig worden. Het is echter van belang de basisbeveiligingsrisico's te begrijpen om vast te stellen of het gemak zwaarder weegt dan mogelijke beveiligingslekken.

Voorbereiden van de installatie

Download de met gzip gecomprimeerde broncodedistributie van de laatste versie van Majordomo vanaf Great Circle Associates en decomprimeer het

[jarchie@kes jarchie]$ tar zxvf majordomo-1.94.5.tar.gz

Hiermee zal een subdirectory worden aangemaakt met alle bestanden die nodig zijn om Majordomo te installeren; deze directory kan niet dezelfde directory zijn waarin Majordomo moet worden geïnstalleerd.

Majordomo moet zodanig worden uitgevoerd onder een specifieke UID en GID dat wanneer een van de scripts wordt uitgevoerd, het zal draaien onder Majordomo's UID. Dus is het nodig een besluit te nemen over onder welke UID en GID Majordomo zal draaien. Ook moet Majordomo een toevertrouwde gebruiker van Sendmail zijn (zie paragraaf Toevertrouwde gebruikers van sendmail).

Kijk in de bestanden /etc/passwd en /etc/group om een nog niet in gebruik genomen UID en GID te achterhalen. Voor dit voorbeeld werd gekozen voor UID 16 en GID 16. Je moet een beslissing nemen over de lokatie waar de Majordomo-scripts zullen voorkomen; in deze HOWTO werd gekozen voor de directory /usr/local/majordomo-1.94.5/. Voeg regels vergelijkbaar met

majordomo:x:16:16:Majordomo List Manager:/usr/local/majordomo-1.94.5:

toe aan /etc/passwd als je gebruik maakt van een shadow password bestand en voeg een van toepassing zijnde regel toe aan /etc/shadow.

majordomo:*:10883:0:88888:7:::

Gebruik de andere regels in deze bestanden als een richtlijn voor wat er precies zou moeten worden toegevoegd. Dit zijn slechts de waarden op mijn systeem. Als je geen gebruik maakt van shadow-passwords, dan is alleen een regel nodig in het bestand /etc/passwd.

Voeg voor de aanmaak van een Majordomo groep een regel toe vergelijkbaar met

majordomo:x:16:jarchie

aan het bestand /etc/group. Je gebruikersnaam toevoegen aan het einde van de regel geeft je toegang tot de Majordomo bestanden die schrijfbaar zijn voor de groep.

Bewerken van de installatiebestanden

De Makefile bevat alle informatie nodig om Majordomo te installeren; gewoonlijk moeten regels in de Makefile worden bewerkt die verwijzen naar systeemspecifieke instellingen zodat Majordomo zuiver op je systeem kan worden geïnstalleerd. De meeste standaardinstellingen zijn correct; echter de volgende instellingen, vrijwel onveranderlijk, moeten per systeem worden gewijzigd.

[jarchie@kes majordomo-1.94.5]$ vi Makefile

De instellingen

PERL = /bin/perl CC = cc W_HOME = /usr/test/majordomo-$(VERSION) MAN = $(W_HOME)/man W_USER = 123 W_GROUP = 45

zouden moeten worden gewijzigd in iets meer geschikt voor je systeem. In mijn setup bijvoorbeeld zijn de waarden gewijzigd in

PERL = /usr/bin/perl CC = gcc W_HOME = /usr/local/majordomo-1.94.5 MAN = /usr/man W_USER = 16 W_GROUP = 16

Ook moet het bestand majordomo.cf worden aangemaakt. Een makkelijke manier om dit bestand aan te maken is door het aangeleverde bestand sample.cf te kopiëren naar majordomo.cf en het te bewerken.

[jarchie@kes majordomo-1.94.5]$ cp sample.cf majordomo.cf [jarchie@kes majordomo-1.94.5]$ vi majordomo.cf

Nogmaals, de meeste standaardinstellingen zijn correct, maar de volgende regels moeten wellicht voor je systeem worden aangepast van

$whereami = "example.com"; $whoami = "Majordomo\@$whereami"; $whoami_owner = "Majordomo-Owner\@$whereami"; $homedir = "/usr/test/majordomo"; $digest_work_dir = "/usr/local/mail/digest"; $sendmail_command = "/usr/lib/sendmail";

in iets meer passend zoals

$whereami = "kes.emeraldis.com"; $whoami = "majordomo\@$whereami"; $whoami_owner = "majordomo-owner\@$whereami"; $homedir = "/usr/local/majordomo-1.94.5"; $digest_work_dir = "/usr/local/majordomo-1.94.5/digest"; $sendmail_command = "/usr/sbin/sendmail";

$whoami en $whoami_owner hoeven voor de werking van Majordomo niet te worden gewijzigd; ik wijzigde ze omdat ik het intikken van hoofdletters graag wil voorkomen. $digest_work_dir is een tijdelijke directory waarin de digest bestanden zouden moeten worden geplaatst; aan deze directory zou moeten worden toegekend de directory waarin je wilt dat de digests worden opgeslagen. Maak je niet druk om deze optie als je niet van plan bent om digest lijsten te gebruiken. $whereami, $homedir, en $sendmail_command zouden moeten worden gewijzigd in de van toepassing zijnde waarden voor je systeem. In tegenstelling tot de Makefile, kunnen deze opties altijd worden gewijzigd nadat Majordomo is geïnstalleerd door het bewerken van majordomo.cf in de directory waarin Majordomo werd geïnstalleerd. (Het configuratiebestand wordt simpelweg gekopieerd tijdens de setup.)

Majordomo installeren

De volgende stap bestaat uit het compileren van de Majordomo wrapper. De wrapper is de enige Majordomo component die moet worden gecompileerd, omdat al het andere bestaat uit een verzameling perl-scripts en daarom niet wordt gecompileerd.

[jarchie@kes majordomo-1.94.5]$ make wrapper

Geef voor de installatie van de Majordomo bestanden de opdrachten:

[root@kes majordomo-1.94.5]# make install [root@kes majordomo-1.94.5]# make install-wrapper

De eerste opdracht kan als de Majordomo gebruiker (in de veronderstelling dat majordomo $home_dir kan aanmaken of hier toegang toe heeft), maar de tweede opdracht moet worden gegeven als root zodat het installatiescript kan SUID root de Majordomo wrapper. (Aangezien, majordomo werd aangemaakt zonder loginshell of wachtwoord, zul je als root de opdracht su majordomo moeten geven om majordomo te worden als je de eerste opdracht als majordomo uit wilt voeren.)

Aanmaken van de Majordomo aliassen

Sendmail aliassen moeten voor Majordomo worden aangemaakt zodat opdrachten verzonden naar Majordomo kunnen worden verwerkt door majordomo, en een alias voor de eigenaar van Majordomo moet worden aangemaakt, zodat mensen je kunnen mailen via het standaardadres owner-majordomo. Voeg de volgende regels toe aan het bestand aliases (zie paragraaf Aliassen).

majordomo: "|/usr/local/majordomo-1.94.5/wrapper majordomo" owner-majordomo: jarchie majordomo-owner: jarchie

Testen van de configuratie

Start als reguliere gebruiker (niet als majordomo of als root)

[jarchie@kes jarchie]$ /usr/local/majordomo-1.94.5/wrapper config-test

Dit programma kan de meeste problemen in de Majordomo installatie detecteren.

Lijsten aanmaken

Voor het aanmaken van een lijst, maak je een bestand aan met de naam van de lijst in de Majordomo-directory lists. Voor bijvoorbeeld het aanmaken van een lijst met de naam test, maak je als Majordomo een bestand test aan

[root@kes /]# su majordomo [majordomo@kes /]$ touch /usr/local/majordomo-1.94.5/lists/test

en voeg de gerelateerde aliassen toe

test: :include:/usr/local/majordomo-1.94.5/lists/test owner-test: jarchie test-request: "|/usr/local/majordomo-1.94.5/wrapper request-answer test" test-approval: jarchie

Verder testen van de configuratie

Test nu de werking van de lijst door een lists opdracht aan Majordomo uit te voeren.

[jarchie@kes jarchie]$ echo lists | mail majordomo

Het zou slechts een seconde moeten duren eer majordomo antwoordt met een bericht waarin alle lijsten die thans zijn opgesteld zijn opgesomd. Probeer vervolgens de opdracht help uit te voeren.

[jarchie@kes jarchie]$ echo help | mail majordomo

Majordomo zou moeten reageren met een lijst met alle opdrachten die Majordomo accepteert. Het is wellicht een goed idee om het bericht voor toekomstige referenties te bewaren.

Probeer jezelf in- en uit te schrijven op de lijst om te achterhalen of de aliassen correct werken.

[jarchie@kes jarchie]$ echo subscribe test | mail majordomo

Je zult een E-mailbericht ontvangen met instructies hoe je de aanmelding kunt bevestigen als ook een melding bevestigend dat je opdracht succesvol was. Na het terugsturen van je bevestiging, zou Majordomo twee meldingen terug moeten sturen, één melding waarin staat dat je aanmeldingsverzoek succesvol was en een andere melding die je welkom heet op de lijst test. Aan de eigenaar van de lijst zal ook een bericht worden gezonden waarin staat aangegeven dat je je hebt aangemeld op de lijst.

Stuur de opdracht unsubscribe om je uit te schrijven van een lijst

[jarchie@kes jarchie]$ echo unsubscribe test | mail majordomo

Je zou een melding terug moeten krijgen waarin staat dat je opdracht succesvol was.

Betere aliassen aanmaken

Bij een aantal lijsten kan het wenselijk zijn om Majordomo de berichten te laten verwerken, voordat ze de lijst bereiken. Majordomo heeft bijvoorbeeld een resend script om berichten gebaseerd op inhoud (zoals woorden die taboe zijn) automatisch te filteren om te voorkomen dat mensen Majordomo opdrachten naar de lijst sturen, en nog andere features. Voor het gebruik van deze opties is het nodig een betere set aliassen te gebruiken, zoals

test: "|/usr/local/majordomo-1.94.5/wrapper resend -l test test-list" test-list: :include:/usr/local/majordomo-1.94.5/lists/test owner-test: jarchie test-owner: jarchie test-request: "|/usr/local/majordomo-1.94.5/wrapper majordomo -l test"

De laatste regel maakt het iemand mogelijk om simpelweg een bericht te sturen naar [email protected] met de tekst subscribe in plaats van het versturen van een bericht naar [email protected] met de tekst subscribe test. Als sendmail gebruik maakt van smrsh, dan zou de bovenstaande aliases verwijzen naar de kopie van de wrapper in het veilige pad, gewoonlijk /etc/smrsh/wrapper.

Fouten opsporen

Het gebeurt regelmatig dat de permissies van Majordomo niet correct worden ingesteld wat veroorzaakt dat Majordomo niet naar behoren werkt. Gelukkig geven Sendmail en Majordomo kenmerkend fatsoenlijke foutmeldingen die een probleem aanduiden. De directory lists bijvoorbeeld moet uitvoerbaar zijn voor de gebruiker sendmail setuids naar, typisch mail of daemon. Als sendmail lists niet kan uitvoeren, dan moeten de permissies wat minder strict zijn.

[root@kes root]# chmod +x /usr/local/majordomo-1.94.5/lists

Een ander gebruikelijk probleem wordt veroorzaakt doordat de directory lists schrijfbaar is door de groep. Als oplossing van dit probleem kan men de schrijfbare bit van de groep verwijderen of de sendmailoptie IncludeFileInGroupWritableDirPath gebruiken (zie paragraaf Schrijfpermissies van de groep en paragraaf Consequenties van onveilige te beschrijven groepen voor meer details).

Majordomo beveiligingskwesties

Majordomo is bedoeld te worden uitgevoerd op een geïsoleerd systeem; er bestaan een paar welbekende beveiligingslekken in de scripts waarmee elke lokale gebruiker wrapper kan draaien om code als de gebruiker majordomo uit te voeren. Als Majordomo op een systeem moet worden uitgevoerd die voorziet in gebruikers met toegang tot een shell, dan is het aan te raden de permissies op de wrapper te verscherpen. Dit kan worden bewerkstelligd door de uitvoerbare bit voor alle overige gebruikers te verwijderen en de groep van de wrapper met chgrp te wijzigen in de gebruiker die de Majordomo-scripts moet uitvoeren. Als bijvoorbeeld Sendmail en MajorCool beiden worden gebruikt om de wrapper uit te voeren, gebruik dan de opdrachten

[root@kes root]# cp /usr/local/majordomo-1.94.5/wrapper /etc/smrsh/wrapper [root@kes root]# chmod 4750 /usr/local/majordomo-1.94.5/wrapper [root@kes root]# chown root:nobody /usr/local/majordomo-1.94.5/wrapper [root@kes root]# chmod 4750 /etc/smrsh/wrapper [root@kes root]# chown root:mail /etc/smrsh/wrapper

om het systeem te beveiligen. Dit laat toe dat sendmail (onderwijl onder mail draaiend) /etc/smrsh/wrapper uit te voeren terwijl het toestaat dat de webserver's MajorCool (draaiend onder nobody) /usr/local/majordomo-1.94.5/wrapper uitvoert. Deze oplossing zal echter toestaan dat iedereen met het UID of GID mail of nobody ook toegang tot het majordomo account kan verkrijgen. Ter bescherming van het nobody account, is het van belang normale gebruikers niet toe te staan gebruik te laten maken van serversite includes of cgi-scripts, tenzij die services niet onder nobody draaien.

MajorCool extraheren

De laatste bestanden kunnen worden gedownload van Conveyance Digital.

[jarchie@kes jarchie]$ mkdir majorcool [jarchie@kes jarchie]$ mv majorcool.tar.gz ./majorcool/ [jarchie@kes jarchie]$ cd majorcool/ [jarchie@kes majorcool]$ tar zxvf majorcool.tar.gz

Bewerk het Configure Script

Open Configure en

[jarchie@kes majorcool]$ vi Configure

wijzig de regel

PERLBIN="/usr/local/bin/perl" # Hoe een perlscript te starten

in de juiste lokatie van perl

PERLBIN="/usr/bin/perl" # Hoe een perlscript te starten

anders zal MajorCool niet juist worden geïnstalleerd.

MajorCool installeren

Tijdens de uitvoering van het Configure script, zal het simpelweg indrukken van de Enter-toets de standaardwaarde accepteren als de standaardkeuze voor een optie akkoord is.

[root@kes majorcool]# ./Configure

Het Configure script zal je vragen een paar maal op de Enter-toets te drukken, en dan zal het vragen om de lokatie van Majordomo en nog wat vragen stellen over de setup van je Webserver.

What is the installation directory of Majordomo? []: /usr/local/majordomo-1.94.5 Will place the MajorCool programs in /usr/local/majordomo-1.94.5. What is the path to your Majordomo configuration file? [/usr/local/majordomo-1.94.5/majordomo.cf]: Using configuration file name '/usr/local/majordomo-1.94.5/majordomo.cf' Where would you like temp files created when MajorCool runs? [/tmp]: MajorCool needs to install CGI programs, support files, and icons in your Web server directories. What is the root directory for your Web server? []: /var/www Where is the cgi-bin directory for your Web server? [/var/www/cgi-bin]: Will place the programs in /var/www/cgi-bin. What is your server's URL for '/var/www/cgi-bin'? [/cgi-bin]: Where is the image directory for your Web server? [/var/www/icons]: Will place the icons in /var/www/icons. What is your server's URL for '/var/www/icons'? [/images]: /icons Where is the root directory for documents on your Web server? []: /var/www/html

Het Configure script zal nog andere vragen stellen die minder kritiek zijn. (De standaardwaarden zijn prima, maar wellicht dat je een paar instellingen naar eigen voorkeuren wilt wijzigen. In tegenstelling tot een aantal Webserver vragen, zou de betekenis moeten blijken uit de context.) Wanneer het configuratiebestand dat het script genereerde uit je antwoorden wordt weergegeven, zou je de nieuwe versie moeten accepteren.

Accept the new version? [yes|no|list|edit|diff]? y

Het installatiescript zal de MajorCool bestanden installeren en het majordomo cgi-script uitvoeren die als uitvoer het html-bestand naar de console geeft. Bekijk het cgi-script majordomo vanaf het web ter controle of de installatie werkte.

[jarchie@kes jarchie]$ lynx http://localhost/cgi-bin/majordomo