Подпись на Mac работает через КриптоПро CSP, браузерный плагин и драйвер носителя. Ошибки чаще всего возникают из-за неверного порядка установки или выключенного расширения. Установка с проверкой занимает 20-40 минут
Коротко: что делать
- Войдите в профиль на cryptopro.ru
- Скачайте последний дистрибутив КриптоПро CSP для macOS
- Установите КриптоПро CSP
- Запустите установщик плагина
cprocsp-pki-2.0.pkg - Включите расширение КриптоПро в браузере
- Установите драйвер вашего токена
- Установите сертификат из контейнера
- Проверьте работу на странице КриптоПро
Что означает проблема
На Mac для работы с подписью в браузере нужна та же цепочка, что и на Windows:
| Звено | Что делает |
|---|---|
| КриптоПро CSP для macOS | работает с ключом и сертификатом |
| КриптоПро ЭЦП Browser plug-in | даёт сайту доступ к КриптоПро |
| расширение в браузере | разрешает браузеру обращаться к плагину |
| драйвер токена | делает токен видимым для системы |
Требования ФНС по памяткам на nalog.gov.ru: Mac OS X 10.13 или новее, криптопровайдер с поддержкой ГОСТ (например КриптоПро CSP 4.0 R4 и выше), плагин КриптоПро ЭЦП Browser plug-in версии 2.0 и выше. Они общие для работы с кабинетами ФНС, у других площадок требования могут отличаться, смотрите их инструкции
Версии macOS для конкретной версии CSP указаны в формуляре на странице загрузки. Сверьте свою версию macOS с ним до установки
Причины
- Нарушен порядок установки: плагин поставлен без CSP или расширение не включено
- Установлен старый дистрибутив: не из актуальной загрузки, а из старой инструкции
- Не установлен драйвер токена или установлен не тот
- Сертификат не установлен в контейнер или нет связи с ключом
- Версия macOS не подходит к дистрибутиву CSP
- Браузер не перезапускали после включения расширения
Диагностика
- Откройте диагностику рабочего места на prokep.ru
- Откройте страницу проверки плагина КриптоПро
- Проверьте токен: если Mac его не видит, начните с драйвера
| Что вы видите | Что делать |
|---|---|
| нет самого КриптоПро CSP | способ 1 |
| CSP есть, плагин не загружен | способ 2 |
| плагин работает, токена или сертификата нет | способы 3 и 4 |
Решение
Способ 1. Скачать и установить КриптоПро CSP
- Откройте страницу загрузок cryptopro.ru
- Войдите в свой профиль: без входа версия для macOS на странице не показывается
- Выберите КриптоПро CSP для macOS. По инструкции Честного Знака рекомендуется последняя сборка CSP 5.0
- Сверьте версию macOS с формуляром на странице загрузки
- Скачайте дистрибутив
- Запустите установщик
- Перезагрузите Mac, если установщик просит
Файлы с других сайтов и из торрентов не используйте. Подробнее о скачивании - статья как скачать КриптоПро CSP
Если macOS при запуске показывает предупреждение вроде «Файл cpinstance повредит компьютеру» (так было в марте 2024 года после отзыва сертификата разработчика КриптоПро), скачайте свежий дистрибутив с cryptopro.ru. Не обходите предупреждение сторонними способами
Способ 2. Плагин и расширение
- По инструкции Честного Знака плагин версии 2.0 ставится вместе с КриптоПро CSP
- Запустите файл
cprocsp-pki-2.0.pkg, он находится среди загруженных файлов КриптоПро - Включите расширение КриптоПро в списке расширений браузера
- Полностью закройте браузер и откройте снова
- Проверьте работу на странице КриптоПро
Если страница пишет, что плагин недоступен, - статья плагин КриптоПро недоступен. Общая установка плагина описана в статье как установить плагин КриптоПро
Официальная инструкция КриптоПро для Mac: macoscspplugin.pdf. Сверьтесь с ней, если шаги в вашей версии отличаются
Способ 3. Драйвер носителя
Драйвер зависит от токена:
| Носитель | Что установить |
|---|---|
| Рутокен ЭЦП 2.0 | PKCS#11 для macOS, подробности в статье Рутокен на Mac |
| Рутокен S | свой отдельный драйвер, после установки перезагрузка |
| JaCarta-2 ГОСТ | Единый клиент JaCarta |
| ESMART Token ГОСТ | ESMART PKI Client |
Скачивайте драйверы только с официальных сайтов производителей токенов
Способ 4. Установить сертификат через certmgr
Команды запускаются в программе Терминал (Программы → Утилиты → Терминал). Источник - инструкция 1С-ЭДО
Сертификат в контейнер:
/opt/cprocsp/bin/certmgr -inst -f ~/downloads/<имя>.cer -ask-container
Корневой сертификат в хранилище доверенных:
/opt/cprocsp/bin/certmgr -inst -store root -f ~/Downloads/<имя>.crt
- Замените
<имя>на имя вашего файла сертификата - Выполните команду
- При запросе выберите контейнер
- Успешная установка заканчивается сообщением
ErrorCode: 0x00000000
Контейнеры на диске лежат в папке /var/opt/cprocsp/keys/<пользователь>/
⚠️ Не удаляйте и не перемещайте папку с контейнерами, пока нет копии ключа. Сделать копию можно по статье как скопировать сертификат КриптоПро
Корневые сертификаты КЭП (квалифицированная электронная подпись) - в статье корневые сертификаты Минцифры
Если не помогло
Если КриптоПро на Mac так и не заработало, а отчёт или заявку нужно отправить сегодня, инженер ProKEP.ru подключится удалённо и настроит цепочку при вас
- подключение через RuDesktop или AnyDesk, вы видите все действия на экране
- PIN-код вы вводите сами, инженер не просит его назвать и не копирует ключи
- после работы - официальный чек самозанятого
Напишите в Telegram @prokep_bot или в мессенджер MAX. Стоимость - на странице помощи инженера
Частые вопросы
Где скачать КриптоПро CSP для Mac?
Только на сайте cryptopro.ru после входа в свой профиль на странице загрузок. Без входа версия для macOS не отображается. Файлы с других сайтов не устанавливайте
Какие требования ФНС к Mac для работы с подписью?
По памяткам ФНС нужны Mac OS X 10.13 или новее, криптопровайдер с поддержкой ГОСТ, например КриптоПро CSP 4.0 R4 и выше, и плагин КриптоПро ЭЦП Browser plug-in версии 2.0 и выше
Нужно ли ставить плагин отдельно от КриптоПро CSP на Mac?
По инструкции Честного Знака рекомендуется последняя сборка КриптоПро CSP 5.0. Плагин версии 2.0 ставится вместе с ней, затем запускается файл cprocsp-pki-2.0.pkg и включается расширение в браузере
Как понять, что сертификат установился командой certmgr?
В конце вывода команды должно быть сообщение ErrorCode: 0x00000000. Если выводится другой код, проверьте путь к файлу сертификата и PIN-код контейнера