CI/CD

fastlane match 공유 맥 배포 방법: 2026 기업 서명 격리 가이드

빌드마다 다른 앱의 서명 신원이 선택되고, 누가 해당 인증서를 사용했는지 로그로 설명할 수 없다면 공유 맥의 상주 키체인이 이미 통제 경계를 넘은 상태입니다. 가장 빠른 해법은 Apple 팀과 프로젝트 신뢰 영역별로 서명 저장소를 나누고, 일반 CI는 읽기 전용 동기화와 임시 키체인만 사용하며, 공식 출시는 별도 맥 노드에서 실행하는 것입니다.

이 글은 여러 iOS 앱을 관리하는 기술 책임자, 공유 빌드 환경을 운영하는 플랫폼 엔지니어, 퇴사와 자격 증명 사고를 관리하는 기업 IT 담당자를 위한 기준서입니다. 단순한 fastlane 설치법이 아니라, 어떤 프로젝트를 함께 둘 수 있고 어디서 분리해야 하는지와 그 결과를 어떻게 검수할지에 집중합니다.

실패 장면을 신뢰 영역의 문제로 다시 정의하기

공유 맥에 여러 프로젝트가 접속하면 프로젝트 A의 인증서와 개인 키가 상주 키체인에 남을 수 있습니다. 프로젝트 B의 작업이 같은 키체인을 검색하면 의도하지 않은 서명 신원이 선택됩니다. 빌드가 실패하는 것보다 더 큰 문제는 성공한 빌드가 어느 앱의 권한으로 서명되었는지 설명하기 어려워진다는 점입니다.

fastlane match는 인증서와 프로비저닝 프로파일을 저장하고 여러 환경에 동기화하는 도구입니다. 그러나 저장소 접근 주체, 맥 호스트, Apple 계정 역할, 출시 권한을 자동으로 분리하지는 않습니다. 공식 문서도 저장 방식과 읽기 전용 실행, 여러 팀 구성을 별도 설정으로 다룹니다. 따라서 match 설정 파일 하나를 보여주는 것만으로는 기업 환경의 격리를 입증할 수 없습니다. fastlane match 공식 설정과 저장 방식을 기준으로 저장소 경계부터 확인해야 합니다.

서명 자산의 경계는 다음 네 가지로 정리됩니다.

  • Apple 팀과 팀 식별자
  • 앱의 번들 식별자와 인증서 유형
  • CI 작업과 실행 주체
  • 복호화 암호, API 키, 개인 키의 수명

이 네 항목 중 하나라도 여러 신뢰 영역에서 공유되면 논리적 분리만으로는 부족합니다. 특히 낮은 신뢰도의 저장소에서 실행된 스크립트가 출시용 개인 키에 접근할 수 있다면, 저장소 이름을 다르게 붙이는 방식은 통제 수단이 되지 못합니다.

주의: 인증서가 만료된 경우와 비밀 정보가 노출된 경우는 처리 순서가 다릅니다. 만료는 갱신과 프로파일 재생성이 중심이지만, 노출은 접근 차단과 폐기 여부 판단이 먼저입니다.

단일 앱 시범 배포를 독립 경계로 고정하기

처음부터 모든 앱을 하나의 공유 맥에 올리지 말고, 신뢰할 수 있는 단일 앱으로 시범 배포를 진행하는 편이 안전합니다. 이 앱에는 명확한 번들 식별자, 담당자, Apple 팀, 인증서 유형, 서명 저장소가 있어야 합니다.

초기화나 서명 자산 갱신은 관리 작업으로 분류합니다. 반면 일반 CI가 실행할 때는 이미 승인된 자산을 읽기 전용으로 가져오는 작업만 허용합니다. fastlane의 setup_ci는 CI 환경에서 임시 키체인을 사용하도록 돕는 구성으로 안내되며, 일반 사용자 키체인에 자산을 계속 남기는 운영을 피하는 데 활용할 수 있습니다. setup_ci 공식 문서에 나온 동작 범위를 실제 실행 환경에서 다시 검증해야 합니다.

공유 맥에서 match를 실행할 때 읽기 전용을 적용해야 하는 경우는 언제인가요?

CI가 서명 자산을 생성하거나 변경할 책임이 없다면 읽기 전용을 기본값으로 둡니다. 자산을 갱신하는 담당자와 파이프라인을 분리해야 하며, 일반 브랜치가 새 인증서를 만들거나 기존 프로파일을 덮어쓰게 두면 변경 원인과 승인자를 추적하기 어려워집니다.

시범 배포의 합격 증거는 다음과 같습니다.

  • 저장소에 접근한 계정과 작업 기록
  • 같은 소스에서 반복한 빌드의 서명 결과
  • 작업 종료 뒤 임시 키체인이 삭제된 기록
  • 잘못된 팀 식별자를 넣었을 때 파이프라인이 중단되는 로그
  • match 저장소 장애 또는 인증 실패 시 사용할 복구 경로

키체인 삭제만 확인해서는 충분하지 않습니다. 작업 로그, 파일 시스템의 잔여 키, CI 변수의 노출 범위까지 함께 확인해야 합니다.

같은 Apple 팀의 여러 앱을 조건부로 묶기

같은 Apple 팀에 속한 앱이라도 모두 같은 신뢰 수준을 갖는 것은 아닙니다. 내부 테스트 앱, 외부 고객용 앱, 금융 또는 의료 데이터를 다루는 앱은 출시 영향과 담당자가 다릅니다. 따라서 같은 팀이라는 이유만으로 하나의 match 저장소와 하나의 출시 권한을 공유해서는 안 됩니다.

여러 번들 식별자를 관리할 때는 앱, 인증서, 프로파일, CI 작업을 한 줄씩 연결한 권한 표를 만듭니다. 앱의 민감도와 출시 빈도, 저장소 신뢰도, 담당자를 함께 기록해야 합니다.

배포 대상 저장소 경계 CI 권한 실행 맥 합격 증거
내부 검증 앱 같은 신뢰 영역 안에서 제한적 공유 읽기 전용 일반 검증 노드 앱 식별자와 프로파일 일치 로그
고객 출시 앱 별도 경로 또는 별도 저장소 읽기 전용, 출시 트리거 제한 독립 출시 노드 승인된 태그만 실행된 기록
민감 정보 앱 물리적으로 분리된 저장소 권장 지정 작업만 접근 전용 맥 잘못된 팀 설정 거부와 접근 감사 기록
서로 다른 Apple 팀 팀별 저장소와 복호화 자격 증명 분리 해당 팀 자산만 읽기 팀별 노드 또는 엄격한 작업 격리 다른 팀 자산을 선택하지 않은 실패 로그

여러 iOS 프로젝트가 하나의 match 저장소를 함께 사용해도 되나요?

가능 여부는 저장소 형식이 아니라 신뢰 영역으로 판단해야 합니다. 동일한 Apple 팀, 유사한 코드 저장소 신뢰도, 동일한 운영 책임자, 분리된 앱 식별자와 권한 정책을 모두 충족할 때만 제한적으로 검토합니다. 하나라도 다르면 팀별 또는 사업부별 저장소를 나누는 편이 낫습니다.

저장소를 공유하더라도 복호화 자격 증명과 CI 변수까지 공유할 필요는 없습니다. 한 저장소에 여러 팀의 자산을 넣는다면 경로와 브랜치 분리는 최소 조건이며, 고위험 앱에는 물리적으로 별도 저장소와 별도 실행 노드를 적용합니다. 이름 규칙만으로 잘못된 자산 사용을 막을 수 있다고 가정하면 안 됩니다.

서로 다른 Apple 팀과 사업부를 물리적으로 나누기

여러 Apple 팀을 운영하는 기업은 팀별로 저장소, 경로, 브랜치, 복호화 자격 증명, CI 작업 주체를 명시해야 합니다. 논리적 분리는 운영이 편하지만, 동일한 맥과 동일한 권한 계층을 통과한다는 위험은 남습니다. 민감한 사업부나 외부 협력 코드가 섞인 환경에서는 전용 맥 노드까지 검토해야 합니다.

fastlane match로 여러 Apple 팀의 인증서를 관리할 때 무엇을 먼저 분리해야 하나요?

먼저 팀 식별자와 앱 식별자를 고정한 뒤 저장소와 접근 주체를 분리합니다. 그다음 각 팀의 인증서와 프로파일을 해당 CI 작업에만 연결합니다. Apple 계정 역할은 업무에 필요한 범위로 제한해야 하며, 역할별 권한의 차이는 Apple 계정 역할 안내에서 확인할 수 있습니다.

검수에서는 일부러 잘못된 팀 설정을 주입합니다. 파이프라인이 다른 팀에서 사용 가능한 인증서를 자동 선택한다면 실패입니다. 명확한 오류와 중단을 반환해야 하며, 담당자가 수동으로 승인하지 않은 출시 작업은 진행되지 않아야 합니다.

일반 CI와 공식 출시 노드를 분리하기

일반 검증 작업은 출시 개인 키를 보지 않는 것이 최선입니다. 서명이 꼭 필요하다면 읽기 전용 match 동기화, 작업별 임시 키체인, 제한된 복호화 자격 증명을 사용합니다. 작업이 끝난 뒤 키체인, 임시 파일, 환경 변수와 로그에 남은 비밀 값을 정리합니다.

공식 출시는 보호된 저장소와 통제된 트리거를 거쳐 독립 맥 노드에서 실행합니다. 임의의 기능 브랜치나 외부 기여 코드가 출시 자격 증명을 호출할 수 없어야 합니다. Apple App Store Connect API 키를 사용하는 경우에도 키의 역할과 접근 범위를 구분해야 하며, App Store Connect API 공식 안내를 기준으로 발급 및 보관 절차를 검토합니다.

일반 CI와 출시 작업의 권한 표에는 최소한 다음 역할을 따로 적습니다.

  • match 자산을 초기화하거나 갱신할 수 있는 관리자
  • 서명 자산을 읽을 수 있는 CI 작업
  • 공식 출시를 승인하고 트리거할 수 있는 담당자
  • 빌드 결과만 확인할 수 있는 개발자와 감사자

iOS CI에서 임시 키체인을 만들고 정리하는 흐름은 어떻게 검수하나요?

CI 시작 시 작업 전용 키체인을 만들고, 필요한 자산만 읽기 전용으로 가져옵니다. 빌드와 검증이 끝나면 키체인을 잠그거나 삭제하고, 인증서와 프로파일의 잔여 파일 및 로그의 비밀 값까지 검사합니다. fastlane 문서의 CI 설정 예시와 실제 러너의 키체인 목록을 대조해야 합니다. CI용 임시 키체인 구성은 구현 참고 자료이지, 기업 내부의 삭제 검증을 대신하는 보증서가 아닙니다.

조건 분기로 출시 구조를 선택하기

다음 목록은 공유 맥을 계속 사용할지, 별도 출시 노드로 분리할지 결정할 때 사용합니다.

  • Apple 팀이 다르고 저장소 신뢰도도 다르면 별도 저장소와 별도 자격 증명을 선택합니다. 그렇지 않으면 팀별 경로와 오류 거부 테스트를 먼저 통과시킵니다.
  • 일반 CI가 출시 개인 키를 필요로 하지 않으면 키를 제공하지 않습니다. 필요하다면 임시 키체인과 읽기 전용 동기화를 강제합니다.
  • 외부 기여 코드나 낮은 신뢰도 브랜치가 있으면 공식 출시 노드에 연결하지 않습니다. 승인된 트리거만 허용합니다.
  • 앱의 실패 영향이 높거나 감사 추적이 필수라면 전용 맥 노드를 선택합니다. 영향이 낮은 내부 검증 앱만 제한적 공유로 되돌립니다.
  • 인증서 저장소의 복호화 자격 증명이 노출되었다면 단순히 비밀번호만 바꾸지 않습니다. 접근을 차단하고, 필요한 인증서와 API 키의 폐기 및 재발급 범위를 평가합니다.

인증서가 실제로 노출되었다면 Apple의 인증서 폐기 절차를 따라 영향받은 자산을 식별합니다. match 전체 자산을 다시 만들어야 하는 상황에서는 match nuke의 공식 주의사항을 먼저 읽어야 합니다. 이 작업은 되돌리기 어려운 영향을 만들 수 있으므로 일반 장애 대응 명령처럼 자동 실행해서는 안 됩니다.

인력 변경과 사고 대응을 운영 절차로 고정하기

입사자는 역할에 맞는 저장소와 CI 작업만 부여합니다. 직무가 바뀌면 기존 접근을 먼저 제거한 뒤 새 권한을 부여합니다. 퇴사자는 저장소 접근, CI 변수, 맥 계정, API 키와 원격 접근 권한을 순서대로 회수하고, 공유된 복호화 자격 증명의 교체 필요성을 판단합니다.

다음 생산 전 점검표를 승인 기록과 함께 보관합니다.

  • [ ] Apple 팀과 번들 식별자별 자산 경계가 작성되어 있습니다.
  • [ ] 일반 CI가 읽기 전용으로만 match를 실행합니다.
  • [ ] CI 작업마다 임시 키체인을 사용하고 종료 후 삭제합니다.
  • [ ] 공식 출시는 독립 맥 노드와 승인된 트리거를 사용합니다.
  • [ ] 저장소 접근, 키체인 정리, 실패와 재시도 로그를 보관합니다.
  • [ ] 인증서 만료, 복호화 자격 증명 노출, API 키 폐기 절차가 분리되어 있습니다.
  • [ ] 예비 노드와 장애 시 수동 복구 담당자가 지정되어 있습니다.
  • [ ] 잘못된 팀 설정과 잘못된 앱 식별자를 넣은 거부 테스트를 완료했습니다.

기존 맥 구축 환경의 계정, 원격 접근, 권한 상승과 감사 로그를 함께 확인하려면 기업 공유 맥 보안 검수 기준을 참고할 수 있습니다. 콘솔에서 실제 노드 접근 방식과 계정 상태를 확인하는 조직이라면 KuzCloud 원격 맥 콘솔도 같은 검수 항목과 함께 비교해야 합니다.

현재 사내 맥 구매 방식은 장기간 고정 부하에는 적합할 수 있지만, 장비 교체 주기와 물리적 장애 대응, 예비 장비 확보, 원격 근무자의 접근 통제를 기업이 직접 부담해야 합니다. 여러 사업부가 짧은 기간에 출시 노드를 추가할 때도 구매 자산은 즉시 늘리기 어렵습니다. 반대로 KuzCloud의 맥 렌탈은 전용 노드와 탄력적인 예비 자원을 비교할 선택지를 제공하므로, 내부 장비가 독립 노드·상시 접근·관리 권한·장애 교체 증거를 충족하지 못할 때 검토할 가치가 있습니다. 다만 장기간 고정적인 고부하 작업이나 물리 인터페이스가 필요한 조직에는 직접 구매가 더 적합할 수 있으므로, 기업용 맥 렌탈 조건을 서명 자산 격리 요건과 함께 대조해야 합니다.

이 기준을 통과한 뒤에도 중요한 것은 맥의 대수가 아니라 신뢰 영역과 권한 경계입니다. 한 대를 여러 앱이 공유하더라도 출시 키를 분리할 수 있어야 하며, 분리가 불가능하면 노드를 나누는 것이 안전한 회귀 경로입니다.

KuzCloud로 기업 서명용 원격 맥을 분리하십시오

KuzCloud의 원격 맥으로 프로젝트와 작업자별 개발 환경을 나누어 서명 정보가 섞이는 위험을 줄일 수 있습니다.

필요한 지역의 맥 환경에 원격으로 접속해 사내 장비를 공유하지 않고 안전하게 빌드와 배포를 진행할 수 있습니다.