Ein geplantes App-Update steht an, doch der bisherige Build-Mac meldet ein abgelaufenes Apple Distribution-Zertifikat.
Die schnellste Lösung: Nicht sofort alle Zertifikate widerrufen. Zuerst die Signierungsart feststellen. Bei automatischer Signierung werden Teamzugriff und cloudverwaltete Zertifikate geprüft; bei manueller Signierung werden ein gültiges Zertifikat, der passende private Schlüssel und ein neu erzeugtes Bereitstellungsprofil benötigt.
[ SECTION_01 ] Für welche Teams diese Wiederherstellung gedacht ist
Diese Anleitung richtet sich an Verantwortliche für App-Updates, die kurz vor dem Veröffentlichungsfenster eine Ablaufmeldung erhalten. Sie ist außerdem für Projektmanager geeignet, die nach einem Wechsel des Dienstleisters weder privaten Schlüssel noch ursprünglichen Build-Mac vollständig übernommen haben.
Auch internationale Teams profitieren davon, wenn eine dauerhaft erreichbare macOS-Umgebung für Xcode, Archive und den Upload fehlt. Eine neue Umgebung ersetzt jedoch keine Apple-Berechtigung und umgeht weder Prüfungen noch regionale Vorgaben.
[ SECTION_02 ] Die Fehlermeldung richtig einordnen
Ein abgelaufenes Zertifikat ist nicht automatisch dasselbe Problem wie ein abgelaufenes Apple Developer Program, ein ungültiges Bereitstellungsprofil oder eine falsche App-Store-Connect-Zuordnung.
Das Apple Developer Program regelt die Mitgliedschaft des Entwicklerteams. Das Apple Distribution-Zertifikat ist ein Signierungsobjekt. Das Bereitstellungsprofil verbindet unter anderem App-ID, Team und Signierungsanforderung. App Store Connect nimmt anschließend den signierten Build entgegen und ordnet ihn der passenden App und Version zu.
Die offiziellen Zertifikatsinformationen unterscheiden die verfügbaren Zertifikatstypen und ihre Berechtigungen. Für die Prüfung sollte das Team deshalb direkt die offizielle Übersicht zu Apple-Zertifikaten verwenden.
| Prüfpunkte | Was geprüft wird | Bedeutung für das Update | Bewertung |
|---|---|---|---|
| Apple Developer Program | Mitgliedschaft und Teamzugang | Ohne gültigen Teamzugang kann keine zuverlässige Signaturverwaltung erfolgen | Grundvoraussetzung |
| Apple Distribution-Zertifikat | Gültigkeit und Verwendung für die Distribution | Das Zertifikat muss zur gewählten Signierungsart passen | Kritisch |
| Privater Schlüssel | Vorhandensein in der Schlüsselbundverwaltung | Eine heruntergeladene Zertifikatsdatei allein reicht nicht für eine Signatur | Kritisch |
| Bereitstellungsprofil | App-ID, Team und Signierungsressourcen | Ein neues Zertifikat kann ein neues Profil erforderlich machen | Kritisch |
| App Store Connect | App, Version und Build-Zuordnung | Ein erfolgreich signierter Build muss noch korrekt verarbeitet werden | Abschlussprüfung |
Kann die App trotz abgelaufenem Apple Distribution-Zertifikat aktualisiert werden?
Ja, ein bereits im App Store verfügbares Produkt wird dadurch nicht automatisch aus dem Store entfernt. Für ein neues Update muss jedoch ein gültiger, korrekt signierter Build erstellt und hochgeladen werden. Bei Enterprise-, Ad-hoc- und App-Store-Verteilung gelten unterschiedliche Abläufe; diese dürfen nicht vermischt werden. Die folgenden Schritte beziehen sich auf den App-Store-Veröffentlichungsweg.
Vor jeder Änderung sollten die Ablaufmeldung, der aktuelle Signierungsstatus in Xcode, der Teamname und der vollständige Build-Fehler als entschärfte Screenshots gespeichert werden. Kontaktdaten, Bundle-IDs mit vertraulichen Bestandteilen, Tokens und Dateiinhalte gehören nicht in ein gemeinsames Dokument.
[ SECTION_03 ] Automatische Signierung zuerst auf Team und Cloud-Ressourcen prüfen
Bei aktivierter automatischer Verwaltung übernimmt Xcode einen Teil der Signierungsverwaltung. Das bedeutet nicht, dass jede lokale Umgebung ohne Teamzugriff sofort einen gültigen Archive-Build erzeugen kann. Der angemeldete Account muss dem richtigen Entwicklerteam angehören. Außerdem müssen Rolle und Ressourcenzugriff zum Vorgang passen.
Apple beschreibt cloudverwaltete Zertifikate als Signierungsoption für unterstützte Xcode- und Teamabläufe. Die Details stehen in der Dokumentation zu cloudverwalteten Zertifikaten.
Erneuert Xcode bei automatischer Signierung das Distributionszertifikat selbst?
Xcode kann bei geeigneter Projektkonfiguration und ausreichenden Teamrechten benötigte Signierungsressourcen verwalten. Das ist aber keine pauschale Zusage für jedes Projekt. Ein manuell gepflegtes Profil, ein fehlender Teamzugang, eine eingeschränkte Rolle oder ein Projekt mit fest eingetragenen Signierungswerten kann die automatische Wiederherstellung verhindern.
Die Prüfung erfolgt in dieser Reihenfolge:
- Projekt in Xcode öffnen und den korrekten Workspace beziehungsweise das korrekte Projekt verwenden.
- Unter „Signing & Capabilities“ feststellen, ob „Automatically manage signing“ aktiviert ist.
- Teamnamen und angemeldeten Apple Account mit dem zuständigen Apple-Developer-Team abgleichen.
- Für das betroffene Target Bundle Identifier und Signierungsmodus prüfen.
- Einen neuen Archive-Vorgang starten, ohne alte Zertifikate vorsorglich zu widerrufen.
- Im Distribute-App-Schritt kontrollieren, ob Xcode die Signaturprüfung abschließt.
- Nur bei einem konkreten Fehler die betroffene Ressource ändern und den Test erneut ausführen.
Die Rolle des Kontos ist dabei entscheidend. Apple führt in der Rollen- und Berechtigungsübersicht auf, welche Nutzer Zertifikate und Profile verwalten dürfen. Eine Person mit App-Store-Connect-Zugriff besitzt deshalb nicht automatisch dieselben Rechte in der Entwicklerkontoverwaltung.
[ SECTION_04 ] Manuelle Signierung mit neuem Zertifikat und Profil wiederaufbauen
Manuelle Signierung wird häufig in älteren Projekten, bei mehreren Build-Maschinen oder bei streng kontrollierten Übergaben verwendet. Hier müssen die einzelnen Bausteine zusammenpassen. Ein neues Zertifikat allein repariert die Kette nicht.
| Signierungsbestandteil | Erforderlicher Abgleich | Typischer Fehler bei der Wiederherstellung |
|---|---|---|
| Apple Distribution-Zertifikat | Richtiges Team und passender Zertifikatstyp | Zertifikat wurde für ein anderes Team erstellt |
| Privater Schlüssel | Zertifikat muss mit dem Schlüsselbundobjekt verbunden sein | Nur die öffentliche Zertifikatsdatei wurde übertragen |
| Bundle Identifier | Muss zur App-ID des Projekts passen | Profil gehört zu einer anderen App |
| Bereitstellungsprofil | Muss nach der Zertifikatsänderung neu erzeugt oder angepasst werden | Profil enthält weiterhin alte Signierungsressourcen |
| Xcode-Projekt | Manuelle Auswahl muss auf die neuen Objekte zeigen | Alte Team- oder Profilwerte bleiben eingetragen |
Die Wiederherstellung sollte in dieser Reihenfolge erfolgen:
- Im Entwicklerkonto feststellen, ob das vorhandene Zertifikat tatsächlich abgelaufen ist und ob ein anderes aktives Zertifikat für denselben Build-Prozess existiert.
- Falls ein neues Zertifikat erforderlich ist, auf dem zuständigen Mac eine Certificate Signing Request erzeugen. Apple beschreibt den Ablauf in der Anleitung zur Erstellung einer CSR.
- Ein neues Apple Distribution-Zertifikat mit der passenden Rolle und dem korrekten Team anlegen.
- Das Zertifikat auf dem vorgesehenen Build-Mac installieren.
- Die App-ID, den Bundle Identifier und die Zielumgebung des Projekts kontrollieren.
- Das App-Store-Bereitstellungsprofil neu erstellen oder bearbeiten. Die offiziellen Schritte zur Erstellung eines App-Store-Bereitstellungsprofils sollten dabei maßgeblich sein.
- Das neue Profil herunterladen und auf dem Build-Mac installieren.
- In Xcode die manuell ausgewählten Zertifikate und Profile aktualisieren.
- Ein neues Archive erzeugen und die Signierungsprüfung vor dem Upload durchführen.
- Erst danach den Build an App Store Connect übergeben.
Warum bleibt das Bereitstellungsprofil nach dem Erstellen eines neuen Zertifikats ungültig?
Das Profil kann weiterhin auf ein altes Zertifikat, eine falsche App-ID oder ein anderes Team verweisen. Ein Profil ist keine allgemeine Freigabe für jede Version des Projekts. Es muss die verwendeten Signierungsressourcen und die konkrete App-Konfiguration abbilden.
Das Profil sollte deshalb nicht nur heruntergeladen, sondern im Entwicklerkonto auf seine enthaltenen Ressourcen geprüft werden. Apple erklärt auch das Bearbeiten, Herunterladen und Löschen von Bereitstellungsprofilen. Nach einer Änderung muss die lokale Auswahl in Xcode erneut kontrolliert werden.
[ SECTION_05 ] Fehlender privater Schlüssel nach Dienstleisterwechsel oder Mac-Tausch
Ein Zertifikat lässt sich als Datei übertragen. Der private Schlüssel ist jedoch ein separates Schlüsselbundobjekt. Fehlt er, kann die Zertifikatsdatei zwar sichtbar sein, aber nicht als vollständige Signierungsidentität verwendet werden.
Was ist zu tun, wenn die Zertifikatsdatei vorhanden ist, aber der private Schlüssel fehlt?
Zuerst sollte auf dem ursprünglichen Mac in der Schlüsselbundverwaltung nach dem Zertifikat gesucht werden. Das Zertifikat muss dort mit dem zugehörigen privaten Schlüssel verbunden sein. Eine isolierte .cer-Datei löst das Problem nicht. Falls die ursprüngliche Identität noch verfügbar ist, sollte sie über einen geschützten, dokumentierten Übergabeprozess exportiert und auf dem neuen Build-Mac importiert werden.
Ist der private Schlüssel nicht mehr erreichbar, muss eine berechtigte Person eine neue Signierungsidentität erstellen. Der alte Zertifikatsimport kann nicht nachträglich in einen fehlenden privaten Schlüssel umgewandelt werden.
Für die Übergabe gelten klare Sicherheitsregeln:
- Keine Weitergabe des Apple-Account-Passworts.
- Keine gemeinsame Nutzung eines Administratorkontos.
- Keine unverschlüsselte Ablage von Zertifikats- oder Schlüsseldateien in Chat, Ticket oder gemeinsamem Laufwerk.
- Exportdateien nur verschlüsselt und mit getrennt übermitteltem Schutzpasswort übertragen.
- Nach der Übergabe prüfen, wer auf Schlüsselbund, Entwicklerkonto und App Store Connect zugreifen kann.
- Nicht mehr benötigte Zugänge nach Abschluss der Übergabe entfernen.
Wie lässt sich die App-Signierung nach einem Mac-Wechsel wiederherstellen?
Der neue Mac braucht nicht nur das Projekt. Er benötigt außerdem den richtigen Teamzugang, die Signierungsidentität, das passende Profil und eine reproduzierbare Xcode-Konfiguration. Bei automatischer Signierung wird zunächst der Teamzugang geprüft. Bei manueller Signierung wird zusätzlich kontrolliert, ob Zertifikat und privater Schlüssel gemeinsam im Schlüsselbund vorliegen.
Der erste Archive-Vorgang auf dem neuen Mac ist ein Wiederherstellungstest, kein Beweis für eine vollständig dokumentierte Übergabe. Das Ergebnis sollte zusammen mit Xcode-Projektstand, verwendeter App-ID, Profilname, Zertifikatsstatus und Upload-Protokoll gespeichert werden.
[ SECTION_06 ] Nach der Signaturprüfung den Upload isoliert testen
Wenn die Signaturprüfung erfolgreich ist, aber der Build nicht in App Store Connect erscheint, sollte das Team nicht erneut alle Zertifikate erzeugen. Die Ursache kann nun bei der App-Zuordnung, dem Build- oder Versionsstand, den Berechtigungen oder der Verarbeitung des Uploads liegen.
Apple beschreibt den vorgesehenen Ablauf zum Hochladen von Builds in App Store Connect. Die Xcode-Anleitung für den Distribute-App-Prozess ist ebenfalls eine geeignete Referenz: Build mit Xcode hochladen.
Die Ergebnisse sollten in vier Gruppen aufgeteilt werden:
- Signaturprüfung schlägt fehl: Zertifikat, privater Schlüssel, Team oder Profil weiter prüfen.
- Profil wird abgelehnt: App-ID, Bundle Identifier und Profilinhalt vergleichen.
- Falsches Team oder falsche App: Account, Teamauswahl und App-Store-Connect-Ziel kontrollieren.
- Upload erfolgt, Build bleibt aus: Upload-Protokoll und Verarbeitungsstatus prüfen, statt neue Zertifikate zu erstellen.
Bei jedem Test sollte nur eine relevante Variable geändert werden. Ein neues Archive mit unverändertem Projekt hilft dabei, zwischen Signaturfehler und Uploadfehler zu unterscheiden. Nach erfolgreicher Übergabe sollte die Build-Nummer, die verwendete Version und der App-Store-Connect-Status im internen Übergabeprotokoll stehen. Diese Werte sind konkrete Prüfparameter, keine vertraulichen Zugangsdaten.
[ SECTION_07 ] Prüfliste für die Übergabe an Betrieb und Technik
Die folgende Liste kann die verantwortliche Person nach dem Wiederaufbau direkt abarbeiten:
- [ ] Apple-Developer-Team und angemeldeter Account stimmen überein.
- [ ] Mitgliedschaftsstatus und Zertifikatsstatus wurden getrennt geprüft.
- [ ] Automatische oder manuelle Signierung ist im Projekt eindeutig dokumentiert.
- [ ] Bei manueller Signierung sind Zertifikat und privater Schlüssel gemeinsam im Schlüsselbund vorhanden.
- [ ] Bundle Identifier und App-ID gehören zur richtigen App.
- [ ] Das Bereitstellungsprofil wurde nach einer Zertifikatsänderung neu erstellt oder bestätigt.
- [ ] Xcode verwendet nicht unbemerkt alte Zertifikats- oder Profilwerte.
- [ ] Ein neues Archive besteht die Signaturprüfung.
- [ ] Der Build wurde mit dem vorgesehenen Upload-Weg übergeben.
- [ ] App Store Connect erkennt die richtige App und Version.
- [ ] Upload-Protokoll und Verarbeitungsstatus sind intern abgelegt.
- [ ] Rollen, Schlüsselübergabe und Aufbewahrungsort sind dokumentiert.
- [ ] Passwörter, Tokens und private Schlüssel stehen nicht im gemeinsamen Übergabedokument.
Für Teams ohne verlässlich zugänglichen Build-Mac ist außerdem zu entscheiden, ob ein fester eigener Mac, eine zeitweise nutzbare Remote-Mac-Umgebung oder ein doppelter Aufbau sinnvoll ist. Bei laufenden Veröffentlichungen sollte die gewählte Umgebung den Schlüsselbund, das Xcode-Projekt und die Build-Protokolle kontrolliert verwahren können. Die Übersicht für eine Mac-Umgebung im Ausland kann als organisatorische Orientierung für diesen Teil der Entscheidung dienen.
[ SECTION_08 ] Wann eine Remote-Mac-Umgebung zur Wiederherstellung passt
Eine Remote-Umgebung ist kein Ersatz für Apple-Account-Rechte, Zertifikate oder private Schlüssel. Sie kann jedoch sinnvoll sein, wenn der bisherige Mac nicht verfügbar ist, der interne Mac erst beschafft wird oder ein technischer Mitarbeiter aus einem anderen Standort sicher auf eine konsistente macOS-Arbeitsumgebung zugreifen muss.
Für die Auswahl zählen nicht nur die Erreichbarkeit des Rechners, sondern auch:
- kontrollierter Zugriff auf Schlüsselbund und Projektdateien,
- klare Benutzer- und Rollenverteilung,
- dokumentierte Löschung nach Ende des Auftrags,
- stabile Verbindung für Xcode und Upload,
- nachvollziehbare Übergabe der Zugangsdaten,
- Möglichkeit, Archive, Logs und Build-Status gemeinsam zu prüfen.
Für eine zeitlich begrenzte Veröffentlichung kann ein nach Zyklus nutzbarer Mac wirtschaftlicher sein als der sofortige Kauf zusätzlicher Hardware. Für dauerhaft hohe Build-Last, physische Gerätezugriffe oder langfristige lokale Entwicklung bleibt ein eigener, kontrolliert verwalteter Mac die passendere Lösung. Bei Bedarf kann das Team die verfügbaren Mac-Optionen für den US-Ost-Standort prüfen und die Eignung zuerst mit einem Archive sowie einem Testupload bewerten.
Der bisherige Ansatz — ein nicht verfügbarer Build-Mac, verstreute Zertifikatsdateien und eine Übergabe ohne privaten Schlüssel — verursacht drei konkrete Nachteile: Die Fehlerursache bleibt unklar, jeder Dienstleisterwechsel verlängert die Wiederherstellung und vertrauliche Signierungsdaten landen leichter in unsicheren Ablagen. Eine dauerhaft reservierte eigene Hardware löst diese Risiken, bindet aber Kapital und muss intern gewartet werden. Für ein einzelnes Update oder bis zur Übergabe des internen Geräts kann eine kontrolliert zugängliche Remote-Mac-Umgebung von NOVAKVM daher die passendere Zwischenlösung sein. Vor der Buchung sollte das Team genau den beschriebenen Archive- und Upload-Test als Abnahmekriterium festlegen.
Entscheidend bleibt die Reihenfolge: Signierungsart feststellen, Team und Berechtigungen prüfen, private Schlüssel verifizieren, Profil passend neu erzeugen und erst danach den Upload bestätigen. So wird aus einer pauschalen Zertifikatswarnung ein begrenzter, dokumentierbarer Wiederherstellungsprozess.