Skip to content
Helpcentrum-gids
3 min leestijdGecontroleerd 2026-11-16

Medewerkerspassen & toegang

Geef personeels-, leveranciers- en bezoekerspassen uit met vervaldatum, 2D-controle en directe intrekking.

In deze gids

Overzicht

Organisaties gebruiken Passinstance om fysieke plastic sleutelkaarten en badges te vervangen door veilige, digitale passen in huisstijl voor Apple Wallet en Google Wallet. Medewerkers, externen, studenten en bezoekers krijgen toegang tot kantoorgebouwen, co-workingcampussen en beveiligde laboratoria via optische 2D-barcodetourniquets of contactloze NFC-kaartlezers.

Backendarchitectuur & visueel schema

Identiteitspassen worden ontworpen met goed zichtbare medewerkersgegevens en visuele maatregelen tegen vervalsing:

SYSTEEMARCHITECTUUR
INTERACTIEVE ARCHITECTUUR
TOEGANG & INTREKKING VOOR MEDEWERKERS
DEELNEMENDE SYSTEEMACTOREN
P1 HR-systeem / REST API
P2 Passinstance Core API
P3 Deurlezer / Scanner
P4 Mobiele Wallet-pas
STAP 1 VERZOEK / ACTIE POST/api/v1/passes
STAP 2 VERZOEK / ACTIE Richt pas & NFC in
STAP 3 VERZOEK / ACTIE Voeg toe
›
(Foto-ID + biometrie)
STAP 4 ANTWOORD Tik op lezer
STAP 5 ANTWOORD POST/api/v1/scans
›
(NFC ISO 14443 / QR)
›
(Check ACTIVE & dienst)
STAP 6 VERZOEK / ACTIE Toegang verleend (200)
STAP 7 VERZOEK / ACTIE POST/api/v1/passes/voiding/:id/void
STAP 8 VERZOEK / ACTIE Stille APNs-push
›
(walletVoidStatus)
›
(Tourniquet weigert
›
olgende scans)

Visuele lay-out & assetposities

  • Pastype (pass type): studentId, generic of posterGeneric (Apple Wallet en Google Wallet tonen deze met specifieke verhoudingen voor identiteitskaarten).
  • HRIS- & directorycorrelatie (externalId): Sla uw directory-/HR-medewerkersnummer op in externalId (max. 255 tekens, uniek binnen actieve tenantpassen) zodat geautomatiseerde uitdiensttredingswebhooks passen kunnen intrekken of bijwerken via POST /api/v1/passes/upsert-by-external-id of GET /api/v1/passes/by-external-id/:externalId.
  • Catalogus-demosjablonen: student-id-card, daily-access-pass en conference-badge.
  • Fotoidentificatie: Upload pasfoto's van medewerkers naar de thumbnail-assetpositie (90x90 pt op @1x, 270x270 px op @3x). Google Wallet geeft dit weer als een prominente ronde of vierkante avatar.
  • Organisatiehuisstijl: Vaste logo- en strip-banner met bedrijfs- of campuskleuren.
  • Dynamische medewerkersgegevens:

- primaryFields: Volledige naam van medewerker ({fullName}). - secondaryFields: Functietitel ({title}) en afdeling ({department}). - auxiliaryFields: Personeels-ID ({employeeId}) en beveiligingsniveau ({clearanceLevel}). - backFields: Noodprotocollen voor het gebouw, telefoonnummers van de beveiliging en links naar de IT-servicedesk.

  • Dynamische antischreenshot-animatie (addSecurityAnimation: true): Genereert een geanimeerde, in de tijd variërende visuele rand rondom de pas om fraude met statische schermafbeeldingen of doorgestuurde foto's tegen te gaan.

Toegangsmechanieken & aanwezigheidsregistratie

Voor dagelijkse aanwezigheid in een gebouw, dienstroosters of controle van lunchvergoedingen kunnen identiteitspassen worden uitgerust met interactieve mechanieken:

  • Mechaniektype: VALID_ONCE_PER_DAY.
  • Tijdzonebepaling (resolveCustomerTimeZone): Pass Mechanics Engine bepaalt de tijdzone van de gebouwlocatie van de pashouder (bijv. Europe/London). Na één scan bij een receptietourniquet geven volgende scans op dezelfde kalenderdag een waarschuwing zonder dubbele aanwezigheid te registreren.
  • Scanmodi (ScanMode) & resultaten (scan status):

- CHECK_IN: Legt de aankomsttijd bij de hoofdingang vast (CHECK_IN_SUCCESS, of ALREADY_CHECKED_IN indien al binnen). - CHECK_OUT: Legt het vertrek bij de uitgang vast (CHECK_OUT_SUCCESS, of ALREADY_CHECKED_OUT). - CHECK_IN_CHECK_OUT_TOGGLE: Schakelt bij elke lezerscan automatisch tussen aanwezig en afwezig op de locatie. - SAVE_ATTENDANCE: Registreert herhaalbare incheckgebeurtenissen zonder de toegangsstatus om te schakelen.

Contactloze NFC-deurtoegang (Apple VAS & Google Smart Tap)

Passinstance ondersteunt contactloze overdracht van inloggegevens via de fysieke ISO/IEC 14443 Type A/B-laag:

NFC-configuratiewoordenboek voor passen

Bij het configureren van contactloze deurtoegang wordt het nfc-schema in de paspayload opgenomen:

JSON
{
  "nfc": {
    "message": "FACILITY_ACCESS_NODE_772",
    "encryptionPublicKey": "04a1b2c3d4e5f6...",
    "requiresAuthentication": true,
    "nfcFaceIdRequired": true,
    "nfcNoBarcode": false
  }
}
  • requiresAuthentication / nfcFaceIdRequired: Vraagt de gebruiker om verificatie via Face ID, Touch ID of toegangscode voordat de NFC-payload naar de deurlezerterminal wordt verzonden.
  • nfcNoBarcode: Onderdrukt de weergave van een optische barcode op de voorkant van de pas bij beveiligde tourniquets die uitsluitend met NFC werken.
  • Compatibele hardwarelezers: Integreert met certified NFC-, Identiv- en HID-lezers die met Passinstance zijn gekoppeld via hardware reader / reader device-configuraties.

Directe uitdiensttreding & intrekkings-API

Wanneer een medewerker de organisatie verlaat of een tijdelijke bezoekersbadge verloopt, moet de toegang onmiddellijk worden ingetrokken:

Intrekkings-endpoint

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

Resultaat

  1. 1
    De passtatus status gaat over naar VOIDED, lifecycleStatus (PassLifecycleStatus) wordt VOIDED en het endpoint retourneert HTTP 204 No Content. Let op: options.reason accepteert VoidingReason (EXPIRED, CANCELLED, LOST, STOLEN, DUPLICATE, FRAUD, TECHNICAL_ISSUE, CUSTOMER_REQUEST, ADMIN_ACTION, SYSTEM_AUTO, OTHER).
  2. 2
    Alle daaropvolgende scans bij deurtourniquets of mobiele scannercontrolepunten worden geweigerd met beslissing ALREADY_VOIDED.
  3. 3
    Passinstance werkt walletVoidStatus (WalletPropagationStatus: NONE -> PENDING -> QUEUED -> SUCCEEDED) bij terwijl achtergrondworkers de update versturen via APNs HTTP/2 en de Google Wallet REST API.

Belangrijk: Contactloze deurtoegang via Apple Wallet vereist een goedgekeurd Apple VAS (Value Added Services)-handelaarscertificaat van Apple Developer Relations. Optisch scannen van QR-/Aztec-codes werkt direct zonder extra goedkeuring op standaardcamera's en 2D-barcodescanners.

Lees meer over onze Oplossingen voor toegang & identiteit.

Gerelateerde product- en ontwikkelaarsdocs

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.