D-Bus интерфейс ru.omp.AuthService

Основной интерфейс для настройки аутентификации и блокировки. Подробнее…

Шина:	системная
Служба:	ru.omp.AuthService
Объект:	/ru/omp/AuthService
Интерфейс:	ru.omp.AuthService

Методы

• bool Authenticate(string service, QVariantMap params)
• bool Cancel()
• bool ChangeAuthData(string method, QVariantMap params)
• QDBusVariant FactorMethod(const QByteArray &token, const QString &method, const QVariantMap &params)
• bool SetDevlockState(QByteArray token, int state)

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

Основной интерфейс для настройки аутентификации и блокировки.

Интерфейс публикуется сервисом AuthService при подключении клиента к отдельному D-Bus-серверу с помощью локального unix-сокета /var/run/authd/authd.socket.

Описание методов

bool Authenticate(string service, QVariantMap params)

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

Параметры:

• service – имя сервиса для авторизации. На данный момент поддерживается только сервис "settings": авторизация в настройках.
• params – дополнительные параметры. В настоящее время они не используются, но в будущем могут содержать дополнительную информацию о запросе авторизации. Например, стороннее приложение сможет запросить авторизацию по отпечатку пальца.

Возвращает true в случае начала авторизации, false в противном случае.

bool Cancel()

Отменяет запущенную ранее авторизацию через метод Authenticate или ChangeAuthData.

bool ChangeAuthData(string method, QVariantMap params)

Выполняет запрос на смену аутентификационных данных (например, смена пароля пользователя).

Параметры:

• method – имя фактора для авторизации.
• params – дополнительные параметры. Например, для пароля можно запросить смену парольных политик с одновременной сменой пароля администратора.

Возвращает true в случае начала смены авторизационных данных, false в противном случае.

QDBusVariant FactorMethod(const QByteArray &token, const QString &method, const QVariantMap &params)

Выполняет некоторый метод фактора с именем method, передавая ему параметры params. Некоторые методы доступны, если пользователь привилегированный или есть подтверждённый токен авторизации (token).

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

bool SetDevlockState(QByteArray token, int state)

Устанавливает состояние устройства. Возможные значения аргумента те же, что и у сигнала StateChanged. В отличие от SetState, данный метод публикуется на локальном unix-сокете для конкретного клиента и может вызываться непривилегированным пользователем. Но в этом случае требуется наличие валидного токена.