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:
Visuele lay-out & assetposities
-
Pastype (pass type):
studentId,genericofposterGeneric(Apple Wallet en Google Wallet tonen deze met specifieke verhoudingen voor identiteitskaarten). -
HRIS- & directorycorrelatie (
externalId): Sla uw directory-/HR-medewerkersnummer op inexternalId(max. 255 tekens, uniek binnen actieve tenantpassen) zodat geautomatiseerde uitdiensttredingswebhooks passen kunnen intrekken of bijwerken viaPOST /api/v1/passes/upsert-by-external-idofGET /api/v1/passes/by-external-id/:externalId. -
Catalogus-demosjablonen:
student-id-card,daily-access-passenconference-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- enstrip-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 Enginebepaalt 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:
{
"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
/api/v1/passes/voiding/:id/void
{
"voided": true,
"options": {
"reason": "CANCELLED",
"customReason": "EMPLOYEE_OFFBOARDED",
"sendPushNotification": false
}
}
Resultaat
-
1
De passtatus
statusgaat over naarVOIDED,lifecycleStatus(PassLifecycleStatus) wordtVOIDEDen het endpoint retourneert HTTP204 No Content. Let op:options.reasonaccepteertVoidingReason(EXPIRED,CANCELLED,LOST,STOLEN,DUPLICATE,FRAUD,TECHNICAL_ISSUE,CUSTOMER_REQUEST,ADMIN_ACTION,SYSTEM_AUTO,OTHER). -
2
Alle daaropvolgende scans bij deurtourniquets of mobiele scannercontrolepunten worden geweigerd met beslissing
ALREADY_VOIDED. -
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.
