Überblick
Organisationen nutzen Passinstance, um physische Plastikkarten und Schlüsselanhänger durch sichere, gebrandete digitale Ausweise in Apple Wallet und Google Wallet zu ersetzen. Mitarbeitende, externe Dienstleister, Studierende und Gebäudebesucher erhalten Zugang zu Bürogebäuden, Co-Working-Standorten und geschützten Bereichen über optische 2D-Barcode-Drehkreuze oder kontaktlose NFC-Lesegeräte.
Backend-Architektur & visuelles Schema
Identitätsausweise sind auf gut sichtbare Mitarbeiterdaten und wirksame Fälschungsschutz-Mechanismen ausgelegt:
Visuelles Layout & Asset-Slots
-
Pass-Typ (pass type):
studentId,genericoderposterGeneric(Apple Wallet und Google Wallet stellen diese mit dedizierten Ausweis-Proportionen dar). -
HRIS- & Verzeichnis-Korrelation (
externalId): Speichern Sie Ihre Mitarbeiter-ID aus dem HR- oder Verzeichnissystem inexternalId(max. 255 Zeichen, mandantenweit eindeutig unter aktiven Pässen), damit automatisierte Offboarding-Webhooks Ausweise überPOST /api/v1/passes/upsert-by-external-idoderGET /api/v1/passes/by-external-id/:externalIdaktualisieren oder sperren können. -
Katalog-Demo-Vorlagen:
student-id-card,daily-access-passundconference-badge. -
Foto-Identifikation: Laden Sie Porträtfotos in den Asset-Slot
thumbnailhoch (90x90 pt bei @1x, 270x270 px bei @3x). Google Wallet stellt dieses Bild prominent als runden oder quadratischen Avatar dar. -
Unternehmensbranding: Feste Slots für
logoundstrip-Banner in Ihren Unternehmens- oder Campusfarben. -
Dynamische Mitarbeiter-Metadaten:
- primaryFields: Vollständiger Name ({fullName}). - secondaryFields: Position ({title}) und Abteilung ({department}). - auxiliaryFields: Personalnummer ({employeeId}) und Sicherheitsstufe ({clearanceLevel}). - backFields: Notfallprotokolle des Gebäudes, Sicherheits-Rufnummern und Links zum IT-Service-Desk.
-
Dynamische Anti-Screenshot-Animation (
addSecurityAnimation: true): Zeigt einen animierten, zeitlich variierenden Sicherheitsrahmen rund um den Pass an, um Täuschungen mit statischen Screenshots oder abfotografierten Ausweisen zu verhindern.
Zutrittskontroll-Mechaniken & Anwesenheitserfassung
Für die tägliche Gebäudeanwesenheit, Schichterfassung oder Kantinenzulagen lassen sich interaktive Mechaniken direkt am Ausweis hinterlegen:
-
Mechanik-Typ:
VALID_ONCE_PER_DAY. -
Zeitzonenauflösung (
resolveCustomerTimeZone): DerPass Mechanics Engineermittelt die Zeitzone des Gebäudestandorts (z. B.Europe/Berlin). Nach dem ersten Scan am Empfangsdrehkreuz liefern weitere Scans am selben Kalendertag eine Warnmeldung, ohne die Anwesenheit doppelt zu erfassen. -
Scan-Modi (
ScanMode) & Ergebnisse (scan status):
- CHECK_IN: Protokolliert den Ankunftszeitstempel am Gebäudeeingang (CHECK_IN_SUCCESS oder ALREADY_CHECKED_IN, falls bereits eingecheckt). - CHECK_OUT: Protokolliert das Verlassen am Ausgang (CHECK_OUT_SUCCESS oder ALREADY_CHECKED_OUT). - CHECK_IN_CHECK_OUT_TOGGLE: Schaltet mit jedem Leser-Scan automatisch zwischen anwesend und abwesend um. - SAVE_ATTENDANCE: Protokolliert beliebig wiederholbare Check-in-Ereignisse ohne Umschaltung des Anwesenheitsstatus.
Kontaktloser NFC-Türzugang (Apple VAS & Google Smart Tap)
Passinstance unterstützt die kontaktlose Hardware-Übertragung von Zugangsdaten über die physische Schicht nach ISO/IEC 14443 Typ A/B:
Pass-NFC-Konfigurationsschema
Bei der Einrichtung des kontaktlosen Türzugangs wird das nfc-Schema in den Pass-Payload eingebettet:
{
"nfc": {
"message": "FACILITY_ACCESS_NODE_772",
"encryptionPublicKey": "04a1b2c3d4e5f6...",
"requiresAuthentication": true,
"nfcFaceIdRequired": true,
"nfcNoBarcode": false
}
}
-
requiresAuthentication/nfcFaceIdRequired: Fordert vor Übertragung des NFC-Payloads an das Türleseterminal eine Bestätigung per Face ID, Touch ID oder Gerätecode an. -
nfcNoBarcode: Blendet den optischen Barcode auf der Vorderseite des Passes aus, wenn ausschließlich sichere NFC-Drehkreuze eingesetzt werden. -
Kompatible Hardware-Lesegeräte: Integration mit Lesegeräten von certified NFC, Identiv und HID über
hardware reader-/reader device-Konfigurationen in Passinstance.
Sofortiger Widerruf beim Offboarding (API)
Verlässt eine Mitarbeiterin oder ein Mitarbeiter das Unternehmen oder läuft ein befristeter Dienstleisterausweis ab, muss der Zugang unmittelbar entzogen werden:
Widerrufs-Endpunkt
/api/v1/passes/voiding/:id/void
{
"voided": true,
"options": {
"reason": "CANCELLED",
"customReason": "EMPLOYEE_OFFBOARDED",
"sendPushNotification": false
}
}
Ergebnis
-
1
Der Pass-
statuswechselt zuVOIDED,lifecycleStatus(PassLifecycleStatus) geht aufVOIDEDüber und der Endpunkt antwortet mit HTTP204 No Content. Hinweis:options.reasonakzeptiert Werte ausVoidingReason(EXPIRED,CANCELLED,LOST,STOLEN,DUPLICATE,FRAUD,TECHNICAL_ISSUE,CUSTOMER_REQUEST,ADMIN_ACTION,SYSTEM_AUTO,OTHER). -
2
Alle nachfolgenden Scans an Türdrehkreuzen oder mobilen Kontrollpunkten werden mit der Entscheidung
ALREADY_VOIDEDabgelehnt. -
3
Passinstance aktualisiert
walletVoidStatus(WalletPropagationStatus:NONE->PENDING->QUEUED->SUCCEEDED), sobald Hintergrund-Worker das Update über APNs HTTP/2 und die Google Wallet REST-API zustellen.
Wichtig: Der kontaktlose Türzugang über Apple Wallet erfordert ein von Apple Developer Relations genehmigtes Apple-VAS-Händlerzertifikat (Value Added Services). Optisches Scannen per QR-/Aztec-Code funktioniert sofort out-of-the-box mit Standardkameras und 2D-Barcode-Hardware.
Erfahren Sie mehr über unsere Zugangs- & Identitätslösungen.
