Разработчику может потребоваться разрешить администраторам ChromeOS Enterprise динамически настраивать ваше приложение. API управляемой конфигурации предоставляет мощный инструмент, позволяющий им управлять поведением вашего приложения после его установки. Вы можете определить интерфейс, позволяющий администраторам передавать конфигурацию вашему приложению и динамически изменять его поведение, включая, помимо прочего:
- Установите определённый размер окна при открытии.
- Предварительно заполните адреса серверов или параметры аутентификации.
- Включить или отключить функции приложения.
Настройка API веб-управляемой конфигурации
Для управляемой конфигурации требуется выполнение определенных действий как разработчиками, так и администраторами предприятия. Разработчики должны реализовать API и опубликовать свой интерфейс. Администраторы предприятия должны настроить свой экземпляр из консоли администрирования. Для иллюстрации этих шагов мы рассмотрим в качестве примера настройку различных параметров входа в систему. Администратор предприятия может захотеть разрешить некоторым пользователям или подразделениям организации входить в систему с определенными учетными данными и запретить другим.
Определите и предоставьте доступ к своему настраиваемому интерфейсу.
Как и в случае с любым другим типом внешнего сервиса, целесообразно начать с определения интерфейса, который можно будет предоставлять любому клиенту, желающему настроить ваше приложение. Управляемая конфигурация отправляет в ваше приложение словарь JSON, поэтому мы рекомендуем документировать каждый параметр с описанием, типом, значением по умолчанию и допустимыми вариантами. Вот как это может выглядеть для параметра, отключающего параметры авторизации:
| Параметр | Тип | По умолчанию | Параметры | Описание |
|---|---|---|---|---|
| Нить[] | | | Список вариантов входа в систему, которые будут отключены. |
Документирование интерфейса таким образом помогает взаимодействовать с внешними командами и клиентами, а также способствует его долгосрочному поддержанию. При этом администратор предприятия может использовать следующий JSON для отключения входа "email" :
{ “DisableLoginOptions”: ["email"] };
Настройка управляемой конфигурации
Консоль администратора Google предоставляет интерфейс, позволяющий администраторам предприятия настраивать управляемую конфигурацию. На момент написания этой статьи эта опция отображается справа от выбранного приложения под названием **Управляемая конфигурация**. Ввод значения и сохранение конфигурации автоматически делают ее доступной для использования управляемым приложением.
Пользовательский интерфейс консоли администратора Google для добавления полей управляемой конфигурации.
Например, чтобы отключить вход в систему, администратор предприятия может настроить приложение с помощью { "'DisableLoginOptions'" : ["email"]} для всех пользователей в корневом организационном подразделении. Это сделает данную конфигурацию автоматически доступной для управляемого приложения после сохранения изменений.
Получите конфигурацию из вашего приложения.
После определения интерфейса и отправки конфигурации в приложение, вам необходимо получить её внутри приложения. Для этого вызовите API управляемой конфигурации:
navigator.managed.getManagedConfiguration(['DisableLoginOptions']).then(function (result) { // result = { "‘DisableLoginOptions’" : ["email"]} // hide email login option });
Функция getManagedConfiguration , основанная на промисах, принимает ключ в виде массива строк и возвращает результат в виде объекта JSON. Это значение, введенное администратором предприятия на предыдущем шаге.
Примечание: Если вы ранее использовали матрицу преобразования для TextureView в своем коде, предварительный просмотр может выглядеть некорректно на устройствах с горизонтальной ориентацией экрана, таких как Chromebook. Вероятно, ваша матрица преобразования ошибочно предполагает ориентацию датчика как 90 или 270 градусов. Вы можете обратиться к этому коммиту на GitHub для решения проблемы, но мы настоятельно рекомендуем вам перейти на использование метода, описанного здесь.
Полученные данные затем можно использовать для изменения поведения вашего приложения, позволяя администраторам динамически настраивать его и адаптировать к потребностям всех подразделений организации.