Vue d'ensemble
Les organisations utilisent Passinstance pour remplacer les cartes et badges d'accès en plastique par des identifiants numériques sécurisés à leur marque dans Apple Wallet et Google Wallet. Collaborateurs, prestataires, étudiants et visiteurs accèdent aux immeubles de bureaux, campus de coworking et laboratoires sécurisés via des portiques à code-barres optiques 2D ou des lecteurs NFC sans contact.
Architecture backend & schéma visuel
Les passes d'identité sont conçus avec des métadonnées collaborateur très lisibles et des protections visuelles anti-contrefaçon :
Mise en page visuelle & emplacements d'images
-
Type de passe (pass type) :
studentId,genericouposterGeneric(Apple Wallet et Google Wallet affichent ces formats avec des proportions dédiées aux cartes d'identité). -
Corrélation SIRH & annuaire (
externalId) : enregistrez l'identifiant RH ou annuaire du collaborateur dansexternalId(max. 255 caractères, unique parmi les passes actifs du locataire) afin que les webhooks de départ puissent annuler ou mettre à jour les badges viaPOST /api/v1/passes/upsert-by-external-idouGET /api/v1/passes/by-external-id/:externalId. -
Modèles de démonstration du catalogue :
student-id-card,daily-access-passetconference-badge. -
Photo d'identification : importez les portraits des collaborateurs dans l'emplacement
thumbnail(90×90 pt en @1x, 270×270 px en @3x). Google Wallet affiche cet emplacement sous forme d'avatar circulaire ou carré bien visible. -
Identité de l'organisation : emplacements fixes
logoetstriparborant les couleurs de l'entreprise ou du campus. -
Métadonnées employé dynamiques :
- primaryFields : nom complet de l'employé ({fullName}). - secondaryFields : intitulé de poste ({title}) et service ({department}). - auxiliaryFields : matricule employé ({employeeId}) et niveau d'habilitation ({clearanceLevel}). - backFields : consignes d'urgence du bâtiment, numéros de sécurité et liens vers le support informatique.
-
Animation dynamique anti-capture d'écran (
addSecurityAnimation: true) : génère un contour animé variant dans le temps autour du passe pour empêcher les captures d'écran statiques ou la présentation d'une photo partagée.
Mécaniques de contrôle d'accès & suivi de présence
Pour le contrôle de présence quotidien, le suivi des vacations ou la gestion des droits de cantine, les passes d'identité peuvent intégrer des mécaniques interactives :
-
Type de mécanique :
VALID_ONCE_PER_DAY. -
Résolution du fuseau horaire (
resolveCustomerTimeZone) :Pass Mechanics Enginerésout le fuseau horaire du site du porteur (ex.Europe/London). Une fois scanné à un portique d'accueil, les scans suivants au cours de la même journée calendaire renvoient un avertissement sans enregistrer de double présence. -
Modes de scan (
ScanMode) & résultats (scan status) :
- CHECK_IN : enregistre l'heure d'arrivée à l'entrée du bâtiment (CHECK_IN_SUCCESS, ou ALREADY_CHECKED_IN si déjà présent). - CHECK_OUT : enregistre le départ à la borne de sortie (CHECK_OUT_SUCCESS, ou ALREADY_CHECKED_OUT). - CHECK_IN_CHECK_OUT_TOGGLE : bascule automatiquement le statut entre présent sur site et absent à chaque passage devant le lecteur. - SAVE_ATTENDANCE : consigne des événements de présence répétables sans basculer d'état entrée/sortie.
Accès sans contact NFC aux portes (Apple VAS & Google Smart Tap)
Passinstance prend en charge la transmission matérielle d'identifiants sans contact sur la couche physique ISO/IEC 14443 Type A/B :
Dictionnaire de configuration NFC du passe
Lors de la configuration de l'accès sans contact aux portes, le schéma nfc est injecté dans la charge utile du passe :
{
"nfc": {
"message": "FACILITY_ACCESS_NODE_772",
"encryptionPublicKey": "04a1b2c3d4e5f6...",
"requiresAuthentication": true,
"nfcFaceIdRequired": true,
"nfcNoBarcode": false
}
}
-
requiresAuthentication/nfcFaceIdRequired: demande à l'utilisateur une validation par Face ID, Touch ID ou code d'accès avant de transmettre la charge utile NFC au lecteur de porte. -
nfcNoBarcode: masque l'affichage du code-barres optique sur la face du passe lors du déploiement de portiques sécurisés exclusivement NFC. -
Lecteurs matériels compatibles : s'intègre avec les lecteurs certified NFC, Identiv et HID appairés à Passinstance via les configurations
hardware reader/reader device.
Départ collaborateur & API de révocation instantanée
Lorsqu'un collaborateur quitte l'organisation ou qu'un badge prestataire temporaire arrive à échéance, son accès doit être révoqué immédiatement :
Endpoint de révocation
/api/v1/passes/voiding/:id/void
{
"voided": true,
"options": {
"reason": "CANCELLED",
"customReason": "EMPLOYEE_OFFBOARDED",
"sendPushNotification": false
}
}
Résultat
-
1
Le champ
statusdu passe bascule versVOIDED,lifecycleStatus(PassLifecycleStatus) passe àVOIDED, et l'endpoint retourne un code HTTP204 No Content. Notez queoptions.reasonaccepte les valeursVoidingReason(EXPIRED,CANCELLED,LOST,STOLEN,DUPLICATE,FRAUD,TECHNICAL_ISSUE,CUSTOMER_REQUEST,ADMIN_ACTION,SYSTEM_AUTO,OTHER). -
2
Tous les scans ultérieurs aux portiques d'accès ou sur les terminaux mobiles de contrôle sont rejetés avec la décision
ALREADY_VOIDED. -
3
Passinstance actualise
walletVoidStatus(WalletPropagationStatus:NONE->PENDING->QUEUED->SUCCEEDED) à mesure que les workers en arrière-plan poussent la mise à jour via APNs HTTP/2 et l'API REST Google Wallet.
Important : L'accès sans contact aux portes via Apple Wallet exige un certificat marchand Apple VAS (Value Added Services) approuvé par Apple Developer Relations. Le scan optique par code QR/Aztec fonctionne immédiatement avec des caméras standard et des lecteurs de codes-barres 2D.
Découvrez nos Solutions d'accès & d'adhésion.
