Skip to content
Hilfecenter-Anleitung
3 Min. LesezeitGeprüft 2026-11-16

Mitarbeiterausweise & Zugangspässe

Geben Sie Ausweise für Mitarbeitende, externe Dienstleister und Besucher mit Ablaufdatum, 2D-Scan-Check-in und sofortigem Widerruf aus.

In dieser Anleitung

Ü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:

SYSTEMARCHITEKTUR-ABLAUF
INTERAKTIVE ARCHITEKTUR
MITARBEITERZUGANG & WIDERRUF
BETEILIGTE SYSTEMKOMPONENTEN
P1 HR-System / REST-API
P2 Passinstance Core API
P3 Türleser / Scanner
P4 Mobiler Wallet-Pass
SCHRITT 1 ANFRAGE / AKTION POST/api/v1/passes
SCHRITT 2 ANFRAGE / AKTION Pass & NFC bereitstellen
SCHRITT 3 ANFRAGE / AKTION In Wallet laden
›
(Foto-ID + Biometrie)
SCHRITT 4 ANTWORT An Leser halten
SCHRITT 5 ANTWORT POST/api/v1/scans
›
(NFC ISO 14443 / QR)
›
(ACTIVE & Schicht prüfen)
SCHRITT 6 ANFRAGE / AKTION Zugang gewährt (200)
SCHRITT 7 ANFRAGE / AKTION POST/api/v1/passes/voiding/:id/void
SCHRITT 8 ANFRAGE / AKTION Stiller APNs-Push
›
(walletVoidStatus)
›
(Drehkreuz lehnt
›
weitere Scans ab)

Visuelles Layout & Asset-Slots

  • Pass-Typ (pass type): studentId, generic oder posterGeneric (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 in externalId (max. 255 Zeichen, mandantenweit eindeutig unter aktiven Pässen), damit automatisierte Offboarding-Webhooks Ausweise über POST /api/v1/passes/upsert-by-external-id oder GET /api/v1/passes/by-external-id/:externalId aktualisieren oder sperren können.
  • Katalog-Demo-Vorlagen: student-id-card, daily-access-pass und conference-badge.
  • Foto-Identifikation: Laden Sie Porträtfotos in den Asset-Slot thumbnail hoch (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 logo und strip-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): Der Pass Mechanics Engine ermittelt 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:

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

POST /api/v1/passes/voiding/:id/void
Header
X-API-Key <API_KEY>
Content-Type application/json
JSON
{
  "voided": true,
  "options": {
    "reason": "CANCELLED",
    "customReason": "EMPLOYEE_OFFBOARDED",
    "sendPushNotification": false
  }
}

Ergebnis

  1. 1
    Der Pass-status wechselt zu VOIDED, lifecycleStatus (PassLifecycleStatus) geht auf VOIDED über und der Endpunkt antwortet mit HTTP 204 No Content. Hinweis: options.reason akzeptiert Werte aus VoidingReason (EXPIRED, CANCELLED, LOST, STOLEN, DUPLICATE, FRAUD, TECHNICAL_ISSUE, CUSTOMER_REQUEST, ADMIN_ACTION, SYSTEM_AUTO, OTHER).
  2. 2
    Alle nachfolgenden Scans an Türdrehkreuzen oder mobilen Kontrollpunkten werden mit der Entscheidung ALREADY_VOIDED abgelehnt.
  3. 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.

Weiterführende Produkt- & Entwicklerdoku

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.