A-Eskwiki - User contributions [en]

Voorzitter (Vakidioot)

2017-06-23T23:03:21Z

Sophieh: Nu weten we wat een voorzitter doet.

[[Category:Vakidioot]]
De '''voorzitter''' is voor de buitenwereld het gezicht van de commissie.

==Taken==
De voorzitter heeft de volgende taken:
* Heb contact met het bestuur.
* Vraag het bestuur om nieuwe leden.
* Heb contact met potentiele nieuwe leden.
* Maak planners voor vergaderingen. (8 of zo weken voor de vergadering)
* Schop mensen om de planner in te vullen. (7 of zo weken voor de vergadering)
* Prik wanneer de vergaderingen komen. (6 of zo weken voor de vergadering)
* Maak een agenda voor de vergadering en stuur deze op. (1 week voor de vergadering)
* Zit de vergadering voor.

Als je een agenda wilt maken, en je je afvraagt wat daar op moet, kun je altijd gewoon de vorige agenda kopieren. Super efficient.

De functie van een voorzitter is om een aangewezen persoon te hebben die initiatief toont en knopen arbitrair doorhakt. Ook voelt de voorzitter zich verantwoordelijk voor het functioneren van de commissie. De voorzitter probeert een overzicht te houden van wat er moet gebeuren, en voert dingen zelf uit of delegeert dingen. Gelukkig heeft de Vakidioot ook een eindredacteur, die voelt zich hopelijk ook verantwoordelijk. Wees daar vooral blij mee, maar zorg wel dat gedeelde verantwoordelijkheid nog steeds wel verantwoordelijkheid blijft.

Veelgestelde vragen (Vakidioot)

2017-03-28T16:06:10Z

Sophieh: /* Hoeveel woorden passen er op een pagina? */

[[Category:Vakidioot]]
Dit is een dumpplek voor vragen die om de zoveel tijd weer gesteld worden.

==Hoe stuur ik een mail vanaf het Vakidioot-account?==
''Antwoord hier''

==Hoeveel woorden passen er op een pagina?==
400 of zo.

==Hoe werk ik op afstand?==
''Antwoord hier''

==Wat zijn wij in het Engels?==
''Antwoord hier''

Redmine Vakidioot

2017-03-28T16:05:32Z

Sophieh:

Als vervanger voor de spreadsheet in Google Docs die we op magisch niveau moesten beheren, worden de artikels en projecten van de Vakidioot vanaf het jaar 2016-2017 bijgehouden in een [https://www.redmine.org/projects/redmine Redminetracker]. De tracker is te vinden via [http://vm-vakidioot.a-eskwadraat.nl/projects/vakidioot]

== Online administratie ==

Als alles online staat, kun je in de wiki van het project hopelijk zo goed als alles vinden wat je wilt weten om het draaiend te houden. Als je geen connectie hiermee krijgt, zie het kopje [[Redmine_Vakidioot#Systeemadministratie|Systeemadministratie]]. Handig om alvast te weten: in het mapje <code>~/cies/vakid/</code> staan inloggegevens van de administratorgebruiker van redmine.

== Systeemadministratie ==

Soms gaat het allemaal nog wel eens kapot. In dit geval moet je waarschijnlijk je favoriete sysoplid vragen om vm-vakidioot te herstarten.

=== Inloggen ===

Alles speelt zich af op de <code>vm-vakidioot</code> op het A–Eskwadraatsysteem. Om hierop te komen, moet je <code>ssh</code>'en:

<pre>
voorbeeld@paul:~$ ssh vm-vakidioot
voorbeeld@vm-vakidioot:~$
</pre>

Hiervoor moet je op het systeem wel in de commissie <code>vakid</code> zitten, als ik de Sysop goed heb begrepen. Vervolgens ga je naar de map waar Redmine draait:

<pre>
voorbeeld@vm-vakidioot:~$ cd /srv/redmine
voorbeeld@vm-vakidioot:/srv/redmine$
</pre>

Hier zul je onder andere ook wat aantekeningen vinden over hoe alles werkt.

=== Installeren ===

Zie <code>vm-vakidioot:/srv/redmine/install</code> voor gedetailleerde instructies en opmerkingen.

=== Onderhoud ===

Op dit moment is er nog geen onderhoud nodig, maar iets als wekelijke backups zou erg luxe zijn. Zet je favoriete commissielid met systeembeheerderaspiraties hierop, en vergeet niet deze pagina up te daten!

[[Category:Vakidioot]]

Qemu-kvm

2017-01-23T17:56:51Z

Sophieh:

[[category:software]]
[[category:sysop]]
Zorgt samen met [[libvirt]] voor de [[virtualisation]] op haskell.

== Config ==
Om qemu-kvm en libvirt te kunnen gebruiken moet SE-linux correct geconfigureerd worden.
Momenteel is SE-linux disabled op Haskell.

== zvol ==

Met qemu en zfs is het mogelijk om een zogenaamde zvol te gebruiken als virtuele hardeschijf. Om hier gebruik van te maken dien je eerst een vm aan te maken in proxmox. Vervolgens maak je een zvol aan op haskell, met:

zfs create -V [size] storage/vm/[naam]

Vervolgens kun je de vm aanpassen om gebruik te maken van deze storage. Vooralsnog dien je hiervoor de config handmatig aan te passen, dat kan in /etc/pve/qemu-server/[id].conf en kan de storage line aangepast worden naar:
<pre>scsi0: /dev/zvol/storage/vm/[naam],format=raw,cache=writeback,discard=on,backup=no,size=[size]</pre>
Voeg ook de volgende regel toe:
<pre>scsihw: virtio-scsi-pci</pre>

Mail

2016-10-31T19:09:37Z

Sophieh: Nu weer helemaal up to date

Bij A–Eskwadraat gebruiken we '''Maildir''' voor de opslag van e-mail van gebruikers. We raden gebruikers aan om niet direct de Maildirmappen te benaderen, maar om dit via [http://en.wikipedia.org/wiki/Internet_Message_Access_Protocol IMAP] of [http://www.washington.edu/alpine/ Alpine] te doen. De standaardconfiguratie van de meeste mailclients staat hier ook voor ingesteld.

== Services ==

Op [[Haskell|haskell]] draait de virtuele machine vm-mailpp (spreek uit: mail plus plus) om het mailverkeer van en naar A-Eskwadraat te regelen:

*[http://www.postfix.org/ postfix] (''/etc/postfix/'') verwerkt in principe alle binnenkomende mails, en wat er waarheen doorgestuurd moet worden;
*[http://www.dovecot.org/ dovecot] (''/etc/dovecot/'') neemt de POP- en IMAP-servers voor zijn rekening en verzorgt authenticatie voor het versturen van mails;
*[https://www.amavis.org/ amavis] (''/etc/amavisd/'') geeft alle binnenkomende mails door aan SpamAssassin en ClamAV om gefilterd te worden;
*[http://spamassassin.apache.org/ SpamAssassin] (''/etc/mail/spamassassin/'') [[Mailfiltering|filtert]] de spam uit het binnenkomende mailverkeer;
*[http://http://www.clamav.net/lang/en/ ClamAV] (''/etc/clamd.d/'') scant het mailverkeer voor virussen en dergelijke;
*[https://roundcube.net/ RoundCube] (''/etc/roundcubemail/'', ''/usr/share/roundcubemail'') is een webmailclient die in een [https://www.apache.org/ apache] webserver op vm-mailpp draait;
*[http://www.list.org/ Mailman] (''/etc/mailman/'') Mailman is verantwoordelijk voor de mailing lists, zoals de BBCie-announce.

== Naamgeving Maildirmappen ==

Let op dat om voor dovecot begrijpbare namen te hebben, de mappen op in ''~/Maildir'' altijd met een punt moeten beginnen. Submappen werken ook op deze manier. Een paar voorbeelden:

*''~/Maildir/.Intro/'' voor de IMAP-map ''Intro'';
*''~/Maildir/.Sysop.postmaster/'' voor de map ''postmaster'' als submap van ''Sysop''.

Als de mappen via IMAP worden aangemaakt gebeurt dit automatisch.

== Postfix ==

Postfix is de SMTP server voor de vm-mailpp.

Postfix gebruikt meerdere ports om mail te ontvangen en te verwerken. Mail die wordt gestuurd door leden moet naar de SMTP daemon op port 587 (''submission'' poort) worden gestuurd. Authenticatie en TLS encryptie zijn een vereiste op deze verbinding. In de toekomst zal de [[Router|Router]] de encryptie tussen client en mail-server regelen. Alle andere mail komt binnen op port 25. Spam- en virus-filtering gebeurd via de SMTP daemons op ports 10025 en 10027 voor onbekende en bekende mail, respectievelijk.

In ''/etc/postfix/master.cf'' staat de configuratie van deze daemons. De configuratie in ''/etc/postfix/main.cf'' wordt gebruikt voor zaken die niet in ''master.cf'' zijn opgegeven; in principe staat hier de configuratie voor poort 25 en worden de opties specifiek voor de andere poorten opgegeven in ''master.cf''.

Een bug/feature van postfix die slecht gedocumenteerd is, is als volgt: wanneer postfix langer dan 10 seconden duurt over het authentiseren van een email, wordt deze geweigerd met een verkeerde foutmelding: "535 5.7.8 Error: authentication failed: Connection lost to authentication server (SMTP AUTH failed with the remote server)".

=== Transport ===

Eerst checkt Postfix of de inkomende mail aan een lokaal mailadres is gestuurd. Welke domeinen als 'lokaal' worden bestempeld staat in ''/etc/postfix/domains/local''. Voor lokale mailadressen geldt, dat het domein in de verdere configuratie kan worden weggelaten.<br/>Daarna checkt Postfix of de inkomende mail naar een virtueel domein is gestuurd. Mailadressen van domeinen zoals turingslegacy.nl worden herschreven naar lokale mailadressen (zonder domeinnaam). De virtuele domeinen staan in ''/etc/postfix/domains/virtual''.

De overblijvende adressen, worden opgezocht in de bestanden met aliases in /etc/postfix/aliases, om te zien of de mail toevallig naar een ander lokaal mailadres doorgestuurd moet worden. Postfix gebruikt hiervoor de bestanden in .db formaat, de tekstbestanden zonder extensie zijn voor ons als sysop leesbaar en te bewerken maar moeten wel met ''postalias'' in een .db bestand omgezet worden naar iedere wijziging.<br/>Als iemand dit vergeet na het aanpassen van een bestand met aliases, plaatst postfix een melding in ''/var/log/maillog'': "database file ''bestandsnaam''.db is older than source file ''bestandsnaam''".<br/>Nu blijven er als het goed is, alleen gebruikersnamen over die op het systeem bestaan. Voor deze gebruikers wordt het bestand ''.forward'' in de homedirectory van de gebruiker opgezocht.

Als in een ''.forward'' bestand de gebruikersnaam voorafgegaan door een backslash (\) wordt aangetroffen, wordt de mail in de Maildir map van die gebruiker geplaatst. Als een regel met een pipe (|) wordt aangetroffen, wordt het mailbericht doorgegeven als standard input aan het commando dat achter het |-teken staat. Andere regels met tekst worden geïnterpreteerd als mailadressen (lokaal zonder domeinnaam of willekeurig mailadres met domeinnaam) waarnaar de mail moet worden doorgestuurd.<br/>''Let op bij het gebruiken van de pipe (|): het kan zijn dat SELinux niet toestaat dat postfix een ander programma direct aanroept.''

Als de mail niet bij een lokaal of virtueel adres hoort, checkt postfix of de inkomende mail is gestuurd naar een domein waarvoor A-Eskwadraat mail relayet. Deze mail word onveranderd naar de mailserver van dat domein verstuurd (relaying). Dit voorkomt verlies van mail voor het externe domein wanneer hun mailserver uitvalt, aangezien A-Eskwadraat de secondary mailserver is voor dat domein. Een uitzondering op de regel is mail bedoeld voor de webserver. Mail aan de webcie komt binnen op de mail server, maar moet worden doorgestuurd naar de webserver. De verwijzingen zijn te vinden in ''/etc/postfix/transport_www'' en ''/etc/postfix/transport_regex''.

Let op dat deze uitleg heel erg bot is. Lees de relevante ''man'' pages van Postfix om te leren hoe mail word verwerkt. Let op dat veranderingen in een alias/transport/domain map niet worden opgemerkt tot het ''postmap'' of ''postalias'' op het bestand is aangeroepen!

=== Mail Authorisatie ===

Om te controleren of een gebruiker wel als een adres mag mailen wordt gebruik gemaakt van de smtpd_sender_login_maps optie voor postfix, die in een database de users opzoekt die als gegeven adres mogen versturen. Als er via SMTP een request gedaan wordt om van buitenaf een mail te versturen doet postfix een query en kijkt welke users als die alias mail mogen versturen. Deze config is op de vm-mailpp te vinden in `/etc/postfix/alias_auth.cf`.

De database wordt gegenereerd door een python script die op de vm-sysop staat bij de sysop api, aangezien daar de mail aliases al staan voor de alias_check. Het python script, te vinden in `/var/www/html/api/python/mail-authorization.py`, loopt recursief langs alle users die in cies, bestuur, extern of iba zitten en kijkt daarnaast ook naar mail aliassen. Aan de hand hiervan wordt met een sql query alle transitieve relaties expliciet gemaakt, zodat dit niet runtime gedaan moet worden. Als een alias naar een cie wordt doorgestuurd, en een user weer in die cie zit, wil je dat die user ook als die alias mag mailen. Als database wordt PostgreSQL gebruikt op de vm-database. De database die gebruikt wordt heet "mail". In de python code staan nog wat comments. Er draait op de vm-sysop een cron die af en toe de database refreshed. Daarnaast is het python script ook intern bereikbaar [http://vm-sysop.a-eskwadraat.nl/api/python/mail-authorization.py hier]. Bij het laden van deze pagina wordt de database gerefreshed. Op deze manier kan de database meteen gerefreshed worden zodra iemand toegevoegd is aan een cie. Als er in een alias een wildcard staat (*@bapc.eu: bapc), wat betekend dat alles van het domein bapc.eu naar de bapc commissie wordt gestuurd, wordt dit omgezet naar een SQL wildcard, wat uiteindelijk dus netjes werkt.

Als gebruiker x mag mailen als y@a-eskwadraat.nl, dan komen in de database de entries (x, y@a-eskwadraat.nl), (x@a-eskwadraat.nl, y) en (x@a-eskwadraat.nl, y@a-eskwadraat.nl) te staan. Dit omdat dingen soms worden opgevraagd met domain en soms zonder.

=== Mailfiltering ===

Postfix maakt gebruik van amavisd voor het filteren van de inkomende mail. Amavis is een interface voor SpamAssassin welke spam filtert en ClamAV welke mails op virussen scant. Check de configuratie op [[Vm-saltmaster|vm-saltmaster]] voor details.

Om de virus database up te daten:
<pre>freshclam
</pre>

== Mailman ==

Mailman is verantwoordelijk voor de infrastructuur van de mailing lists. De mailing lists zijn te vinden op [lists.a-eskwadraat.nl/mailman lists.a-eskwadraat.nl/mailman]. Er zijn twee belangrijke services om mailman te draaien: mailman en httpd. De configuratie van mailman bevind zich in ''/etc/mailman/'', de data bevind zich in ''/var/lib/mailman'', en de binaries bevinden zich in ''/usr/lib/mailman''.

Gebruik de scripts in /usr/lib/mailman/bin om de mailing lists vanaf de command-line te wijzigen. De volgende commando's zijn belangrijk bij het debuggen / migreren van mailman:

*check_perms: repareert de bestandsrechten van mailman-specifieke bestanden.
*with_list & fix_url: repareert de links van de mailman archieven indien deze zijn veranderd.

Lees de [http://wiki.list.org/DOC/4.09%20Summary%20of%20the%20mailman%20bin%20commands MailmanWiki] voor een samenvatting van alle commands.

Mailman werkt samen met de Postfix mailserver via de alias map ''/etc/mailman/aliases''. Voer het volgende commando uit na het toevoegen/verwijderen van een lijst zodat Postfix zijn alias database update:
<pre>postalias /etc/mailman/aliases
</pre>

Na een migratie van de mailman lijsten is het belangrijk om ''restorecon'' uit te voeren op ''/var/lib/mailman''. Mailman en SELinux werken prima samen zolang de rechten maar goed staan.
<pre># Samenvatting van een Mailman migratie.
# Op de nieuwe mailserver.
rsync -azv -e "ssh -i <sshkey>" <OUDEHOST>:/var/lib/mailman/ /var/lib/mailman/
restorecon -r /var/lib/mailman/
cd /usr/lib/mailman/
bin/check_perms -f
bin/withlist -l -a -r fix_url
</pre>

== Dovecot ==

Dovecot is de IMAP server verantwoordelijk voor het ophalen en beheren van de mail opgeslagen in de homedirs. Mail wordt opgeslagen in de .Maildir van een gebruik zijn home directory. De server luistert op poort 143 (standaard IMAP poort) en vereist een TLS-encrypted verbinding van de gebruiker. Het certificaat voor de verbinding is anders dan het certificaat van de webserver.  Dovecot authenticeert gebruikers door middel van LDAP. Dovecot werkt ook als authenticatie-server voor postfix door middel van een open socket. Een SELinux module is vereist om Postfix toegang te geven tot de socket.

Voor meer configuratie details, zie de configuratie op de salt-master. (CentOS 6: /srv/salt/centos/vm-mail/dovecot, CentOS 7: /srv/salt/centos7/dovecot)

'''AL DE CONFIGURATIE HIERONDER IS GIGANTISCH OUT OF DATE''' \/\/\/

== Configuratie mailfilters ==

Gebruik je een ''.forward'' of ''.procmailrc'' om e-mail direct in mappen te stoppen, let dan op de naamgeving (zie hierboven) en zorg ervoor dat de mappen altijd op een ''/'' eindigen. Begin je ''.procmailrc'' ook altijd met de regel

MAILDIR=$HOME/Maildir/

om te zorgen dat e-mail toch niet in ''/var/mail'' terechtkomt.

== Maak een mailserver met exim, en dovecot ==

Zorg eerst dat sendmail uit staat!
<pre>service sendmail stop
chkconfig sendmail off
</pre>

Bij voorkeur verwijder je ook de package voor [[Postfix|postfix]]. Deze is standaard bij CentOS geïnstalleerd.

=== Exim ===

Exim is een MTA (Mail Transfer Agent) en is ervoor om mailtjes te versturen, ontvangen, en doorsturen. Dit gebeurd uiteraard op de mailserver!

Installeer allereerst exim op de host.
<pre># yum install exim
</pre>

Verander vervolgens het configuratie bestand /etc/exim/exim.conf:
<pre># Het Mail domain - normaal gesproken a-eskwadraat.nl
primary_hostname = circle.a-eskwadraat.nl

# Weiger met ipv6 te werken.
local_interfaces = 0.0.0.0
disable_ipv6 = true

daemon_smtp_ports = smtp : submission
accept_8bitmime = true

# Lijsten van geldige mail domainin.
domainlist mailman_domains = CONFDIR/domains.mailman
domainlist local_domains = @ : CONFDIR/domains.local : +mailman_domains : lsearch;CONFDIR/domains.virtual
domainlist relay_to_domains = CONFDIR/domains.relay

hostlist relay_from_hosts = 10.14.3.0/22

# Backup mail server in het geval dat onze niet werkt.
hostlist mx_hosts = mail.wolffelaar.nl

qualify_domain = A-Eskwadraat.nl

queue_run_max = 250

smtp_accept_max = 100
smtp_accept_max_per_host = ${if match_ip{$sender_host_address}{+mx_hosts}{50}{10}}

received_headers_max = 30

RETRY_SECONDARY=F,90d,15m
RETRY_REST=F,2h,15m; G,16h,2h,1.5; F,4d,8h

acl_smtp_rcpt = acl_check_rcpt
acl_not_smtp_start = acl_check_not_smtp
acl_smtp_data = acl_check_data

host_lookup = *
helo_try_verify_hosts = !@ : !@[]
helo_allow_chars = _

# ClamAV - The Anti-Virus Scanner
av_scanner = clamd:/var/run/clamav/clamd.sock

# Custom 5s limiet.
rfc1413_query_timeout = 5s

# Mailman support, als per /usr/share/doc/mailman/README.EXIM.gz
MAILMAN_HOME=/var/lib/mailman
MAILMAN_WRAP=/usr/lib/mailman/mail/mailman
MAILMAN_USER=mailman
MAILMAN_GROUP=mailman
</pre>

=== Dovecot ===

Dovecot is een IMAP en POP3 server, wat inhoud dat het mailtjes kan ontvangen, iets wat best wel handig is om te hebben. Installeer dovecot op je mailserver als je dat nog niet gedaan hebt. Verander dan nu het volgende:

In /etc/dovecot/dovecot.conf:

*protocols = imap
*login_trusted_networks = <ip-adressen die je vertrouwd>

In /etc/dovecot/conf.d/10-mail.conf

*mail_location = maildir:~/Maildir
*lock_method = dotlock

In /etc/dovecot/conf.d/10-auth.conf

*disable_plaintext_auth = no
*auth_realms = aeskwadraat
*auth_default_realm = aeskwadraat
*auth_gssapi_hostname = <ipa-server>
*auth_krb5_keytab = /etc/dovecot/krb5.keytab
*auth_mechanisms = plain gssapi

en zet op het einde
<pre>userdb {
driver = static
args = uid=dovecot gid=dovecot home=/var/spool/mail/%u
}
</pre>

Maak nu op de ipa-server een service imap aan met de mailserver als host. Dit kan je doen via de webinterface. Voer vervolgens het volgende uit op de mailserver:
<pre>kinit admin
ipa-getkeytab -s <ipa-server> -p imap/<mailserver> -k /etc/dovecot/krb5.keytab
chown root:dovecot /etc/dovecot/krb5.keytab
chmod 640 /etc/dovecot/krb5.keytab
</pre>

Restart dovecot en zet hem standaard aan:
<pre>service dovecot restart
chkconfig dovecot on
</pre>

Zet tenslotte nog met system-config-firewall-tui 'imap over ssl' en 'mail (smtp)' aan, en voila! Je kan nu met ipa-users gebruik maken van IMAP om mailtjes te ontvangen!

Je kan eventueel in /etc/postfix/main.cf en /etc/dovecot/conf.d/10-mail.conf nog het een ander van waar de mail wordt opgeslagen veranderen.

=== Spamassassin ===

Spamassassin is een mailfilteringprogramma voor spam. Om het te installeren:
<pre>yum install spamassassin
</pre>

Maak nu de user en group spamd aan:
<pre>groupadd -g 5001 spamd
useradd -u 5001 -g spamd -s /sbin/nologin -d /var/lib/spamassassin spamd
mkdir /var/lib/spamassassin
chown spamd:spamd /var/lib/spamassassin
</pre>

Zet dan het volgende in /etc/mail/spamassassin/local.cf:
<pre>required_score 5.0
report_safe 0
rewrite_header Subject [***SPAM***]

# Enable the Bayes system
use_bayes 1
use_bayes_rules 1
# Enable Bayes auto-learning
bayes_auto_learn 1
</pre>

Verander nu in /etc/postfix/master.cf
<pre>smtp inet n - n - - smtpd
</pre>

in
<pre>smtp inet n - n - - smtpd -o content_filter=spamassassin
</pre>

en stop op het einde van master.cf:
<pre>spamassassin unix - n n - - pipe flags=R user=spamd argv=/usr/bin/spamc -e /usr/sbin/sendmail -oi -f ${sender} ${recipient}
</pre>

Restart nu spamassassin en postfix:
<pre>chkconfig spamassassin on
service spamassassin restart
service postfix restart
</pre>

=== Aliases ===

In postfix staan de locaties van de aliases in /etc/postfix/main.cf. Deze kan je vinden bij de regel 'alias_maps = ...'. Als je een nieuw aliasbestand wilt toevoegen, voeg dit dan ook toe bij deze regel als hash:<bestandslocatie>. Vergeet ook niet om dit toe te voegen bij alias_database!.

De aliases zelf staan geconfigureerd in de aliasbestanden die te vinden zijn onder /etc/postfix/alias/. Als je een nieuwe alias in een bestand hebt gezet moet je het db-bestand up-to-date make door het commando 'postalias *bestand*' uitvoeren. Let erop dat de bestandsnaam de naam van het bestand is wat je gewijzigd hebt, niet een bestand met extensie '.db'.

== Instellingen ==

=== Postfix ===

==== Mail relay ====

Postfix kan mail relayen naar een extern domein. Hiervoor is de volgende regel:
<pre>relay_domains = $mydestination, hash:/etc/postfix/domains.relay
</pre>

In het bestand /etc/postfix/domains.relay staat de lijst van alle externe domains waar mail naar toe gerelayed wordt. Als je iets in het bestand wijzigt, vergeet dan niet om daarna het commando
<pre>postmap /etc/postfix/domains.relay
</pre>

uit te voeren.

==== Whitelist ====

Postfix kan gebruik maken van een whitelist. Zorg hiervoor dat er het volgende in /etc/postfix/main.cf staat:
<pre>smtpd_client_restrictions = check_client_access hash:/etc/postfix/client.access
</pre>

In het bestand /etc/postfix/client.access staat de lijst van alle domains die geweigerd en toegelaten worden. Als je hier iets in verandert, vergeet dan niet om uit te voeren
<pre>postmap /etc/postfix/access.client
</pre>

== SquirrelMail ==

SquirrelMail is een webmail-client.

=== SquirrelMail installeren ===

Installeer eerst natuurlijk Squirrelmail:
<pre>yum install squirrelmail
</pre>

Zorg ervoor dat httpd standaard aan staat en start httpd:
<pre>chkconfig httpd on
service httpd start
</pre>

Verander nu het volgende in /etc/squirrelmail/config.php:
<pre>$org_name = "A-Eskwadraat";
$org_logo = SM_PATH . 'images/sm_logo.png';
$org_logo_width = '308';
$org_logo_height = '111';
$org_title = 'A-Eskwadraat SquirrelMail $version";
$signout_page = 'vm-mail.a-eskwadraat.nl';

$domain = 'circle.a-eskwadraat.nl';
$imapServerAddress = 'localhost';
$useSendmail = false;
$smtpServerAddress = 'localhost';
$pop_before_smtp = false;

</pre>

Zet nu het A-Eskwadraat logo in de squirrelmail config map.
<pre>setsebool -P httpd_can_network_connect 1
</pre>

== RoundcubeMail ==

Roundcube is ook een webmail client.

=== Installeren ===

Op vm-salt-master staat een configuratie voor een Roundcube mail VM met een korte readme. Deze zorgt ervoor dat httpd, roundcubemail en mariadb geinstalleerd staan. Salt een VM met deze configuratie.
<pre>salt '$hostname' state.highstate
</pre>

Laat vervolgens httpd van die VM door de firewall heen. Daarna moet de database voor Roundcube geinitialiseerd worden. Dit gaat met mysql.
<pre>CREATE DATABASE roundcubemail;
GRANT ALL PRIVILEGES on roundcubemail.* TO roundcube@localhost IDENTIFIED BY '$password';
FLUSH PRIVILEGES;
</pre>

Nu moet de timezone nog even ingesteld worden in /etc/php.ini op de roundcube VM. Daarna moeten er nog de juiste tables in de database worden gezet. Dit kan door op de nieuwe VM de bestanden in /etc/roundcubemail/databasefiles te runnen met mysql.
<pre>mysql roundcubemail < mysql.initial.sql
</pre>
[[Category:Sysop]]