¶ Linux
¶ Ручная регистрация
¶ Шаг 1. Переход на страницу регистрации
На главной странице веб-интерфейса Ринго нажмите на пункт меню «Привязать».
¶ Шаг 2. Авторизация
В появившемся окне введите логин и пароль учётной записи, которая имеет доступ к странице регистрации устройств.
¶ Шаг 3. Загрузка агента
После успешной авторизации скачайте и разархивируйте установщик агента ringo-agent-linux на устройстве Linux, которое нужно добавить в Ринго.
¶ Шаг 4. Запуск установки агента
Запустите в терминале service.sh из разархивированной папки.
¶ Шаг 5. Установка агента
В командной строке введите 1 и нажмите ввод. После успешной установки в окне командной строки будет сообщено о этом.
¶ Шаг 6. Проверка регистрации устройства
После завершения установки профилей устройство становится управляемым и отображается в списке устройств веб-интерфейса Ринго.
¶ Автоматическая массовая регистрация устройств
Скрипт разворачивает агента Ринго на Linux-устройствах без ручного прохождения мастера enroll на каждой машине. Предусмотрены два режима работы — выбор зависит от того, есть ли у устройств сетевой доступ к серверу Ринго.
| Режим | Условие применения | Источник enroll-архива |
|---|---|---|
| Онлайн-установка | Устройство имеет сетевой доступ к серверу Ринго | Скрипт скачивает архив с сервера самостоятельно |
| Автономная установка | Сетевой доступ к серверу Ринго закрыт | Архив подготавливается администратором заранее и доставляется на устройство вместе со скриптом |
Во всех примерах вместо
https://ringo.example.comукажите адрес вашего сервера Ринго, вместоadminиsecret— учётные данные администратора.
¶ Онлайн-установка
Скрипт install-ringo-linux.sh обращается к серверу Ринго, проходит аутентификацию, скачивает enroll-архив и устанавливает агента. Аутентификация выполняется по учётным данным пользователя Ринго либо по bearer-токену.
Для работы скриптов может потребоваться установка следующих пакетов:
apt install jq curl unzip
¶ Параметры скрипта
| Параметр | Назначение |
|---|---|
--ringo |
Адрес сервера Ринго |
--user |
Логин пользователя Ринго |
--pass |
Пароль пользователя Ринго |
--token |
Bearer-токен, используется вместо пары логин/пароль |
get-token |
Запрос токена без установки агента |
¶ Аутентификация по учётным данным
sudo bash ./install-ringo-linux.sh --ringo https://ringo.example.com --user admin --pass secret
¶ Аутентификация по bearer-токену
Токен запрашивается отдельным вызовом и сохраняется в переменную TOKEN:
TOKEN=$(bash ./install-ringo-linux.sh get-token --ringo https://ringo.example.com --user admin)
Полученное значение передаётся в параметре --token:
sudo bash ./install-ringo-linux.sh --ringo https://ringo.example.com --token "$TOKEN"
Время жизни bearer-токена — 15 минут. Интерактивный ввод пароля требуется только при запросе токена, сама установка выполняется без него. Такой порядок позволяет не передавать пароль администратора в командной строке на конечных устройствах и не сохранять его в журналах.
¶ Автономная установка
Устройства не обращаются к серверу Ринго для загрузки архива с агентом, поэтому enroll-архив готовится заранее.
Порядок подготовки:
- Администратор скачивает enroll-архив
ringo-*.zipи размещает его на файловом ресурсе. - Средствами централизованного управления конфигурацией архив и скрипт доставляются на каждое устройство в один каталог.
- На устройстве запускается только скрипт;
Скрипт install-ringo-linux-offline.sh распаковывает архив, извлекает значение challenge из service.sh и устанавливает агента. Установка проходит без взаимодействия с оператором.
¶ Запуск
sudo bash ./install-ringo-linux-offline.sh
Срок действия
challengeв enroll-архиве — 90 дней с момента скачивания. По его истечении архив непригоден для установки: необходимо скачать новый и повторить раздачу.