Ошибка «No signing certificate found» или сообщение Xcode о недействительном сертификате появляется чаще всего в момент, когда вы пытаетесь собрать приложение на реальное устройство или отправить сборку в App Store Connect. Причина почти всегда одна — отсутствует, истёк или отозван Apple Developer Certificate, без которого система подписи кода Apple не позволит ни установить приложение, ни опубликовать его.
Сертификат разработчика Apple — это цифровой документ, привязанный к вашей учётной записи Apple ID и паре криптографических ключей на вашем Mac. Он подтверждает, что приложение создано именно вами, и обеспечивает доверие операционной системы iOS к подписанному коду. В этой статье разберём, какие типы сертификатов существуют, как их создать, экспортировать и что делать при типичных ошибках.
Что такое Apple Developer Certificate и зачем он нужен
Сертификат разработчика выдаётся через портал Apple Developer и работает в связке с закрытым ключом, который хранится в связке ключей Keychain Access на вашем Mac. Без этой пары Xcode не сможет подписать сборку: сертификат подтверждает личность, а закрытый ключ выполняет саму криптографическую подпись.
Механизм устроен так: вы генерируете Certificate Signing Request (CSR) на своём компьютере, загружаете его на портал разработчика, а в ответ получаете файл сертификата с расширением .cer. После установки он объединяется с закрытым ключом, и Xcode получает возможность подписывать приложения.
Важно понимать разницу между элементами системы подписи:
- 🔑 Certificate — удостоверяет личность разработчика или организации;
- 📱 Provisioning Profile — связывает сертификат, App ID и список устройств;
- 🆔 App ID — уникальный идентификатор приложения;
- 🗝 Private Key — закрытый ключ, без которого сертификат бесполезен.
Типы сертификатов Apple Developer
Apple разделяет сертификаты по назначению. Выбор неправильного типа — частая причина того, что сборка не проходит проверку при загрузке в App Store Connect.
| Тип сертификата | Назначение | Где используется |
|---|---|---|
| Apple Development | Подпись сборок для разработки и отладки | Установка на тестовые устройства |
| Apple Distribution | Подпись релизных сборок | App Store, Ad Hoc, Enterprise |
| Developer ID Application | Подпись приложений для macOS вне App Store | Распространение с сайта |
| Apple Push Services | Push-уведомления | Серверная интеграция APNs |
Для большинства разработчиков достаточно двух первых типов. Apple Development позволяет запускать приложение на зарегистрированных устройствах, а Apple Distribution нужен для публикации. Один аккаунт может иметь ограниченное число активных сертификатов каждого типа, поэтому перед созданием нового стоит проверить список существующих.
Создание сертификата: пошаговая инструкция
Процедура создания одинакова для обоих основных типов и занимает несколько минут. Вам потребуется оплаченная учётная запись Apple Developer Program и Mac с доступом к Keychain Access.
☑️ Создание Apple Developer Certificate
Генерация запроса выполняется через стандартную утилиту macOS. Откройте Keychain Access, затем в строке меню выберите путь Keychain Access → Certificate Assistant → Request a Certificate From a Certificate Authority. Укажите email, выберите сохранение на диск — полученный файл .certSigningRequest загрузите на портал.
После одобрения (обычно мгновенно) скачайте сертификат и откройте его двойным кликом. Он автоматически попадёт в связку ключей. Проверьте: если рядом с сертификатом в Keychain Access есть раскрывающийся треугольник с закрытым ключом — всё настроено правильно.
⚠️ Внимание: если сертификат отображается в Keychain Access без закрытого ключа, подписывать сборки им нельзя. Такое происходит, когда сертификат скачан на компьютере, где не генерировался CSR. Решение — экспортировать файл
.p12с исходного Mac или создать новый сертификат.
Экспорт сертификата в формате p12
Работаете в команде или на нескольких машинах? Тогда потребуется перенести сертификат вместе с закрытым ключом. Для этого используется формат .p12 (PKCS#12).
В Keychain Access найдите нужный сертификат, выделите его вместе с закрытым ключом (через Cmd), кликните правой кнопкой и выберите Export. Система предложит задать пароль — сохраните его надёжно, он понадобится при импорте на другом компьютере и в CI/CD-системах.
Для автоматизации в терминале можно использовать команду проверки сертификата:
security find-identity -v -p codesigningОна выведет список действительных подписывающих идентичностей в связке ключей. Если вашего сертификата в списке нет — Xcode его тоже не увидит.
Типичные ошибки и их решения
Проблемы с сертификатами проявляются по-разному, но большинство сводится к нескольким сценариям. Разберём самые частые.
- ⚠️ «Certificate has expired» — срок действия истёк; создайте новый сертификат и обновите профили.
- 🔒 «Private key not found» — нет закрытого ключа; импортируйте .p12 с исходной машины.
- 🚫 «Certificate revoked» — сертификат отозван вами или владельцем команды; создайте новый.
- 🔄 «Provisioning profile doesn't include signing certificate» — профиль создан под другой сертификат; пересоздайте профиль.
Часто помогает простое действие: в Xcode откройте Settings → Accounts, выберите свою команду и нажмите Manage Certificates. Отсюда можно создать сертификат напрямую — Xcode сам сгенерирует ключи и отправит запрос, минуя ручную работу с CSR.
⚠️ Внимание: не отзывайте сертификат Distribution, если не уверены, что он не используется коллегами или CI-сервером. Отзыв мгновенно сломает сборку релизов у всей команды, хотя уже опубликованные в App Store приложения продолжат работать.
Срок действия и продление
Сертификаты Apple Developer имеют ограниченный срок действия — как правило, около года для сертификатов, созданных в рамках текущих правил программы. Точный срок всегда виден в портале разработчика и в Keychain Access рядом с названием сертификата.
Продлить существующий сертификат нельзя — создаётся новый. Последовательность такая: выпустите новый сертификат, обновите связанные provisioning profiles (при автоматическом управлении подписью Xcode сделает это сам), затем удалите или отзовите старый. Уже установленные на устройствах пользователей приложения не перестанут работать при истечении сертификата — ограничение касается только подписи новых сборок.
Что происходит с приложением после истечения сертификата
Опубликованные в App Store приложения продолжают работать у пользователей бессрочно — Apple переподписывает их своим сертификатом. А вот сборки, распространяемые через Ad Hoc или Enterprise, могут перестать запускаться после истечения срока профиля, поэтому их нужно периодически пересобирать и перевыпускать.
Автоматическое управление подписью в Xcode
Начиная с современных версий Xcode, Apple предлагает режим Automatically manage signing. Система сама создаёт сертификаты, регистрирует устройства и обновляет профили. Для одиночных разработчиков и небольших команд это самый безболезненный вариант.
Ручное управление оправдано, когда у вас сложная инфраструктура: несколько CI-серверов, корпоративные профили, необходимость точного контроля над entitlements. В этом случае заведите документированную процедуру: кто хранит .p12, где лежат пароли, кто отвечает за продление.
Часто задаваемые вопросы
Можно ли использовать один сертификат на нескольких Mac?
Да. Экспортируйте сертификат вместе с закрытым ключом в файл .p12 и импортируйте его на другие компьютеры. Пароль от файла понадобится при каждом импорте.
Что делать, если потерян закрытый ключ от сертификата?
Восстановить ключ невозможно. Создайте новый сертификат через портал Apple Developer или Xcode, обновите provisioning profiles, а старый сертификат отзовите, чтобы не путаться в списке.
Нужен ли платный аккаунт для создания сертификата?
Для полноценных сертификатов Development и Distribution требуется оплаченное членство в Apple Developer Program. С бесплатным аккаунтом доступна только ограниченная подпись для тестирования на собственном устройстве через Xcode.
Сколько сертификатов можно создать на один аккаунт?
Apple ограничивает количество активных сертификатов каждого типа на аккаунт. Если лимит исчерпан, отзовите неиспользуемые сертификаты или используйте существующий через экспорт .p12.
Почему Xcode не видит установленный сертификат?
Проверьте три вещи: сертификат установлен в правильную связку ключей (login), рядом с ним есть закрытый ключ, и срок действия не истёк. Команда security find-identity -v -p codesigning покажет, какие идентичности система считает действительными.