Адресные книги КриптоАРМ — создание и настройка - Документация для КриптоАРМ 6
Перейти к содержанию

Как управлять адресными книгами КриптоАРМ#

В этой инструкции вы узнаете, как создавать и настраивать адресные книги в КриптоАРМ, подключать внешние источники контактов (LDAP и CardDAV), импортировать контакты в формате vCard, а также управлять адресными книгами и их содержимым.

Содержание:


Типы адресных книг#

Адресные книги в КриптоАРМ предназначены для хранения и управления контактами, которые используются при отправке обычных и зашифрованных писем, а также при шифровании документов.

При установке приложения автоматически создаётся локальная адресная книга «Контакты». Она готова к использованию сразу после запуска — в неё можно добавлять записи вручную или импортировать контакты из файлов.

КриптоАРМ поддерживает несколько типов адресных книг:

  • Локальная адресная книга — хранит контакты непосредственно на устройстве пользователя. Поддерживается ручное добавление контактов и импорт из файлов формата vCard.
  • Адресная книга LDAP — корпоративный каталог, подключаемый по протоколу LDAP.
  • Адресная книга CardDAV — адресная книга, синхронизируемая с серверами по протоколу CardDAV.

Контакты в адресной книге могут содержать расширенную информацию:

  • фамилию, имя, отчество, должность, номера телефонов и e-mail-адреса;
  • почтовые адреса и дату рождения;
  • фотографии, логотипы и другие мультимедийные элементы;
  • электронные сертификаты для защищённой переписки и шифрования данных.

Добавление локальной адресной книги#

  1. Перейдите в раздел Контакты и нажмите на название активной адресной книги.
  2. Выберите Добавить адресную книгу.

    Список адресных книг в КриптоАРМ

  3. В открывшемся окне укажите название адресной книги.

  4. Нажмите Создать.

    Добавление локальной адресной книги в КриптоАРМ

💡 Следующий шаг: переключитесь на новую адресную книгу. Теперь вы можете добавить контакты вручную или импортировать их из файла.


Добавление адресной книги LDAP#

Назначение и принцип работы#

КриптоАРМ поддерживает интеграцию с корпоративными LDAP-каталогами, что позволяет импортировать контакты из Active Directory и автоматически синхронизировать изменения.

Принцип работы:

  1. КриптоАРМ подключается к серверу LDAP с использованием учетной записи пользователя, предназначенной для чтения каталога.
  2. По заданной базе поиска и фильтру извлекаются контакты.
  3. Полученные записи отображаются в интерфейсе КриптоАРМ как отдельная адресная книга.
  4. При включенном автообновлении изменения на сервере автоматически отражаются в КриптоАРМ.

💡 Совет: Адресная книга LDAP не заменяет локальные контакты, а дополняет их. Можно использовать несколько адресных книг одновременно и комбинировать их с локальными контактами.

Подготовка к подключению#

  1. Создайте в LDAP учетную запись, с которой будет выполняться подключение к серверу.
  2. Настройте фильтры. В зависимости от настроек клиента, могут использоваться фильтры, в которых можно отсечь ненужные записи.
  3. Сервер LDAP должен быть доступен по сети с компьютера, на котором работает почтовый клиент.

    Если данный сервер находится за NAT или он закрыт брандмауэром, то необходимо обеспечить доступ по следующим портам:

    • 389 tcp или udp. Незащищенный доступ к активному каталогу.
    • 636 tcp или udp. Доступ с защитой SSL.

    Достаточно открыть и использовать один из данных портов, желательно 636.

Создание подключения в КриптоАРМ#

  1. Откройте форму подключения одним из способов:

    • Перейдите в раздел Контакты. Откройте окно со списком адресных книг. Для этого нажмите на название активной адресной книги в верхнем правом углу окна. Выберите действие Добавить подключение LDAP.

      Кнопка Добавить подключение LDAP в КриптоАРМ

    • Перейдите в раздел Настройки → проверка Адресные книги. Нажмите на кнопку Добавить Кнопка Добавить в верхней части окна и выберите действие Добавить подключение LDAP.

  2. Откроется форма подключения адресной книги.

  3. Укажите параметры подключения:

    • Название адресной книги — Имя книги, отображаемое в приложении,
    • Имя сервера — Адрес LDAP-сервера для подключения,
    • Порт — Порт для подключения к LDAP-серверу,
    • Имя пользователя и пароль — Учетная запись и пароль для подключения к серверу,
  4. Настройте параметры сервера:

    • Время ожидания — Время ожидания ответа сервера (в секундах),
    • Не возвращать более чем — Максимальное количество записей за один запрос (0 = без ограничения),
    • Постраничное получение результатов — При включении позволяет получать результаты частями,
    • Размер страницы — Количество записей, возвращаемых за одну страницу при постраничном получении,
    • Фильтр поиска — Фильтр поиска учетных записей в LDAP,
    • База поиска — DN контейнера, где выполняется поиск,
  5. Настройте параметры синхронизации:

    • Получение контактов — Определяет, какие контакты сохраняются локально,
    • Автообновление каталога — Настройка синхронизации данных с сервером (Никогда / 1 раз в день / Раз в 60 мин / Раз в 30 мин),
    • Использовать для поиска получателей шифрованных писем — Если при отправке зашифрованного письма не найден сертификат получателя, система выполнит поиск сертификата во всех доступных книгах. Система выполняет поиск по адресу электронной почты получателя. В результаты поиска включаются все найденные сертификаты, связанные с этим адресом. Данная настройка позволяет исключить адресную книгу из этого автоматического поиска.
  6. Нажмите Сохранить.

💡 Совет: После подключения появится новая адресная книга. Чтобы увидеть её контакты, переключитесь на неё (см. Переключение между книгами).


Добавление адресной книги CardDAV#

Что такое CardDAV#

CardDAV — это открытый интернет-протокол для синхронизации и управления контактами, основанный на стандарте vCard. Протокол обеспечивает централизованное хранение контактной информации на сервере и её доступ с различных устройств и приложений.

Принцип работы:

  1. Подключение к серверу: КриптоАРМ использует учетную запись пользователя для доступа к серверу CardDAV.
  2. Получение контактов: приложение получает список контактов в формате vCard и отображает их в интерфейсе.
  3. Синхронизация: изменения, внесённые локально или на сервере, синхронизируются по выбранному интервалу и направлению.
  4. Двусторонняя или односторонняя синхронизация: данные могут синхронизироваться в обе стороны (локально ↔ сервер) или только с сервера на локальное устройство.

Подготовка учетных данных#

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

Создание подключения в КриптоАРМ#

  1. Откройте форму подключения:

    • Перейдите в раздел Контакты и нажмите на название активной адресной книги. Выберите действие Добавить учётную запись CardDAV.

      Список адресных книг КриптоАРМ

    • Перейдите в раздел Настройки → проверка Адресные книги. Нажмите на кнопку Добавить Кнопка в верхней части окна и выберите действие Добавить учётную запись CardDAV.

  2. Откроется форма добавления адресной книги.

  3. Укажите настройки подключения:

    • Название адресной книги — Произвольное название, которое будет отображаться в приложении,
    • Адрес сервера — Адрес сервера, на котором размещена книга,
    • Имя пользователя и пароль — Учетная запись и пароль для подключения к серверу,
    • Интервал обновления — Частота синхронизации адресной книги с почтовым сервисом. По умолчанию «Никогда»,
    • Порядок синхронизации — По умолчанию выставлено значение «В обе стороны»,
    • Сохранять новые контакты в учетную запись CardDAV — По умолчанию настройка неактивна.
  4. Нажмите Сохранить.


Импорт контактов vCard#

vCard (Virtual Contact File) — международный стандарт обмена электронными визитными карточками, предназначенный для хранения и передачи информации о контактах. Формат vCard широко используется в почтовых клиентах, мобильных устройствах, CRM-системах и корпоративных каталогах.

Формат поддерживает хранение различных данных о контакте, включая:

  • контактную информацию (ФИО, номера телефонов, e-mail-адреса),
  • адресные и демографические данные (место работы, адрес, дата рождения),
  • мультимедийные элементы (фотографии, логотипы),
  • электронные сертификаты для безопасного обмена документами и письмами.

Принцип работы:

  1. Пользователь выбирает файл vCard для импорта.
  2. Программа считывает все контакты и извлекает атрибуты (ФИО, телефон, email, и др.).
  3. Контакты импортируются в выбранную адресную книгу и при необходимости в заданную группу.
  4. При успешном завершении отображается уведомление с количеством импортированных контактов.

Основной способ (через раздел «Контакты»)#

  1. Перейдите в раздел Контакты.
  2. Нажмите на кнопку Новый контакт в боковом меню.
  3. В появившемся меню выберите Импорт vCard.

    Меню с выбором действия импорта контактов

  4. Откроется окно Импорт vCard.

    • Нажмите Выбрать файл и в появившемся окне файлового менеджера укажите путь к файлу с контактами.
    • Выберите адресную книгу, в которую необходимо импортировать контакты.
    • Укажите группу, в которую будут вложены контакты.

    Форма импорта контактов vCard в КриптоАРМ

    • При необходимости создайте новую группу в указанной адресной книге.

    Форма создания адресной книги при импорте  контактов vCard

  5. Нажмите Импортировать.

Будет запущен процесс импорта.

После окончания операции будет выведено уведомление с количеством импортированных контактов.

💡 Если экспортируется большой объём контактов, операция может занять некоторое время.

Альтернативный способ (через раздел «Настройки»)#

  1. Перейдите в раздел НастройкиАдресные книги.
  2. Откроется окно со списком адресных книг (если они обнаружены).
  3. Нажмите на кнопку Добавить Кнопка Добавить в верхней части окна.
  4. Выберите действие Импортировать из файла vCard.
  5. Откроется окно Импорт vCard.
  6. Следуйте шагам из инструкции Основной способ.

Управление адресными книгами#

Переключение между книгами#

  1. Перейдите в раздел Контакты и нажмите на название активной адресной книги.
  2. В открывшемся окне выберите нужную адресную книгу из списка доступных.

Активная книга отмечается иконкой Иконка, список контактов автоматически обновляется в соответствии с выбранной книгой.

Редактирование адресной книги#

⚠️ Примечание: Редактировать можно только название адресной книги. Содержимое контактов редактируется отдельно.

  1. Перейдите в раздел Контакты и нажмите на название активной адресной книги.
  2. В открывшемся окне наведите курсор на панель с адресной книгой.
  3. Откройте меню по кнопке Настройки Иконка Настройки и выберите действие Редактировать.

    Кнопка для редактирования адресной книги в КриптоАРМ

  4. Укажите новое название адресной книги.

    Форма редактирования адресной книги в КриптоАРМ

  5. Нажмите Сохранить.

Экспорт адресной книги#

💡 Совет: Можно экспортировать как всю адресную книгу, так и выбранные контакты (см. Экспорт контакта).

  1. Перейдите в раздел Контакты и нажмите на название активной адресной книги.
  2. В открывшемся окне наведите курсор на панель с адресной книгой.
  3. Откройте меню по кнопке Настройки Иконка Настройки и выберите действие Экспортировать.
  4. Укажите место и имя файла для сохранения.

Экспортируемый файл будет сохранен в формате .vcf (vCard), включая все данные контакта и привязанные сертификаты (если они есть).

Удаление адресной книги#

  1. Перейдите в раздел Контакты и нажмите на название активной адресной книги.
  2. В открывшемся окне наведите курсор на панель с адресной книгой.
  3. Откройте меню по кнопке Настройки Иконка Настройки и выберите действие Удалить.
  4. Подтвердите удаление в появившемся окне.

Адресная книга удаляется, а ее контакты помещаются в папку Корзина.


Возможные ошибки#

Подробности о возникающих ошибках можно найти в Журнале.

Ошибка Описание Рекомендуемые действия
Не удалось подключиться к LDAP Возможно, указаны некорректные параметры подключения Проверьте параметры подключения адресной книги
Ошибка синхронизации аккаунта CardDAV Возможно, указаны некорректные параметры подключения Проверьте параметры подключения адресной книги
Ошибка получения контактов Возможно, указаны некорректные параметры подключения, либо отсутствует подключение к сети Интернет 1. Проверьте подключение к сети Интернет,
2. Проверьте параметры подключения адресной книги.
Не удалось импортировать контакты (при импорте vCard) Возможно, файл пустой или поврежден Проверьте содержимое файла .vcf и повторите импорт

Смотрите также#

  • Работа с контактами — добавление, редактирование и управление контактами в адресной книге.
  • Установка сертификатов — инструкция по установке личных, корневых и промежуточных сертификатов, сертификатов других пользователей и списков отзыва (CRL).

Для повышения удобства работы и хранения данных веб-сайт CRYPTOARM.RU использует файлы COOKIE. Продолжая работу с веб-сайтом, Вы даете свое согласие на работу с этими файлами.