Skip to content
Helpcentrum-gids · Certificaten & sleutels
3 min leestijdGecontroleerd 2026-11-16

Certificaatvernieuwing & beheer

Volg vervaldata en vernieuw onder dezelfde Pass Type ID zonder dat klanten opnieuw hoeven te downloaden.

In deze gids

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.
SYSTEEMARCHITECTUUR
INTERACTIEVE ARCHITECTUUR
CERTIFICAATVERNIEUWING ZONDER DOWNTIME
FASE 01 GEAUTOMATISEERDE VERVALCRON (Certificate Renewal Monitor)
Dagelijkse taak om 02:00 controleert actieve certs met validTo <= now + 30d
Waarschuwt werkruimtecontacten om een nieuw certificaat tijdig te uploaden
FASE 02 STAP 1: CSR GENEREREN VOOR BESTAANDE PASS TYPE ID
POST/api/v1/certificates/generate-csr
Behoudt exacte passTypeIdentifier (pass.com.yourbrand.loyalty)
Behoudt Apple teamIdentifier van 10 tekens
FASE 03 STAP 2: CERTIFICAAT VERNIEUWEN IN APPLE DEVELOPER PORTAL
Open bestaande Pass Type IDCreate CertificateUpload vernieuwings-CSR
Download vernieuwde pass.cer (trek oude cert pas in als nieuwe actief is)
FASE 04 STAP 3: UPSERT / VERVANG (POST/api/v1/certificates/upsert)
Valideert overeenkomende passTypeIdentifier & teamIdentifier + WWDR G4/G6
Vervangt actieve .p12-ondertekenaar in encrypted storageiOS-passen blijven syncen

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. 1
    Bewaak vervalvensters (Certificate Renewal Monitor): Passinstance voert dagelijks om 02:00 uur een geplande controle uit op actieve certificaten waarvan validTo binnen 30 dagen ligt, e-mailt eigenaren/beheerders van de werkruimte en toont waarschuwingen onder Settings -> Wallet -> Apple Certificates.
  2. 2
    Genereer een vernieuwings-CSR: open het bijna verlopen certificaat in Passinstance en download een nieuwe CSR (POST /api/v1/certificates/generate-csr).
  3. 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. 4
    Voer een upsert uit voor de vernieuwde pass.cer in Passinstance: upload de ondertekende .cer via POST /api/v1/certificates/upsert (multipart/form-data, met vermelding van passTypeId, type: "TYPE_PASS" | "TYPE_NFC" en optioneel pkeyId). Passinstance verifieert de Apple WWDR G4/G6-keten en wisselt het actieve ondertekeningscertificaat om.
  5. 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)

MethodeEndpoint-padVereiste machtigingBeschrijving
GET/api/v1/certificatescertificates:readGeeft een lijst van werkruimtecertificaten en inspectiemetadata (validFrom, validTo, passTypeIdentifier, teamIdentifier, type).
POST/api/v1/certificates/generate-csrcertificates:manageGenereert een RSA-sleutelpaar (CertificatePkey) en retourneert een PEM CSR voor ondertekening in Apple Developer.
POST/api/v1/certificates/upsertcertificates:manageMaakt een certificaat aan of vervangt/vernieuwt atomair een bestaand certificaat vanuit een geüploade ondertekende .cer (multipart/form-data).
GET/api/v1/certificates/:idcertificates:readInspecteert X.509-certificaatmetadata, geldigheidsdatums en koppeling met de Pass Type ID.
DELETE/api/v1/certificates/:idcertificates:manageVerwijdert een vervangen of ongebruikt certificaatrecord.

Voorbeeld: een vernieuwde .cer-bundel upserten

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"

Antwoord (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"
}

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.

Klaar om uw eerste kaartprogramma te lanceren?

Maak uw workspace aan, configureer uw sjabloon en test een echte kaart in Apple Wallet en Google Wallet voordat u opschaalt.