Skip to content
Hilfecenter-Anleitung · Zertifikate & ZugangsdatenOnboarding-Phase 3
3 Min. LesezeitGeprüft 2026-11-16

Apple Wallet-Zertifikate

Legen Sie eine Pass Type ID in Apple Developer an, erzeugen Sie eine CSR, laden Sie .cer/.p12 hoch und binden Sie das Zertifikat.

In dieser Anleitung

Prüfen Sie passende Dashboard-Bereiche, Steuerelemente und Zoom-Hinweise zu diesem Thema.

Vergrößerter UI-Fokus
Wichtige UI-Elemente

Template Settings — Signierung & External IDs (Zoom)

Signaturzertifikat, Wallet-Sortierung, Veröffentlichungsstatus und Eindeutigkeitsregeln für External IDs in Settings prüfen.

Ü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. 1
    Abgetrennte PKCS#7-Paket-Signierung: Signiert die manifest.json innerhalb jedes .pkpass-Archivs (verkettet mit Apples Zwischenzertifikat WWDR G4/G6), sodass iOS die Echtheit verifiziert und Ihren bestätigten Organisationsnamen anzeigt.
  2. 2
    APNs-HTTP/2-Push-Authentifizierung: Authentifiziert TLS-HTTP/2-Verbindungen zu api.push.apple.com unter dem Zertifikats-Topic pass.com.<domain>.<name>, damit Passinstance Kunden-iPhones für Live-Pass-Updates aufwecken kann.
SYSTEMARCHITEKTUR-ABLAUF
INTERAKTIVE ARCHITEKTUR
PROVISIONIERUNG EINES APPLE PASS TYPE-ZERTIFIKATS
STUFE 01 SCHRITT 1: Private Key & CSR in Passinstance erzeugen (Certificate Management API)
POST/api/v1/certificates/generate-csr
Erzeugt 2048-Bit-RSA-CertificatePkey (im encrypted storage verschlüsselt gespeichert)
Liefert PEM-kodierte .certSigningRequest (CSR)
STUFE 02 SCHRITT 2: Apple Developer Portal (developer.apple.com)
1
Identifier registrierenPass Type ID (pass.com.yourbrand.loyalty)
2
Zertifikat erstellenPassinstance-CSR hochladenpass.cer laden
STUFE 03 SCHRITT 3: Signierte .cer in Passinstance hochladen (POST/api/v1/certificates)
1
Parst X.509 .cer: Liest passTypeIdentifier, teamIdentifier & Laufzeit
2
Prüft Public-Key-Modulus gegen gespeicherten CertificatePkey
3
Validiert Vertrauenskette gegen Apple WWDR G4 / G6 Zwischenzertifikat
4
Erzeugt verschlüsseltes PKCS#12 (.p12) im encrypted storageStatus: VALID / ACTIVE

Voraussetzungen: Sie benötigen eine aktive Mitgliedschaft im Apple Developer Program (Rolle Account Holder oder Admin), 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 andere passTypeIdentifier oder teamIdentifier.

Schritt-für-Schritt-Workflow zur Zertifikatseinrichtung

  1. 1
    CSR in Passinstance erzeugen: Öffnen Sie Einstellungen -> Wallet -> Apple-Zertifikate (/settings/workspace/wallet) und klicken Sie auf CSR generieren (ruft POST /api/v1/certificates/generate-csr mit optionaler passTypeId auf). Laden Sie die .certSigningRequest-Datei herunter. Passinstance speichert den erzeugten RSA-Private-Key (CertificatePkey) sicher verschlüsselt.
  2. 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. 3
    Signierte .cer in 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 Datei pass.cer herunter.
  4. 4
    pass.cer in Passinstance hochladen: Übermitteln Sie pass.cer über POST /api/v1/certificates (multipart/form-data, optional teamIdentifier, passTypeId, demo, isNfcCertificate) oder POST /api/v1/certificates/upsert (file + type: "TYPE_PASS" | "TYPE_NFC"). Passinstance verknüpft die .cer mit dem erzeugten Private Key, prüft die Apple WWDR G4/G6-Zwischenzertifikatskette und speichert das verschlüsselte .p12-Signaturbündel.
  5. 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)

MethodeEndpunkt-PfadErforderliche BerechtigungBeschreibung
POST/api/v1/certificates/generate-csrcertificates:manageErzeugt ein RSA-Schlüsselpaar (CertificatePkey) und gibt einen PEM-Certificate-Signing-Request (.csr) zurück.
POST/api/v1/certificatescertificates:manageLä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/upsertcertificates:manageErstellt oder aktualisiert/erneuert ein bestehendes Zertifikat anhand einer signierten .cer (multipart/form-data, optional pkeyId, type, intermediatePem).
GET/api/v1/certificatescertificates:readListet Workspace-Zertifikate inklusive passTypeIdentifier, teamIdentifier, validFrom, validTo und Status auf.
GET/api/v1/certificates/:idcertificates:readGibt X.509-Metadaten und Details für eine bestimmte Zertifikats-ID zurück.
DELETE/api/v1/certificates/:idcertificates:manageEntfernt ein ungenutztes oder abgelaufenes Zertifikat.

Beispiel: CSR erzeugen & pass.cer hochladen

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

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

Antwort (200 OK):

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

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"

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

Lesen Sie Zertifikatserneuerung & Verwaltung und Apple Wallet für die fortlaufende Wartung im Lebenszyklus.

Bereit für Ihr erstes Wallet-Kartenprogramm?

Erstellen Sie Ihren Workspace, konfigurieren Sie Ihre Vorlage und testen Sie eine echte Karte in Apple Wallet und Google Wallet, bevor Sie skalieren.