Безопасность

Как развернуть fastlane match на общем Mac: руководство по изоляции корпоративной подписи 2026

На общем Mac разные проекты начинают подписывать сборки одной и той же личностью, а после сбоя уже невозможно установить, какой pipeline использовал закрытый ключ.

Быстрое решение: не выдавать всем проектам общий доступ к хранилищу fastlane match и постоянному Keychain; разделить активы по Apple-командам и доменам доверия, перевести обычный CI в режим readonly с временным Keychain, а релизные задачи вынести на отдельный Mac-узел.

Эта статья предназначена руководителям, которые управляют несколькими iOS-приложениями и хотят исключить ошибочное использование сертификатов на общей машине. Она также полезна владельцам CI/CD-платформы, аудиторам безопасности и IT-командам, отвечающим за отзыв доступа после увольнения.

Что именно изолировать до первого запуска

Развёртывание fastlane match на общем Mac — это не установка инструмента и не копирование Matchfile. match синхронизирует сертификаты и provisioning profiles из выбранного хранилища, но сам по себе не разделяет хост, репозиторий, Apple-аккаунт, секрет расшифровки и право публикации. Эти границы должна определить архитектура CI.

Официальная документация fastlane описывает хранение подписывающих активов в Git или объектном хранилище, различение команд и режим чтения для CI. Это означает, что механизм синхронизации есть, но ответственность за модель доступа остаётся на стороне организации: описание возможностей match в официальной документации.

Для каждого приложения необходимо зафиксировать:

  • Apple Team ID и владельца бизнес-приложения;
  • bundle identifier, включая варианты для production, staging и внутренних сборок;
  • тип сертификата и связанный provisioning profile;
  • хранилище активов и ветку либо префикс пути;
  • субъект, который может создавать или обновлять активы;
  • pipeline, которому разрешена только загрузка;
  • задачу, которой разрешено распространение или публикация;
  • срок действия секрета расшифровки и порядок его замены.

На общей машине есть как минимум четыре скрытых риска. Во-первых, постоянный Keychain может содержать закрытые ключи сразу нескольких проектов. Во-вторых, агент CI способен получить больше полномочий, чем требуется для проверки сборки. В-третьих, общий каталог или кэш может оставить сертификаты после завершения задачи. В-четвёртых, при ручном запуске легко выбрать доступную identity другой команды, если конфигурация не проверяет Team ID и bundle identifier.

Первый сценарий: пилот с одним доверенным приложением

Для одного приложения допустима минимальная архитектура, если репозиторий и pipeline находятся в одном доверенном контуре. Это не означает, что всё следует складывать в общий постоянный профиль пользователя.

Сначала назначается отдельный идентификатор приложения и один ответственный за инициализацию подписывающих активов. Его задача — создать или обновить сертификаты и profiles в административном процессе. Ежедневный CI не должен выполнять эту операцию автоматически. Для него используется отдельный путь синхронизации с режимом только чтения.

Инициализация и обычная сборка — разные классы операций:

  • административная задача создаёт, обновляет или отзывает активы;
  • CI получает уже подготовленный набор и не меняет его;
  • релизная задача использует отдельное разрешение на публикацию;
  • аудит видит, кто изменил активы и какой pipeline получил их.

Временный macOS Keychain следует создавать непосредственно перед импортом сертификата и удалять после сборки. Документация setup_ci предназначена именно для настройки CI-окружения, включая подготовку безопасного рабочего процесса с Keychain: официальные параметры setup_ci.

Приёмка пилота считается неполной, если проверена только успешная сборка. В журнале должны остаться:

  • запись обращения pipeline к хранилищу;
  • подтверждение правильного Team ID;
  • результат сборки с ожидаемым bundle identifier;
  • факт создания временного Keychain;
  • факт удаления Keychain и импортированных ключей;
  • повторный запуск после очистки;
  • понятная ошибка при неверном секрете;
  • инструкция возврата к последнему рабочему активу.

Если после завершения job закрытый ключ остаётся в пользовательском Keychain, пилот нельзя считать готовым к расширению на другие проекты.

Когда общего хранилища достаточно для пилота

Несколько приложений могут временно использовать один логический репозиторий активов только при строгом разделении путей, идентификаторов и субъектов доступа. Общая оболочка хранилища не должна превращаться в общий доступ ко всем сертификатам.

Нужно заранее проверить, что pipeline приложения A не может скачать profile приложения B, даже если знает имя файла. Одной договорённости о префиксах недостаточно: сервисный субъект должен получать только требуемый набор объектов, а ошибочный запрос должен завершаться отказом.

Второй сценарий: несколько приложений в одной Apple-команде

Одна Apple-команда не делает все приложения взаимозаменяемыми. У них могут различаться уровень конфиденциальности, частота релизов, владельцы и последствия компрометации.

Для принятия решения удобно использовать карту «приложение — сертификат — profile — CI-задача». Она должна отвечать на четыре вопроса: какой актив нужен, кто его читает, кто его обновляет и какой ущерб возникнет при ошибочном доступе.

Сценарий Хранилище и область доступа Кто получает закрытый ключ Где выполняется задача Доказательство приёмки
Проверка доверенного приложения Отдельная область приложения Только временный CI-процесс Общий Mac с очищаемым Keychain Повторная сборка и журнал очистки
Несколько малорисковых приложений одной команды Разделённые пути или ветки с политикой доступа Только назначенные pipeline Общий узел при доказанной изоляции Отказ при запросе чужого bundle identifier
Чувствительное приложение Отдельное хранилище или физически выделенная область Только релизный pipeline Выделенный Mac-узел Ошибка при неверном Team ID и ручное подтверждение
Несколько Apple-команд Разные хранилища, ветки и секреты расшифровки Субъект конкретной команды Раздельные узлы или строго изолированные пулы Невозможность получить актив другой команды
Production-релиз Ограниченное хранилище и закрытый триггер Только релизная роль Независимый узел публикации Аудит запуска, очистка и повторяемый релиз

Внутри одной команды можно совместить инфраструктуру, но нельзя автоматически совмещать права. Низкодоверенный репозиторий не должен запускать job, которая получает ключ приложения с высокой стоимостью ошибки. Это особенно важно для pull request, сторонних интеграций и задач, запускаемых по пользовательскому вводу.

Если приложения принадлежат разным бизнес-линейкам, имеют разных владельцев или используют разные правила выпуска, предпочтительнее раздельные хранилища. Логическая изоляция снижает операционные расходы, но физическое разделение лучше ограничивает последствия ошибки в политике доступа. Для высокочувствительного приложения запрет должен опираться не на название ветки, а на независимое разрешение и отдельный секрет.

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

Третий сценарий: несколько Apple-команд и бизнес-линий

При работе с несколькими Team ID правило должно быть жёстким: одна команда — собственная область активов, собственный секрет расшифровки и понятный субъект доступа. Разные ветки в одном репозитории могут быть допустимы для умеренного риска, но для критичного production-кода лучше использовать раздельные хранилища.

В конфигурации следует явно проверять:

  1. ожидаемый Team ID;
  2. ожидаемый bundle identifier;
  3. тип сертификата;
  4. имя provisioning profile;
  5. субъект, которому разрешено расшифрование;
  6. целевую среду — staging или production.

Тест ошибки обязателен. В изолированной среде намеренно задаётся неверная команда, после чего pipeline должен завершиться отказом. Он не должен автоматически выбрать другую доступную identity только потому, что она присутствует в Keychain. Такой fallback удобен для ручной работы, но опасен для корпоративной подписи: сборка может пройти, а результат окажется связанным с неправильной командой или профилем.

В качестве дополнительного контрольного материала полезно изучить руководство по безопасности общего Mac и удалённому доступу, но его нельзя подменять проверкой границ подписывающих активов. Защита хоста и изоляция сертификатов — связанные, но разные задачи.

Вопросы о fastlane match, readonly и общем репозитории

Может ли несколько iOS-проектов использовать один репозиторий match

Может, если доступ разделён по Apple-командам, bundle identifier, путям и субъектам, а политика хранилища действительно запрещает чтение чужих объектов. Само наличие нескольких каталогов не доказывает изоляцию.

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

Нужно ли включать readonly на общем Mac

Для обычного CI — да. Режим readonly не даёт pipeline создавать или изменять подписывающие активы и тем самым уменьшает вероятность того, что автоматическая задача изменит общий набор сертификатов. Однако readonly не заменяет ограничение доступа к хранилищу: job всё равно может прочитать разрешённые ей активы.

Обновление выполняется отдельной административной задачей, запускаемой контролируемым субъектом. После изменения активов необходимо проверить новую сборку и возможность отката. Описание режима CI и параметров match следует сверять с официальной документацией fastlane match, поскольку команды и параметры могут меняться.

Как создавать и удалять временный Keychain в iOS CI

Рабочий процесс должен выглядеть так:

  1. Запустить job на чистом или проверенном узле.
  2. Создать Keychain с непредсказуемым именем, доступным только текущей задаче.
  3. Задать его временным основным Keychain процесса, не меняя постоянное хранилище пользователя без необходимости.
  4. Получить активы через readonly-синхронизацию.
  5. Импортировать сертификат и закрытый ключ с ограниченным списком разрешённых инструментов.
  6. Выполнить сборку и, если требуется, экспорт подписанного артефакта.
  7. Удалить временный Keychain, рабочий каталог и временные переменные.
  8. Проверить, что после завершения job ключ не находится в постоянном Keychain.

Порядок очистки должен выполняться и при успешном, и при аварийном завершении. Если runner был принудительно остановлен, следующая задача должна начать с проверки и удаления оставшихся временных объектов. Нельзя считать очистку доказанной только по строке «cleanup completed» в обычном логе; нужен контрольный тест после сбоя.

Четвёртый сценарий: обычный CI и формальный релиз

Проверка исходного кода, сборка для тестировщиков и публикация в магазин имеют разные требования к полномочиям. Ошибка архитектуры возникает, когда все эти задачи запускаются одним агентом с одним секретом.

Обычным CI достаточно получить сертификат, необходимый для сборки, и profile конкретного bundle identifier. Он не должен видеть API Key публикации, релизный секрет или сертификаты других приложений. Если задача запускается из ветки с непроверенным кодом, доступ к закрытому ключу следует рассматривать как потенциально скомпрометированный.

Релизный pipeline должен иметь отдельный триггер, ограниченный список сопровождающих и собственный Mac-узел. Это не обязательно означает отдельный физический сервер в каждом случае, но должно означать независимую область выполнения, очищаемое окружение и запрет вызова из обычного CI.

Для доступа к App Store Connect следует использовать отдельный API Key с минимально необходимой ролью. Apple описывает API Key как самостоятельный механизм доступа, поэтому его нельзя смешивать с секретом расшифровки match или с учётной записью разработчика: официальные границы App Store Connect API.

Пример матрицы полномочий:

  • владелец подписи — создаёт и обновляет активы;
  • CI сборки — только читает разрешённые активы;
  • релизный оператор — запускает публикацию через защищённый pipeline;
  • аудитор — читает журналы, но не закрытые ключи;
  • администратор инфраструктуры — обслуживает Mac, не получает секрет расшифровки без отдельного одобрения.

Такая модель помогает отличить проблему подписи от проблемы хоста. Для диагностики отказов пригодится руководство по проверке сертификатов, profiles и Keychain на Mac-сборщике, однако исправление ошибки не должно приводить к постоянному импорту релизного ключа в общий пользовательский Keychain.

Пятый сценарий: отзыв доступа, утечка и замена активов

Ротация после увольнения и ротация после утечки — не одно и то же. При увольнении сначала отзывается доступ конкретного пользователя к хранилищу, CI и Apple-команде, затем проверяются активные сессии и сервисные токены. При подозрении на раскрытие секрета расшифровки нужно считать доступными все активы, которые он мог открыть.

Рекомендуемый порядок при потенциальной утечке:

  • остановить релизные pipeline;
  • сохранить журналы обращений и состояние конфигурации;
  • отозвать доступ к хранилищу и заменить секрет расшифровки;
  • проверить, какие сертификаты и profiles могли быть извлечены;
  • отозвать скомпрометированные сертификаты в Apple-аккаунте;
  • создать новый набор активов в изолированной области;
  • обновить секреты только у разрешённых pipeline;
  • выполнить тестовую сборку и контролируемую публикацию;
  • зафиксировать владельца инцидента и дату завершения.

Apple прямо предусматривает отзыв сертификата, поэтому после доказанной компрометации нельзя ограничиваться удалением файла из репозитория: порядок отзыва сертификата Apple. Для массового уничтожения активов команда должна понимать последствия операции match nuke: официальное описание предупреждает, что это действие удаляет соответствующие сертификаты и profiles, поэтому его следует применять только по утверждённому сценарию восстановления: документация match nuke.

Отдельно проверяется App Store Connect API Key. Его отзыв и выпуск нового ключа не заменяют отзыв сертификата подписи, потому что это разные полномочия и разные поверхности риска.

Чек-лист перед включением production

Перед выдачей доступа к релизному Mac технический руководитель должен получить подтверждение по каждому пункту:

  • [ ] Для каждого приложения указан Apple Team ID.
  • [ ] Bundle identifier не выводится только из имени каталога.
  • [ ] У каждого актива есть владелец и назначение.
  • [ ] Обычный CI работает в readonly-режиме.
  • [ ] Административное обновление отделено от ежедневной сборки.
  • [ ] Временный Keychain создаётся на job и удаляется после неё.
  • [ ] Очистка проверяется также после аварийного завершения.
  • [ ] Pipeline с низким доверием не видит production-секреты.
  • [ ] Релизный триггер отделён от обычной проверки кода.
  • [ ] Ошибка Team ID приводит к отказу, а не к автоматическому выбору другой identity.
  • [ ] Журналы показывают субъект, задачу, приложение и результат.
  • [ ] Есть резервный Mac-узел или документированный план восстановления.
  • [ ] Для увольнения, утечки и окончания срока действия существуют разные процедуры.
  • [ ] Ответственный за отзыв и ротацию назначен до запуска.

Если текущая инфраструктура не может доказать хотя бы очистку Keychain, границы сервисных субъектов или отказ при неверной команде, расширять общий Mac на новые приложения преждевременно.

Как выбрать между общим, выделенным и арендованным Mac

Условное правило выбора выглядит так:

  • Если приложения принадлежат одной доверенной команде, имеют сопоставимый риск, а CI подтверждает readonly, временный Keychain и очистку, можно начать с общего узла.
  • Если production и тестовые задачи используют разные секреты, но физическое разделение пока не оправдано, следует применить логически выделенные рабочие области и отдельные триггеры.
  • Если есть несколько Apple-команд, непроверенные репозитории, строгие требования аудита или высокая цена ошибочной публикации, нужно выбрать отдельный Mac-узел либо изолированный релизный пул.
  • Если требуется временная мощность, быстрый запуск резервного узла или отсутствие капитальной закупки, можно рассмотреть аренду Mac после проверки root-доступа, длительности доступности, способа подключения и процедуры замены узла.
  • Если нагрузка постоянная, требуется физический интерфейс, локальная интеграция или долгий жизненный цикл оборудования, собственный Mac может быть рациональнее аренды.

Перед сравнением вариантов стоит проверить консоль удалённого Mac и отдельно запросить у поставщика доказательства изоляции учётных записей, восстановления после переподключения и очистки среды.

Общая машина обычно дешевле по количеству узлов, но дороже при расследовании ошибки, ротации активов и вынужденной остановке нескольких приложений. Выделенный узел увеличивает инфраструктурные затраты, зато сокращает радиус поражения. Аренда не является автоматически самым дешёвым решением: её нужно сравнивать с закупкой по сроку использования, резервированию, администрированию, простою и требованиям к физическому доступу.

Если текущая схема держится на постоянном Keychain, общей записи расшифровки и ручном выборе сертификата, она создаёт три системных недостатка: трудно доказать источник подписи, один скомпрометированный pipeline может затронуть несколько приложений, а восстановление после утечки зависит от человека, который помнит неформальные настройки. В таких условиях аренда Mac у KuzCloud может дать более управляемый путь к отдельному узлу или резервному пулу — при условии, что до оплаты зафиксированы способ доставки доступа, права администратора, изоляция задач, длительность работы и процедура замены.

Для долгосрочной стабильной нагрузки с подтверждёнными требованиями к оборудованию собственная закупка остаётся разумным вариантом. Для пилота, миграции, сезонного релиза или резервной мощности практичнее сначала проверить арендованный Mac по этому чек-листу и только затем принимать решение о расширении всей инфраструктуры.

Изолированный удалённый Mac для корпоративной сборки

KuzCloud предоставляет удалённые Mac для настройки fastlane match и безопасной работы с сертификатами и профилями подписи.

Разделяйте команды, учётные записи и процессы сборки, чтобы ограничить доступ к ключам подписи на общем Mac.