<?xml version="1.0"?>
<api>
  <query-continue>
    <allpages gapcontinue="VPS" />
  </query-continue>
  <query>
    <pages>
      <page pageid="59" ns="0" title="Sphelper">
        <revisions>
          <rev contentformat="text/x-wiki" contentmodel="wikitext" xml:space="preserve">sp-helper — это средство для автоматического создания unix-пользователей (как следствие, почтовых ящиков) и samba-пользователей синхронно с созданием пользователей в Школьном портале. Это же касается задания (сброса) и изменения их паролей.

&lt;pre&gt;
# для начала использования этого сервиса нужен samba-пользователь.
# есть ли пользователь для sp-helper? узнаём командой:
pdbedit -L | grep sp-helper

# если нет, создаём

# придумайте и запишите страшно длинный пароль
# например, с помощью команды
pwgen --secure 64 1

# создаём пользователя с паролем
smbpasswd -s -a sp-helper

# включаем пользователя в группу root:
usermod -G root sp-helper

# проверка (должно ответить root)
id -n -g sp-helper
&lt;/pre&gt;

В файле конфигурации (см. [[Файл конфигурации]]) должны быть заданы настройки:
# sphelper_smbuser = sp-helper
# sphelper_smbpass = тот_самый_страшный_пароль

По умолчанию sp-helper устанавливается на сервере вместе с порталом.

== sphelper на другом сервере ==

Можно установить sp-helper на другой сервер, где нет портала.

Для этого нужно скопировать файлы:
&lt;pre&gt;
/opt/xxi/sphelper.pl
/etc/xinetd.d/sphelper
&lt;/pre&gt;

Выполните в bash от пользователя root скрипт:

&lt;pre&gt;
#!/bin/bash

SPHELPER_SERVICES_LINE='sphelper 7890/tcp'
if ! grep -q &quot;$SPHELPER_SERVICES_LINE&quot; /etc/services; then
	echo &quot;$SPHELPER_SERVICES_LINE&quot; &gt;&gt; /etc/services
fi
chown root.root /opt/xxi/sphelper.pl
chmod 750       /opt/xxi/sphelper.pl
service xinetd restart
&lt;/pre&gt;

Файл конфигурации портала нужно скопировать на сервер, куда вы ставите sp-helper.

В нём должны быть параметры, равные параметрам на основном сервере:
# db_user
# db_pass

На сервере с порталом необходимо задать настройки:
# create_dc_users = sp-helper
# sp_helper_host = IP_сервера_куда_вы_перенесли_sphelper

Пример файла конфигурации для sphelper
&lt;pre&gt;
# SP config for sphelper only
sphelper_smbuser = sphelper
sphelper_smbpass = ***
db_user = SYSDBA
db_pass = ***
&lt;/pre&gt;

== Журнал ==

&lt;pre&gt;
/var/log/sphelper.log
&lt;/pre&gt;

== Проверки ==

sphelper слушает порт?

&lt;pre&gt;
netstat -ntlp|grep 7890
# пример результата
# tcp        0      0 0.0.0.0:7890            0.0.0.0:*               LISTEN      25855/xinetd
&lt;/pre&gt;

Perl-скрипт для проверки sphelper:
&lt;pre&gt;
#!/usr/bin/perl
use strict;
use CGI::Carp;
require &quot;/var/www/cgi-bin/sp/common.pl&quot;;

# имя пользователя для проверки (логин в Портале)
my $user = 'ivanov';

our (%gconf);
%gconf = read_config('/var/www/cgi-bin/sp/sp.conf');

my $answer = sphelper_request(&quot;&lt;sp_user_info&gt;&lt;user&gt;$user&lt;/user&gt;&lt;/sp_user_info&gt;&quot;);

if ( $answer =~ m|&lt;groups&gt;(.+)&lt;/groups&gt;| )
	{ print &quot;OK: user = $user, groups = $1\n&quot; }
else
	{ print &quot;FAIL: $answer\n&quot; }

# пример результата
# OK: user = ivanov, groups = students,class_1a
&lt;/pre&gt;</rev>
        </revisions>
      </page>
      <page pageid="117" ns="0" title="VK Workmail">
        <revisions>
          <rev contentformat="text/x-wiki" contentmodel="wikitext" xml:space="preserve">== Организация почты на домене вида schoolXX.tgl.ru ==

Не путайте с почтой на домене edu.tgl.ru! Доступ е ней в рамках ЕСПД сохранён. Техническую поддержку осуществляет, по-прежнему, ЦИТ.

В ЕСПД невозможно держать почтовый сервер внутри локальной сети школы. Будем переезжать.

Демонстрация на примере школы 90, то есть домен school90.tgl.ru. Примеры адресов:

 ivanova@school90.tgl.ru
 petrova@school90.tgl.ru

При выполнении рецепта исправляйте на свой домен.

=== Шаг 1. Учётная запись админа ===

У вас должна быть учётная запись на сервисе mail.ru. Если её нет, заведите. Эта учётка станет административной для вашей почтовой службы.  Войдите под этой учёткой в mail.ru (либо вас попросят войти на втором шаге)

=== Шаг 2. Регистрация вашего домена в сервисе ===

По адресу https://biz.mail.ru/mail/ введите ваш домен:

 school90.tgl.ru

=== Шаг 3. Подтверждение домена ===

Вы попадёте на страницу подтверждения домена.

Так как домены в зоне tgl.ru администрирует Мэрия, стоит минимизировать обращение к ним. Нам подойдёт способ подтверждения через HTML-файл.

Отправьте HTML-файл к нам в техподдержку, мы разместим его на сервере, где живёт ваш сайт. После этого вы сможете дать команду проверить домен.

После подтверждения владения доменом нужно настроить записи в домене. Это может сделать только сотрудник Мэрии.

=== Шаг 4. Отправьте в Мэрию заявку ===

[[Заявка в Мэрию по доменам в зоне tgl.ru|Способы подавать заявку]]

Для обеспечения работоспособности почтовой службы просим в домене school90.tgl.ru добавить или заменить (если есть):

1. MX-запись со следующими параметрами:

 Поддомен: @
 Значение: emx.mail.ru.
 Приоритет: 10

2. ТХТ-запись со следующим значением:

 v=spf1 redirect=_spf.mail.ru.

A-запись (для работы сайта) не изменять!

=== Шаг 5. Проверка MX- и SPF-записей ===

Выполнение заявки занимает время у администратора в Мэрии, также есть и дальнейшие автоматические технические процессы. Всё вместе может занимать до 1-2 суток.

По адресу

https://mxtoolbox.com/SuperTool.aspx?action=mx%3Aschool90.tgl.ru&amp;run=toolpage

можно самостоятельно контролировать наличие корректной MX-записи в домене. Там же можно запросить и SPF. И DKIM.

Как только прошло 2 суток или вы раньше заметили корректные записи, можно попросить сервис VK Workmail проверить эти записи. Когда они будут проверены успешно, почта почти готова к работе. Останется только добавить DKIM-пдпись. Без неё почта тоже будет работать, но повышается вероятность попадания писем в спам. Поэтому проявите терпение и подайте в мэрию заявку на добавление ещё одной записи в домен. Вам покажут примерно такую картину:

[[Файл:vkworkmail_dkim.png]]

Отправьте в Мэрию запрос на добавление DKIM-записи.

На фоне его исполнения можно создавать почтовые ящики.

=== Шаг 6. Создание ящиков ===

Два варианта. Вы уже использовали почту до внедрения ЕСПД или не использовали никогда.

Если не использовали никогда, создавайте такие ящики, какие хотите.

Если пользовались ранее, нужно создавать ящики, в точности совпадающие со старыми адресами сотрудников.

Отдайте сотрудникам логин и пароль. Логин должен включать и ящик, и домен, например, ivanova@school90.tgl.ru

Объясните им, что доступ к почте возможен через веб-интерфейс по адресу https://mail.ru/

== Доступ к почте из ЕСПД ==

Дополнительные действия для доступа через веб интерфейс не нужны. Адрес: https://mail.ru/

Если требуется доступ через настольные почтовые программы (например, Thunderbird, Outlook по протоколам IMAP, SMTP), напишите в Минцифры обращение:

Для всех IP-адресов (вида 10.163.X.X) компьютеров сотрудников (которым нужен такой доступ) открыть доступ к:

 imap.mail.ru на порт TCP 143
 imap.mail.ru на порт TCP 993
 smtp.mail.ru на порт TCP 465</rev>
        </revisions>
      </page>
    </pages>
  </query>
</api>