Overzicht: waarom Apple Pass Type ID-certificaten vereist zijn
Apple vereist dat elk .pkpass-archief voor productie cryptografisch wordt ondertekend met een Pass Type ID Certificate dat is uitgegeven onder het Apple Developer Program-account van uw organisatie (Certificate Management API op /api/v1/certificates). Het certificaat vervult twee kritieke functies:
-
1
Losse PKCS#7-bundelondertekening: ondertekent
manifest.jsonin elk.pkpass-archief (gekoppeld aan het tussencertificaat Apple WWDR G4/G6), zodat iOS de echtheid verifieert en uw geverifieerde organisatienaam weergeeft. -
2
APNs HTTP/2 push-authenticatie: authenticeert TLS HTTP/2-verbindingen met
api.push.apple.comonder het onderwerppass.com.<domain>.<name>van het certificaat, zodat Passinstance iPhones van klanten kan activeren voor live pasupdates.
Vereisten: U hebt een actief Apple Developer Program-lidmaatschap nodig (rol
Account HolderofAdmin) om Pass Type ID's te registreren en productiecertificaten voor Pass Type ID's uit te geven. Hoewel Passinstance een beheerd sandbox-certificaat biedt voor eerste onboarding-demo's, moet u uw eigen Pass Type ID-certificaat koppelen voordat u productiepassen distribueert naar klanten — Apple staat namelijk niet toe om reeds geïnstalleerde passen na installatie naar een anderepassTypeIdentifierofteamIdentifierte migreren.
Stapsgewijze workflow voor certificaatconfiguratie
-
1
Genereer een CSR in Passinstance: navigeer naar Settings -> Wallet -> Apple Certificates (
/settings/workspace/wallet) en klik op Generate CSR (roeptPOST /api/v1/certificates/generate-csraan met optionelepassTypeId). Download het.certSigningRequest-bestand. Passinstance slaat de gegenereerde RSA-privésleutel (CertificatePkey) op in versleutelde opslag. -
2
Registreer een Pass Type ID in Apple Developer: log in op Apple Developer Portal -> Certificates, Identifiers & Profiles -> Identifiers, klik op +, selecteer Pass Type IDs en registreer een reverse-DNS-identifier zoals
pass.com.yourbrand.loyalty. -
3
Geef de ondertekende
.ceruit in Apple Developer: open uw nieuwe Pass Type ID, klik op Create Certificate, upload het vanuit Passinstance gedownloade.certSigningRequest-bestand en download het resulterendepass.cer-bestand. -
4
Upload
pass.cernaar Passinstance: uploadpass.cerviaPOST /api/v1/certificates(multipart/form-data, optioneleteamIdentifier,passTypeId,demo,isNfcCertificate) ofPOST /api/v1/certificates/upsert(file+type: "TYPE_PASS" | "TYPE_NFC"). Passinstance koppelt de.ceraan de gegenereerde privésleutel, verifieert de Apple WWDR G4/G6-tussenketen en verpakt de versleutelde.p12-ondertekeningsbundel. -
5
Koppel het certificaat aan uw sjabloon: open Template Settings en koppel uw geverifieerde Pass Type ID-certificaat.
API-referentie voor certificaatbeheer (Certificate Management API)
| Methode | Endpoint-pad | Vereiste machtiging | Beschrijving | |
|---|---|---|---|---|
| POST | /api/v1/certificates/generate-csr | certificates:manage | Genereert een RSA-sleutelpaar (CertificatePkey) en retourneert een PEM Certificate Signing Request (.csr). | |
| POST | /api/v1/certificates | certificates:manage | Uploadt een door Apple ondertekend .cer-bestand via multipart/form-data, verifieert de WWDR G4/G6-vertrouwensketen en activeert het certificaat (CertificateType: `TYPE_PASS \ | TYPE_NFC`). |
| POST | /api/v1/certificates/upsert | certificates:manage | Maakt een certificaat aan of werkt/vernieuwt een bestaand certificaat vanuit een ondertekende .cer (multipart/form-data, optionele pkeyId, type, intermediatePem). | |
| GET | /api/v1/certificates | certificates:read | Geeft een overzicht van werkruimtecertificaten met passTypeIdentifier, teamIdentifier, validFrom, validTo en status. | |
| GET | /api/v1/certificates/:id | certificates:read | Retourneert X.509-metadata en details voor een specifieke certificaat-ID. | |
| DELETE | /api/v1/certificates/:id | certificates:manage | Verwijdert een ongebruikt of verlopen certificaat. |
Voorbeeld: een CSR genereren & pass.cer uploaden
1. CSR genereren (POST /api/v1/certificates/generate-csr):
POST /api/v1/certificates/generate-csr
{
"passTypeId": "pass.com.phenixroasters.loyalty"
}
Antwoord (200 OK):
{
"success": true,
"data": {
"csr": "-----BEGIN CERTIFICATE REQUEST-----\nMIICvDCCAaQCAQAwdzELMAkGA1UEBhMCREUx...\n-----END CERTIFICATE REQUEST-----"
},
"description": "CSR generated successfully",
"errors": [],
"statusCode": 200
}
2. Ondertekende .cer uploaden (POST /api/v1/certificates):
Verzend als multipart/form-data met het veld file (pass.cer), optionele passTypeId, teamIdentifier en isNfcCertificate ("false" of "true"):
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"
Antwoord (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"
}
Raadpleeg Certificaatvernieuwing & -beheer en Apple Wallet voor levenscyclusonderhoud.
