Apple Developer 인증서 만료 시 어떻게 해야 할까요? 2026 iOS 배포 복구

서명 오류가 나고 아카이브나 업로드가 멈췄다면, 인증서 만료만 원인이라고 단정하지 마세요.
개발 인증서, 배포 인증서, 프로비저닝 프로파일, 개발자 멤버십 상태를 구분한 다음 실제 빌드 맥에서 다시 서명해 확인하세요.

이 글은 업데이트를 앞두고 인증서 오류를 만난 독립 개발자를 위한 점검 절차입니다.
갱신한 서명 자산을 팀과 원격 빌드 환경에 반영해야 하는 소규모 팀에도 유용합니다.
로컬에서는 되지만 원격 맥에서 실패하는 경우에도 원인을 좁힐 수 있습니다.

오류 메시지보다 서명 자산의 상태를 먼저 확인하세요

Xcode의 서명 오류는 원인을 하나로 특정해 주지 않을 수 있습니다. 인증서가 만료됐는지, 취소됐는지, 프로비저닝 프로파일이 유효하지 않은지, 계정 멤버십에 문제가 있는지 각각 확인해야 합니다. Apple은 인증서 유형별 용도와 상태를 공식 인증서 안내에서 설명합니다.

먼저 실패한 작업과 서명 대상을 기록하세요. 개발용 빌드인지, 앱 스토어 제출용 아카이브인지, 개발자 ID 서명인지에 따라 필요한 서명 자산이 다릅니다. 개발 인증서와 Apple Distribution 인증서를 같은 것으로 취급하면 사용하지 않는 인증서를 새로 만들거나 필요한 프로파일을 놓칠 수 있습니다.

Apple Development와 Apple Distribution의 만료 영향은 어떻게 다를까요?

Apple Development 인증서는 개발 중인 앱을 서명하고 테스트하는 용도입니다. Apple Distribution 인증서는 배포용 빌드에 사용됩니다. 따라서 개발 인증서 만료는 개발 서명 작업에, 배포 인증서 만료는 새 배포용 아카이브나 업로드 작업에 영향을 줄 수 있습니다. 인증서의 용도는 Apple의 인증서 유형 설명에서 확인하세요.

앱 스토어에 이미 배포된 앱이 있다는 사실만으로 현재 사용 중인 서명 자산이 모두 유효하다고 판단하지 마세요. 배포 인증서 만료는 일반적으로 새 제출물을 만드는 문제와 관련되며, 기존에 배포된 앱이 즉시 중단된다는 뜻은 아닙니다. 기존 앱의 상태와 새 버전 제출을 분리해 판단해야 합니다.

인증서 만료와 취소도 다릅니다. 만료는 유효 기간이 끝난 상태이고, 취소는 계정에서 해당 인증서의 권한을 폐기한 상태입니다. 취소는 영향 범위를 확인하지 않고 반복해서 실행하지 마세요. Apple의 인증서 권한 취소 안내를 확인하고, 의심되는 인증서가 어떤 용도인지 먼저 대조하세요.

배포 인증서 갱신 뒤 프로파일과 개인 키를 확인하세요

새 인증서를 계정에서 확인했다고 해서 빌드 맥에서도 바로 서명할 수 있는 것은 아닙니다. 서명에 필요한 것은 공개 인증서만이 아니라 해당 인증서에 연결된 개인 키까지 포함한 서명 신원입니다. 실제 빌드를 수행하는 맥의 키체인에서 인증서와 개인 키가 한 쌍으로 보이는지 확인하세요. 팀에서 인증서를 관리한다면 Apple의 팀 서명 인증서 안내도 참고하세요.

확인할 때는 Xcode 프로젝트의 서명 팀과 빌드 설정도 함께 살펴보세요. 다른 팀의 인증서를 선택했거나, 대상 앱이 다른 번들 식별자 또는 서명 설정을 사용하면 유효한 인증서가 있어도 서명이 실패할 수 있습니다. 오류가 난 타깃과 실행한 빌드 구성을 기준으로 설정을 대조해야 합니다.

인증서를 새로 만들기 전에 실패한 빌드의 로그와 키체인 상태를 보존하세요. 원인을 확인하지 않고 기존 인증서를 취소하면, 정상적으로 서명하던 다른 빌드 환경까지 영향을 받을 수 있습니다.

iOS 배포 인증서를 바꾼 뒤 프로파일도 다시 만들어야 할까요?

프로비저닝 프로파일은 앱 식별자, 권한, 서명 인증서 등과 연결됩니다. 새 배포 인증서가 프로파일에 포함되어 있지 않거나 프로파일 자체가 만료됐다면, 기존 파일을 계속 사용하지 말고 해당 프로파일을 갱신하거나 다시 생성해야 합니다. Apple은 프로파일 편집과 다운로드 절차와 프로파일 업데이트 안내를 제공합니다.

다만 인증서를 갱신했다는 이유만으로 모든 프로파일을 무조건 새로 만들 필요는 없습니다. 현재 프로파일이 유효한지, 새 인증서를 포함하는지, 앱 식별자와 필요한 기능이 일치하는지 확인한 뒤 결정하세요. Xcode가 관리하는 프로파일과 개발자 계정에서 직접 관리하는 프로파일은 갱신 및 다운로드 경로가 다를 수 있으므로, 현재 프로젝트에서 실제로 사용하는 방식을 확인해야 합니다.

계정 멤버십 문제라면 인증서 재발급을 멈추세요

개발자 멤버십 만료나 팀 권한 문제는 인증서 자체의 만료와 다른 원인입니다. 개발자 계정에서 멤버십 상태와 사용자의 역할을 확인하세요. Apple의 멤버십 갱신 안내를 기준으로 계정 상태를 검토하고, 권한이 없거나 갱신이 필요한 상황이면 인증서를 계속 취소하거나 재발급하지 마세요.

오류가 여러 맥과 여러 프로젝트에서 동시에 발생하거나, 계정 페이지에서 상태를 확인할 수 없다면 빌드 설정만 반복해서 바꾸는 것도 피하세요. 계정 권한, 멤버십 또는 Apple 서비스 상태가 원인일 가능성이 있다면 해당 항목을 먼저 해결한 뒤 서명을 재검증해야 합니다.

원격 맥의 서명 실패는 실제 실행 환경에서 재현하세요

로컬 키체인에 새 인증서를 가져온 것과 자동화 작업이 새 인증서를 사용하는 것은 별개의 확인입니다. 먼저 파이프라인이 실제로 호출하는 맥과 실행 계정을 확인하세요. 로컬에서 성공한 결과를 원격 환경에도 반영된 것으로 간주하면 안 됩니다.

원격 환경에서는 다음 항목을 차례로 대조하세요.

• 빌드 작업이 실행되는 맥과 사용자 계정이 예상한 대상인지 확인합니다.
• 해당 계정의 키체인에서 인증서와 개인 키가 함께 사용 가능한지 확인합니다.
• Xcode의 서명 팀, 빌드 구성, 앱 식별자가 목표 배포 방식과 맞는지 점검합니다.
• 프로파일이 새 인증서를 포함하고, 앱 식별자와 권한이 프로젝트 설정에 맞는지 확인합니다.
• 자동화 로그에서 실제 선택된 서명 신원과 내보내기 대상을 확인합니다.

fastlane match를 사용하는 경우에는 인증서 저장소의 상태만 보지 말고, 빌드 실행 환경에 동기화된 결과를 확인하세요. 자동화 빌드에서 readonly 설정을 사용하는 방식은 fastlane의 match 문서를 참고할 수 있습니다. 읽기 전용 동기화는 빌드 중 새 서명 자산을 만들지 않도록 하는 경계이므로, 필요한 인증서나 프로파일이 저장소에 없으면 먼저 관리 절차에서 보완해야 합니다. 여기서는 저장소 초기화나 일반적인 match 오류가 아니라, 갱신된 자산이 실제 빌드 맥에 도착했는지를 확인하는 데 집중하세요.

인증서를 갱신했는데 원격 맥에서 계속 실패하는 이유는 무엇일까요?

흔한 원인은 새 인증서가 로컬에만 설치됐거나, 원격 작업이 다른 사용자 계정이나 다른 맥에서 실행되는 경우입니다. 키체인이 잠겨 개인 키를 사용할 수 없는 상황, 오래된 프로파일을 계속 참조하는 빌드 설정도 확인 대상입니다. 실패 로그의 서명 신원과 실제 실행 맥을 비교하면, 인증서 문제와 환경 동기화 문제를 구별할 수 있습니다.

조건에 따라 갱신 또는 계정 점검을 선택하세요

아래 조건을 기준으로 다음 작업을 정하세요. 인증서를 더 만들기 전에 실패 증거와 일치하는 분기로 이동해야 합니다.

• 인증서 상태가 만료이고 계정 권한이 정상이라면: 해당 용도의 유효한 인증서를 준비하고, 그 인증서를 쓸 빌드 맥에 개인 키가 포함된 서명 신원을 설치합니다.
• 인증서는 유효하지만 프로파일이 만료됐거나 인증서를 포함하지 않는다면: 앱 식별자와 권한을 확인한 뒤 해당 프로파일을 업데이트하거나 다시 생성합니다.
• 로컬 서명은 성공하고 원격 서명만 실패한다면: 인증서를 반복 발급하지 말고 실제 실행 맥, 사용자 계정, 키체인, 프로파일 동기화부터 확인합니다.
• 계정에서 멤버십이나 팀 권한 오류가 확인된다면: 인증서 재발급을 멈추고 계정 상태와 권한을 해결합니다.
• 로그에서 취소 또는 Apple 서비스 관련 문제가 의심된다면: 기존 인증서를 추가로 취소하지 말고 계정 상태와 공식 안내를 확인한 뒤 필요한 경우 지원 절차로 넘깁니다.

아카이브부터 업로드까지 복구 여부를 판정하세요

서명 설정 화면이 정상으로 보이는 것만으로 복구를 완료 처리하지 마세요. 실패했던 배포 방식과 같은 설정으로 아카이브하거나 내보내고, 산출물에 적용된 서명 신원과 프로파일이 목표 앱 및 배포 방식에 맞는지 확인해야 합니다. 이어 업로드 단계에서 계정과 제출 상태를 점검하세요. 아카이브 성공은 업로드 성공과 같은 의미가 아닙니다.

평가는 공식 장애 등급이 아니라 복구 작업 순서를 정하기 위한 판단입니다. Apple 공식 안내와 실제 빌드 로그가 서로 다른 상태를 가리키면, 로그에 나타난 실행 환경과 계정에서 확인한 정보를 다시 대조하세요. 지속적으로 서명 작업을 운영해야 한다면 맥 미니 사용 비용 안내를 통해 직접 장비를 마련하는 선택도 비교할 수 있습니다.

로컬 맥만으로 배포를 이어가면 장비를 계속 켜 두어야 하고, 저장 공간과 키체인을 관리해야 하며, 담당자가 바뀔 때 서명 환경을 다시 맞춰야 할 수 있습니다. 반대로 원격 맥은 실제 서명 환경을 따로 운영할 수 있지만, 장기적으로 계속 무거운 작업을 돌리거나 물리 장비 연결이 필요한 경우에는 직접 보유가 더 적합할 수 있습니다. 인증서와 프로파일을 먼저 정리한 뒤 일정 기간 사용할 서명용 맥이 필요하다면, MacDate의 원격 맥 이용 방식을 비교해 보세요. 실제 실행 환경에서 아카이브와 업로드까지 확인할 수 있는지 기준을 세우면, 단순히 인증서를 바꾸는 것보다 재발을 줄이는 데 도움이 됩니다.