Автоматическая конфигурация AlterOffice AMail 2025

Оглавление

1) Конфигурация с помощью AutoConfig

        - Настройка Autoconfig

        - Функции AutoConfig

        - Конфигурация учетных записей

                - IMAP

                - AMailEx (Будет доступно начиная с 2025.3)

2) Конфигурация с помощью policies.json

1) Конфигурация с помощью AutoConfig

Конфигурация с помощью Autoconfig известна также под именем Mission Control Desktop (MCD).

Файлы AutoConfig можно использовать для установки и блокировки параметров, автоматической настройки учетных записей. Данный механизм позволяет настраивать параметры приложения на основе свойств пользователей, полученных либо из переменных системной среды, либо из каталога LDAP организации.

Настройка Autoconfig

1. Создать autoconfig.js в папке установки: c:\Program Files\AlterOffice AMail\defaults\pref\autoconfig.js или Он должен содержать следующие две строки:

pref("general.config.filename", "amail.cfg");
pref("general.config.obscure_value", 0);

Вторая строка указывает на то, что файл автоматической конфигурации не должен быть скрыт. По умолчанию AlterOffice AMail ожидает, что файл будет с побайтовым смещением 

Обратите внимание, все файлы конфигурации должны быть в кодировке utf-8

В случае необходимости шифрования конфигурационного файла, указать значение

pref("general.config.obscure_value", 13);

1. Создать amail.cfg в папке установки на верхнем уровне: c:\Program Files\AlterOffice AMail Он всегда должен начинаться со строки-комментария, например:

// ВАЖНО: Комментарий конфигурационного файла

Данный файл несмотря на расширение .cfg является файлом JavaScript. Это позволяет записывать в файл дополнительный JavaScript код для добавления необходимой логики в различных ситуациях. Для конфигурационного файла можно использовать скрипт файла "encode_config.pl" :

#!/usr/bin/perl

# Usage to do byteshift of 13
#   To decode: encode_config.pl -s -13
<amail.cfg >amail.cfg.txt
#   To encode: encode_config.pl -s 13 <amail.cfg.txt >amail.cfg

use strict;
use Getopt::Std;

use vars qw/$opt_s/;

getopts("s:");
if(!defined $opt_s) {
    die "Missing shift\n";
}

my $buffer;
while(1) {
    binmode(STDIN, ":raw");
    my $n=sysread STDIN, $buffer, 1;
    if($n == 0) {
       last;
    }
    my $byte = unpack("c", $buffer);
    $byte += 512 + $opt_s;
    $buffer = pack("c", $byte);
    binmode(STDOUT, ":raw");
    syswrite STDOUT, $buffer, 1;
}

Функции AutoConfig

Следующие функции доступны внутри AutoConfig-файла:

Конфигурация учетных записей

Ветка mail.* — одна из самых больших групп настроек, которыми можно управлять с помощью autoconfig. Настройка правильной комбинации mail.account, mail.server, mail.identity и mail.smtpserver позволяет настроить учетную запись. Для этого необходимо их правильно связать.

Учетные записи в AMail (за исключением учетной записи Локальные папки) состоят из следующих компонентов: 

- account

- server (для входящей почты)

- identities (одна или несколько, в интерфейсе представлены в меню "Дополнительные адреса электронной почты") 

- smtp server (для исходящей почты)

IMAP

Пример конфигурации учетной записи IMAP

// ВАЖНО: Начните свой код со второй строки
try {

// Получаем имя пользователя и домашнюю папку
    if (getenv("USER") != "") {
    // *NIX параметры
        let env_user = getenv("USER");
        let env_home = getenv("HOME");
    } else {
        // Windows параметры
        let env_user = getenv("USERNAME");
        let env_home = getenv("HOMEPATH");
    }
    env_user = "testuser8";

// Ставим аккаунтом по умолчанию account2 (account1 относится к Локальным папкам)
    defaultPref("mail.accountmanager.defaultaccount", "account2");

// Добавляем account2 в список аккаунтов
    defaultPref("mail.accountmanager.accounts", "account1,account2");

// Связываем account2 сервер server2 (IMAP) (server1 относится к Локальным папкам)
    lockPref("mail.account.account2.server", "server2");

// Настройки IMAP сервера
    lockPref("mail.server.server2.type", "imap");
    lockPref("mail.server.server2.hostname", "imap.almipartner.ru");
    lockPref("mail.server.server2.realhostname", "imap.almipartner.ru");
    lockPref("mail.server.server2.port", 143);              //Порт сервера
    lockPref("mail.server.server2.socketType", 2);          // Использовать STARTLS
    lockPref("mail.server.server2.name", env_user);         // Логин пользователя
    lockPref("mail.server.server2.userName", env_user);     // Логин пользователя
    lockPref("mail.server.server2.realuserName", env_user); // Логин пользователя
    lockPref("mail.server.server2.login_at_startup", true); // ! Обязательный параметр при автоматически
    lockPref("mail.server.server2.isSecure", true);         // Защищённый сервер

// Настройки SMTP сервера
    lockPref("mail.smtpserver.smtp1.hostname", "smtp.almipartner.ru");
    lockPref("mail.smtpserver.smtp1.port", 587);
    lockPref("mail.smtpserver.smtp1.auth_method", 1);
    lockPref("mail.smtpserver.smtp1.username", env_user);
    lockPref("mail.smtpserver.smtp1.try_ssl", 2);
    lockPref("mail.smtp.defaultserver", "smtp1");
    lockPref("mail.smtpservers", "smtp1");

// Настройки идентификатора пользователя
    defaultPref("mail.identity.id1.fullName", env_user);
    defaultPref("mail.identity.id1.fcc_folder", "imap://" + env_user + "@imap.almipartner.ru/Sent");
    lockPref("mail.identity.id1.useremail", env_user + "@almipartner.ru");
    lockPref("mail.identity.id1.reply_to", env_user + "@almipartner.ru");
    lockPref("mail.identity.id1.valid", true);
    lockPref("mail.identity.id1.smtpServer", "smtp1");

// Привязываем ID к аккаунту account2
    lockPref("mail.account.account2.identities", "id1");

} catch (e) {
    displayError("lockedPref", e);
}

EWS

// ВАЖНО: Начните свой код со второй строки

try {

// Получаем имя пользователя и домашнюю папку
    if (getenv("USER") != "") {

        // *NIX параметры
        let env_user = getenv("USER");
        let env_home = getenv("HOME");

    } else {

// Windows параметры
        let env_user = getenv("USERNAME");
        let env_home = getenv("HOMEPATH");
    }

    env_user = "testuser8";
    let displayName = "Тестовый Пользователь 8";
    let domain = "almipartner.ru";
    let hostname = "mail.almipartner.ru";
    let ewsURL = "https://" + hostname + "/EWS/Exchange.asmx";
    defaultPref("devtools.debugger.prompt-connection", false);

// Ставим аккаунтом по умолчанию account2 (account1 относится к Локальным папкам)
    defaultPref("mail.accountmanager.defaultaccount", "account2");

// Добавляем account2 в список аккаунтов
    defaultPref("mail.accountmanager.accounts", "account2,account1");

// Связываем account2 сервер server2 (AMailEx) (server1 относится к Локальным папкам)
    defaultPref("mail.account.account2.server", "server2");

   

// Настройки сервера
    defaultPref("mail.server.server2.type", "amailex");
    defaultPref("mail.server.server2.hostname", hostname);
    defaultPref("mail.server.server2.socketType", 3);          // Использовать SSL
    defaultPref("mail.server.server2.name", env_user + "@" + domain + " on " + hostname);
    defaultPref("mail.server.server2.userName", env_user);     // Логин пользователя
    defaultPref("mail.server.server2.login_at_startup", true); // ! Обязательный параметр при автом.
    defaultPref("mail.server.server2.useAB", true);            // Использовать автодополнение
    defaultPref("mail.server.server2.ewsURL", ewsURL);
    defaultPref("mail.server.server2.check_new_mail", true);   // Проверять наличие новых сообщений
    defaultPref("mail.server.server2.check_time", 5);          // Каждые 5 минут
    defaultPref("mail.server.server2.spamLevel", 0);           // Анти-спам фильтры

// Настройки идентификатора пользователя
    defaultPref("mail.identity.id1.fullName", displayName);    // Имя отправителя
    defaultPref("mail.identity.id1.fcc_folder", "amailex://" + env_user + "@" + hostname + "/Sent");
    defaultPref("mail.identity.id1.useremail", env_user + "@" + domain);
    defaultPref("mail.identity.id1.reply_on_top", 1);          // Поместить курсор перед цитируемым текстом
    defaultPref("mail.identity.id1.sig_bottom", false);        // Ставить подпись после моего ответа
    defaultPref("mail.identity.id1.valid", true);
    defaultPref("mail.identity.id1.smtpServer", "server2");    // В качестве исходящего сервера указываем тот же что и для входящих сообщений

// Привязываем ID к аккаунту account2
    defaultPref("mail.account.account2.identities", "id1");

    let extensionPrefix = "extensions.amailex.";

// Debug логи расширения AMailEx
    pref(extensionPrefix + "log.dump", true);
    pref(extensionPrefix + "log.file", true);
    pref(extensionPrefix + "log.level", "Debug");
    pref(extensionPrefix + "logBodies", true);

// Настройки расширения AMailEx
    defaultPref(extensionPrefix + "mail.account.account2.identities", "id1");
    defaultPref(extensionPrefix + "mail.account.account2.server", "server2");
    defaultPref(extensionPrefix + "mail.identity.id1.fullName", displayName);
    defaultPref(extensionPrefix + "mail.identity.id1.smtpServer", "server2");
    defaultPref(extensionPrefix + "mail.identity.id1.useremail", env_user + "@" + hostname);
    defaultPref(extensionPrefix + "mail.identity.id1.valid", true);
    defaultPref(extensionPrefix + "postamailex17", true);
    defaultPref(extensionPrefix + "postamailex19", true);

} catch (e) {
    displayError("lockedPref", e);
}

{
 "policies": { 
   "BlockAboutConfig": true
 }
}

В этом примере мы устанавливаем для политики BlockAboutConfig значение true, что означает, что у пользователя не будет доступа к странице about:config.
2) Установка сертификатов в хранилище сертификатов приложения: 

{
  "policies": {
    "Certificates": {
      "Install": [
        "/usr/lib64/alteroffice-amail/Пример_сертификата.pem"
      ],
      "ImportEnterpriseRoots": true
    }
  }
}

Где размещенный сертификат по локальному пути /usr/lib64/alteroffice-amail/Пример_сертификата.pem автоматически определиться почтовым клиентом при инициализации. 

Список поддерживаемых политик: