Окно агента: платформы и состояния¶
Окно агента —
приложение alatyr-agent-gui, единственная часть продукта, которую видит не
администратор, а сотрудник. Эта страница отвечает на два вопроса, которых нет в
общем разделе: на каких платформах окно вообще поставляется и что означает
каждое состояние цели, которое окно показывает.
На каких платформах есть окно¶
| Платформа | Окно в стандартной поставке | Что вместо него |
|---|---|---|
| Windows | да — alatyr-agent-gui.exe входит в MSI и ставится вместе с агентом |
— |
| Linux | нет — окно собирается отдельной сборкой (джоба build:agent-gui:linux), но в пакеты deb/rpm/tgz не входит |
команда alatyr-agent purposes |
| macOS | да, начиная с 1.5.5 — alatyr-agent-gui.app входит в .pkg и открывается из значка в строке меню |
— |
На Linux, где окна в поставке нет, состояние целей показывает консольная команда (на любой платформе она работает и рядом с окном):
$ alatyr-agent purposes
Она называет те же состояния, что и окно, — таблица ниже относится и к ней.
Что окно может и чего не может¶
Коротко (подробно — в разделе «Окно агента»):
- Слева — список целей, справа — состояние выбранной и пояснение, что агент делает дальше. Внизу — переключатель языка и время последнего обмена с сервером.
- Цель, которая сотруднику не назначена, можно запросить кнопкой «Запросить»: заявка попадёт администратору в раздел Запросы назначений. Прав окно не выдаёт — решение всегда за администратором.
- Окно стартует скрытым: его открывают из значка агента в системной панели.
- Часть целей может быть скрыта администратором на весь парк — тогда раздела в окне нет вовсе, и это не «продукт сломан».
Что означает состояние цели¶
Состояния сформулированы так, как их показывает окно (и alatyr-agent purposes).
Жизненный цикл устройства и цели:
| Состояние | Что оно значит | Что делать сотруднику |
|---|---|---|
| Устройство ещё не зарегистрировано | Машина ещё не появилась на сервере | Дождаться регистрации; если долго — к администратору |
| Регистрация ждёт решения администратора | Заявка на регистрацию подана, решения ещё нет | Ждать решения администратора |
| Регистрация отклонена | Администратор отклонил регистрацию этого устройства | Обратиться к администратору |
| Сертификат отозван | Доступ устройства (или цели) отозван | Обратиться к администратору |
| Устанавливается | Одобренный сертификат ставится на машину | Ничего, процесс короткий |
| Не запрошено | Цель назначена, но сертификат ещё не просили | Нажать «Запросить» или подождать автоматический выпуск |
| Ещё не выдан | Цель видна, выдачи ещё не было | Подождать; если долго — к администратору |
| Разрешено, агент выпускает | Администратор разрешил, агент выпускает сертификат | Ничего |
| Выдан | Сертификат выпущен и установлен, цель работает | Ничего |
| Выдан, но не установлен | Сертификат выпущен, но на машине не появился | Перезапустить агент; если повторяется — к администратору |
| Выпуск сертификата отклонён | Сервер отказал в выпуске именно этой цели | Обратиться к администратору |
| Заявка на рассмотрении | Запрос цели отправлен администратору | Ждать решения в «Запросах назначений» |
| Заявка отклонена | Администратор отказал в запросе | Обратиться к администратору |
| Заявка записана | Запрос сохранён на машине и уйдёт при следующей связи с сервером | Ничего, уйдёт само |
| Доступ отозван | Доступ к цели отозван | Обратиться к администратору |
| Сертификата нет на месте | Сертификат числится выданным, но на машине его нет | Перезапустить агент; если повторяется — к администратору |
Работа со смарт-картой (когда цель требует PIN-код карты):
| Состояние | Что оно значит | Что делать сотруднику |
|---|---|---|
| Ждём ваш PIN | Для выпуска нужен PIN-код карты | Ввести PIN в окне агента |
| PIN принят | PIN принят, выпуск продолжается | Ничего |
Особые случаи:
| Состояние | Что оно значит | Что делать сотруднику |
|---|---|---|
| Пока не поддерживается на этой платформе | Цель на этой ОС не выдаётся | Ничего, это ограничение платформы |
| Состояние недоступно | Окно не смогло прочитать локальное состояние | Перезапустить агент; если повторяется — к администратору |
| Сервер отказал в регистрации ключа | Сервер отказал в регистрации ключа устройства | Обратиться к администратору (точную причину см. в пояснении под состоянием) |
| Состояние на сервере: … | Состояние цели названо словами сервера | См. пояснение рядом |
Если «Запросить» нажато, а ничего не происходит¶
Кнопка «Запросить» остаётся доступной всегда — это не поломка. Если после нажатия окно сообщает, что «подписать запрос нечем», формулировка различает три случая — читайте её до конца:
- «устройство ещё не зарегистрировано: … нечем» — машина ещё не зарегистрирована на сервере. Дождаться регистрации или обратиться к администратору.
- «устройство зарегистрировано, но пользовательская половина агента ещё не получила токен: … нечем» — регистрация уже прошла, просто агенты ещё не обменялись: первый такт после входа человека токен ещё не принёс. Подождать следующий такт, переустанавливать агента не нужно.
- «устройство зарегистрировано; пользовательские цели выключены политикой выдачи — администратор включает их в настройках (политика выдачи устройства «пользователь» или «обе»), погашены: …» — администратор погасил цели политикой выдачи. Список погашенных целей назван в самом сообщении.
Что дальше¶
- Про окно в целом, скрытые цели и лицензионные места: Агенты.
- Про цель доступа по VPN: Доступ по VPN.