1. Пара слов от автора
В комментариях к прошлой статье мне задали интересный вопрос об автоматическом формировании списков рассылки на основе групп безопасности AD. Есть задача – есть решение. Правда, оговорюсь сразу, решение несколько костыльное (почему – читать далее), но рабочее. Итак, поехали.
2. Исходные данные
ОС сервера: CentOS 7
Домен Zimbra: zimbramail.home.local
Путь монтирования шары на хосте Zimbra: /mnt/ZM/
3. Настройка
1) Монтируем шару Windows к нашему Linux серверу. Это нужно для упрощения и автоматизации передачи данных из Windows PowerShell в Linux Bash. Процедура монтирования была описана в предыдущей статье. Не буду повторяться
2) Создаем в AD отдельное OU, в котором создаем группы, на основе которых будут созданы списки рассылки в Zimbra. Имя группы = имя списка рассылки
3) Добавляем в группы, созданные в новом OU, пользователей или группы безопасности, на основе которых будут наполняться списки рассылки в Zimbra. Скрипт отрабатывает рекурсивно, что значит, что он соберет все данные о пользователях, состоящих в группах, которые добавлены в группы в целевом OU. Подробнее о выводе команды Get-ADGroupMember
4) Создаем скрипт сбора данных из Active Directory
5) Создаем скрипт добавления листов рассылки и их наполнения пользователями на основе полученных данных в предыдущем скрипте
6) Наслаждаемся
3.1. По поводу OU
Я создал OU “ZimbraDL” в корне домена и запретил ему наследование групповых политик, чтобы эти группы оставались обособленными. Они не будут участвовать в жизни домена никак, помимо формирования Distribution Lists в Zimbra Collaboration OSE.
4. Скрипт на PowerShell для сбора данных из AD
$Path = "C:ZMZimbraDL"
#Очистка каталога
if(test-path $Path)
{
Remove-Item $Path -Recurse -Force
}
#Создание рабочих директорий
if(!(test-path $Path))
{
New-Item -ItemType Directory -Force -Path $Path
}
if(!(Test-Path $PathGroups))
{
New-Item -ItemType Directory -Force -Path $PathGroups
}
if(!(Test-Path $PathUsers))
{
New-Item -ItemType Directory -Force -Path $PathUsers
}
if(!(Test-Path $PathUsersTemp))
{
New-Item -ItemType Directory -Force -Path $PathUsersTemp
}
if(!(Test-Path $PathGroupslistgrp))
{
New-Item -ItemType Directory -Force -Path $PathGroupslistgrp
}
if(!(Test-Path $PathUserslistusr))
{
New-Item -ItemType Directory -Force -Path $PathUserslistusr
}
#Пауза
sleep 2
#Создание списка групп
Import-Module ActiveDirectory
Get-AdGroup -filter * -SearchBase "OU=ZimbraDL,DC=home,DC=local" | sort Name | select Name | Out-File "$PathGroupsGetGroupsAD.txt"
#Форматирование списка групп
(Get-Content "$PathGroupsGetGroupsAD.txt") -notmatch "Name" | where {$_ -ne ""} | where {$_ -ne "--"} | Where-Object {$_ -notmatch '-'} | out-file "$PathGroupsGetGroupsAD.txt"
$File = @(Get-Content $PathGroupsGetGroupsAD.txt)
foreach ($File1 in $File)
{
$string=$File1.TrimStart(' ')
$string=$string.TrimEnd(' ') | Out-File $PathGroupsGroupsList.txt -Append
}
#Создание структуры групп
$File = @(Get-Content "$PathGroupsGetGroupsAD.txt")
foreach ($File1 in $File)
{
New-Item -ItemType File -Force -Path "$PathGroupslistgrp$File1"
}
#Создание файлов со списком пользователей для каждой группы
$GroupName = @(Get-Content $PathGroupsGroupsList.txt)
Foreach ($Group in $GroupName)
{
Get-ADGroupMember $Group -recursive | ft SamAccountName | out-file "$PathUsersTemp$Group.txt" -Append
(get-content "$PathUsersTemp$Group.txt") -notmatch "Name" | where {$_ -ne ""} | where {$_ -ne "--"} | Where-Object {$_ -notmatch '-'} | out-file "$PathUsersTemp$Group.txt"
$File=@(Get-Content $PathUsersTemp$Group.txt)
foreach ($File1 in $File)
{
$string=$File1.TrimEnd(' ') | Out-File "$PathUsersTemp$Group.txt" -Append
#Создание структуры пользователей
$Var = @(Get-Content "$PathUsersTemp$Group.txt")
foreach ($Var1 in $Var)
{
New-Item -ItemType Directory -Force -Path $PathUserslistusr$Group
New-Item -ItemType File -Force -Path "$PathUserslistusr$Group$Var1"
}
}
}
4.1. Как работает скрипт
1) Скрипт запускается либо руками после изменения данных в AD, либо шедалером, если «не к спеху». Сначала происходит проверка существования и удаление рабочей директории, если она существует. Это нужно, чтобы в процессе работы данные не задвоились.
2) PoSh смотрит в указанное OU, считывает группы пользователей, находящиеся в нем и записывает их в файл GetGroupsAD.txt
3) Отбрасывает из полученного файла все лишнее (PoSh пишет в файл весь свой вывод, так что в изначальном выводе команды первой строкой идет Name, второй строкой разделитель "----", и только после этого перечисляются группы по одной на строку), результатом чего является другой файл GroupsList.txt
4) Далее формируются директории с именами групп в каталоге C:ZMZimbraDLGroupslistgrp по именам групп.
5) В полученных директориях создаются файлы с именами пользователей, входящих в состав соответствующих групп в AD
4.1.1. Почему так сложно?
Это и есть то самое «костыльное, но рабочее решение», о котором я упоминал в самом начале. Проблема в том, что у меня просто не получилось передать в Bash текстовые файлы вывода команд PowerShell. При каждой попытке парсинга я получал странные результаты, начиная от нечитаемых символов, которые не воспринимались командлетом zmprov (что логично), заканчивая тем, что файлы вообще очищались.
Если кто-то знает, как можно передать в Bash текстовые файлы, созданные в PoSh – милости прошу в коменты!
5. Скрипт на Bash для создания списков рассылки
#!/bin/bash
#Определение переменных
#Путь к рабочему каталогу
Path="/mnt/ZM/ZimbraDL"
#имя домена Zimbra
Domain="zimbramail.home.local"
#путь к командлету zmprov
zmprov="/opt/zimbra/bin/zmprov"
#путь к лог-файлу
log="/mnt/ZM/DLlog.txt"
#путь ко временному файлу со списком групп
DLnames="/mnt/ZM/DLnames"
#путь ко временному файлу со списком пользователей
UserNames="/mnt/ZM/Usernames"
#конец блока переменных
echo "Запись списка групп..."
ls $Path/Users/listusr > $DLnames
if [ $? -eq 0 ]; then
echo -n "$(tput hpa $(tput cols))$(tput cub 6) [OK]"
echo
echo -en "ls directory for Groups correct $(date +%T)n" >> $log
else
echo -n "$(tput hpa $(tput cols))$(tput cub 6) [FAIL]"
echo
echo -en "ls directory for Groups INcorrect $(date +%T)n" >> $log
fi
#Удаление списков рассылки
echo "Удаление обновляемых списков рассылки"
for DLname in $( cat $DLnames); do
#Проверка существования списка рассылки
echo "Проверка существования списка рассылки $DLname..."
Result=$($zmprov gdl $DLname@$Domain)
if [ $? -eq 0 ]; then
echo -n "$(tput hpa $(tput cols))$(tput cub 6)[OK]"
echo
echo -en "DL $DLname exist $(date +%T)n" >> $log
#Удаление списка рассылки
echo -en "Start deleting DL for group $DLname $(date +%T)n" >> $log
echo "Удаление списка рассылки $DLname..."
$zmprov ddl $DLname@$Domain
if [ $? -eq 0 ]; then
echo -n "$(tput hpa $(tput cols))$(tput cub 6) [OK]"
echo
echo -en "DL for group $DLname is deleted in $(date +%T)n" >> $log
else
echo -n "$(tput hpa $(tput cols))$(tput cub 6) [FAIL]"
echo
echo -en "DL for group $DLname is NOT deleted in $(date +%T)n" >> $log
fi
else
echo -n "$(tput hpa $(tput cols))$(tput cub 6)[FAIL]"
echo
echo -en "DL $DLname not exist! $(date +%T)n" >> $log
fi
done
for DLname in $( cat $DLnames); do
#Создание списка рассылки
echo -en "Start create DL for group $DLname $(date +%T)n" >> $log
echo "Создание списка рассылки для группы AD $DLname..."
$zmprov cdl $DLname@$Domain
if [ $? -eq 0 ]; then
echo -n "$(tput hpa $(tput cols))$(tput cub 6) [OK]"
echo
echo -en "DL for group $DLname is created in $(date +%T)n" >> $log
else
echo -n "$(tput hpa $(tput cols))$(tput cub 6) [FAIL]"
echo
echo -en "DL for group $DLname is NOT created in $(date +%T)n" >> $log
fi
#Наполнение списка рассылки
echo "Наполнение списка рассылки"
echo "Запись списка пользователей группы $DLname в массив..."
ls $Path/Users/listusr/$DLname > $UserNames
if [ $? -eq 0 ]; then
echo -n "$(tput hpa $(tput cols))$(tput cub 6) [OK]"
echo
echo -en "ls directory for Users correct $(date +%T)n" >> $log
else
echo -n "$(tput hpa $(tput cols))$(tput cub 6) [FAIL]"
echo
echo -en "ls directory for Users INcorrect $(date +%T)n" >> $log
fi
for UserName in $( cat $UserNames); do
echo "Проверка существования ящика для пользователя $UserName..."
Result=$($zmprov gmi $UserName@$Domain)
if [ $? -eq 0 ]; then
echo -n "$(tput hpa $(tput cols))$(tput cub 6) [OK]"
echo
echo -en "MilBox for user $UserName exist $(date +%T)n" >> $log
echo "Добавление пользователя $UserName в список рассылки $DLname@$Domain..."
$zmprov adlm $DLname@$Domain $UserName@$Domain
if [ $? -eq 0 ]; then
echo -n "$(tput hpa $(tput cols))$(tput cub 6) [OK]"
echo
echo -en "User $UserName added in $DLname@$Domain correctly in $(date +%T)n" >> $log
else
echo -n "$(tput hpa $(tput cols))$(tput cub 6) [FAIL]"
echo
echo -en "DL for group $DLname is NOT created in $(date +%T)n" >> $log
fi
else
echo -n "$(tput hpa $(tput cols))$(tput cub 6) [FAIL]"
echo
echo -en "MilBox for user $UserName is NOT exist $(date +%T)n" >> $log
fi
done
done
#Очистка временных файлов
echo "Очистка временных файлов"
echo "Очистка файла со списком групп..."
echo -n > $DLnames
if [ $? -eq 0 ]; then
echo -n "$(tput hpa $(tput cols))$(tput cub 6)[OK]"
echo
echo -en "File $DLnames was successfull cleared in $(date +%T)n" >> $log
else
echo -n "$(tput hpa $(tput cols))$(tput cub 6) [FAIL]"
echo
echo -en "File $DLnames was NOT cleared in $(date +%T)n" >> $log
fi
echo "Очистка файла со списком пользователей..."
echo -n > $UserNames
if [ $? -eq 0 ]; then
echo -n "$(tput hpa $(tput cols))$(tput cub 6)[OK]"
echo
echo -en "File $UserNames was successfull cleared in $(date +%T)n" >> $log
else
echo -n "$(tput hpa $(tput cols))$(tput cub 6) [FAIL]"
echo
echo -en "File $UserNames was NOT cleared in $(date +%T)n" >> $log
fi
#Удаление директорий, содержащих структуру групп и пользователей
echo "Удаление рабочего каталога $Path для очистки свободного пространства..."
rm -rf $Path
if [ $? -eq 0 ]; then
echo -n "$(tput hpa $(tput cols))$(tput cub 6)[OK]"
echo
echo -en "Directory $Path was seccessfull deleted in $(date +%T)n" >> $log
else
echo -n "$(tput hpa $(tput cols))$(tput cub 6) [FAIL]"
echo
echo -en "Directory $Path was NOT deleted in $(date +%T)n" >> $log
fi
#запись в лог-файл времени окончания обновления списков рассылки
echo -en "Job complete in $(date +%T)n" >> $log
echo -en "____________________________________n" >> $log
5.1. Как работает скрипт
1) Записать в файл список групп
2) Проверить существование списков рассылки в Zimbra, при существовании – удалить его
3) Поочередно создать списки рассылки на основе списка групп, наполняя каждый из них пользователями (на экран выводится ID списка рассылки, это стандартный вывод командлета zmprov при создании DL). При этом проверяется существование почтовых ящиков пользователей в Zimbra, и если ящика не существует, то пользователь не будет добавлен в список рассылки. Можно, конечно, создать пользователю новый почтовый ящик и добавить его в список рассылки, но я исходит из того, что Zimbra autoprov работает в режиме Eager, и если пользователь не создался автоматически, то ему и нечего делать в системе
4) Очистить временные файлы
5) Удалить рабочую директорию
6. Заключение
В целом, задача не сложная, проблема лишь в костыльном методе «передачи данных» из PowerShell в Bash. Если избавиться от создания кучи файликов и директорий, используя вместо этого текстовые файлы с наполнением, как это планировалось вначале, то все выглядит довольно красиво. Если данная проблема будет решена — я перепишу скрипты в более правильный вид и изменю статью.
7. P.S.:
Это третья статья из серии «как я «Zimbra» внедрял». Первая, про внедрение, LDAP-авторизацию и автоматическое создание ящиков для пользователей AD, вот тут. Вторая, про настройку резервного копирования и восстановления Zimbra целиком и отдельными ящиками – тут.
Автор: Сысоев Андрей
На хабре есть переделанные скрипты. Кому интересно – заходите в первоисточник.