Статус `Invalid` — не повод менять сертификаты наугад. Скачайте notary log для конкретного submission ID: в нём Apple указывает путь к проблемному executable, архитектуру и сообщение проверки. У Electron-приложения ошибка часто находится не в основном `.app`, а во вложенном helper, native module или утилите, попавшей в Resources.
Правильный порядок выпуска такой: собрать приложение, подписать все вложенные исполняемые объекты изнутри наружу, проверить подпись локально, упаковать, отправить outer artifact в notary service, дождаться Accepted и прикрепить ticket. Перепаковка после подписи или notarization меняет байты и разрушает проверенную цепочку.
Notary log превращает общий отказ в конкретный файл
xcrun notarytool history --keychain-profile "notary-ci"
xcrun notarytool log <submission-id> --keychain-profile "notary-ci"
codesign --verify --deep --strict --verbose=4 "dist/Example.app"
spctl --assess --type execute --verbose=4 "dist/Example.app"Команды используют условное имя профиля Keychain и путь. Секреты не передавайте аргументами CI и не печатайте их в лог. `--deep` удобен как проверка, но не должен маскировать неправильный процесс подписи: каждый вложенный компонент подписывается явно или корректно обрабатывается инструментом сборки.
Сообщение Apple указывает класс исправления
| Сообщение или признак | Обычно означает | Где исправлять |
|---|---|---|
| The binary is not signed | В архив попал неподписанный executable | Шаг packaging и список extraResources |
| Signature does not include a secure timestamp | Подпись создана без timestamp | Параметры codesign/osxSign |
| Hardened Runtime is not enabled | Цель подписана без runtime option | Конфигурация подписи приложения и helpers |
| Invalid entitlement | Entitlements не подходят цели или имеют неверный формат | Файлы entitlements для parent/child процессов |
| Accepted, но offline запуск не проходит | Ticket не прикреплён к распространяемому artifact | Staple и финальная упаковка |
Apple требует Developer ID-подпись, Hardened Runtime, secure timestamp и корректные entitlements для современного workflow. Не включайте `get-task-allow` в release. Разрешения JIT для Electron добавляйте только в соответствии с актуальной версией Electron и потребностями процесса: лишний entitlement расширяет поверхность атаки.
Проверьте каждый вложенный исполняемый объект
Electron bundle содержит main app, Helper, Helper Renderer, GPU helper и иногда `.node` native modules. Сторонний updater или CLI тоже является кодом. Сопоставьте каждый path из notary log с правилом упаковки: кто его создал, каким identity подписал и какой entitlements-файл применил.
- Удалите из release случайные тестовые binaries и debug-инструменты.
- Не изменяйте `.app` после финальной подписи.
- Собирайте universal binary только из корректно подписываемых архитектурных частей.
- Проверяйте, что CI использует Developer ID Application нужной Team ID.
- Храните учётные данные notarytool в Keychain profile или защищённых секретах CI.
От Accepted до готового файла есть ещё два шага
Accepted означает, что Apple создала ticket, но пользователю нужен тот же artifact, который вы проверили. Выполните stapling для приложения или внешнего контейнера согласно схеме распространения и проверьте результат. Apple рекомендует notarize outermost container: при цепочке app → pkg → dmg подписываются компоненты, а отправляется внешний распространяемый контейнер.
Тестируйте скачанный release на другой чистой машине или хотя бы в отдельной среде с quarantine attribute. Локальный build-каталог может иметь исключения и кеши, которых у пользователя нет. Проверка запуска рядом с исходниками не заменяет тест DMG/ZIP, полученного из канала доставки.
Когда повторно отправлять сборку
Повторная submission оправдана только после локального подтверждения исправления по каждому issue из лога. Сохраните submission ID, commit, хеш artifact и версии Electron/packager: так ответ Apple связывается ровно с одним файлом. Если статус долго не меняется, не создавайте очередь одинаковых загрузок — сначала проверьте history и состояние исходной submission.
Для разбора подготовьте notary log без учётных данных, вывод codesign/spctl, структуру bundle и конфигурацию osxSign/osxNotarize. Сертификат с приватным ключом, app-specific password и API key передавать не нужно.