Настройка постоянного доступа на macOS

Установка постоянной фоновой службы выполняется в два этапа:

Этап 1. Установка основного приложения
Этап 2. Запуск службы через терминал macOS

Этап 1

Установка основного приложения

Скачать файл установки для запуска абонентской части программы на macOS можно одним из способов:

Из личного кабинета.
По ссылке: https://help.kontur.ru/files/Kontur.Dostup.Abonent.dmg.

После загрузки файла установки запустите его. Появится окно.
Чтобы произошла установка, перетащите значок доступа в папку «Applications».
После установки приложение не запустится самостоятельно, нужно найти его в папке «Applications» и запустить.
При первом запуске операционная система сообщит о необходимости предоставить права приложению. Нажмите «Открыть Системные настройки».
В разделе «Конфиденциальность и безопасность» включите пункт «Контур.Доступ Абонент».
Операционная система может запросить подтверждение действия отпечатком пальца или вводом пароля от учетной записи apple.
В окне с запросом прав нажмите «Открыть Системные настройки».
В разделе «Конфиденциальность и безопасность» включите пункт «Контур.Доступ Абонент».
Подтвердите действие отпечатком пальца или вводом пароля от учетной записи apple.

После установки и выдачи прав приложению запускать само приложение не обязательно, так как далее установка фоновой службы будет через терминал macOS.

Этап 2

Запуск службы через терминал macOS

Обычная установка

Запустите терминал macOS: «Finder» → «Applications/Приложения» → «Utilities/Утилиты» → «Terminal/Терминал».
В открывшемся окне введите команду, которая указывает папку с приложением, чтобы терминал понимал, к какой программе выполнять следующие команды:
```
cd /Applications/Kontur.Dostup\ Abonent.app/Contents/MacOS
```
Нажмите клавишу Enter.
Введите следующую команду, которая запускает фоновую службу с постоянным портом и паролем:
```
sudo ./kontur.dostup.abonent --install
```
Нажмите клавишу Enter.
Система запросит подтвердить действие вашим паролем от записи apple или отпечатком пальца.
После выполнения команды окно терминала сформирует постоянные порт и пароль для подключения к службе.
Сохраните порт и пароль или добавьте это устройство в личный кабинет для подключения прямо из сервиса.
При необходимости установку постоянной службы можно сразу же выполнить с автоматическим добавлением устройства в адресную книгу, нужную папку и с указанием тегов. В таком случае команда установки будет выглядеть так:
```
sudo ./kontur.dostup.abonent --install /OrgId=8908a69a-05a1-477b-91cb-e9d4315311a8 /GroupId=0c6d09da-3849-4996-9af2-8d2bb48e79d6 /contacttag=123,virtualbox,macOS
```

OrgID — обязательный параметр для автоматического добавления контакта. Находится в разделе «Устройства» → кнопка «Массовое добавление».
GroupId — необязательный параметр, используется только для автоматического добавления в определенную папку. Находится в разделе «Устройства» → нажмите на нужную папку в сервисе → «Управление папкой».
contacttag — необязательный параметр, используется, только если при добавлении контакта ему сразу же необходимо назначить теги. Перечисляются через запятую без пробелов.

Дополнительные команды для управления службой:

sudo./kontur.dostup.abonent --uninstall

sudo./kontur.dostup.abonent --credentials

sudo./kontur.dostup.abonent --reset-port

sudo./kontur.dostup.abonent --reset-password

./kontur.dostup.abonent --status

Пример

Вы выполнили обычную установку и сохранили порт и пароль, но позже они были скомпрометированы. В этом случае необходимо изменить порт и пароль для подключения. Для этого запустите терминал и выполните команды:

cd /Applications/Kontur.Dostup\ Abonent.app/Contents/MacOS — данная команда указывает папку с приложением, чтобы терминал понимал к какой программе выполнять следующие команды.
sudo./kontur.dostup.abonent --uninstall — чтобы внести какие-либо изменения, службу сначала нужно остановить.
sudo./kontur.dostup.abonent --reset-port — команда для генерации нового порта.
sudo./kontur.dostup.abonent --reset-password — команда для генерации нового пароля.
sudo./kontur.dostup.abonent --install — запускается постоянная служба и подключиться к ней можно только по новым порту и паролю.

Установка с дополнительными параметрами

Список дополнительных параметров установки постоянной службы:

sudo./kontur.dostup.abonent --enable-watchmode

sudo./kontur.dostup.abonent --disable-watchmode

sudo./kontur.dostup.abonent --enable-watchmode

sudo./kontur.dostup.abonent --disable-watchmode

sudo./kontur.dostup.abonent --enable-ask-connect-permission-service

sudo./kontur.dostup.abonent --disable-ask-connect-permission-service

Пример

Вы выполнили обычную установку, но позже поняли, что иногда нужно подключаться в режиме наблюдения без забора управления. Для этого выполните команды в терминале в следующем порядке:

cd /Applications/Kontur.Dostup\ Abonent.app/Contents/MacOS — команда указывает папку с приложением, чтобы терминал понимал к какой программе выполнять следующие команды.
sudo./kontur.dostup.abonent --uninstall — чтобы внести какие-либо изменения, службу сначала нужно остановить.
sudo./kontur.dostup.abonent --enable-watchmode — команда включает режим наблюдения.
sudo./kontur.dostup.abonent --install — постоянная служба становится снова активной и теперь по необходимости к ней можно подключиться в режиме наблюдения.