Ключи регистрации (MDM)

Ключ регистрации заводит устройства сам – для массовой установки агента на парк Mac через Jamf, Intune и другие MDM. Агентов не нужно добавлять по одному и раздавать токены: в MDM кладут пакет агента и короткий скрипт с ключом, и каждая машина, на которую он попал, появляется в Настройки → Агенты → Пользовательские со своим именем, метками и тестами ключа.

Ключи – на вкладке Настройки → Агенты → «Ключи регистрации». Вкладку видит только администратор аккаунта; число на ней – сколько ключей действует.

Только macOS

Сейчас ключом заводятся Mac. Windows – позже, вместе с установщиком на пользователя. Для Windows, Linux и телефонов агентов по-прежнему заводят по одному, см. Парк агентов.

Создать ключ

1. «+ Новый ключ».

2. Заполните окно «Новый ключ регистрации»:

   Поле	Что задаёт
   «Название»	видно в списке ключей и у каждого устройства, заведённого этим ключом, например «Офис Москва»
   «Лимит устройств»	сколько устройств можно завести ключом, по умолчанию 100
   «Действует до»	дата, до конца которой ключ работает; по умолчанию через 30 дней, не больше года
   «Метки новым устройствам»	метки, которые получит каждое новое устройство: по ним работают политика сбора и группы в отчётах
   «Добавить в тесты»	тесты к сетям и серверам, в которые встанет каждое новое устройство. Без тестов устройство присылает контекст, но не мерит сервисы
   «Описание»	необязательно – для кого ключ

3. «Создать ключ».

Места лицензии

Сверх мест лицензии устройства не заведутся – агент будет ждать места, см. Лицензия.

Метки заводятся в «Пользовательском опыте → Метки». Если меток или тестов ещё нет, окно так и пишет.

Окно «Ключ создан»

После создания окно показывает сам ключ – один раз, с кнопкой «Копировать», – и срок: «Действует до … или до N устройств. Кто знает ключ, может завести устройство в ваш аккаунт – храните его только в MDM.»

Ниже – три вкладки с инструкцией в два шага: первым шагом скачать пакет агента для macOS, вторым – скрипт.

Вкладка	Шаг 1	Шаг 2
«Jamf Pro»	«Загрузите пакет в Jamf и добавьте его в политику»	«Добавьте в ту же политику скрипт – после пакета»
«Intune»	«Добавьте пакет как приложение macOS (LOB) и назначьте группе»	«Добавьте скрипт оболочки macOS – от root, не от имени пользователя»
«Вручную»	«Установите пакет»	«Выполните в терминале – ключ спросит сам»

Скрипт для Jamf и Intune уже содержит адреса вашей платформы и ключ. Он выглядит так (адрес и ключ в окне – ваши):

#!/bin/bash
# Netelum · ключ «Офис Москва» · до 21.11.2026
cat > /tmp/netelum-enroll.conf <<'CONF'
manager=https://netelum.example.com/agent/manager
collector=https://netelum.example.com/agent/collector
key=nek_…
CONF
/usr/local/netelum/enroll.sh --enroll-config /tmp/netelum-enroll.conf

Скрипт выполняется от root и запускается после установки пакета. В Intune, если пакета ещё нет, скрипт завершится ошибкой, и Intune повторит его по своему расписанию.

Вкладка «Вручную» – для пробы на одной машине: команда спрашивает ключ в терминале, и он не попадает ни в аргументы процесса, ни в историю оболочки.

Окно закрывается кнопкой «Готово». После этого ключ больше не показывается нигде – если его не сохранили, создайте новый.

Что происходит на машине

Скрипт кладёт ключ агенту и стирает файл конфигурации. Агент меняет ключ на свой токен и стирает ключ, а устройство появляется в «Пользовательских» с именем машины, метками и тестами ключа. В раскрытии его строки – «заведено ключом «…»».

• Ответ скрипта – «агент зарегистрирован ключом и запущен» или причина, по которой платформа пока отказала: лимит ключа исчерпан, нет мест в лицензии, ключ отозван или истёк. Агент при этом запущен и повторяет сам раз в час: освободили место или подняли лимит – машина заведётся без второго прохода MDM.
• Повторный запуск скрипта на заведённой машине ничего не меняет.
• Переустановка на той же машине даёт то же устройство в панели, если прежний агент молчал 15 минут.

Окно macOS с вопросом о геопозиции (доступ к имени сети Wi-Fi, см. Установка на Mac, шаг 4) остаётся вопросом сотруднику.

Версия пакета

Ключом заводится агент из пакета текущего релиза платформы – берите пакет по ссылке в окне «Ключ создан». Агенты старых версий ключ не понимают.

Список ключей

Колонка	Что в ней
«Ключ»	название ключа
«Использовано»	сколько устройств заведено из лимита, например «12 из 100»
«Действует до»	дата окончания
«Метки»	метки, которые получают новые устройства
«Статус»	«действует», «исчерпан», «истёк» или «отозван»

Сверху – действующие ключи, за ними исчерпанные, истёкшие и отозванные; внутри – новые сверху.

В раскрытии строки:

• «Создал» – кто и когда;
• «Тесты новым устройствам» и «Описание»;
• «Последнее устройство» – когда ключом заводили устройство в последний раз;
• «Переустановок» – сколько раз ключом заново заводили уже известную машину;
• «Отказано за неделю» – сколько отказов и почему: «нет мест в лицензии», «лимит ключа исчерпан», «устройство с тем же серийником на связи»;
• до пяти последних устройств, заведённых ключом, со статусом и последним контактом, и ссылка «Все N в «Пользовательских»» – она открывает вкладку с фильтром «Ключ».

Изменить ключ

Меню строки (⋯) → «Изменить». Можно поменять название, лимит устройств, срок и описание. Метки и тесты ключа не меняются: их уже получили заведённые устройства. Нужны другие – создайте новый ключ.

Если ключ исчерпан, а машины ещё ставятся, поднимите лимит: машины, которым отказали, заведутся сами при следующей попытке – агент повторяет раз в час.

Отозвать ключ

Меню строки (⋯) → «Отозвать» → окно «Отозвать ключ «…»?» → «Отозвать ключ». Новые устройства этим ключом больше не заведутся. Уже заведённые работают дальше на своих токенах. Отменить отзыв нельзя – понадобится новый ключ. Отозванный ключ остаётся в списке со статусом «отозван» и строкой «Отозвал» в раскрытии.

Ключ утёк

Отзовите его и создайте новый, а в MDM замените скрипт. Устройства, уже заведённые старым ключом, трогать не нужно.

Журнал

В журнал попадают создание, изменение и отзыв ключа, каждое устройство, заведённое или переустановленное ключом, и каждый отказ устройству. Сам ключ в журнал не попадает.