Überblick: Warum Apple Pass Type ID-Zertifikate erforderlich sind
Apple schreibt vor, dass jedes produktive .pkpass-Archiv kryptografisch mit einem Pass Type ID-Zertifikat signiert sein muss, das über das Apple Developer Program-Konto Ihres Unternehmens ausgestellt wurde (Certificate Management API unter /api/v1/certificates). Das Zertifikat erfüllt zwei zentrale Aufgaben:
-
1
Abgetrennte PKCS#7-Paket-Signierung: Signiert die
manifest.jsoninnerhalb jedes.pkpass-Archivs (verkettet mit Apples Zwischenzertifikat WWDR G4/G6), sodass iOS die Echtheit verifiziert und Ihren bestätigten Organisationsnamen anzeigt. -
2
APNs-HTTP/2-Push-Authentifizierung: Authentifiziert TLS-HTTP/2-Verbindungen zu
api.push.apple.comunter dem Zertifikats-Topicpass.com.<domain>.<name>, damit Passinstance Kunden-iPhones für Live-Pass-Updates aufwecken kann.
Voraussetzungen: Sie benötigen eine aktive Mitgliedschaft im Apple Developer Program (Rolle
Account HolderoderAdmin), um Pass Type IDs zu registrieren und produktive Pass Type ID-Zertifikate auszustellen. Zwar stellt Passinstance für erste Onboarding-Demos ein verwaltetes Sandbox-Zertifikat bereit, doch vor der produktiven Verteilung an Kundinnen und Kunden müssen Sie Ihr eigenes Pass Type ID-Zertifikat hinterlegen — Apple erlaubt nach der Installation keine Migration bereits installierter Pässe auf eine anderepassTypeIdentifieroderteamIdentifier.
Schritt-für-Schritt-Workflow zur Zertifikatseinrichtung
-
1
CSR in Passinstance erzeugen: Öffnen Sie Einstellungen -> Wallet -> Apple-Zertifikate (
/settings/workspace/wallet) und klicken Sie auf CSR generieren (ruftPOST /api/v1/certificates/generate-csrmit optionalerpassTypeIdauf). Laden Sie die.certSigningRequest-Datei herunter. Passinstance speichert den erzeugten RSA-Private-Key (CertificatePkey) sicher verschlüsselt. -
2
Pass Type ID bei Apple Developer registrieren: Melden Sie sich im Apple Developer Portal -> Certificates, Identifiers & Profiles -> Identifiers an, klicken Sie auf +, wählen Sie Pass Type IDs und registrieren Sie eine Reverse-DNS-Kennung wie
pass.com.yourbrand.loyalty. -
3
Signierte
.cerin Apple Developer ausstellen: Öffnen Sie Ihre neue Pass Type ID, klicken Sie auf Create Certificate, laden Sie die aus Passinstance heruntergeladene.certSigningRequest-Datei hoch und laden Sie die fertige Dateipass.cerherunter. -
4
pass.cerin Passinstance hochladen: Übermitteln Siepass.cerüberPOST /api/v1/certificates(multipart/form-data, optionalteamIdentifier,passTypeId,demo,isNfcCertificate) oderPOST /api/v1/certificates/upsert(file+type: "TYPE_PASS" | "TYPE_NFC"). Passinstance verknüpft die.cermit dem erzeugten Private Key, prüft die Apple WWDR G4/G6-Zwischenzertifikatskette und speichert das verschlüsselte.p12-Signaturbündel. -
5
Zertifikat an Ihre Vorlage binden: Öffnen Sie die Vorlageneinstellungen und verknüpfen Sie Ihr verifiziertes Pass Type ID-Zertifikat.
API-Referenz zur Zertifikatsverwaltung (Certificate Management API)
| Methode | Endpunkt-Pfad | Erforderliche Berechtigung | Beschreibung | |
|---|---|---|---|---|
| POST | /api/v1/certificates/generate-csr | certificates:manage | Erzeugt ein RSA-Schlüsselpaar (CertificatePkey) und gibt einen PEM-Certificate-Signing-Request (.csr) zurück. | |
| POST | /api/v1/certificates | certificates:manage | Lädt eine von Apple signierte .cer-Datei über multipart/form-data hoch, prüft WWDR G4/G6 und aktiviert das Zertifikat (CertificateType: `TYPE_PASS \ | TYPE_NFC`). |
| POST | /api/v1/certificates/upsert | certificates:manage | Erstellt oder aktualisiert/erneuert ein bestehendes Zertifikat anhand einer signierten .cer (multipart/form-data, optional pkeyId, type, intermediatePem). | |
| GET | /api/v1/certificates | certificates:read | Listet Workspace-Zertifikate inklusive passTypeIdentifier, teamIdentifier, validFrom, validTo und Status auf. | |
| GET | /api/v1/certificates/:id | certificates:read | Gibt X.509-Metadaten und Details für eine bestimmte Zertifikats-ID zurück. | |
| DELETE | /api/v1/certificates/:id | certificates:manage | Entfernt ein ungenutztes oder abgelaufenes Zertifikat. |
Beispiel: CSR erzeugen & pass.cer hochladen
1. CSR erzeugen (POST /api/v1/certificates/generate-csr):
POST /api/v1/certificates/generate-csr
{
"passTypeId": "pass.com.phenixroasters.loyalty"
}
Antwort (200 OK):
{
"success": true,
"data": {
"csr": "-----BEGIN CERTIFICATE REQUEST-----\nMIICvDCCAaQCAQAwdzELMAkGA1UEBhMCREUx...\n-----END CERTIFICATE REQUEST-----"
},
"description": "CSR generated successfully",
"errors": [],
"statusCode": 200
}
2. Signierte .cer hochladen (POST /api/v1/certificates):
Als multipart/form-data mit dem Feld file (pass.cer), optional passTypeId, teamIdentifier und isNfcCertificate ("false" oder "true") übermitteln:
curl -X POST https://api.passinstance.com/api/v1/certificates \
-H "X-API-Key: <API_KEY>" \
-F "file=@./pass.cer" \
-F "passTypeId=pass.com.phenixroasters.loyalty" \
-F "isNfcCertificate=false"
Antwort (201 Created):
{
"id": "cert_8841a9b0-2c3d-4e5f-8a9b-0c1d2e3f4a5b",
"passTypeIdentifier": "pass.com.phenixroasters.loyalty",
"teamIdentifier": "9A8B7C6D5E",
"type": "TYPE_PASS",
"validFrom": "2026-11-15T10:18:00.000Z",
"validTo": "2027-12-15T10:17:59.000Z"
}
Lesen Sie Zertifikatserneuerung & Verwaltung und Apple Wallet für die fortlaufende Wartung im Lebenszyklus.
