Tommes: Tommes verschob die Seite Virtuelle E-Mail User erstellen nach Archiv:Virtuelle E-Mail User erstellen

2025-03-15T07:19:08Z

Tommes verschob die Seite Virtuelle E-Mail User erstellen nach Archiv:Virtuelle E-Mail User erstellen

← Nächstältere Version	Version vom 15. März 2025, 07:19 Uhr
(kein Unterschied)

imported>Jahlives: /* Quellcode */

2010-09-12T12:37:38Z

Quellcode

← Nächstältere Version		Version vom 12. September 2010, 12:37 Uhr
Zeile 320:		Zeile 320:
	exit		exit
	</pre>		</pre>
			[[Category:Mailstation]]

imported>Jahlives: /* Mailbenutzer erstellen */

2010-04-18T14:46:43Z

Mailbenutzer erstellen

← Nächstältere Version		Version vom 18. April 2010, 14:46 Uhr
Zeile 7:		Zeile 7:
	=== config ===		=== config ===
	Die Config Sektion des Codes muss man sich nach seinen Gegebenheiten anpassen. Das Script schreibt in Systemfiles und darum sind alle Pfade von Files die geschrieben werden im Auslieferungszustand auf /tmp gesetzt. Damit kann man das Script ausprobieren und schauen ob die generierten/angepassten Files in /tmp soweit korrekt sind. <br />		Die Config Sektion des Codes muss man sich nach seinen Gegebenheiten anpassen. Das Script schreibt in Systemfiles und darum sind alle Pfade von Files die geschrieben werden im Auslieferungszustand auf /tmp gesetzt. Damit kann man das Script ausprobieren und schauen ob die generierten/angepassten Files in /tmp soweit korrekt sind. <br />
	Im folgenden eine kurze Beschreibung der Konfig		Im folgenden eine kurze Beschreibung der Konfig (diese bezieht sich auf die [http://svn.brain-force.ch/filedetails.php?repname=Linux+Stuff&path=%2Fcreate_mailuser%2Fdevel%2FcreateMaildir devel-Version] des Scripts!)
	==== global ====		==== global ====
	===== mail =====		===== mail =====

imported>Jahlives: Die Seite wurde neu angelegt: „== Mailbenutzer erstellen == Wenn ihr neue E-Mail Benutzer erstellen wollt, dann geht das am Schnellsten via dem DSM. Der Nachteil dieser Lösung ist es, dass man…“

2010-04-18T14:43:40Z

Die Seite wurde neu angelegt: „== Mailbenutzer erstellen == Wenn ihr neue E-Mail Benutzer erstellen wollt, dann geht das am Schnellsten via dem DSM. Der Nachteil dieser Lösung ist es, dass man…“

Neue Seite

== Mailbenutzer erstellen ==
Wenn ihr neue E-Mail Benutzer erstellen wollt, dann geht das am Schnellsten via dem DSM. Der Nachteil dieser Lösung ist es, dass man dann für jeden E-Mail Benutzer einen lokalen Systemaccount einrichten muss. Dafür gibt es virtuelle Benutzer, welche es ermöglichen alle Mailprozesse unter einem lokalen User fahren zu lassen. Das hat den Vorteil, dass man für neue E-Mail Nutzer nur noch einen virtuellen Benutzer für die Mailserver anlegen muss. Das System (also /etc/passwd) kennt diese Mailbenutzer jedoch nicht. Darum virtuell ;)
Mehr dazu wie man virtuelle Nutzer für [[Virtuelle_E-Mail_Nutzer_mit_postfix|Postfix]] und [[Virtuelle_E-Mail_Nutzer_mit_dovecot|Dovecot]] erstellen kann.

Da man virtuelle Benutzer nicht über den DSM anlegen kann, habe ich folgendes kleine Script geschrieben, welches dem admin beim Einrichten der User hilft.
Ihr könnt den Code in [http://svn.brain-force.ch/listing.php?repname=Linux+Stuff&path=%2Fcreate_mailuser%2F meinem svn finden] oder [[#Quellcode|weiter unten]] direkt in diesem Beitrag
=== config ===
Die Config Sektion des Codes muss man sich nach seinen Gegebenheiten anpassen. Das Script schreibt in Systemfiles und darum sind alle Pfade von Files die geschrieben werden im Auslieferungszustand auf /tmp gesetzt. Damit kann man das Script ausprobieren und schauen ob die generierten/angepassten Files in /tmp soweit korrekt sind. <br />
Im folgenden eine kurze Beschreibung der Konfig
==== global ====
===== mail =====
Legt das Root Verzeichnis der virtuellen User fest
<pre>
mail=/tmp/dovecot
</pre>
===== user =====
Gibt den Usernamen des lokalen Benutzers an unter dessen Kennung die virtuellen Benutzer "laufen". Wird für den chown auf dem neuangelegten Mailbox Verzeichnis benötigt
<pre>
user=vmail
</pre>
===== group =====
Siehe <code>user</code>
<pre>
group=vmail
</pre>
==== Dovecot ====
Config für Dovecot
===== dovecot_pw_file =====
Pfad zum Dovecot Passwort File, welches die virtuellen User und deren Passworte enthält (gebt hier NIEMALS /etc/passwd an!!!)
<pre>
dovecot_pw_file=/tmp/dovecot/passwd
</pre>
===== dovecotpw =====
Pfad zum dovecotpw Binary. Dieses wird jedoch nicht in der Firmware (Mailstation) mitgeliefert. Man kann es sich jedoch aus den Quellen selbe kompillieren oder dieses Script mit dem Parameter <code>-i</code> oder <code>--install</code> aufrufen. Dann wird dovecotpw aus dem ipkg dovecot installiert.
<pre>
dovecotpw=/usr/syno/mailstation/libexec/dovecot/dovecotpw
</pre>
===== scheme =====
Legt das zu verwendende Schema bei der Erstellung der Passworte für die virtuellen User fest.
<pre>
scheme=SSHA
</pre>
==== Postfix ====
Konfiguration der Postfix-Seite
===== postfix =====
Pfad zum Postfix Binary. Wird zum Neuladen der Konfig nach Erstellen der Nutzer benötigt
<pre>
postfix=/usr/syno/mailstation/sbin/postfix
</pre>
===== postfix_postmap =====
Pfad zum postmap Kommando. Dieses wird benötigt um aus den virtuellen Userfiles des Postfix die benötigten db Files zu erstellen
<pre>
postfix_postmap=/usr/syno/mailstation/sbin/postmap
</pre>
===== postfix_vmailbox =====
Legt den Pfad für das Postfix vmailbox File fest
<pre>
postfix_vmailbox=/tmp/dovecot/vmailbox
</pre>
===== postfix_virtual =====
Pfad zum Postfix File mit den Alias Namen der virtuellen Benutzer
<pre>
postfix_virtual=/tmp/dovecot/virtual
</pre>
===== postfix_main =====
Der Pfad zum main.cf File des Postfix Servers. Darin wird nichts geschrieben! Das Script nutzt das File um zu prüfen, ob die im Script angegebenen Files auch in der Postfix Config korrekt gesetzt sind
<pre>
postfix_main=/usr/syno/mailstation/etc/main.cf
</pre>
=== Script benutzen ===
Das Script ist ein "einfaches" Shellscript für die Kommandokonsole. Es sollte von root ausgeführt werden. Sonst bestehen keine Schreibrechte auf die benötigten Konfigfiles.
==== Parameter ====
Es gibt einige Parameter, die ich hier kurz erläutern möchte
===== -i|--install =====
Wenn dovecotpw nicht vorhanden ist, kann man mit diesem Parameter das Script anweisen dovecotpw von ipkg zu laden. Dabei wird natürlich ein funktionierendes ipkg und eine Internetverbindung benötigt
===== -h|--help =====
Zeigt die "Hilfe" des Scripts an
===== user =====
Legt den Usernamen des neu zu installierenden E-Mail Nutzers fest. Es handelt sich hierbei nur um den <code>Local Part</code> der Adresse, also alles vor dem <code>@</code>!
===== domain =====
Legt den Domainnamen des Nutzers fest. Es handelt sich hierbei nur um den <code>Domain Part</code> der Adresse also alles hinter dem <code>@</code>!
===== password =====
Dürfte selbsterklärend sein, wofür dieser Parameter ist ;-)
==== Aufrufen ====
Der Aufruf des Scriptes ist ziemlich einfach
<pre>
createMaildir foo bar.tld secret
</pre>
erstellt im <code>mail</code> Verzeichnis aus der Konfiguration - falls nicht vorhanden - das Verzeichnis bar.tld für die Domain bar.tld an. Darin wird das Verzeichnis foo für den User foo erstellt. Dortdrin wird dann das .Maildir Verzeichnis angelegt, wo die E-Mails drin landen. Die Mailbox also. secret wird als Passwort für den User <code>foo@bar.tld</code> in <code>dovecot_pw_file</code> verwendet. <br />
Bei obigem Aufruf wird also im Mailroot die folgende Struktur angelegt
<pre>
/volume1/homes/vmail
+ bar.tld
++ foo
+++ .Maildir
</pre>
=== Quellcode ===
<pre>
#!/bin/sh

###########################################################################
# #
# createMaildir Script #
# #
# <author> tobster@brain-force.ch #
# <version> Version 0.1b #
# <date> 4th April 2010 #
# <license> GNU GPL V 3 #
# <url> http://svn.brain-force.ch/linuxstuff #
# #
# This script only works IF local mail derlivery is performed via deliver #
# Check your system whether you have deliver on it. Otherwise you have to #
# compile it from Dovecot source which can be found here: #
# #
# http://www.dovecot.org/download.html #
# #
# Furthermore this script requieres dovecotpw to be installed. If missing #
# the code can be obtained from the source above. Or you can call the #
# script with -i or --install parameter to get dovecotpw from ipkg #
# #
# This code is under GPL license. Feel free to modify as you may wish #
# #
# See config section for more details #
# #
###########################################################################

#### BEGIN OF "CONFIG" SECTION ####
## change the following variables to fit your enviroment
## if you don't have dovecotpw on your system just set the dovecotpw variable to a valid value on your box
## and call the script with -i or --install parameter. The script will install dovecotpw to the location specified in $dovecotpw
##
## root directory for mailboxes.
mail=/tmp/dovecot
##
# path to the dovecot password file. This implies that you have deliver installed or compiled from source
dovecot_pw_file=/tmp/dovecot/passwd
##
# Variables for interaction with postfix server
postfix=/usr/syno/mailstation/sbin/postfix
postfix_postmap=/usr/syno/mailstation/sbin/postmap
postfix_vmailbox=/tmp/dovecot/vmailbox
postfix_virtual=/tmp/dovecot/virtual
postfix_main=/usr/syno/mailstation/etc/main.cf
##
## user and group for chown on mailbox directory
user=vmail
group=vmail
##
## path to dovecotpw binary (see comment on top!) and the desired password scheme to use
## you can check the schemes your system supports by dovecotpw -l
dovecotpw=/usr/syno/mailstation/libexec/dovecot/dovecotpw
scheme=SSHA
##
## IMPORTANT: The installed dovecotpw file is made for Dovecot V 1.2
## So if you use Dovecot < 1.2 then you should NOT USE one of the
## new password schemes introduced in 1.2. like ex SSHA256.
## SSHA and MD5 work fine!
#### END OF "CONFIG" SECTION ####

if test "$*" = '-i' || test "$*" = '--install'; then
echo "create tmp dir and cd into"
mkdir /tmp/dovecot
cd /tmp/dovecot
echo "download dovecot from ipkg"
ipkg download dovecot > /dev/null 2>&1
f=$(find ./ -type f | grep ipk)
echo "download done. unpacking dovecot files"
mv ./$f ./dovecot.tar.gz
tar -xzf ./dovecot.tar.gz
tar -xzf ./data.tar.gz
echo "copy file to destination and clean up tmp files"
cp -f ./opt/sbin/dovecotpw $dovecotpw
rm -R /tmp/dovecot
echo
echo "installation complete. You should see to output of available schemes from dovecotpw now:"
$dovecotpw -l
echo
echo " ###########################################################################"
echo " ## ##"
echo " ## IMPORTANT: The installed dovecotpw file is made for Dovecot V 1.2 ##"
echo " ## So if you use Dovecot < 1.2 then you should NOT USE one of the ##"
echo " ## new password schemes introduced in 1.2. like ex SSHA256. ##"
echo " ## SSHA and MD5 work fine! ##"
echo " ## ##"
echo " ###########################################################################"
echo
exit
elif test ! -e $mail || test ! -d $mail; then
echo "ERROR: $mail could not be found"
exit
elif test ! -e $dovecot_pw_file; then
echo "ERROR: $dovecot_pw_file could not be found. Check config!"
exit
elif test ! -e $dovecotpw || test ! -x $dovecotpw; then
echo "ERROR: $dovecotpw not found or not executable."
echo " Ensure that dovecotpw is set correctly"
exit
elif test ! -e $postfix_postmap || test ! -x $postfix_postmap; then
echo "ERROR: Check that $postfix_postmap exists and is executable."
exit
elif test ! -e $postfix_virtual || test ! -e $postfix_vmailbox; then
echo "ERROR: Ensure that $postfix_virtual AND $postfix_vmailbox exist"
exit
elif test ! -e $postfix || test ! -x $postfix; then
echo "ERROR: $postfix must be present and executable"
exit
elif test -z $(cat /etc/passwd | grep "$user:"); then
echo "ERROR: $user not found in /etc/passwd"
exit
elif test -z $(cat /etc/group | grep "$group:"); then
echo "ERROR: $group not found in /etc/groups"
exit
elif test -e $dovecotpw && test -z "$($dovecotpw -l | grep $scheme)"; then
echo "ERROR: your system does not support $scheme encryption"
echo " the following schemes are supported on your platform:"
echo $($dovecotpw -l)
exit
elif test -z $(cat $postfix_main | grep ^virtual_mailbox_maps | grep $postfix_vmailbox); then
echo "ERROR: $postfix_vmailbox not found in \"virtual_mailbox_maps\" within $postfix_main"
exit
elif test -z $(cat $postfix_main | grep ^virtual_alias_maps | grep $postfix_virtual); then
echo "ERROR: $postfix_virtual not found in \"virtual_alias_maps_\" within $postfix_main"
exit
elif test -z $(cat $postfix_main | grep ^virtual_mailbox_base | grep $mail); then
echo "$mail not found in \"virtual_mailbox_root\" within $postfix_main"
exit
fi
uname=''
domain=''
pw=''
if test $# -eq 3; then
uname=$(echo $1 | grep ^[a-zA-Z0-9._\-]*$)
domain=$(echo $2 | grep ^[a-zA-Z0-9._\-]*$)
pw=$3
if test "$uname" = '' || test "$domain" = ''; then
echo "Only chars in [a-zA-Z0-9._\-] are allowed for username or domain"
exit
elif test -e "$mail/$domain/$uname"; then
echo "$mail/$domain/$uname exists already. Nothing to be done. Exit"
exit
else
echo "create $mail/$domain/$uname/.Maildir and chown to $user:$group"
mkdir -p "$mail/$domain/$uname/.Maildir"
chown -R $user:$group "$mail/$domain"
echo $uname@$domain:$($dovecotpw -p "$pw" -s $scheme) >> $dovecot_pw_file
echo $uname@$domain $domain/$uname/.Maildir >> $postfix_vmailbox
echo $uname@$domain $uname@$domain >> $postfix_virtual
$postfix_postmap $postfix_vmailbox
$postfix_postmap $postfix_virtual
echo "Account successfully created. See details:"
echo "Username: $uname@$domain"
echo "Files created"
ls -al "$mail/$domain"
ls -al "$mail/$domain/$uname"
echo "Line from $dovecot_pw_file"
cat $dovecot_pw_file | grep $uname@$domain
echo "Line from $postfix_vmailbox"
cat $postfix_vmailbox | grep "$domain/$uname/.Maildir"
echo "Line from $postfix_virtual"
cat $postfix_virtual | grep $uname@$domain
echo
echo "Check $postfix_main"
if test -z $(cat $postfix_main | grep ^virtual_mailbox_domains | grep $domain); then
f=$(cat $postfix_main | grep ^virtual_mailbox_domains)
echo $f $domain
fi
echo "Reload postfix config files" $($postfix reload)
fi
elif test "$*" = '-h' || test "$*" = '--help'; then
echo
echo " ###########################################################################"
echo " # #"
echo " # Usage: #"
echo " # createMaildir [-i|--install] [-h|--help] <user> <domain> <password> #"
echo " # #"
echo " # -i | --install Installs the necessary dovecotpw from ipkg. #"
echo " # Needs ipkg to be installed! #"
echo " # -h | --help Show this message #"
echo " # <user> Username of the account to be created. #"
echo " # IMPORTANT: Username only, no domain part #"
echo " # <domain> Domainname for the user account. #"
echo " # Folders are created like this /path/<domain>/<user> #"
echo " # <password> Password for the account #"
echo " # #"
echo " # <user>, <domain> and <password> are ALL MANDATORY #"
echo " # if a useraccount is to be created #"
echo " # Example usage: createMaildir myuser mydomain mysecret #"
echo " # #"
echo " ###########################################################################"
exit
else
echo
echo " ###########################################################################"
echo " # #"
echo " # createMaildir Script #"
echo " # #"
echo " # <author> tobster@brain-force.ch #"
echo " # <version> Version 0.1b #"
echo " # <date> 4th April 2010 #"
echo " # <license> GNU GPL V 3 #"
echo " # <url> http://svn.brain-force.ch/linuxstuff #"
echo " # #"
echo " # This script helps admins to create new users for their mailserver. #"
echo " # This script only works IF local mail derlivery is performed via deliver #"
echo " # Check your system whether you have deliver on it. Otherwise you have to #"
echo " # compile it from Dovecot source which can be found here: #"
echo " # #"
echo " # http://www.dovecot.org/download.html #"
echo " # #"
echo " # Furthermore this script requieres dovecotpw to be installed. If missing #"
echo " # the code can be obtained from the source above. Or you can call the #"
echo " # script with -i or --install parameter to get dovecotpw from ipkg #"
echo " # #"
echo " # This code is under GPL license. Feel free to modify as you may wish #"
echo " # #"
echo " ###########################################################################"
echo
fi
exit
</pre>

Archiv:Virtuelle E-Mail User erstellen - Versionsgeschichte

Tommes: Tommes verschob die Seite Virtuelle E-Mail User erstellen nach Archiv:Virtuelle E-Mail User erstellen

imported>Jahlives: /* Quellcode */

imported>Jahlives: /* Mailbenutzer erstellen */

imported>Jahlives: Die Seite wurde neu angelegt: „== Mailbenutzer erstellen == Wenn ihr neue E-Mail Benutzer erstellen wollt, dann geht das am Schnellsten via dem DSM. Der Nachteil dieser Lösung ist es, dass man…“