CI/CD

fastlane match 共有Macの導入方法:2026年企業署名分離ガイド

ビルドするアプリとは別の証明書が選ばれ、署名者を追跡できない状態なら、共有Macの常駐Keychainと書き込み可能な公開資格情報をまず疑います。

最も安全な結論は、Appleチームとプロジェクトの信頼ドメインごとに署名資産を分け、通常のCIはreadonlyで同期し、臨時Keychainを使うことです。正式リリースは独立したMacノードまたは専用の公開プールに限定してください。 これが企業向けのfastlane match 共有Macの導入で採用すべき基準です。

この内容は、複数のiOSアプリを管理し、共有ビルド環境で証明書の誤用を防ぎたい技術責任者向けです。CI/CD基盤の担当者、セキュリティ監査や退職時の権限回収を担う企業IT担当者も、設計と検収の基準として利用できます。

まず失敗範囲を切り分ける

fastlane matchは、証明書やProvisioning Profileを保管場所から同期する仕組みです。Gitまたはオブジェクトストレージを利用でき、CI向けのreadonly運用や臨時Keychainの設定もサポートされていますが、ホスト、リポジトリ、Appleアカウント、リリース権限まで自動的に分離する機能ではありません。詳細は fastlane match公式ドキュメント と setup_ciの公式ドキュメント で確認できます。

共有Macで発生しやすい失敗は、主に次の4つです。

  • 以前のジョブが常駐Keychainに残した秘密鍵を、別プロジェクトのジョブが読み取る。
  • 複数のbundle identifierに対応するProfileが同じ作業領域へ同期され、誤った署名対象を選ぶ。
  • 通常の検証ブランチから、正式公開用の証明書やApp Store Connect用の資格情報へ到達できる。
  • 署名リポジトリを読める担当者が多すぎて、退職者のアクセス回収や操作責任の特定が難しくなる。

したがって、分離単位は「Macが同じかどうか」だけでは決まりません。AppleのTeam ID、アプリの信頼度、ジョブの目的、資格情報の有効期間を一つの信頼ドメインとして評価します。

単一アプリの試行環境を最小構成にする

最初の試行は、信頼できる一つのアプリと一つのCIサービスアカウントに限定します。管理者が初期化・更新を行い、日常のビルドジョブは署名資産を読み取るだけに分けてください。

管理作業と日常CIを分ける

管理作業では、対象のteam_id、app_identifier、証明書の種類、Profileの用途、責任者を明示します。CI側では、必要なリポジトリまたはオブジェクトストレージだけを読み取り、readonlyを有効にします。

Appleの証明書とProfileは、単なるファイルではなく、アプリ識別子とチームの権限関係に結び付いた署名資産です。Appleの コード署名に関する証明書の案内 では、証明書を失効させる場合の影響と再発行の考え方が説明されています。更新担当者をCIジョブへ与える設計は、通常のビルドと管理操作の境界を壊します。

fastlane matchを使うときの確認項目

臨時Keychainをジョブごとに作成し、署名資産のインポート先をログで確認します。ジョブ終了後はKeychainを削除し、作業ディレクトリ、環境変数、CIの一時ファイルに復号済み資格情報が残っていないことを確認します。

次の証拠が揃わない場合、試行環境を本番公開へ進めるべきではありません。

  • 署名ストレージへの読み取り記録と、管理者による更新記録
  • 同じコミットから再実行した場合の署名結果
  • 臨時Keychainの作成、利用、削除の記録
  • 誤ったTeam IDやbundle identifierを指定した場合の失敗ログ
  • 署名同期に失敗した場合のビルド停止と復旧手順

複数アプリを同じAppleチームで扱う境界を決める

同じAppleチームに属するアプリでも、同じ署名権限を共有してよいとは限りません。社内管理ツールと一般公開アプリでは、漏えい時の影響、リリース担当者、公開頻度が異なるためです。

どのアプリを同じ保管単位にできるか

アプリの機密性、リリース頻度、担当部署、CIジョブの信頼度がすべて近い場合に限り、管理単位を共通化できます。反対に、低信頼の外部コードを扱うジョブや、決済・個人情報に関係するアプリは、同じMac上でも署名リポジトリ、CI主体、Keychainを分けます。

複数のbundle identifierを扱うときは、名前の付け方だけで誤用を防ごうとしてはいけません。アプリ、証明書、Profile、CIジョブ、担当者を次のように対応付け、権限の範囲を確認できる状態にします。

管理対象 記録する値 主なアクセス主体 誤用時の影響
Appleチーム team_id 管理責任者、公開ジョブ 別チーム資産の選択、署名失敗
アプリ app_identifier、bundle identifier 対象アプリのCI 別アプリとして署名
証明書 種類、保管単位、更新責任者 管理作業、限定された公開ジョブ 不正な公開や再発行
Profile 開発・検証・配布用途 対象ジョブ 実機検証または公開工程の停止
CIタスク ブランチ、トリガー、実行ノード 開発者またはリリース担当 高権限ジョブの不正実行

この表を承認記録として残すと、Matchfileの内容だけを見せるよりも、実際の権限境界を監査しやすくなります。

Appleチームが複数ある場合は保管単位を分離する

fastlane matchで複数のAppleチームを管理する場合、独立したブランチ、保管パス、または署名リポジトリをチーム単位で用意します。各CI主体には対象Team IDの資産だけを読ませ、別チームの資格情報を同じ環境変数セットへ混在させません。

論理分離は、ストレージやリポジトリのアクセス制御が正しく機能する場合に有効です。一方、高機密の事業では、公開用ノード、実行アカウント、Keychain、復号用資格情報まで物理的に分ける方が、設定ミスの影響範囲を小さくできます。

注意:ディレクトリ名に「team-a」「team-b」と付けるだけでは隔離になりません。誤ったTeam IDを設定したジョブが、別チームの証明書を自動選択せず、明確なエラーで停止することを必ず再現してください。

Appleのアカウント権限は役割ごとに異なります。 Appleのアカウント役割一覧 を基に、署名資産の管理者、ビルド担当者、公開承認者を同一人物・同一APIキーへ集約しない設計にします。

通常CIと正式公開ノードを分ける

通常のプルリクエスト検証では、可能な限り公開用秘密鍵へ触れない構成にします。署名が必要な検証だけ、readonly同期と臨時Keychainを組み合わせ、公開用の配布資格情報は別のジョブへ隔離します。

ジョブ区分 署名資産 実行主体 ノードとトリガー 検収の要点
静的解析・単体検証 原則不要 開発CIアカウント 通常の共有Macでも可 秘密鍵へ到達しない
実機検証 必要最小限 対象アプリのCI readonly、臨時Keychain 終了後の削除を確認
ベータ配布 配布用資産 限定されたリリース担当 承認済みブランチ Team IDとProfileを固定
正式公開 高感度の配布資産 専用の公開主体 独立Mac、制限トリガー 操作記録と失敗時の停止
署名資産の更新 書き込み権限 指名された管理者 管理用ジョブのみ 変更理由と承認者を保存

App Store Connect APIを利用する場合も、キーの用途と権限範囲を分けます。Appleの App Store Connect API公式案内 にあるキー管理の説明を参照し、通常CIへ正式公開に必要な権限をそのまま渡さないようにします。

共有Macでreadonlyを有効にする判断

共有Macで実行する日常CIは、原則としてreadonlyを有効にします。資産が存在しない場合に自動作成・更新へ進む挙動を許すと、ジョブの誤設定が証明書更新やProfile変更へ発展するためです。

ただし、初期化と更新の管理ジョブでは書き込みが必要になることがあります。その場合も、通常CIと別のアカウント、別のトリガー、別の監査ログを使用し、管理ジョブの実行後にCIへ書き込み権限が残っていないことを確認します。

臨時Keychainの作成から削除までを検収する

iOS CIで臨時Keychainを使う場合、ジョブ開始時に一意の名前で作成し、パスワードをCIの秘密変数から渡し、署名資産をそのKeychainへ限定してインポートします。setup_ciの設定と処理範囲は fastlane setup_ciの公式説明 に合わせ、固定のログインKeychainへ秘密鍵を残さないことが重要です。

実装後は、次の順番で検収します。

  1. ジョブ専用の実行アカウントと対象Team IDを確定します。
  2. 署名ストレージの読み取り権限だけをCIへ付与します。
  3. ジョブ開始時に臨時Keychainを作成し、検索対象をそのKeychainへ限定します。
  4. fastlane matchをreadonlyで実行し、対象アプリのProfileだけを同期します。
  5. ビルド、署名、必要な検証処理を行い、ログに秘密鍵や復号パスワードが出ていないことを確認します。
  6. ジョブ終了時にKeychain、作業ディレクトリ、一時ファイルを削除します。
  7. 同じジョブを再実行し、前回の秘密鍵が残っていなくても同じ結果になることを確認します。
  8. 誤ったTeam ID、存在しないProfile、ストレージ拒否を順に再現し、別資産へ自動フォールバックしないことを確認します。

この手順で失敗する場合は、Mac構築環境の接続方式を確認する前に、Keychainの検索順序、CI環境変数、復号用資格情報の範囲を見直します。接続できることと、正しい署名資産だけを使えることは別の検収項目です。

条件分岐でノード構成を決める

次の条件で、共有Mac、分離した専用ノード、または公開専用プールを選びます。

  • Appleチームが一つで、アプリの機密性と担当者が近く、CIがreadonlyで動作する場合は、論理分離した共有Macから開始します。
  • Appleチームは同じでも、低信頼コードと高機密アプリが同じCIに入る場合は、署名ストレージと臨時Keychainを分け、正式公開だけ専用ノードへ戻します。
  • Appleチームが複数あり、誤設定時の影響が大きい場合は、チーム別の保管単位と実行主体を分けます。それを証明できない場合は物理的に分離します。
  • 任意のブランチから正式公開トリガーを呼べる場合は、公開用資格情報を共有Macへ置かず、承認済みブランチと独立ノードへ移します。
  • 長時間の管理作業、物理デバイス接続、組織固有の監視が必要な場合は、自社保有Macを優先します。短期の増員、予備ノード、検証用の隔離環境が目的なら、KuzCloudのMacレンタル条件 と自社設備の運用負担を比較します。

署名リポジトリを一つに集約する設計が直ちに誤りというわけではありません。ただし、複数チームや異なる信頼度のアプリが同じリポジトリを使うなら、ブランチ・パス・主体・復号資格情報の全てを分け、監査ログで境界を説明できることが条件です。説明できない場合は、複数の署名リポジトリへ分割します。

漏えいと人員変更に備えてローテーションする

署名証明書リポジトリまたは復号資格情報の漏えいが疑われる場合、単にパスワードを変更するだけでは不十分です。まず対象ストレージとCI主体のアクセスを止め、漏えい範囲を特定し、必要に応じて証明書、Profile、APIキーを順に再構成します。

Appleの証明書失効手順を基準に、失効によって影響を受けるアプリと配布工程を確認します。match nukeを使う場合も、対象チーム全体の署名資産を失効させる可能性があるため、 match nuke公式ドキュメント の影響範囲と復旧条件を承認者が確認してから実行します。

入社、異動、退職、証明書期限、漏えい疑いでは対応が異なります。人員変更ならストレージとCIの主体を撤回し、資格情報を再発行します。漏えい疑いなら、アクセス停止、ログ保全、証明書やAPIキーの失効、署名資産の再作成、公開工程の再承認までをインシデント手順として扱います。

本番放行前のチェック項目を残す

本番の公開ノードへ移す前に、担当者が次をチェックします。

  • [ ] Appleチーム、bundle identifier、証明書、Profile、CIジョブの対応表がある
  • [ ] 通常CIの署名同期はreadonlyで、更新権限を持たない
  • [ ] 臨時Keychainがジョブ終了後に削除される
  • [ ] 正式公開は承認済みトリガーと独立Macノードに限定される
  • [ ] 誤ったTeam IDを指定した場合、別チーム資産へ切り替わらず停止する
  • [ ] ストレージアクセス、署名、公開操作のログを担当者へ結び付けられる
  • [ ] 証明書失効、APIキー撤回、復号資格情報の輪番手順が文書化されている
  • [ ] ノード障害時の代替環境と、再実行時の署名結果を確認している
  • [ ] 離職者のアカウント、CIシークレット、ストレージ権限を回収できる

既存のMac構築機がこの条件を満たさず、共有ログインKeychain、常時書き込み権限、公開ジョブと検証ジョブの同居を解消できないなら、設定を増やして補うより、公開ノード自体を分離する方が説明可能な設計になります。専用ノード、常時稼働、管理権限、障害時の交換条件を自社設備と同じ表で比較し、利用条件を確認してください。

自社で用意したMacは物理インターフェースや長期固定負荷に向きますが、調達期間、保守担当、予備機、設置場所が必要です。KuzCloudのMacレンタルは、短期の検証、増員時の追加ノード、正式公開用の分離環境を先に確保したい場合に比較対象になります。

署名資産の棚卸しを終えた後であれば、KuzCloudのMacレンタル料金と提供条件 を、専用公開ノードと予備ノードの要件に照らして確認できます。価格だけで決めず、root権限、アカウント分離、接続経路、ログ、復旧時の再現性を満たす場合に限って、レンタルを企業CIの選択肢へ加えるのが適切です。

署名運用に適した専用Mac環境をKuzCloudで

プロジェクトや信頼ドメインごとに分離したMac環境を用意し、署名資産を安全に管理できます。

遠隔操作に対応した専用Macで、ビルド・検収・リリース作業を安定して進められます。