Overzicht: waarom bewaking van certificaatvervaldatums belangrijk is
Apple Pass Type ID-certificaten (pass.com.yourbrand.*) hebben een strikte geldigheidsduur van 397 dagen (~13 maanden) die wordt afgedwongen door Apple's Certification Authority. Als een certificaat zonder vernieuwing verloopt:
-
Nieuwe downloads mislukken: Passinstance kan geen geldige losse PKCS#7-handtekeningen meer genereren voor nieuwe
.pkpass-downloads die aan dat certificaat zijn gekoppeld. -
APNs-pushupdates stoppen: Apple's HTTP/2 APNs-gateway (
api.push.apple.com) weigert onmiddellijk TLS-verbindingen die zijn geauthenticeerd met een verlopen certificaat, waardoor live saldo- en veldupdates op geïnstalleerde iPhones worden stopgezet.
Belangrijk: Vernieuw altijd onder exact dezelfde Pass Type ID (
pass.com.yourbrand.*) en Apple Developer Team ID in plaats van een gloednieuwe Pass Type ID aan te maken. Omdat iOS geïnstalleerde passen koppelt aan het paar(passTypeIdentifier, teamIdentifier), zorgt het vernieuwen van het certificaat op dezelfde Pass Type ID ervoor dat elke bestaande pas op iPhones en Apple Watches van klanten APNs-pushupdates blijft ontvangen zonder dat klanten opnieuw hoeven te installeren.
Procedure voor certificaatvernieuwing zonder downtime
-
1
Bewaak vervalvensters (
Certificate Renewal Monitor): Passinstance voert dagelijks om 02:00 uur een geplande controle uit op actieve certificaten waarvanvalidTobinnen 30 dagen ligt, e-mailt eigenaren/beheerders van de werkruimte en toont waarschuwingen onder Settings -> Wallet -> Apple Certificates. -
2
Genereer een vernieuwings-CSR: open het bijna verlopen certificaat in Passinstance en download een nieuwe CSR (
POST /api/v1/certificates/generate-csr). -
3
Geef een nieuw certificaat uit onder de bestaande Pass Type ID: selecteer in de Apple Developer Portal -> Identifiers -> Pass Type IDs uw bestaande Pass Type ID, klik op Create Certificate, upload de CSR en download de nieuwe
pass.cer. (Apple staat overlappende actieve certificaten per Pass Type ID toe, zodat u veilig kunt roteren voordat u het oude certificaat intrekt.) -
4
Voer een upsert uit voor de vernieuwde
pass.cerin Passinstance: upload de ondertekende.cerviaPOST /api/v1/certificates/upsert(multipart/form-data, met vermelding vanpassTypeId,type: "TYPE_PASS" | "TYPE_NFC"en optioneelpkeyId). Passinstance verifieert de Apple WWDR G4/G6-keten en wisselt het actieve ondertekeningscertificaat om. -
5
Verifieer ondertekening & APNs-push: geef een testpas uit (
POST /api/v1/passes) en verzend een pushmelding (POST /api/v1/push-notifications/passes/:id) om te bevestigen dat zowel de PKCS#7-bundelondertekening als de APNs HTTP/2-bezorging slagen.
API-endpoints voor certificaatvernieuwing & levenscyclus (Certificate Management API)
| Methode | Endpoint-pad | Vereiste machtiging | Beschrijving |
|---|---|---|---|
| GET | /api/v1/certificates | certificates:read | Geeft een lijst van werkruimtecertificaten en inspectiemetadata (validFrom, validTo, passTypeIdentifier, teamIdentifier, type). |
| POST | /api/v1/certificates/generate-csr | certificates:manage | Genereert een RSA-sleutelpaar (CertificatePkey) en retourneert een PEM CSR voor ondertekening in Apple Developer. |
| POST | /api/v1/certificates/upsert | certificates:manage | Maakt een certificaat aan of vervangt/vernieuwt atomair een bestaand certificaat vanuit een geüploade ondertekende .cer (multipart/form-data). |
| GET | /api/v1/certificates/:id | certificates:read | Inspecteert X.509-certificaatmetadata, geldigheidsdatums en koppeling met de Pass Type ID. |
| DELETE | /api/v1/certificates/:id | certificates:manage | Verwijdert een vervangen of ongebruikt certificaatrecord. |
Voorbeeld: een vernieuwde .cer-bundel upserten
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"
Antwoord (201 Created / 200 OK):
{
"id": "cert_8841a9b0-2c3d-4e5f-8a9b-0c1d2e3f4a5b",
"passTypeIdentifier": "pass.com.phenixroasters.loyalty",
"teamIdentifier": "9A8B7C6D5E",
"type": "TYPE_PASS",
"validTo": "2027-12-31T23:59:59.000Z"
}
Automatische verwerking van Apple WWDR G4- & G6-tussencertificaten
Passinstance beheert Apple's tussencertificaten van Worldwide Developer Relations (WWDR) (G4 en G6) automatisch in de server-side PKCS#7-certificaatopslag (Apple Wallet Packager). U hoeft nooit handmatig AppleWWDRCAG4.cer of AppleWWDRCAG6.cer te uploaden — Passinstance inspecteert de Authority Key Identifier (AKI) van uw geüploade pass.cer en sluit het bijbehorende WWDR-tussencertificaat in bij elke .pkpass signature.
Raadpleeg Apple Wallet-certificaten en Apple Wallet voor de stappen voor de eerste inrichting.
