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

Apple Wallet-certificaten

Maak een Pass Type ID in Apple Developer, genereer een CSR, upload het .cer/.p12-bestand en koppel uw certificaat.

In deze gids

Interactieve UI-weergaven

Openen in onboardinggids (6 fasen)

Bekijk de exacte dashboardpanelen, knoppen en ingezoomde toelichtingen bij deze gids.

Ingezoomde UI-focus
Belangrijke UI-onderdelen

Template Settings — Ondertekening & External IDs (Ingezoomd)

Controleer certificaatstatus, Wallet-volgorde, Published-status en External ID-regels in Settings.

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. 1
    Losse PKCS#7-bundelondertekening: ondertekent manifest.json in elk .pkpass-archief (gekoppeld aan het tussencertificaat Apple WWDR G4/G6), zodat iOS de echtheid verifieert en uw geverifieerde organisatienaam weergeeft.
  2. 2
    APNs HTTP/2 push-authenticatie: authenticeert TLS HTTP/2-verbindingen met api.push.apple.com onder het onderwerp pass.com.<domain>.<name> van het certificaat, zodat Passinstance iPhones van klanten kan activeren voor live pasupdates.
SYSTEEMARCHITECTUUR
INTERACTIEVE ARCHITECTUUR
APPLE PASS TYPE-CERTIFICAAT INRICHTEN
FASE 01 STAP 1: Privésleutel & CSR genereren in Passinstance (Certificate Management API)
POST/api/v1/certificates/generate-csr
Genereert 2048-bits RSA CertificatePkey (versleuteld in encrypted storage)
Retourneert PEM-gecodeerde .certSigningRequest (CSR)
FASE 02 STAP 2: Apple Developer Portal (developer.apple.com)
1
Identifier registrerenPass Type ID (pass.com.yourbrand.loyalty)
2
Certificate aanmakenPassinstance CSR uploadenpass.cer downloaden
FASE 03 STAP 3: Ondertekende .cer uploaden naar Passinstance (POST/api/v1/certificates)
1
Parseert X.509 .cer: extraheert passTypeIdentifier, teamIdentifier & verloop
2
Vergelijkt publieke-sleutelmodulus met opgeslagen CertificatePkey
3
Valideert vertrouwensketen tegen Apple WWDR G4 / G6-tussencertificaat
4
Bundelt versleutelde PKCS#12 (.p12) in encrypted storageStatus: VALID / ACTIVE

Vereisten: U hebt een actief Apple Developer Program-lidmaatschap nodig (rol Account Holder of Admin) 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 andere passTypeIdentifier of teamIdentifier te migreren.

Stapsgewijze workflow voor certificaatconfiguratie

  1. 1
    Genereer een CSR in Passinstance: navigeer naar Settings -> Wallet -> Apple Certificates (/settings/workspace/wallet) en klik op Generate CSR (roept POST /api/v1/certificates/generate-csr aan met optionele passTypeId). Download het .certSigningRequest-bestand. Passinstance slaat de gegenereerde RSA-privésleutel (CertificatePkey) op in versleutelde opslag.
  2. 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. 3
    Geef de ondertekende .cer uit in Apple Developer: open uw nieuwe Pass Type ID, klik op Create Certificate, upload het vanuit Passinstance gedownloade .certSigningRequest-bestand en download het resulterende pass.cer-bestand.
  4. 4
    Upload pass.cer naar Passinstance: upload pass.cer via POST /api/v1/certificates (multipart/form-data, optionele teamIdentifier, passTypeId, demo, isNfcCertificate) of POST /api/v1/certificates/upsert (file + type: "TYPE_PASS" | "TYPE_NFC"). Passinstance koppelt de .cer aan de gegenereerde privésleutel, verifieert de Apple WWDR G4/G6-tussenketen en verpakt de versleutelde .p12-ondertekeningsbundel.
  5. 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)

MethodeEndpoint-padVereiste machtigingBeschrijving
POST/api/v1/certificates/generate-csrcertificates:manageGenereert een RSA-sleutelpaar (CertificatePkey) en retourneert een PEM Certificate Signing Request (.csr).
POST/api/v1/certificatescertificates:manageUploadt 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/upsertcertificates:manageMaakt een certificaat aan of werkt/vernieuwt een bestaand certificaat vanuit een ondertekende .cer (multipart/form-data, optionele pkeyId, type, intermediatePem).
GET/api/v1/certificatescertificates:readGeeft een overzicht van werkruimtecertificaten met passTypeIdentifier, teamIdentifier, validFrom, validTo en status.
GET/api/v1/certificates/:idcertificates:readRetourneert X.509-metadata en details voor een specifieke certificaat-ID.
DELETE/api/v1/certificates/:idcertificates:manageVerwijdert een ongebruikt of verlopen certificaat.

Voorbeeld: een CSR genereren & pass.cer uploaden

1. CSR genereren (POST /api/v1/certificates/generate-csr):

JSON
POST /api/v1/certificates/generate-csr
{
  "passTypeId": "pass.com.phenixroasters.loyalty"
}

Antwoord (200 OK):

JSON
{
  "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"):

BASH
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):

JSON
{
  "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.

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.