В интерфейсе Ринго, в логах и в документации Apple одни и те же понятия называются по-разному. В этом разделе используется термин из первой колонки, а во второй колонке перечислены варианты, под которыми он встречается в интерфейсе и логах.
| Термин | Другие названия | Определение |
|---|---|---|
| Регистрация | Энролл, зачисление («Устройство не зачислено в mdm»), enrollment, привязка (кнопка «Привязать») | Установка на устройство профиля, после которой Ринго может управлять устройством. |
| Enroll-профиль | «MDM Enroll Profile», com.ringo.mdm, enroll.mobileconfig, com.ringo.enroll, профиль MDM |
Профиль, который регистрирует устройство в Ринго. Со страницы регистрации скачивается enroll.mobileconfig (com.ringo.enroll): устройство отправляет серверу подписанный запрос и получает профиль MDM «MDM Enroll Profile» (com.ringo.mdm) с адресом сервера и настройками MDM. |
| Сертификат устройства | «Ringo Device Identity», identity, «Сертификат энролл профиля» | Сертификат, которым устройство подписывает запросы к серверу. Выдаётся при регистрации по SCEP и действует один год. |
| SCEP | /scep, «SCEP‑сервер» |
Протокол, по которому устройство получает сертификат при регистрации. |
| UDID | udid, Hardware UUID | Уникальный идентификатор устройства. В логе backend записывается строчными буквами, на Mac — заглавными. |
| Снятие с учёта | CheckOut, «Пользователь удалил MDM профиль», unenroll |
CheckOut — сообщение устройства серверу о том, что профиль MDM удалён. Поле «Пользователь удалил MDM профиль: Да» в карточке устройства Ринго выставляет после CheckOut, после ответа Apple о недействительном push-токене или когда агент сообщает, что профиля MDM на Mac нет. |
| Одобренное пользователем MDM | User Approved MDM, MDM enrollment: Yes (User Approved) |
Регистрация macOS, подтверждённая пользователем в Системных настройках. Без подтверждения часть настроек не применяется. |
| Контролируемое устройство | Supervised | Устройство, зарегистрированное через ADE или Apple Configurator. Ему доступны дополнительные команды и ограничения. |
| ADE | Automated Device Enrollment, DEP, Enrolled via DEP |
Автоматическая регистрация устройств, приобретённых организацией, через Apple Business Manager. |
| Bootstrap Token | SetBootstrapToken, «Bootstrap Token escrowed to server» |
Ключ, который Mac передаёт серверу, чтобы сервер мог выдавать Secure Token и разрешать обновления на Mac с Apple silicon. |
| Термин | Другие названия | Определение |
|---|---|---|
| Канал MDM | Протокол Apple MDM, mdmclient | Встроенный в macOS и iOS механизм управления: профили и MDM-команды. |
| MDM-команда | Команда, Apple MDM command, InstallProfile, «Установка профиля» |
Действие, которое сервер ставит в очередь для устройства. Устройство забирает команду само. |
| Push | Push-нотификация, push-уведомление, APNS push | Короткий сигнал через Apple, который сообщает устройству о новых командах. Самих команд он не содержит. |
| APNs | Apple Push Notification service, api.push.apple.com, courier.push.apple.com |
Служба Apple, через которую доставляются push. |
| APNs-сертификат | «Сертификат APNS», MDM Push Notification Certificate, push-сертификат | Сертификат, с которым сервер отправляет push. Apple выдаёт его на один год; продлевается кнопкой Renew. |
| Topic (идентификатор) | «Идентификатор» в разделе Настройки → Сертификат APNS, com.apple.mgmt.External.…, UID сертификата |
Идентификатор канала push. У устройства и у APNs-сертификата он должен совпадать. |
| Push-токен | TokenUpdate, push token, mdm_push_token |
Адрес конкретного устройства в APNs. Устройство сообщает его серверу при регистрации. |
| Ответы устройства | Idle, Acknowledged, Error, NotNow |
Соответственно: «готово принять команды», «выполнено», «отказ», «сейчас не может». В Ринго им соответствуют статусы «Выполнено», «Ошибка» и «Отложено»; пока ответа нет, команда в статусе «Отправлено». |
| Профиль конфигурации | Профиль, payload, .mobileconfig |
Набор настроек, который устанавливается на устройство MDM-командой. |
| Термин | Другие названия | Определение |
|---|---|---|
| Агент | Агент Ринго, com.ringo.agent, AgentGateway |
Программа Ринго на устройстве: политики, скрипты, пакеты, терминал, инвентаризация ПО. |
| Профиль агента | «RINGO Agent Configuration Profile», com.ringo.agent.configuration |
Профиль с настройками подключения, сертификатом агента и разрешениями PPPC. |
| Сертификат агента | «Ringo Agent Device Identity» | Сертификат, с которым агент проходит авторизацию на сервере. |
| Сборка агента | Build id, «Неверный id сборки» |
Версия агента. Должна совпадать с версией сервера. |
| Политика | Policy | Задание для агента (скрипт, пакет, сбор сведений), которое запускается по триггеру с заданной частотой. |
| Точка распространения | Package Distribution Point, точка распространения пакетов | Сервер HTTP или SMB, с которого агент загружает пакеты. |
| Область действия | Scope, «Устройство включено в область профиля» | Устройства и группы, к которым применяется профиль или политика. |
| PPPC | Privacy Preferences Policy Control, TCC | Настройка профиля, которая даёт программе доступ к файлам и действиям без запроса у пользователя. Для агента входит в «RINGO Agent Configuration Profile». |
| Термин | Другие названия | Определение |
|---|---|---|
| Backend | roll-deploy-backend, приложение Ринго, порт 5000 |
Основной контейнер Ринго: интерфейс, API, протокол MDM, очередь команд, отправка push. |
| Reverse proxy | Прокси, nginx-proxy, балансировщик |
Сервер перед backend: TLS, маршрутизация путей, ограничение доступа. |
| WAF | ModSecurity, межсетевой экран для веб-приложений | Фильтр HTTP-запросов перед сервером. Может блокировать запросы MDM: их тело — plist, а не обычная веб-форма. |
| SSL-inspection | TLS-инспекция, MITM-прокси | Расшифровка TLS на прокси с подменой сертификата сайта. Если корневой сертификат прокси не установлен на устройстве, агент не доверяет сертификату сервера. |
| Полная цепочка | Fullchain | Сертификат сервера вместе с промежуточным сертификатом. Прокси должен отдавать её целиком: без промежуточного сертификата устройства и агенты не доверяют серверу. |
| DPI, ТСПУ | Глубокая инспекция трафика | Оборудование на пути трафика, которое может разрывать долгие соединения или останавливать передачу данных. |
| Исходящий прокси для Apple | APPLE_PROXY_URL |
Прокси, через который backend отправляет push, если у сервера нет прямого доступа в интернет. |
Проверено на Ринго 3.0.5, октябрь 2026. Тексты ошибок — Справочник ошибок, термины — Термины.