Класс Certificates
(Sailfish::Mdm::Certificates)
Класс Certificates управляет системными сертификатами CA. Подробнее…
| Заголовочный файл: | #include <mdm-certificate.h> |
Публичные типы
Публичные методы
- Certificates(QObject *parent = nullptr)
- ~Certificates()
- void blacklist(const QString &fileName, const QByteArray &data)
- void blacklist(const QString &fileName, const QList<QSslCertificate> &certificates)
- QList<CertificateFile> blacklistedFiles() const
- QList<QSslCertificate> certificates() const
- void install(const QString &fileName, const QByteArray &data)
- void install(const QString &fileName, const QList<QSslCertificate> &certificates)
- QList<CertificateFile> installedFiles() const
- QString lastErrorMessage()
- int lastErrorType()
- void unblacklist(const QString &fileName)
- void uninstall(const QString &fileName)
Сигналы
- void blacklistFinished(const CertificateFile &file, Result result)
- void blacklistedFilesChanged()
- void certificatesChanged()
- void installFinished(const CertificateFile &file, Result result)
- void installedFilesChanged()
- void unblacklistFinished(const CertificateFile &file, Result result)
- void uninstallFinished(const CertificateFile &file, Result result)
Подробное описание
Класс Certificates управляет системными сертификатами CA.
Новые сертификаты могут быть добавлены к набору системных сертификатов с помощью методов install(). Файлы, содержащие эти установленные сертификаты, можно запросить с помощью метода installedFiles().
Нежелательные сертификаты могут быть занесены в чёрный список с помощью методов blacklist(). Полный список установленных файлов чёрного списка сертификатов доступен с помощью метода blacklistedFiles().
Полный список системных сертификатов доступен в методе certificates.
Описание типов класса
enum Certificates::ErrorType
Коды возможных ошибок для операций install() и uninstall().
| Константа | Значение | Описание |
|---|---|---|
Sailfish::Mdm::Certificates::Success |
? | Операция выполнена успешно |
Sailfish::Mdm::Certificates::Error |
? | Операция провалилась |
Sailfish::Mdm::Certificates::NoError |
0 |
Нет ошибки. |
Sailfish::Mdm::Certificates::InvalidCommand |
1 |
Неверная команда для установщика сертификата. |
Sailfish::Mdm::Certificates::InvalidFileName |
2 |
В имени файла содержатся недопустимые символы или расширение файла не '.crt'. |
Sailfish::Mdm::Certificates::EmptyFile |
3 |
Файл сертификата пуст. |
Sailfish::Mdm::Certificates::CantOpenFile |
5 |
Установщик сертификата не может открыть файл. |
Sailfish::Mdm::Certificates::CantWriteFile |
6 |
Установщик сертификата не может записать файл. |
Sailfish::Mdm::Certificates::FailedVerify |
7 |
Провалена верификация сертификата. |
Sailfish::Mdm::Certificates::FailedFinalizeFile |
8 |
Установщик сертификата не может завершить работу с файлом. |
Sailfish::Mdm::Certificates::UpdateCaTrusIssue |
9 |
Ошибка внешней программы update-ca-trust. |
Sailfish::Mdm::Certificates::DBusError |
10 |
Ошибка D-Bus. |
enum Certificates::Result
Возможные типы результатов для таких операций, как install() и uninstall().
| Константа | Значение | Описание |
|---|---|---|
Sailfish::Mdm::Certificates::Success |
0 |
Операция выполнена успешно |
Sailfish::Mdm::Certificates::Error |
1 |
Операция провалилась |
Описание методов класса
Certificates::Certificates(QObject *parent = nullptr)
Создаёт новый экземпляр сертификата с заданным родителем parent.
Certificates::~Certificates()
Уничтожает экземпляр сертификата.
void Certificates::blacklist(const QString &fileName, const QByteArray &data)
Устанавливает файл чёрного списка сертификатов с именем fileName.
Сертификаты в формате PEM в data будут записаны в новый файл. Если файл с таким же именем уже существует, он будет перезаписан.
Следует обратить внимание, что имена файлов являются относительными и не могут содержать разделителей путей, иначе установка не удастся.
Установка может занять некоторое время и выполняется асинхронно. По завершении будет испущен сигнал blacklistFinished().
См. также blacklistedFiles() и unblacklist().
void Certificates::blacklist(const QString &fileName, const QList<QSslCertificate> &certificates)
Устанавливает файл чёрного списка сертификатов с именем fileName.
certificates будут записаны в новый файл. Если файл с таким же именем уже существует, он будет перезаписан.
Это перегруженная функция.
[signal] void Certificates::blacklistFinished(const CertificateFile &file, Result result)
Сигнал испускается после завершения операции blacklist() для указанного file сертификата. result содержит результат операции.
QList<CertificateFile> Certificates::blacklistedFiles() const
Возвращает список всех установленных файлов чёрного списка сертификатов.
Сертификаты в этих файлах отклонены, даже если они были подтверждены системными сертификатами, предоставленными операционной системой, или одним из установленных файлов сертификатов.
Новые файлы могут быть добавлены в этот список с помощью метода blacklist(), а файлы могут быть удалены с помощью метода unblacklist().
Сигнал blacklistedFilesChanged() будет испущен, если этот список изменится.
[signal] void Certificates::blacklistedFilesChanged()
Сигнал испускается при изменении списка blacklistedFiles().
QList<QSslCertificate> Certificates::certificates() const
Возвращает список всех системных сертификатов CA.
Это комбинация сертификатов, предоставленных операционной системой, и сертификатов из файла installedFiles().
Сигнал certificatesChanged() будет испущен, если этот список изменится.
[signal] void Certificates::certificatesChanged()
Сигнал испускается при изменении списка certificates().
void Certificates::install(const QString &fileName, const QByteArray &data)
Устанавливает файл сертификата с именем fileName.
Сертификаты в формате PEM в data будут записаны в новый файл. Если файл с таким же именем уже существует, он будет перезаписан.
Следует обратить внимание, что имена файлов являются относительными и не могут содержать разделителей путей, иначе установка не удастся.
Установка может занять некоторое время и выполняется асинхронно. По завершении будет испущен сигнал installFinished().
См. также installedFiles() и uninstall().
void Certificates::install(const QString &fileName, const QList<QSslCertificate> &certificates)
Устанавливает файл сертификата с именем fileName.
certificates будут записаны в новый файл. Если файл с таким же именем уже существует, он будет перезаписан.
Это перегруженная функция.
[signal] void Certificates::installFinished(const CertificateFile &file, Result result)
Сигнал испускается, когда заканчивается действие install() для указанного file сертификата. result содержит результат операции.
QList<CertificateFile> Certificates::installedFiles() const
Возвращает список всех установленных файлов сертификатов.
Сертификаты в этих файлах расширяют системные сертификаты за пределы основного набора, предоставляемого операционной системой.
Новые файлы могут быть добавлены в этот список с помощью метода install(), а файлы могут быть удалены с помощью метода uninstall().
Сигнал installedFilesChanged() будет испущен, если этот список изменится.
[signal] void Certificates::installedFilesChanged()
Сигнал испускается при изменении списка installedFiles().
QString Certificates::lastErrorMessage()
int Certificates::lastErrorType()
void Certificates::unblacklist(const QString &fileName)
Удаляет установленный файл чёрного списка сертификатов с именем fileName.
Удаление может занять некоторое время и выполняется асинхронно. По завершении будет испущен сигнал unblacklistFinished().
См. также blacklistedFiles() и blacklist().
[signal] void Certificates::unblacklistFinished(const CertificateFile &file, Result result)
Сигнал испускается после завершения операции unblacklist() для указанного file сертификата. result содержит результат операции.
void Certificates::uninstall(const QString &fileName)
Удаляет установленный файл сертификата с именем fileName.
Удаление может занять некоторое время и выполняется асинхронно. По завершении будет испущен сигнал uninstallFinished().
См. также installedFiles() и install().
[signal] void Certificates::uninstallFinished(const CertificateFile &file, Result result)
Сигнал испускается после завершения операции uninstall() для указанного file сертификата. result содержит результат операции.