CI/CD / DevOps

fastlane match 共享 Mac 怎麼部署:2026 企業簽名隔離指南

fastlane 官方文件明列,match 可透過 Git 或雲端儲存同步簽名資產;這個兩種儲存方式的選擇,並不等於完成權限隔離。官方 match 文件 所能解決的是證書與描述檔分發,不是共享 Mac 上的主機身份、Apple Team、倉庫存取及發布權限。

獲勝者是「按信任域拆分、CI 只讀、發布節點獨立」的部署方式;適合管理多個 iOS 應用程式、需要共享建置資源但不能接受簽名私鑰混用的企業。 若所有專案同屬一個低風險團隊、發布權限已嚴格分離,才可在受控條件下共用部分簽名基礎設施。

這篇文章適合三類讀者:管理多個 iOS 應用程式的技術負責人、負責 CI/CD 平台的工程負責人,以及要處理權限撤銷、離職交接和安全稽核的企業 IT。重點不是安裝 fastlane,而是判斷哪一種共享 Mac 架構能留下可追責的證據。

先建立邊界:match 不會替共享 Mac 完成隔離

共享建置機最容易出現的事故,不是指令寫錯,而是不同專案在同一個常駐 macOS Keychain 內看到彼此的簽名身份。某個工作流程可能因此選到錯誤的 distribution certificate,另一個流程則可能取得不應接觸的私鑰;即使最後建置失敗,單靠建置輸出也未必能證明是哪個操作者讀取了甚麼資產。

這裡至少有四個獨立邊界:

  • Apple 團隊邊界:Team ID、bundle identifier、證書與 Provisioning Profile 的關係必須固定,不能讓工作流程從主機上「自動尋找可用身份」。
  • 專案信任邊界:來自不同倉庫、分支或外部貢獻者的程式碼,不應因共用 Mac 而取得正式發布私鑰。
  • 任務權限邊界:初始化或更新 match 資產是管理任務;日常 CI 只應同步既有資產,兩者不能使用同一個可寫身份。
  • 憑據生命週期邊界:解密密碼、App Store Connect API Key、證書私鑰和主機登入權限,撤銷與輪換的處理方式並不相同。

Apple 的帳戶角色文件可用來核對團隊成員及其工作權限,但角色本身不會自動限制某一條 CI 流水線能讀取哪個倉庫。Apple 帳戶角色說明 應與 CI 的服務身份、儲存策略和主機隔離一起設計。

第一步:單一可信應用程式先做最小可用部署

單一應用程式試點不代表可以把所有權限放在共享 Mac 上,而是把資產範圍縮小,先證明每一個動作都能被回放。

建議先固定以下內容:

  • 應用程式的 bundle identifier 與 Apple Team ID。
  • 使用的證書類型,例如開發、Ad Hoc 或 App Store 發布所需的身份。
  • 對應的 Provisioning Profile,以及允許讀取該資產的 CI 服務身份。
  • 負責建立或更新簽名資產的管理者,不讓普通建置任務具備寫入權限。
  • 簽名倉庫或物件儲存的加密密碼保存位置,並禁止直接寫入程式碼倉庫與建置日誌。

初始化任務可以在受控環境中建立或更新 match 資產;日常 iOS CI 則以 readonly 方式同步。這個分工比單純展示 Matchfile 更能反映真實權限範圍,因為 Matchfile 只描述設定,不會證明誰可以解密、誰可以觸發發布。

試點完成後,驗收證據至少要包括:

  • 儲存服務的存取記錄,能對應到管理任務或 CI 服務身份。
  • 相同提交在乾淨環境中可重複完成簽名建置。
  • 工作完成後的 Keychain、暫存私鑰與解密環境清理記錄。
  • 錯誤 Team ID、錯誤 bundle identifier 或缺少資產時,流水線會拒絕執行。
  • match 失敗、儲存服務暫時不可用或節點中斷時,有明確回退路徑,而不是改用主機上殘留的另一套身份。

第二步:同一 Apple 團隊的多應用程式,按風險而非方便共用

同一 Apple 團隊下的多個應用程式,通常會出現「技術上可以共用」與「治理上不應共用」的落差。判斷時不應只看 bundle identifier 是否不同,還要看應用程式的敏感度、發布頻率、維護人員和倉庫可信度。

可以採用以下分支:

  • 若應用程式由同一受信任團隊維護、程式碼來源一致、發布責任人相同,且 CI 任務能固定映射 bundle identifier,則可共用同一簽名倉庫的受限範圍。
  • 若應用程式由不同業務線維護、倉庫信任程度不同,或其中一個應用程式具有較高資料敏感度,則應拆分倉庫、儲存路徑或至少拆分服務身份。
  • 若任何普通分支可以觸發正式發布,則不應讓該分支所在的共享建置環境接觸發布私鑰;應回退到獨立發布節點。

每一個應用程式都要建立「應用程式—證書—Profile—CI 任務」映射。映射內容應記錄哪個 bundle identifier 可使用哪項資產、哪個服務身份可以讀取、哪個觸發器可以執行,以及失敗後由誰處理。這份映射比把多個專案放進同一個 match 倉庫更能支援稽核與離職交接。

第三步:多個 Apple 團隊與業務線必須切開信任域

當共享 Mac 同時服務多個 Apple Team ID 或多條業務線時,邏輯隔離與物理隔離的風險不可混為一談。

邏輯隔離可以透過獨立分支、不同儲存路徑、不同解密密碼和不同 CI 服務身份完成,適合信任程度接近、管理流程一致的團隊。可是,只要共享主機仍保留常駐 Keychain 或共用管理員憑據,主機遭入侵、工作流程被竄改或人員誤操作時,邏輯界線就可能被繞過。

物理隔離則是讓高敏感業務使用獨立 Mac 節點、獨立登入帳戶和專用發布任務;它增加節點管理成本,卻能縮小私鑰暴露範圍。高敏感應用程式不能只靠倉庫命名、資料夾名稱或團隊約定來防止誤用。

驗收時應刻意注入錯誤設定:

  • 把 CI 的 Team ID 改成另一業務線的值。
  • 讓任務使用不相符的 bundle identifier。
  • 移除該任務應有的 Profile,觀察是否錯誤讀取其他專案資產。
  • 讓普通建置觸發器嘗試進入正式發布流程。

合格結果是流水線明確拒絕,而不是自動挑選主機上「剛好可用」的證書。Apple 對證書吊銷的處理邊界,應以官方證書撤銷說明為準;撤銷不是替代權限隔離的萬用按鈕。

第四步:把普通 CI 與正式發布節點分成兩條路徑

普通驗證任務的目標是編譯、測試和產出可供審查的建置結果,不應因方便而取得正式發布能力。若普通任務確實需要簽名,應限制為只讀同步,並在任務生命週期內使用暫時 Keychain。

fastlane 的 setup_ci 文件提供 CI 環境下設定臨時 Keychain 的官方參考;setup_ci 使用說明也應配合流水線的失敗清理邏輯使用。實際部署不可只驗證成功路徑,因為測試失敗、中斷和取消更容易留下私鑰。

臨時 Keychain 的操作流程可按以下順序落地:

  1. 任務開始時建立工作專用 Keychain,名稱和工作識別碼不要使用跨專案的固定常駐名稱。
  2. 只同步本次 bundle identifier 所需的證書與 Profile,拒絕拉取其他應用程式資產。
  3. 將解密密碼透過 CI 的秘密管理機制注入,不在命令列、設定檔或輸出日誌中顯示。
  4. 建置期間限制 Keychain 的解鎖範圍,避免其他並行任務共用相同解鎖狀態。
  5. 無論成功、失敗、取消或節點重連,都執行清理:刪除臨時 Keychain、私鑰暫存檔、解密後的設定和工作目錄。
  6. 在清理後檢查 Keychain 清單、檔案系統和 CI 日誌,確認沒有殘留資產或秘密值。

正式發布則應進入獨立 Mac 節點或受控發布池,只接受受保護分支、核准觸發器和指定服務身份。Apple App Store Connect API 的用途與權限應依官方 API 說明核對;API Key 不能被當成可任意替代 Apple 帳戶角色的萬能憑據。

用條件分支決定共享、拆分或獨立節點

採購或平台工程團隊可以在架構評審時直接套用以下判斷,不必先接受「所有專案共用一套環境」這個預設。

  • 若只有一個 Apple Team、單一可信應用程式,CI 可 readonly,且每次任務都建立並清理臨時 Keychain,選擇共享 Mac 試點。
  • 若同一 Apple Team 下有多個應用程式,但能以 bundle identifier、服務身份和資產映射限制讀取範圍,選擇分區共用的簽名儲存;更新資產仍由獨立管理任務負責。
  • 若存在多個 Apple Team、不同業務線或低信任倉庫,回退到獨立倉庫、路徑、解密憑據和 CI 身份。
  • 若任務需要正式發布、涉及高敏感應用程式,或普通分支可能接觸發布觸發器,直接選擇獨立 Mac 發布節點。
  • 若目前共享 Mac 只能依賴常駐 Keychain、共用登入帳戶或可寫 match 權限,先不要上線;在隔離措施完成前,回退到受控的單用途節點。

FAQ:企業上線前要釐清的五個問題

fastlane match 管理多個 Apple 團隊時,證書要怎樣分開?

不同 Apple Team ID 不應只靠檔名區分。較穩妥的做法是分開簽名倉庫或分支、儲存路徑、加密密碼與 CI 身份,並在工作流程中固定 team ID;錯誤設定時必須直接失敗,不可自動改用另一團隊的身份。

共享 Mac 上執行 match,CI 是否應該開啟 readonly?

日常建置通常應啟用 readonly,讓 CI 只讀取既有證書與描述檔,不負責建立、更新或撤銷資產。初始化與更新工作應由受控管理任務執行,並保留操作者、儲存存取與變更記錄。

iOS CI 怎樣建立並清理臨時 Keychain?

建置開始時建立工作專用 Keychain,匯入本次任務所需的私鑰,並限制解鎖範圍;任務成功或失敗後都要刪除 Keychain、清除匯入檔與解密憑據。setup_ci 可作為設定參考,但清理仍須由流水線明確保證。

多個 iOS 專案可以共用同一個 match 倉庫嗎?

同一 Apple 團隊內可以在明確隔離 bundle identifier、證書類型與 CI 任務的前提下共用,但不代表所有專案都應共用。低信任專案、敏感應用程式或不同業務線,應改用獨立倉庫、路徑與存取身份。

簽名證書倉庫或解密憑據外洩後,輪換應先做甚麼?

先撤銷受影響的儲存存取與 CI 憑據,再輪換解密密碼、吊銷 Apple API Key 或相關證書,最後重建並重新分發必要的簽名資產。處理順序要配合存取記錄,避免只改密碼卻留下仍可使用的舊私鑰。

第五步:把憑據輪換與離職流程寫成可執行程序

人員變動時,不能只刪除某人的程式碼倉庫帳戶。企業 IT 應先確認該人員曾接觸哪些層級:Mac 登入、共享 Mac 管理權限、match 儲存、解密密碼、CI 秘密、Apple 帳戶角色,以及 App Store Connect API Key。

建議按事件類型處理:

  • 離職或立即撤權:先停用主機與儲存存取,再撤銷 CI 秘密和 Apple 帳戶角色,之後檢查近期存取記錄。
  • 職務調整:移除不再需要的專案與發布權限,重新核對應用程式—證書—Profile—CI 任務映射。
  • 解密憑據疑似外洩:輪換 match 加密密碼,檢查是否已下載私鑰,必要時重建簽名資產。
  • Apple API Key 疑似外洩:依 Apple 的 API Key 管理邊界撤銷或重建,並檢查發布活動,而不是只更換 Mac 上的環境變數。
  • 證書疑似外洩:先評估用途與影響範圍,再依 Apple 流程吊銷證書、重建 Profile 和重新部署。

fastlane match nuke 涉及大範圍清除簽名資產,使用前必須確認備份、仍在使用的應用程式和回復責任人;match nuke 官方說明不應被理解為日常清理指令。

上線前的可勾選驗收清單

  • [ ] 每個 Apple Team ID 都有明確的儲存邊界與 CI 服務身份。
  • [ ] 每個 bundle identifier 都能對應到指定證書、Profile 和建置任務。
  • [ ] 普通 CI 使用 readonly,不具備建立、更新或撤銷簽名資產的權限。
  • [ ] 正式發布只接受受控分支、核准觸發器和獨立 Mac 節點。
  • [ ] 臨時 Keychain 在成功、失敗、取消和重連後都能清理。
  • [ ] 解密密碼、私鑰、API Key 和主機登入權限有不同的輪換流程。
  • [ ] 錯誤 Team ID、錯誤 bundle identifier 和缺少 Profile 時,流水線會拒絕執行。
  • [ ] 儲存存取、CI 觸發、發布活動和人員撤權都有可稽核記錄。
  • [ ] 節點故障時有備用節點或人工回退方案,且不會為了恢復服務而重新啟用常駐共享 Keychain。
  • [ ] 發布責任人、資產管理人和事件處理人已被指定,並能在交接時重新驗證。

對需要更完整主機層驗收的團隊,可先參考 企業遠端 Mac 安全驗收入口,再把 root 權限、遠端連線、帳戶隔離與簽名私鑰檢查合併到同一份變更紀錄中。若要評估實際管理介面與節點操作流程,也可查看 KuzCloud 控制台所提供的存取方式;這些資訊不能取代企業自身的權限測試。

如果現有方案是把多個專案放在同一台自購 Mac mini 上,常見缺點是常駐 Keychain 難以追責、硬體故障時發布流程一起中斷,以及新增或撤換節點要由企業自行處理;若改用一般雲端建置環境,則可能遇到 macOS 版本、實體 Mac 可用性、私鑰清理證據或長時間節點控制不足等限制。因此,在完成信任域盤點後,若內部資源無法提供獨立節點、長期在線、完整管理權限和故障替換證據,KuzCloud 的 Mac 租賃可作為專用發布節點或彈性備用節點的比較選項;需要臨時算力、短期驗證或不想先採購實機的團隊,再到 KuzCloud Mac 租賃方案核對交付條件,而不是把租賃直接當成所有長期重負載工作的唯一答案。

對企業而言,fastlane match 共享 Mac 部署的合格標準不是「建置成功一次」,而是每個專案只能取得被授權的資產、每個發布動作都能追溯,且在失敗、重連、離職或憑據外洩後仍有可驗證的回復路徑。

為企業簽名流程配置專屬 KuzCloud Mac

透過 KuzCloud 遠端 Mac,為不同應用程式與團隊建立清晰分隔的工作環境,降低簽名資產互相干擾的風險。

按需租用獨立 Mac 資源,讓日常整合、正式發布及憑據輪換可在分開的環境中穩定執行。