MDM API

Интерфейсы, описанные ниже, предоставляются библиотекой libsailfishmdm.

Accounts

Предоставляет API для управления учетными записями.

Sailfish::Mdm::Accounts

EmailAccountProvisoner

Наследник класса Provisioner. Предоставляет API, позволяющее установить на устройство учетную запись электронной почты с определенными настройками.

Большинство задаваемых настроек могут быть установлены автоматически (основываясь на конфигурациях сервисов, поставляемых с устройством). Единственные настройки, которые не могут быть установлены автоматически (даже при условии, что на устройстве присутствует конфигурация для требуемого провайдера электронной почты), это:

  • providerName
  • emailAddress
  • incomingPassword

Плюс, если необходимо принимать недоверенные сертификаты - это должно быть явно указано, в противном случае эта настройка будет установлена в "запрет".

Возможности:

  • Получить изначальное имя сервиса учетных записей, связанного с учетной записью
  • Получить адрес эл.почты, связанный с учетной записью
  • Задать/получить настройку "Принимать недоверенные сертификаты от сервера входящей/исходящей почты
  • Получить/задать тип шифрования соединения при связи с сервером входящей/исходящей почты
  • Получить/задать пароль, используемый на сервере входящей/исходящей почты
  • Получить/задать порт, через который происходит связь с сервером входящей/исходящей почты
  • Получить/задать протокол, поддерживаемый сервером входящей/исходящей почты
  • Получить/задать интернет-адрес или URL сервера входящей/исходящей почты
  • Получить/задать имя пользователя, используемое на сервере входящей/исходящей почты

Sailfish::Mdm::Accounts::EmailAccountProvisioner

GenericAccountProvisoner

Наследник класса Provisioner. Предоставляет API, позволяющее клиентам MDM устанавливать на устройство учетную запись с заданными параметрами.

Sailfish::Mdm::Accounts::GenericAccountProvisioner

Provisioner

Базовый сервис учетной записи. Не следует использовать данный тип, вместо него следует использовать производные типы, такие как Sailfish::Mdm::Accounts::EmailAccountProvisioner

Возможности:

  • Получить/задать настройки конфигурации учетной записи
  • Получить/задать имя учетной записи
  • Получить/задать флаг "Учетная запись создана в режиме "Только для чтения"
  • Получить/задать имя провайдера учетной записи
  • Получить информацию о том, достаточно ли предоставлено настроек, чтобы успешно создать учетную запись
  • Удалить учетную запись
  • Вернуть ошибку, возникшую при создании учетной записи

Sailfish::Mdm::Accounts::Provisioner

Applications

Обеспечивает API, позволяющий клиентам получать списки установленных приложений и пакетов. Позволяет:

  • Получить список приложений, установленных на устройстве
  • Получить список пакетов, установленных на устройстве
  • Установить заданный пакет из системных репозиториев RPM
  • Удалить установленный пакет RPM

Sailfish::Mdm::Applications

AutoStart

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

  • Добавить/убрать приложение из списка автоматически запускаемых;
  • Получить пути к приложениям, находящимся в настоящий момент в списке автоматически запускаемых.

Sailfish::Mdm::Autostart

BatteryInfo

Предоставляет API, позволяющее клиентам получать статус заряда батареи. Позволяет:

  • Получить величину текущего заряда батареи
  • Получить статус зарядного устройства
  • Получить статус зарядки батареи

Sailfish::Mdm::BatteryInfo

CallStatistics

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

Sailfish::Mdm::CallStatistics

Certificates

Предоставляет API для управления системными сертификатами удостоверяющих центров. Позволяет:

  • Установить в систему файл с "черным списком" сертификатов
  • Получить установленный в системе набор файлов с "черными списками" сертификатов
  • Установить в систему файл, содержащий сертификаты
  • Получить список установленных файлов сертификатов (расширяющих набор сертификатов, полученных при установке ОС)
  • Удалить из системы установленный файл с "черным списком" сертификатов
  • Удалить из системы установленный файл с сертификатами

Sailfish::Mdm::Certificates

ConnectivitySettings

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

  • Получить настройки точки доступа мобильной сети, ассоциированной с SIM с заданным номером imsi
  • Соединиться с мобильной сетью, используя SIM с заданным номером imsi
  • Отсоединиться от мобильной сети, к которой присоединена SIM с заданным номером
  • Получить информацию о том, включен ли режим полета на устройстве
  • Включить/отключить режим полета
  • Получить список imsi всех SIM-карт, имеющих возможность работы с мобильной сетью
  • Задать определенному imsi определенный набор настроек связи
  • Получить информацию о том, включен ли адаптер WLAN на устройстве
  • Включить/отключить адаптер WLAN на устройстве

Sailfish::Mdm::ConnectivitySettings

DateTimeSettings

Предоставляет API, позволяющий клиентам установить параметры даты и времени. Позволяет:

  • Работу с параметром "Автоматическое обновление даты и времени с сервера синхронизации времени" (установка, получение значения)
  • Работу с параметром "Автоматическое обновление временной зоны с сервера синхронизации времени" (установка, получение значения)
  • Получить список валидных временных зон
  • Установить дату
  • Установить время

Sailfish::Mdm::DateTimeSettings

DeviceLock

Предоставляет API, позволяющее клиентам заблокировать/разблокировать устройство, очистить его файловую систему или установить ему код безопасности. Позволяет:

  • Попытаться очистить устройство согласно опциям очистки (асинхронная операция)
  • Установить опции блокировки устройства
  • Установить на устройство код безопасности
  • Получить статус блокировки устройства

Sailfish::Mdm::DeviceLock

LocationInfo

Предоставляет API для получения текущего местоположения устройства. Позволяет:

  • Получить координаты устройства (широта-долгота)
  • Запросить обновление местоположения
  • Получить число используемых GPS-спутников
  • Получить число доступных GPS-спутников
  • Получить время последнего обновления местоположения

Sailfish::Mdm::LocationInfo

LocationSettings

Предоставляет API, позволяющее клиентам активировать либо деактивировать различные способы позиционирования, включая GPS и aGPS. Позволяет:

  • Получить информацию о провайдере aGPS с заданным именем на устройстве
  • Получить информацию о наличии и статусе GPS позиционирования на устройстве
  • Активировать провайдер aGPS на устройстве
  • Активировать провайдер GPS на устройстве
  • Активировать геопозиционирование на устройстве

Sailfish::Mdm::LocationSettings

Netproxy

Контролирует используемые прокси-серверы.

Режим прокси может быть "прямым" (прокси не используется), "ручным" (использовать указанные прокси-сервера) и "автоматическим" (определять по ссылке на PAC-файл).

Тип прокси определяется протоколом. К примеру, для прокси в ручном режиме - если указать прокси с префиксом http - он будет распознан как веб-прокси.

Прокси могут быть применены либо для конкретных сервисов, либо глобально. Если активен глобальный прокси - он переопределит набор прокси для конкретных сервисов (включая их деактивацию, если это оговорено в глобальном прокси).

Возможности:

  • Получить список идентификаторов сервисов, которые поддерживают прокси
  • Выбрать прокси, с которым будут вестись дальнейшие операции
  • Получить идентификатор/имя текущего выбранного сервиса
  • Получить список сетевых технологий, которые поддерживают конфигурацию прокси
  • Выбрать, будут ли использованы индивидуальные прокси сервисов или глобальный прокси
  • Задать URL PAC-файла для использования на текущем выбранном устройстве
  • Задать исключения доменов для текущего выбранного сервиса
  • Задать прокси-серверы для использования в выбранном вручную сконфигурированном прокси
  • Задать тип текущего выбранного прокси (прямой, ручной, авто)
  • Получить тип текущего выбранного прокси

Sailfish::Mdm::NetProxy

NetworkDataCounter

Отслеживает использование сетевых данных. Позволяет:

  • Задать/получить интервал обновления данных
  • Сбросить счетчик, находящийся по заданному пути
  • Задать/получить порог точности для обновления данных в килобайтах

Sailfish::Mdm::NetworkDataCounter

NotificationInfo

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

  • Закрыть уведомление с заданным идентификатором
  • Получить данные по всем уведомлениям от заданного владельца
  • Получить данные по всем уведомлениям в заданной категории

Sailfish::Mdm::NotificationInfo

SecuritySettings

Предоставляет API, позволяющее клиентам разрешать либо запрещать установку небезопасного ПО на устройство (стороннюю загрузку). Позволяет:

  • Разрешить/запретить режим разработчика
  • Разрешить/запретить стороннюю загрузку приложений

Sailfish::Mdm::SecuritySettings

SimInfo

Предоставляет API, позволяющее клиентам получать информацию о SIM-картах в устройствах, включая IMEI, IMSI, ICCID и номер телефона. Позволяет:

  • Получить статус доступности системного сервиса, предоставляющего информацию о SIM-картах
  • Получить код ICCID для каждой SIM-карты, установленной в слот
  • Получить код IMEI для каждой SIM-карты, установленной в слот
  • Получить детализированную информацию по каждой SIM-карте
  • Получить номер IMSI для каждой SIM-карты, установленной в слот
  • Получить телефонный номер для каждой SIM-карты, установленной в слот

Sailfish::Mdm::SimInfo

SimMobileDatafilter

Позволяет задать SIM-карте с определенным imsi правило на реагирование на получение мобильных данных.

Sailfish::Mdm::SimMobileDataFilter

SimSmsFilter

Позволяет задать SIM-карте с определенным imsi правило реагирования на получение SMS.

Sailfish::Mdm::SimSmsFilter

SimVoiceCallFilter

Позволяет задать SIM-карте с определенным imsi правило реагирование на голосовые вызовы. Позволяет:

  • Получить/задать правила реагирования на исходящие вызовы
  • Получить/задать правила реагирования на входящие вызовы

Sailfish::Mdm::SimVoiceCallFilter

SoftwareUpdate

Предоставляет API, позволяющее клиентам инициировать обновления ОС на устройстве. Возможности:

  • Проверить наличие системных обновлений
  • Инициировать скачивание системного обновления заданной версии
  • Инициировать загрузку и установку системного обновления
  • Получить идентификатор последнего доступного системного обновления

Sailfish::Mdm::SoftwareUpdate

SysInfo

Предоставляет доступ к информации об устройстве. Позволяет:

  • Получить Bluetooth MAC адрес устройства
  • Получить название модели устройства (внутреннее, принятое у производителя)
  • Получить название модели устройства (полное)
  • Получить уникальный идентификатор устройства (производный от внутреннего MAC адреса и внутреннего идентификатора)
  • Получить название производителя устройства
  • Получить версию ОС на устройстве
  • Получить идентификатор версии ОС
  • Получить MAC адрес беспроводной сети на устройстве

Sailfish::Mdm::SysInfo