Класс ActiveSyncAccountProvisioner

(Sailfish::Mdm::Accounts::ActiveSyncAccountProvisioner)

Класс ActiveSyncAccountProvisioner позволяет клиентам создавать учётные записи Active Sync. Подробнее…

Подключение:	#include <mdm-accounts.h>
Наследуется от:	Provisioner

Список всех членов класса, включая унаследованные

Свойства

acceptUntrustedCertificates : bool
certPassphrase : QString
certificate : QString
description : QString
domain : QString
emailAddress : QString
password : QString
port : int
secureConnection : bool
serverAddress : QString
signature : QString
username : QString
9 свойств, унаследованных от класса Sailfish::Mdm::Accounts::Provisioner

Публичные функции

ActiveSyncAccountProvisioner(QObject *parent = nullptr)
bool acceptUntrustedCertificates() const
QString certPassphrase() const
QString certificate() const
QString description() const
QString domain() const
QString emailAddress() const
QString password() const
int port() const
bool secureConnection() const
QString serverAddress() const
void setAcceptUntrustedCertificates(bool acceptUntrustedCertificates)
void setCertPassphrase(const QString &certPassphrase)
void setCertificate(const QString &certificate)
void setDescription(const QString &description)
void setDomain(const QString &domain)
void setEmailAddress(const QString &emailAddress)
void setPassword(const QString &password)
void setPort(int port)
void setSecureConnection(bool secureConnection)
void setServerAddress(const QString &serverAddress)
void setSignature(const QString &signature)
void setUsername(const QString &username)
QString signature() const
QString username() const

Повторно реализованные публичные функции

virtual bool commitChanges()
virtual bool createAccount()
virtual bool selectAccount(quint64 accountId)

23 публичных метода, унаследованных от класса Sailfish::Mdm::Accounts::Provisioner

Сигналы

void acceptUntrustedCertificatesChanged()
void certPassphraseChanged()
void certificateChanged()
void descriptionChanged()
void domainChanged()
void emailAddressChanged()
void passwordChanged()
void portChanged()
void secureConnectionChanged()
void serverAddressChanged()
void signatureChanged()
void usernameChanged()

9 сигналов, унаследованных от класса Sailfish::Mdm::Accounts::Provisioner

Подробное описание

Класс ActiveSyncAccountProvisioner позволяет клиентам создавать учётные записи Active Sync.

Он предоставляет API, который позволяет клиенту MDM подготовить устройство c учётной записью Active Sync с определёнными настройками.

Свойство Sailfish::Mdm::Accounts::Provisioner::providerName установлено по умолчанию. Кроме того, если на устройстве необходимо использовать ненадёжные сертификаты, это необходимо явным образом разрешить. В противном случае такие сертификаты будут запрещены по умолчанию. Точно так же secureConnection включено по умолчанию, а порт по умолчанию — 443.

Для использования данного класса в qmake-настройки проекта клиента следует добавить следующее:

 CONFIG += link_pkgconfig
 PKGCONFIG += sailfishmdm

и затем #include <mdm-accounts.h>.

 #include <mdm-accounts.h>
 void createActiveSyncAccount(const QString &emailAddress, const QString &serverAddress, const QString &username)
 {
     Sailfish::Mdm::Accounts::ActiveSyncAccountProvisioner activeSyncAccount;
     activeSyncAccount.setEmailAddress(emailAddress);
     activeSyncAccount.setServerAddress(serverAddress);
     activeSyncAccount.setUsername(username);

     if (!activeSyncAccount.createAccount()) {
         qWarning() << "Не удалось создать учётную запись:" << activeSyncAccount.errorMessage();
     }
 }

Или изменить существующую учётную запись:

 #include <mdm-accounts.h>
 void setAccountServerAddress(quint64 accountId, const QString &serverAddress)
 {
     Sailfish::Mdm::Accounts::ActiveSyncAccountProvisioner activeSyncAccount;
     if (activeSyncAccount.selectAccount(accountId)) {
         activeSyncAccount.setServerAddress(accountId);
         if (!activeSyncAccount.commitChanges()) {
             qWarning() << "Не удалось изменить учётную запись:" << activeSyncAccount.errorMessage();
         }
     } else {
         qWarning() << "Нет такой учётной записи"
     }
 }

Описание свойств

acceptUntrustedCertificates : bool

Свойство истинно, если устройство должно принимать ненадёжные сертификаты от сервера Active Sync.

Значение по умолчанию: false.

Методы доступа:

bool acceptUntrustedCertificates() const
void setAcceptUntrustedCertificates(bool acceptUntrustedCertificates)

Сигнал уведомления:

void acceptUntrustedCertificatesChanged()

certPassphrase : QString

Свойство содержит кодовую фразу для разблокировки клиентского сертификата PKCS#12.

Следует обратить внимание: установка этого параметра не будет иметь никакого эффекта, если также не определён файл сертификата. Кодовая фраза будет проверена во время создания/изменения учётной записи.

Методы доступа:

QString certPassphrase() const
void setCertPassphrase(const QString &certPassphrase)

Сигнал уведомления:

void certPassphraseChanged()

certificate : QString

Свойство содержит путь к набору сертификатов клиента PKCS#12, который будет использоваться для аутентификации.

Путь должен быть абсолютным, относительные пути не будут разрешены. Для очистки следует использовать QString().

Методы доступа:

QString certificate() const
void setCertificate(const QString &certificate)

Сигнал уведомления:

void certificateChanged()

description : QString

Свойство содержит описание учётной записи.

Методы доступа:

QString description() const
void setDescription(const QString &description)

Сигнал уведомления:

void descriptionChanged()

domain : QString

Свойство содержит домен учётной записи Active Sync.

Методы доступа:

QString domain() const
void setDomain(const QString &domain)

Сигнал уведомления:

void domainChanged()

emailAddress : QString

Содержит адрес электронной почты, связанный с учётной записью.

Методы доступа:

QString emailAddress() const
void setEmailAddress(const QString &emailAddress)

Сигнал уведомления:

void emailAddressChanged()

password : QString

Свойство содержит пароль для использования с учётной записью.

Пароль — это необязательное значение для создания учётной записи. Рекомендуется разрешить пользователю завершить создание учётной записи, введя пароль.

Методы доступа:

QString password() const
void setPassword(const QString &password)

Сигнал уведомления:

void passwordChanged()

port : int

Свойство содержит порт, к которому необходимо подключиться для связи с сервером Active Sync.

См. также serverAddress

Методы доступа:

int port() const
void setPort(int port)

Сигнал уведомления:

void portChanged()

secureConnection : bool

Свойство истинно, если учётная запись использует безопасное соединение, в противном случае — ложно.

Можно установить значение false, чтобы не использовать безопасное соединение. Следует обратить внимание, что это не влияет на порт, его нужно менять отдельно.

Значение по умолчанию: true.

Методы доступа:

bool secureConnection() const
void setSecureConnection(bool secureConnection)

Сигнал уведомления:

void secureConnectionChanged()

serverAddress : QString

Свойство содержит адрес интернет-сервера или URL-адрес сервера Active Sync.

См. также port

Методы доступа:

QString serverAddress() const
void setServerAddress(const QString &serverAddress)

Сигнал уведомления:

void serverAddressChanged()

signature : QString

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

Методы доступа:

QString signature() const
void setSignature(const QString &signature)

Сигнал уведомления:

void signatureChanged()

username : QString

Свойство содержит имя пользователя для использования с учётной записью.

Методы доступа:

QString username() const
void setUsername(const QString &username)

Сигнал уведомления:

void usernameChanged()

Описание функций-членов

ActiveSyncAccountProvisioner::ActiveSyncAccountProvisioner(QObject *parent = nullptr)

Конструктор для класса ActiveSyncAccountProvisioner с родительским элементом, указанном в параметре parent.

[virtual] bool ActiveSyncAccountProvisioner::commitChanges()

Повторно реализуется из Provisioner::commitChanges().

[virtual] bool ActiveSyncAccountProvisioner::createAccount()

Повторно реализуется из Provisioner::createAccount().

[virtual] bool ActiveSyncAccountProvisioner::selectAccount(quint64 accountId)

Повторно реализуется из Provisioner::selectAccount().

Подготавливает провайдер к модификации/интроспекции активной учётной записи с значением accountId.