Skip to content
Hilfecenter-Anleitung · Zertifikate & Zugangsdaten
3 Min. LesezeitGeprüft 2026-11-16

Zertifikatserneuerung & Verwaltung

Überwachen Sie Ablaufdaten und erneuern Sie Apple Pass Type ID-Zertifikate nahtlos ohne Neuinstallation bei Endkunden.

In dieser Anleitung

Überblick: Warum die Überwachung von Ablaufdaten entscheidend ist

Apple Pass Type ID-Zertifikate (pass.com.yourbrand.*) besitzen eine von Apples Zertifizierungsstelle fest vorgegebene Gültigkeitsdauer von 397 Tagen (~13 Monate). Läuft ein Zertifikat ohne Erneuerung ab:

  • Schlagen neue Downloads fehl: Passinstance kann für neue .pkpass-Downloads unter diesem Zertifikat keine gültigen PKCS#7-Signaturen mehr erzeugen.
  • Stoppen APNs-Push-Updates: Apples HTTP/2-APNs-Gateway (api.push.apple.com) lehnt TLS-Verbindungen mit abgelaufenem Zertifikat sofort ab — Live-Kontostands- und Feldaktualisierungen auf installierten iPhones werden dadurch unterbrochen.
SYSTEMARCHITEKTUR-ABLAUF
INTERAKTIVE ARCHITEKTUR
ZERTIFIKATSERNEUERUNG OHNE AUSFALLZEIT
STUFE 01 AUTOMATISIERTER ABLAUF-MONITORING-CRON (Certificate Renewal Monitor)
Täglicher Job um 02:00 Uhr prüft aktive Zertifikate mit validTo <= jetzt + 30d
Benachrichtigt Workspace-Kontakte rechtzeitig vor Ablauf für die Erneuerung
STUFE 02 SCHRITT 1: CSR FÜR BESTEHENDE PASS TYPE ID ERZEUGEN
POST/api/v1/certificates/generate-csr
Behält exakt passTypeIdentifier (pass.com.yourbrand.loyalty) bei
Behält die 10-stellige Apple-teamIdentifier bei
STUFE 03 SCHRITT 2: ZERTIFIKATS-ROLLOVER IM APPLE DEVELOPER PORTAL
Bestehende Pass Type ID öffnenCreate CertificateErneuerungs-CSR laden
Neue pass.cer laden (Altes Zertifikat erst widerrufen, wenn neues aktiv ist)
STUFE 04 SCHRITT 3: UPSERT / TAUSCH (POST/api/v1/certificates/upsert)
Prüft übereinstimmende passTypeIdentifier & teamIdentifier + WWDR G4/G6
Ersetzt aktiven .p12-Signer im encrypted storage; alle installierten Pässe syncen weiter

Wichtig: Erneuern Sie stets unter exakt derselben Pass Type ID (pass.com.yourbrand.*) und Apple Developer Team ID, statt eine komplett neue Pass Type ID anzulegen. Da iOS installierte Pässe an das Tupel (passTypeIdentifier, teamIdentifier) bindet, sorgt eine Erneuerung auf derselben Pass Type ID dafür, dass alle vorhandenen Pässe auf Kunden-iPhones und Apple Watches ohne jegliche Neuinstallation durch Endkundinnen und Endkunden weiterhin APNs-Push-Updates empfangen.

Ablauf für unterbrechungsfreie Zertifikatserneuerung

  1. 1
    Ablauffristen überwachen (Certificate Renewal Monitor): Passinstance führt täglich um 02:00 Uhr eine geplante Prüfung aller aktiven Zertifikate mit validTo innerhalb der nächsten 30 Tage durch, benachrichtigt Workspace-Owner/-Admins per E-Mail und blendet Hinweise unter Einstellungen -> Wallet -> Apple-Zertifikate ein.
  2. 2
    Erneuerungs-CSR erzeugen: Öffnen Sie das ablaufende Zertifikat in Passinstance und laden Sie eine neue CSR herunter (POST /api/v1/certificates/generate-csr).
  3. 3
    Neues Zertifikat unter bestehender Pass Type ID ausstellen: Wählen Sie im Apple Developer Portal -> Identifiers -> Pass Type IDs Ihre bestehende Pass Type ID aus, klicken Sie auf Create Certificate, laden Sie die CSR hoch und laden Sie die neue pass.cer herunter. (Apple erlaubt mehrere zeitlich überlappende aktive Zertifikate je Pass Type ID, sodass Sie gefahrlos rotieren können, bevor das alte Zertifikat widerrufen wird.)
  4. 4
    Erneuerte pass.cer per Upsert in Passinstance laden: Laden Sie die signierte .cer-Datei über POST /api/v1/certificates/upsert hoch (multipart/form-data mit Angabe von passTypeId, type: "TYPE_PASS" | "TYPE_NFC" und optional pkeyId). Passinstance prüft die Apple WWDR G4/G6-Kette und tauscht das aktive Signaturzertifikat aus.
  5. 5
    Signatur & APNs-Push verifizieren: Geben Sie einen Testpass aus (POST /api/v1/passes) und senden Sie eine Push-Benachrichtigung (POST /api/v1/push-notifications/passes/:id), um sowohl PKCS#7-Signierung als auch APNs-HTTP/2-Auslieferung zu bestätigen.

API-Endpunkte für Zertifikatserneuerung & Lebenszyklus (Certificate Management API)

MethodeEndpunkt-PfadErforderliche BerechtigungBeschreibung
GET/api/v1/certificatescertificates:readListet Workspace-Zertifikate samt Prüf-Metadaten (validFrom, validTo, passTypeIdentifier, teamIdentifier, type) auf.
POST/api/v1/certificates/generate-csrcertificates:manageErzeugt ein RSA-Schlüsselpaar (CertificatePkey) und gibt eine PEM-CSR zur Signierung in Apple Developer zurück.
POST/api/v1/certificates/upsertcertificates:manageErstellt oder ersetzt/erneuert ein bestehendes Zertifikat atomar anhand einer hochgeladenen .cer-Datei (multipart/form-data).
GET/api/v1/certificates/:idcertificates:readZeigt X.509-Zertifikatsmetadaten, Gültigkeitsdaten und Pass-Type-ID-Verknüpfung an.
DELETE/api/v1/certificates/:idcertificates:manageEntfernt einen abgelösten oder ungenutzten Zertifikatsdatensatz.

Beispiel: Erneuertes .cer-Zertifikat per Upsert einspielen

BASH
curl -X POST https://api.passinstance.com/api/v1/certificates/upsert \
  -H "X-API-Key: <API_KEY>" \
  -F "file=@./pass-renewed.cer" \
  -F "passTypeId=pass.com.phenixroasters.loyalty" \
  -F "type=TYPE_PASS"

Antwort (201 Created / 200 OK):

JSON
{
  "id": "cert_8841a9b0-2c3d-4e5f-8a9b-0c1d2e3f4a5b",
  "passTypeIdentifier": "pass.com.phenixroasters.loyalty",
  "teamIdentifier": "9A8B7C6D5E",
  "type": "TYPE_PASS",
  "validTo": "2027-12-31T23:59:59.000Z"
}

Apple WWDR G4 & G6 Zwischenzertifikats-Rollover

Passinstance verwaltet Apples Worldwide Developer Relations (WWDR) Zwischenzertifikate (G4 und G6) vollautomatisch im serverseitigen PKCS#7-Zertifikatsspeicher (Apple Wallet Packager). Sie müssen niemals manuell AppleWWDRCAG4.cer oder AppleWWDRCAG6.cer hochladen — Passinstance prüft den Authority Key Identifier (AKI) Ihrer hochgeladenen pass.cer und bettet automatisch das passende WWDR-Zwischenzertifikat in jede .pkpass-signature ein.

Für die Ersteinrichtung siehe Apple Wallet-Zertifikate und Apple Wallet.

Bereit für Ihr erstes Wallet-Kartenprogramm?

Erstellen Sie Ihren Workspace, konfigurieren Sie Ihre Vorlage und testen Sie eine echte Karte in Apple Wallet und Google Wallet, bevor Sie skalieren.