인증서 만료 알림이 나타났지만 업데이트 일정은 이미 잡혀 있고, 기존 빌드 맥에도 접속할 수 없는 상태라면 먼저 모든 인증서를 폐기하지 않아야 합니다. Apple Distribution 인증서 만료 2026 문제는 자동 서명인지 수동 서명인지부터 나눈 뒤, 권한과 클라우드 관리 인증서 또는 새 인증서와 프로파일을 순서대로 확인해야 복구 범위를 줄일 수 있습니다.
[ SECTION_01 ] 이 글이 필요한 담당자
앱 업데이트 직전에 분배 인증서 만료 알림을 받은 앱 운영 책임자에게 적합합니다. 외주 프로젝트를 넘겨받았지만 개인 키, 프로파일 또는 기존 빌드 맥을 찾지 못한 프로젝트 관리자도 대상입니다.
기술 담당자가 원격으로 서명 복구와 빌드 업로드를 진행할 수 있도록 안정적인 맥 환경을 준비해야 하는 해외 사업팀 관리자에게도 유용합니다.
[ SECTION_02 ] 먼저 구분해야 할 네 가지 상태
Apple Developer Program의 회원 상태가 정상이어도 Apple Distribution 인증서는 만료될 수 있습니다. 반대로 인증서가 새로 만들어졌어도 프로비저닝 프로파일이 예전 서명 자산을 가리키면 빌드가 계속 실패할 수 있습니다.
발행 담당자는 다음 네 항목을 별개로 기록해야 합니다.
- Apple Developer Program 회원 상태
- Apple Distribution 인증서와 연결된 개인 키
- 앱 식별자와 연결된 App Store용 프로파일
- App Store Connect의 앱, 버전, 빌드 처리 상태
Apple은 인증서 종류와 사용 권한을 별도로 관리하며, App Store용 프로파일도 따로 만들도록 안내합니다. 인증서 종류와 권한에 관한 공식 안내와 App Store용 프로파일 생성 절차를 각각 확인해야 합니다.
이 구분을 하지 않으면 회원 갱신 문제를 인증서 문제로 착각하거나, 업로드가 끝났는데 App Store Connect에서 빌드가 보이지 않는 상황을 반복하게 됩니다.
[ SECTION_03 ] 자동 서명이라면 기존 인증서를 바로 폐기하지 않습니다
Xcode 자동 서명은 언제 새 분배 인증서를 사용할 수 있습니까
Xcode 프로젝트에서 자동 서명 관리가 켜져 있다면 먼저 현재 로그인 계정이 올바른 팀에 속해 있는지 확인합니다. 자동 서명은 팀의 클라우드 관리 서명 자산을 사용할 수 있는 환경에서 유효합니다. 따라서 만료 문구만 보고 수동으로 여러 자산을 삭제하는 것은 안전한 첫 조치가 아닙니다.
Apple의 클라우드 관리 인증서 안내에 따라 다음을 확인합니다.
- Xcode의 서명 팀이 실제 앱의 팀과 일치하는지 확인합니다.
- 프로젝트의 자동 서명 관리가 활성화되어 있는지 확인합니다.
- 현재 계정에 인증서 관련 권한이 있는지 담당자에게 확인합니다.
- 새 Archive를 만들고 배포 검사를 먼저 실행합니다.
- 오류가 인증서인지 프로파일인지 업로드 단계인지 기록합니다.
자동 서명은 모든 권한 문제를 대신 해결하지 않습니다. 팀에서 인증서 자산을 볼 수 없는 계정이라면 Xcode 설정을 반복해도 해결되지 않습니다. 역할별 접근 범위는 Apple Developer 역할과 권한 표에서 확인할 수 있습니다.
자동 서명과 수동 서명의 선택 점수
다음 기준으로 복구 경로를 정하면 됩니다.
- 자동 서명: 3점
- 프로젝트 설정을 변경할 수 있습니다.
- 올바른 팀 계정으로 Xcode에 로그인할 수 있습니다.
- 새 Archive를 만들 수 있습니다.
- 수동 서명: 3점
- 배포 인증서와 개인 키를 직접 관리합니다.
- 프로파일을 특정 파일로 고정해 두었습니다.
- 외주 인수나 여러 빌드 맥 때문에 서명 자산을 명시적으로 통제해야 합니다.
자동 서명 점수가 높으면 기존 자산을 보존한 상태로 새 Archive부터 시도합니다. 수동 서명 점수가 높으면 새 인증서, 개인 키, 프로파일을 맞춰야 합니다. 두 경로를 동시에 섞으면 어느 자산이 실패했는지 추적하기 어려워집니다.
[ SECTION_04 ] 수동 서명은 인증서와 프로파일을 함께 다시 맞춥니다
새 인증서만 만든 뒤 업로드를 반복하는 방식은 부족합니다. 수동 서명에서는 유효한 Apple Distribution 인증서, 그 인증서의 개인 키, 앱에 맞는 App Store용 프로파일이 한 세트로 맞아야 합니다.
첫 단계: 기존 자산의 사용처를 기록합니다
폐기나 삭제를 하기 전에 다음 내용을 별도 기록에 남깁니다.
- 어떤 프로젝트가 기존 인증서를 사용하는지
- 누가 빌드와 업로드를 담당했는지
- 어떤 맥의 키체인에 자산이 설치되어 있었는지
- 현재 버전과 다음 업데이트 버전이 무엇인지
- 자동 서명과 수동 서명 중 어느 방식인지
같은 팀의 다른 앱이나 배포 작업이 아직 기존 자산을 사용 중일 수 있습니다. 따라서 만료된 자산이 보인다는 이유만으로 팀의 인증서를 일괄 폐기하지 않아야 합니다.
두 번째 단계: 새 인증서를 만들고 프로파일을 다시 생성합니다
새 인증서가 필요하다면 권한을 가진 담당자가 인증서 서명 요청 파일을 만들고 Apple Developer에서 새 배포 인증서를 생성합니다. 인증서 서명 요청 생성 방법을 기준으로 진행해야 합니다.
그다음 앱 식별자와 배포 목적을 확인해 App Store용 프로파일을 새로 만들거나 다시 생성합니다. 이미 만든 프로파일을 편집하거나 내려받는 경우에는 프로파일 편집과 재생성 안내를 따릅니다.
새 프로파일이 무효로 보이는 대표적인 이유는 다음과 같습니다.
- 새 인증서가 프로파일에 포함되지 않았습니다.
- 다른 앱 식별자를 선택했습니다.
- 다른 팀을 선택했습니다.
- Xcode가 이전 프로파일을 계속 사용합니다.
- 인증서는 설치했지만 연결된 개인 키가 없습니다.
따라서 새 인증서 파일을 내려받는 것만으로는 충분하지 않습니다. 프로파일을 새 서명 자산에 맞춰 다시 만들고, 해당 파일을 빌드 맥에 설치한 뒤 프로젝트의 서명 설정을 다시 확인해야 합니다.
[ SECTION_05 ] 개인 키가 없으면 인증서 파일만으로 복구할 수 없습니다
분배 인증서 파일은 있지만 개인 키가 없는 경우
키체인 접근에서 인증서 항목을 열었을 때 연결된 개인 키가 함께 표시되는지 확인합니다. 인증서 파일만 있고 개인 키가 없다면 해당 맥에서는 그 인증서로 서명할 수 없습니다.
원래 맥 또는 기존 담당자가 아직 접근 가능한 경우에는 개인 키를 보호된 방식으로 인수합니다. 파일을 메신저나 공개 저장소에 올리는 방식은 피해야 합니다. 원래 개인 키를 복구할 수 없다면 권한을 가진 담당자가 새 인증서와 새 프로파일을 생성해야 합니다.
Apple 계정 암호, 맥 관리자 계정, 개인 키가 포함된 보호되지 않은 인증서 내보내기 파일을 공유해서는 안 됩니다. 외주 인수 시에는 자산 자체보다 접근 권한과 보관 위치를 함께 확인해야 합니다.
맥을 교체한 뒤 앱 서명을 복구하는 순서
- 새 맥에 승인된 Apple 계정으로 Xcode를 설치하고 로그인합니다.
- 프로젝트가 사용하는 팀과 번들 식별자를 확인합니다.
- 기존 인증서에 연결된 개인 키가 있는지 키체인에서 확인합니다.
- 개인 키가 없으면 기존 파일을 계속 재사용하지 말고 새 서명 자산 발급 여부를 결정합니다.
- 새 인증서가 필요하면 인증서 서명 요청을 만들고 권한 담당자가 발급합니다.
- 새 인증서를 해당 맥에 설치합니다.
- 새 인증서에 맞는 App Store용 프로파일을 내려받아 설치합니다.
- Xcode에서 서명 방식과 팀, 인증서, 프로파일을 다시 선택합니다.
- 새 Archive를 생성하고 배포 검사를 실행합니다.
- 업로드 뒤 App Store Connect에서 올바른 앱과 버전에 빌드가 연결되는지 확인합니다.
이 과정에서 원래 맥의 키체인이나 프로젝트 설정을 확보했다면 먼저 보존합니다. 기존 자산을 삭제한 뒤 새 환경에서만 작업하면 원인 비교가 어려워집니다.
[ SECTION_06 ] 복구 후에는 서명 오류와 업로드 오류를 분리합니다
인증서를 다시 만든 뒤에도 업로드가 되지 않는다면 같은 인증서를 반복해서 만들지 않아야 합니다. 실패 지점을 네 가지로 나누면 다음 조치가 달라집니다.
- 서명 검사 실패: 인증서, 개인 키, 팀 또는 프로파일을 다시 확인합니다.
- 프로파일 불일치: 앱 식별자와 새 인증서가 프로파일에 포함됐는지 확인합니다.
- 팀 선택 오류: Xcode 로그인 계정과 프로젝트의 팀을 대조합니다.
- 업로드 뒤 빌드 미표시: App Store Connect의 앱, 버전, 처리 상태와 업로드 로그를 확인합니다.
Apple은 App Store Connect에 빌드를 올리는 공식 절차를 제공합니다. 빌드 업로드 공식 안내와 Xcode에서 업로드하는 절차를 기준으로 한 번에 한 가지 설정만 바꿔 재검수합니다.
이때 저장할 기록은 세 가지입니다.
- 서명 검사 결과
- 업로드 로그와 빌드 식별 정보
- App Store Connect에서 확인한 앱과 버전 상태
오류가 버전 번호, 앱 권한 또는 빌드 처리 단계로 이동했다면 인증서 복구는 완료된 것일 수 있습니다. 이 경우 인증서를 계속 재생성하지 말고 새 오류의 원인을 따로 조사해야 합니다.
[ SECTION_07 ] 업데이트 전 최종 인수 확인
다음 체크리스트는 운영 담당자가 기술 담당자의 작업 결과를 확인할 때 사용할 수 있습니다.
- [ ] Apple Developer Program 회원 상태를 확인했습니다.
- [ ] Xcode의 팀 선택이 실제 앱 팀과 일치합니다.
- [ ] 자동 서명 또는 수동 서명 방식을 문서에 기록했습니다.
- [ ] 배포 인증서와 연결된 개인 키를 확인했습니다.
- [ ] 새 인증서가 필요하다면 담당자와 발급 주체를 기록했습니다.
- [ ] App Store용 프로파일이 새 인증서와 앱 식별자에 맞습니다.
- [ ] 새 맥 또는 기존 맥에서 Xcode가 올바른 서명 자산을 사용합니다.
- [ ] Archive 생성과 서명 검사를 완료했습니다.
- [ ] 빌드 업로드 로그를 보관했습니다.
- [ ] App Store Connect에서 올바른 앱과 버전에 빌드가 나타납니다.
- [ ] 인증서 담당자와 프로파일 보관 위치를 기록했습니다.
- [ ] 공유 문서에 암호와 개인 키를 평문으로 저장하지 않았습니다.
앱 업데이트가 반복적으로 예정되어 있다면 고정 맥, 단기 원격 맥, 이중 환경을 비교해야 합니다. 고정 맥은 키체인 보관과 재현성에 유리하지만 장비 인수인계가 늦어질 수 있습니다. 단기 환경은 이번 복구와 업로드 검수에 적합할 수 있지만, 프로젝트가 계속된다면 접근 권한과 보관 정책을 먼저 정해야 합니다. 이 비교를 위한 해외 맥 환경 구성 안내도 함께 확인할 수 있습니다.
현재 방식이 개인 담당자의 맥 한 대에만 의존한다면, 담당자 부재와 키체인 미인수라는 두 가지 문제가 남습니다. 외주 종료 뒤에는 서명 자산의 위치를 찾는 시간이 늘어나고, 새 맥을 받을 때마다 빌드 환경을 다시 맞춰야 합니다. 이럴 때 NOVAKVM의 원격 맥을 단기 환경으로 검토할 수 있습니다. 다만 원격 맥도 Apple 권한, 개인 키 보호, 심사 규칙을 우회하지 않습니다. 실제 프로젝트에 맞는지는 먼저 한 번의 Archive와 업로드 검수로 판단하는 편이 안전합니다. 미국 환경이 필요한 팀은 미국 동부 원격 맥 선택지도 비교할 수 있습니다.
핵심은 Apple Distribution 인증서 만료 2026 문제를 일괄 폐기 문제로 다루지 않는 것입니다. 자동 서명은 팀과 권한, 클라우드 관리 자산을 먼저 확인하고, 수동 서명은 인증서·개인 키·프로파일을 한 세트로 다시 맞춰야 합니다. 마지막에는 반드시 Archive, 업로드, App Store Connect 빌드 표시까지 확인해야 다음 업데이트에서 같은 문제가 반복되지 않습니다.